LCTL-NETWORK(8)

NAME
lctl-network - start or stop an LNet network or set network type

SYNOPSIS
lctl network {up|down} | {configure|unconfigure} | {tcp|o2ib}

DESCRIPTION
lctl network is used to start or stop LNet and LNet configuration on a client, server, or router. lctl net is an alias for lctl network. However, netctl lnet is the preferred command for configuring and unconfiguring network interfaces.

The Lustre software automatically starts and stops LNet, but it can also be manually stopped or started in a standalone manner. This is particularly useful to verify that your networking setup is working correctly before you attempt to start the Lustre file system, or necessary for Lustre routers which only need the LND and LNet modules.

OPTIONS

up  Starts LNet. The LNet modules must be loaded first.

down
    Stops LNet

configure
    Loads LNet configuration

unconfigure
    Clears LNet configuration. This step is necessary for standalone routers to remove LNet references before the LNet modules can be removed.

NOTES
Since Lustre 2.15.0 the lustre_rmmod script calls lnetctl lnet unconfigure or lctl network down command internally to stop the LNet network interfaces. Otherwise the lustre_rmmod utility does not work if you have manually run the lctl network up command.

Attempting to remove lustre(7) modules prior to stopping the network may result in a crash or an LNet hang. If this occurs, the node must be rebooted (in most cases). Make sure that the Lustre network and file system are stopped prior to unloading the modules.

EXAMPLES
To load the module and start LNet:
        # modprobe lnet
        # lctl network up
        LNet configured

To stop LNet and remove the module:
        # lctl network down
        LNet ready to unload
        # rmmod lnet

To load LNet configuration in standalone mode:
        # lctl network configure
        LNet configured

To clear the LNet configuration:
        # lctl network unconfigure
        LNet ready to unload

AVAILABILITY
lctl network is a subcommand of lctl(8) and is distributed as part of the lustre(7) filesystem package since release 0.6.0

SEE ALSO
lctl(8), lnetctl(8)