lustre/doc/lctl-network.8

   1 .TH lctl-network 8 "2014 May 28" Lustre "configuration utilities"
   2 .SH NAME
   3 lctl network \- start or stop an LNet network or set network type
   4 .SH SYNOPSIS
   5 .B lctl network
   6 .I up
   7 |
   8 .I down
   9 |
  10 .I configure
  11 |
  12 .I unconfigure
  13 |
  14 .RI < tcp / o2ib >
  15
  16 .B net
  17 can be substituted for
  18 .B network
  19 .SH DESCRIPTION
  20 .B lfs network
  21 is used to start or stop LNet and LNet configuration on a client, server, or router.
  22 .P
  23 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.
  24 .SH OPTIONS
  25 .TP
  26 .B up
  27 Starts LNet. The LNet modules must be loaded first.
  28 .TP
  29 .B down
  30 Stops LNet
  31 .TP
  32 .B configure
  33 Loads LNet configuration
  34 .TP
  35 .B unconfigure
  36 Clears LNet configuration. This step is necessary for standalone routers to remove LNet references before the LNet modules can be removed.
  37 .SH EXAMPLES
  38 .TP
  39 To load the module and start LNet
  40 # modprobe lnet
  41 .br
  42 # lctl network up
  43 .br
  44 LNet configured
  45 .TP
  46 To stop LNet and remove the module
  47 # lctl network down
  48 .br
  49 LNet ready to unload
  50 .br
  51 # rmmod lnet
  52 .TP
  53 To load LNet configuration in standalone mode
  54 # lctl network configure
  55 .br
  56 LNet configured
  57 .TP
  58 To clear the LNet configuration
  59 # lctl network unconfigure
  60 LNet ready to unload
  61 .SH NOTES
  62 .P
  63 The lustre_rmmod utility does not work if you have manually run the
  64 .B lctl network
  65 .I up
  66 command.
  67 .P
  68 Attempting to remove
  69 .BR lustre (7)
  70 modules prior to stopping the network may result in a crash or an LNet hang.
  71 If this occurs, the node must be rebooted (in most cases). Make sure that the
  72 Lustre network and file system are stopped prior to unloading the modules.
  73 .SH AVAILABILITY
  74 .B lctl network
  75 is a subcommand of
  76 .BR lctl (8)
  77 and is distributed as part of the
  78 .BR lustre (7)
  79 filesystem package.
  80 .SH SEE ALSO
  81 .BR lctl (8)