From 3cab078778a7735f2c1d7cf05e853b64e6863184 Mon Sep 17 00:00:00 2001 From: Andreas Dilger Date: Tue, 6 Sep 2016 02:42:11 -0600 Subject: [PATCH] LU-4315 doc: split lctl-network.8 man page from lctl.8 Split the lctl-network.8 man page from lctl.8 so that it can have a more complete description and usage messages. Test-Parameters: trivial Signed-off-by: Andreas Dilger Change-Id: I5c3b94fca277c53b249d09ac9e65266a8b8ad322 Reviewed-on: http://review.whamcloud.com/22324 Tested-by: Jenkins Tested-by: Maloo Reviewed-by: James Simmons Reviewed-by: Doug Oucharek Reviewed-by: Oleg Drokin --- lustre/doc/lctl-network.8 | 81 +++++++++++++++++++++++++ lustre/doc/lctl.8 | 151 ++++++++++++++++++++++++---------------------- 2 files changed, 159 insertions(+), 73 deletions(-) create mode 100644 lustre/doc/lctl-network.8 diff --git a/lustre/doc/lctl-network.8 b/lustre/doc/lctl-network.8 new file mode 100644 index 0000000..6917574 --- /dev/null +++ b/lustre/doc/lctl-network.8 @@ -0,0 +1,81 @@ +.TH lctl-network 8 "2014 May 28" Lustre "configuration utilities" +.SH NAME +lctl network \- start or stop an LNet network or set network type +.SH SYNOPSIS +.B lctl network +.I up +| +.I down +| +.I configure +| +.I unconfigure +| +.RI < tcp / o2ib > + +.B net +can be substituted for +.B network +.SH DESCRIPTION +.B lfs network +is used to start or stop LNet and LNet configuration on a client, server, or router. +.P +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. +.SH OPTIONS +.TP +.B up +Starts LNet. The LNet modules must be loaded first. +.TP +.B down +Stops LNet +.TP +.B configure +Loads LNet configuration +.TP +.B unconfigure +Clears LNet configuration. This step is necessary for standalone routers to remove LNet references before the LNet modules can be removed. +.SH EXAMPLES +.TP +To load the module and start LNet +# modprobe lnet +.br +# lctl network up +.br +LNet configured +.TP +To stop LNet and remove the module +# lctl network down +.br +LNet ready to unload +.br +# rmmod lnet +.TP +To load LNet configuration in standalone mode +# lctl network configure +.br +LNet configured +.TP +To clear the LNet configuration +# lctl network unconfigure +LNet ready to unload +.SH NOTES +.P +The lustre_rmmod utility does not work if you have manually run the +.B lctl network +.I up +command. +.P +Attempting to remove +.BR 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. +.SH AVAILABILITY +.B lctl network +is a subcommand of +.BR lctl (8) +and is distributed as part of the +.BR lustre (7) +filesystem package. +.SH SEE ALSO +.BR lctl (8) diff --git a/lustre/doc/lctl.8 b/lustre/doc/lctl.8 index 8a248f0..69d399f 100644 --- a/lustre/doc/lctl.8 +++ b/lustre/doc/lctl.8 @@ -1,4 +1,4 @@ -.TH lctl 1 "2003 Oct 8" Lustre "configuration utilities" +.TH lctl 1 "2016 Sep 8" Lustre "configuration utilities" .SH NAME lctl \- Low level Lustre filesystem configuration utility .SH SYNOPSIS @@ -11,40 +11,33 @@ lctl \- Low level Lustre filesystem configuration utility .B lctl is used to directly control Lustre via an ioctl interface, allowing various configuration, maintenance, and debugging features to be accessed. - + .B lctl can be invoked in interactive mode by issuing lctl command. After that, commands are issued as below. The most common commands in lctl are -.B dl -, -.B dk -, -.B device -, -.B network -.I -, -.B list_nids -, +.BR dl , +.BR dk , +.BR device , +.B network +.IR , +.BR list_nids , .B ping -.I nid -, -.B help -, -.B quit. +.IR nid , +.BR help , +.BR quit . To get a complete listing of available commands, type .B help at the lctl prompt. To get basic help on the meaning and syntax of a -command, type -.B help +command, type +.B help .I command -. Command completion is activated with the TAB key, and command history is available via the up- and down-arrow keys. +. Command completion is activated with the TAB key, and command history is available via the up- and down-arrow keys. -For non-interactive use, one uses the second invocation, which runs command after connecting to the device. +For non-interactive use, one uses the second invocation, which runs command after connecting to the device. .SS Network Configuration .TP -.BI network " |" +.BR network " <" up / down >|< tcp / o2ib > Start or stop LNET, or select a network type for other .I lctl LNET commands @@ -70,35 +63,35 @@ The previous log is backed up with the suffix '.bak'. Check LNET connectivity via an LNET ping. This will use the fabric appropriate to the specified NID. .TP -.BI interface_list -Print the network interface information for a given +.BI interface_list +Print the network interface information for a given .B network type. .TP -.BI peer_list -Print the known peers for a given +.BI peer_list +Print the known peers for a given .B network type. .TP -.BI conn_list +.BI conn_list Print all the connected remote NIDs for a given .B network type. -.TP -.BI route_list +.TP +.BI route_list Print the complete routing table. .PP .SS Device Selection -.TP -.BI device " " -This will select the specified OBD device. All other commands depend on the device being set. -.TP -.BI device_list -Show all the local Lustre OBDs. AKA +.TP +.BI device " " +This will select the specified OBD device. All other commands depend on the device being set. +.TP +.BI device_list +Show all the local Lustre OBDs. AKA .B dl .PP .SS Device Operations -.TP +.TP .BI list_param " [-F|-R] " List the Lustre or LNet parameter name .B -F @@ -233,9 +226,9 @@ Delete a parameter setting (use the default value at the next restart). A null .br .B Parameters: .br -All of the writable parameters under +All of the writable parameters under .B lctl list_param -(e.g. +(e.g. .I lctl list_param -F osc.*.* | grep = ) can be permanently set using .B lctl conf_param @@ -244,33 +237,33 @@ All of the writable parameters under Additionally, failover nodes may be added (or removed), and some system-wide parameters may be set as well (sys.at_max, sys.at_min, sys.at_extra, sys.at_early_margin, sys.at_history, sys.timeout, sys.ldlm_timeout.) is ignored for system wide parameters. .br .B Examples: -.br +.br # lctl conf_param testfs.sys.at_max=1200 .br -# lctl conf_param testfs.llite.max_read_ahead_mb=16 +# lctl conf_param testfs.llite.max_read_ahead_mb=16 .br # lctl conf_param testfs-MDT0000.lov.stripesize=2M .br -# lctl conf_param lustre-OST0001.osc.active=0 +# lctl conf_param lustre-OST0001.osc.active=0 .br -# lctl conf_param testfs-OST0000.osc.max_dirty_mb=29.15 +# lctl conf_param testfs-OST0000.osc.max_dirty_mb=29.15 .br -# lctl conf_param testfs-OST0000.ost.client_cache_seconds=15 +# lctl conf_param testfs-OST0000.ost.client_cache_seconds=15 .br # lctl conf_param testfs-OST0000.failover.node=1.2.3.4@tcp1 -.TP -.BI activate -Reactivate an import after deactivating, below. This setting is only effective until the next restart (see +.TP +.BI activate +Reactivate an import after deactivating, below. This setting is only effective until the next restart (see .B conf_param ). -.TP -.BI deactivate +.TP +.BI deactivate Deactivate an import, in particular meaning do not assign new file stripes to an OSC. This command should be used on the OSC in the MDT LOV corresponding to a failed OST device, to prevent further attempts at communication with the failed OST. -.TP -.BI abort_recovery +.TP +.BI abort_recovery Abort the recovery process on a restarting MDT or OST device .PP .SS Virtual Block Device Operation @@ -391,43 +384,43 @@ Stop LFSCK on the specified MDT or OST device. Get the LFSCK global status via the specified MDT device. .RE .SS Debug -.TP -.BI debug_daemon +.TP +.BI debug_daemon Start and stop the debug daemon, and control the output filename and size. -.TP -.BI debug_kernel " [file] [raw]" +.TP +.BI debug_kernel " [file] [raw]" Dump the kernel debug buffer to stdout or file. -.TP +.TP .BI debug_file " [output]" Convert kernel-dumped debug log from binary to plain text format. -.TP -.BI clear +.TP +.BI clear Clear the kernel debug buffer. -.TP -.BI mark " " +.TP +.BI mark " " Insert marker text in the kernel debug buffer. -.TP -.BI filter " " +.TP +.BI filter " " Filter kernel debug messages by subsystem or mask. -.TP -.BI show " " +.TP +.BI show " " Show specific type of messages. -.TP -.BI debug_list " " +.TP +.BI debug_list " " List all the subsystem and debug types. .TP -.BI modules " " +.BI modules " " Provide gdb-friendly module information. .SH OPTIONS -The following options can be used to invoke lctl. +The following options can be used to invoke lctl. .TP -.B --device +.B --device The device to be used for the operation. This can be specified by name or -number. See +number. See .B device_list .TP -.B --ignore_errors | ignore_errors +.B --ignore_errors | ignore_errors Ignore errors during script processing .TP .B lustre_build_version @@ -457,12 +450,24 @@ lctl > quit .SH AVAILABILITY .B lctl -is part of the -.BR Lustre (7) +is part of the +.BR Lustre (7) filesystem package. .SH SEE ALSO .BR lustre (7), .BR mkfs.lustre (8), .BR mount.lustre (8), .BR lctl (8), +.BR lctl-lfsck-start (8), +.BR lctl-lfsck-stop (8), +.BR lctl-lfsck-query (8), +.BR lctl-network (8), +.BR lctl-nodemap-activate (8), +.BR lctl-nodemap-add-idmap (8), +.BR lctl-nodemap-add-range (8), +.BR lctl-nodemap-add (8), +.BR lctl-nodemap-del-idmap (8), +.BR lctl-nodemap-del-range (8), +.BR lctl-nodemap-del (8), +.BR lctl-nodemap-modify (8), .BR lfs (1) -- 1.8.3.1