LCTL-NETWORK(8) Lustre Configuration Utilities LCTL-NETWORK(8)

# [NAME](#NAME)

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

# [SYNOPSIS](#SYNOPSIS)

`lctl network` {**up**|**down**} | {**configure**|**unconfigure**} | {**tcp**|**o2ib**}

# [DESCRIPTION](#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](#OPTIONS)

[**up**](#up)

Starts LNet. The LNet modules must be loaded first.

[**down**](#down)

Stops LNet

[**configure**](#configure)

Loads LNet configuration

[**unconfigure**](#unconfigure)

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

# [NOTES](#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)](/man/enterprise-packages/lustre/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](#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](#AVAILABILITY)

**lctl network** is a subcommand of [**lctl**(8)](/man/enterprise-packages/lustre/lctl.8) and is distributed as part of the [**lustre**(7)](/man/enterprise-packages/lustre/lustre.7) filesystem package since release 0.6.0

# [SEE ALSO](#SEE_ALSO)

[**lctl**(8)](/man/enterprise-packages/lustre/lctl.8), [**lnetctl**(8)](/man/enterprise-packages/lustre/lnetctl.8)

2024-08-14 Lustre

---

Document: lctl-network(8) from lustre 2.17.59-r1 (Chainguard OS)
Source: https://github.com/lustre/lustre-release