lctl-network(8)

LCTL-NETWORK(8)

Lustre Configuration Utilities

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}

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