LDEV.CONF(5)

NAME
/etc/ldev.conf - lustre device configuration file

DESCRIPTION
The ldev.conf file contains a list of Lustre devices used by the ldev utility.

FORMAT
Comments beginning with a hash (#) are ignored. Each line represents one device and includes the following information separated by a white space:

lOCAL_HOSTNAME
    The name of the host where the device normally runs.

FOREIGN_HOSTNAME
    The name of the host where the device runs when failed over. If failover is not used, insert a hyphen as a placeholder.

LABEL
    The Lustre label associated with the device in the form FSNAME- {OST|MDT} NNNN where FSNAME is the file system name, followed by either OST or MDT, and NNNN is the four-digit hex index of the device.

DEVICE_PATH
    The path name of the device. In failover configurations it should be available on both local and foreign hosts, e.g. use the symlinks maintained by udev in /dev/disk/by-id.

JOURNAL_PATH
    The path name of the journal device, if any. This field may be omitted unless the raidtab field is present. If a journal device is not used a hyphen may be inserted as a placeholder.

RAIDTAB
    The path name of a Linux software raid configuration file or ZFS cache file. Using non-default names for these files may help prevent arrays from being automatically started by the system. This is important in failover configurations where the timing of device initialization must be strictly controlled. This field may be omitted.

EXAMPLES
    # ldiskfs on block device example
    # LOCAL FOREIGN/- LABEL [md:|zfs:]DEVICE_PATH [JOURNAL_PATH]/- [RAIDTAB]
    tycho-mds1 -    lc1-MDT0000 /dev/sda                /dev/sdc
    tycho1  tycho5  lc1-OST0000 /dev/disk/by-id/scsi-10103a262891d340100
    tycho1  tycho5  lc1-OST0008 /dev/disk/by-id/scsi-10103a262681d340200
    tycho1  tycho5  lc1-OST0010 /dev/disk/by-id/scsi-10103a2629e1d340300
    tycho5  tycho1  lc1-OST0004 /dev/disk/by-id/scsi-101046e6b401d341100
    tycho5  tycho1  lc1-OST000c /dev/disk/by-id/scsi-101046e6b591d341200
    tycho5  tycho1  lc1-OST0014 /dev/disk/by-id/scsi-101046e6bb41d341300

    # ldiskfs on Linux software RAID example
    # LOCAL FOREIGN/- LABEL [md:|zfs:]DEVICE_PATH [JOURNAL_PATH]/- [RAIDTAB]
    zwicky-mds1  -    zwicky-MDT0000 md:/dev/md0 -         /etc/mdadm.conf.mds
    zwicky1  zwicky2  zwicky-OST0000 md:/dev/md0 /dev/md10 /etc/mdadm.conf.oss
    zwicky2  zwicky1  zwicky-OST0001 md:/dev/md1 /dev/md20 /etc/mdadm.conf.oss

    # ZFS example
    # LOCAL FOREIGN/- LABEL [md:|zfs:]DEVICE_PATH [JOURNAL_PATH]/- [RAIDTAB]
    zeno-mds1 -   zeno-MDT0000 zfs:lustre-zeno-mds1/mdt1 - /etc/zfs/zpool.cache.zeno
    zeno1  zeno5  zeno-OST0000 zfs:lustre-zeno1/ost1     - /etc/zfs/zpool.cache.zeno
    zeno5  zeno1  zeno-OST0001 zfs:lustre-zeno5/ost1     - /etc/zfs/zpool.cache.zeno

AVAILABILITY
/etc/ldev.conf is part of the lustre(7) filesystem package since release 2.3.0

SEE ALSO
ldev(8)