lustre/doc/ldev.conf.5

   1 .TH ldev.conf 5 Lustre ldev.conf /etc/ldev.conf
   2 .SH NAME
   3 /etc/ldev.conf \- lustre device configuration file
   4 .SH DESCRIPTION
   5 The ldev.conf file contains a list of Lustre devices used by the
   6 \fBldev\fR utility.
   7 .SH FORMAT
   8 Comments beginning with a hash (#) are ignored.  Each line represents one
   9 device and includes the following information separated by white space:
  10 .TP
  11 .I "local hostname"
  12 The name of the host where the device normally runs.
  13 .TP
  14 .I "foreign hostname"
  15 The name of the host where the device runs when failed over.
  16 If failover is not used, insert a hyphen as a placeholder.
  17 .TP
  18 .I "label"
  19 The Lustre label associated with the device in the form \fIfsname-SRVnnnn\fR
  20 where \fIfsname\fR is the file system name, \fISRV\fR is \fBOST\fR or
  21 \fBMDT\fR, and \fInnnn\fR is the four-digit hex index of the device.
  22 .TP
  23 .I "path"
  24 The path name of the device.  In failover configurations it should be available
  25 on both local and foreign hosts, e.g. use the symlinks maintained by udev
  26 in \fI/dev/disk/by-id\fR.
  27 .TP
  28 .I "journal-path"
  29 The path name of the journal device, if any.  This field may be omitted unless
  30 the raidtab field is present.  If a journal device is not used a hyphen may be
  31 inserted as a placeholder.
  32 .TP
  33 .I "raidtab"
  34 The path name of a Linux software raid configuration file or ZFS cache file.
  35 Using non-default names for these files may help prevent arrays from being
  36 automatically started by the system.  This is important in failover
  37 configurations where the timing of device initialization must be strictly
  38 controlled.  This field may be omitted.
  39 .SH EXAMPLES
  40 .nf
  41
  42 #local  foreign/-  label    [md:|zfs:]device-path   [journal-path]/- [raidtab]
  43
  44 # ldiskfs on block device example
  45 tycho-mds1 -    lc1-MDT0000 /dev/sda                /dev/sdc
  46 tycho1  tycho5  lc1-OST0000 /dev/disk/by-id/scsi-10103a262891d340100
  47 tycho1  tycho5  lc1-OST0008 /dev/disk/by-id/scsi-10103a262681d340200
  48 tycho1  tycho5  lc1-OST0010 /dev/disk/by-id/scsi-10103a2629e1d340300
  49 tycho5  tycho1  lc1-OST0004 /dev/disk/by-id/scsi-101046e6b401d341100
  50 tycho5  tycho1  lc1-OST000c /dev/disk/by-id/scsi-101046e6b591d341200
  51 tycho5  tycho1  lc1-OST0014 /dev/disk/by-id/scsi-101046e6bb41d341300
  52
  53 # ldiskfs on Linux software RAID example
  54 #local  foreign/-  label    [md:|zfs:]device-path   [journal-path]/- [raidtab]
  55 zwicky-mds1  -    zwicky-MDT0000 md:/dev/md0 -         /etc/mdadm.conf.mds
  56 zwicky1  zwicky2  zwicky-OST0000 md:/dev/md0 /dev/md10 /etc/mdadm.conf.oss
  57 zwicky2  zwicky1  zwicky-OST0001 md:/dev/md1 /dev/md20 /etc/mdadm.conf.oss
  58
  59 # ZFS example
  60 #local  foreign/-  label    [md:|zfs:]device-path   [journal-path]/- [raidtab]
  61 zeno-mds1 -   zeno-MDT0000 zfs:lustre-zeno-mds1/mdt1 - /etc/zfs/zpool.cache.zeno
  62 zeno1  zeno5  zeno-OST0000 zfs:lustre-zeno1/ost1     - /etc/zfs/zpool.cache.zeno
  63 zeno5  zeno1  zeno-OST0001 zfs:lustre-zeno5/ost1     - /etc/zfs/zpool.cache.zeno
  64
  65 .fi
  66 .SH "SEE ALSO"
  67 .BR ldev (8)