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> net can be substituted for network

DESCRIPTION
lfs network is used to start or stop LNet and LNet configuration on a client, server, or router.

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.

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

NOTES

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.

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

SEE ALSO
lctl(8)