Man Linux: Main Page and Category List


       lctl - Low level Lustre filesystem configuration utility


       lctl --device <devno> <command [args]>


       lctl  is  used  to  directly  control  Lustre  via  an ioctl interface,
       allowing various configuration, maintenance, and debugging features  to
       be accessed.

       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  dl  ,  device  , network <up/down> , list_nids , ping nid , help ,

       To get a complete listing of available commands, type help at the  lctl
       prompt.  To get basic help on the meaning and syntax of a command, type
       help command 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.

   Network Configuration
       network <up/down>|<tcp/elan/myrinet>
              Start or stop LNET, or select a network type for other lctl LNET

              Print  all  Network  Identifiers on the local node. LNET must be

       which_nid <nidlist>
              From a list of nids for a  remote  node,  show  which  interface
              communication will take place on.

       ping <nid>
              Check  LNET  connectivity  via  an  LNET ping. This will use the
              fabric appropriate to the specified NID.

              Print the network interface  information  for  a  given  network

              Print the known peers for a given network type.

              Print all the connected remote NIDs for a given network type.

              This  command should print active transmits, and it is only used
              for elan network type.

              Print the complete routing table.

   Device Selection
       device <devname>
              This will select the specified OBD device.  All  other  commands
              depend on the device being set.

              Show all the local Lustre OBDs. AKA dl

   Device Operations
       conf_param <device> <parameter>
              Set  a  permanent configuration parameter for any device via the
              MGS.  This command must be run on the MGS node.

              Reactivate an import after deactivating, below.

              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.

              Abort the recovery process on a restarting MDT or OST device

   Virtual Block Device Operation
       Lustre  is able to emulate a virtual block device upon regular file. It
       is necessary to be used when you are trying to setup a swap  space  via

       blockdev_attach <file name> <device node>
              Attach  the lustre regular file to a block device. If the device
              node is not existent, lctl will create it - it is recommended to
              create  it  by  lctl  since  the emulator uses a dynamical major

       blockdev_detach <device node>
              Detach the virtual block device.

       blockdev_info <device node>
              Acquire which lustre file was attached to the device node.

              Start and stop the debug daemon, and control the output filename
              and size.

       debug_kernel [file] [raw]
              Dump the kernel debug buffer to stdout or file.

       debug_file <input> [output]
              Convert  kernel-dumped  debug  log  from  binary  to  plain text

       clear  Clear the kernel debug buffer.

       mark <text>
              Insert marker text in the kernel debug buffer.

       filter <subsystem id/debug mask>
              Filter kernel debug messages by subsystem or mask.

       show <subsystem id/debug mask>
              Show specific type of messages.

       debug_list <subs/types>
              List all the subsystem and debug types.

       modules <path>
              Provide gdb-friendly module information.


       The following options can be used to invoke lctl.

              The device to be used for the operation. This can  be  specified
              by name or number. See device_list

       --ignore_errors | ignore_errors
              Ignore errors during script processing

              # lctl
              lctl > dl
                0     UP     mgc    MGC192.168.0.20@tcp    bfbb24e3-7deb-2ffa-
              eab0-44dffe00f692 5
                1 UP ost OSS OSS_uuid 3
                2 UP obdfilter testfs-OST0000 testfs-OST0000_UUID 3
              lctl > dk /tmp/log Debug log: 87 lines, 87 kept, 0 dropped.
              lctl > quit

       # lctl conf_param testfs-MDT0000 sys.timeout=40


       Please    report    all    bugs    to    Sun     Microsystems,     Inc.


       lctl  is part of the Lustre(7) filesystem package and is available from
       Sun Microsystems, Inc.


       Lustre(7), mkfs.lustre(8), mount.lustre(8), lctl(8), lfs(1)