LUSTRE\_ROUTES\_CONFIG(8) Lustre Configuration Utilities LUSTRE\_ROUTES\_CONFIG(8)

# [NAME](#NAME)

lustre\_routes\_config - Configure routes dynamically

# [SYNOPSIS](#SYNOPSIS)

`lustre_routes_config` \[**--setup**|**--cleanup**|**--dry-run**|**--verbose**] *CONFIG\_FILE*

# [DESCRIPTION](#DESCRIPTION)

lustre\_routes\_config sets or cleans up LNET routes from the specified config file. /etc/lnet\_routes.conf file can be used to automatically configure routes on LNET startup.

The format of the config file is:

`NETWORK: {` **gateway**: *GATEWAY*@*EXIT\_NETWORK* \[**hop**: *HOP*] \[**priority**: *PRIOIRTY*] }

# [OPTIONS](#OPTIONS)

[**--setup**](#setup)

Configure routes listed in config\_file

[**--cleanup**](#cleanup)

Unconfigure routes listed in config\_file

[**--dry-run**](#dry-run)

Echo commands to be run, but do not execute them

[**--verbose**](#verbose)

Echo commands before they are executed

# [FILES](#FILES)

/etc/lnet\_routes.conf

# [NOTES](#NOTES)

An LNET router is identified when its local NID appears within the list of routes. However, this can not be achieved by the use of this script, since the script only adds extra routes after the role of the router is determined. To ensure that a router is identified correctly, make sure to add its local NID in the routes parameter in the modprobe lustre configuration file.

# [EXAMPLES](#EXAMPLES)

An example of a config file that the script expects:

```
tcp1: { gateway: 10.1.1.2@tcp0, priority: 3 }
tcp4: { gateway: 10.3.3.4@tcp }
tcp6: { gateway: 10.3.3.6@tcp, hop: 2, priority: 5 }
tcp7: { gateway: 10.3.3.[6-12]@tcp, priority: 20, hop: 8 }
```

An example of script execution:

```
lustre_routes_config --setup <path/to/routes_config_file>
lustre_routes_config --cleanup <path/to/routes_config_file>
```

# [AUTHORS](#AUTHORS)

Amir Shehata

# [AVAILABILITY](#AVAILABILITY)

**lustre\_routes\_config** is part of the [**lustre**(7)](/man/enterprise-packages/lustre/lustre.7) filesystem package since release 2.4.0

# [SEE ALSO](#SEE_ALSO)

[**nids**(5)](/man/enterprise-packages/lustre/nids.5), [**lustre**(7)](/man/enterprise-packages/lustre/lustre.7), [**lctl**(8)](/man/enterprise-packages/lustre/lctl.8), [**lustre\_routes\_conversion**(8)](/man/enterprise-packages/lustre/lustre_routes_conversion.8)

2024-08-28 Lustre

---

Document: lustre_routes_config(8) from lustre 2.17.59-r2 (Chainguard OS)
Source: https://github.com/lustre/lustre-release