NAME

       aoe-mkshelf - create special device files for one shelf address

SYNOPSIS

       aoe-mkshelf {device-dir} {shelf-address}
       env n_partitions=1 aoe-mkshelf {device-dir} {shelf-address}

DESCRIPTION

       The  aoe-mkshelf  command  is not needed on systems that have udev installed and is incompatible with aoe
       drivers that have the aoe_dyndevs module parameter set to 1.

       Systems lacking udev and having an aoe driver that uses static minor device numbers can  use  aoe-mkshelf
       to create the block special files necessary to access the AoE devices with the given shelf address.

       All  aoe  drivers prior to aoe6-50 use static minor device numbers.  Versions 50 and up use dynamic minor
       device numbers when the module parameter aoe_dyndevs=1 is set.

       If you are using static minor device numbers and your aoe driver supports only one partition  per  device
       (whole-disk  partitions),  then  the  device  files  must  match,  and  you  should  use the n_partitions
       environment variable described below.

   Arguments
       device-dir
              This should be the name of the directory where the block device files will be created.

       shelf-address
              This is the AoE major address, or shelf address, for which to create device nodes.   For  example,
              specifying a shelf address of 1 means that the e1.* device nodes will be created in device-dir.

ENVIRONMENT VARIABLES

       If the n_partitions variable is set in the environment, it will override the default number of partitions
       per aoe disk, namely 16.

EXAMPLE

       In this example, the root user on a host named nai creates special files for using the aoe disks in shelf
       7.  Then he remembers that the driver doesn't have partition support, so the command is called again with
       n_partitions set to 1.

              nai:~# aoe-mkshelf /dev/etherd 7
              nai:~# ls /dev/etherd/e7.* | wc -l
              160
              nai:~# rm /dev/etherd/e7.*
              nai:~# n_partitions=1 aoe-mkshelf /dev/etherd 7
              nai:~# ls /dev/etherd/e7.* | wc -l
              10
              nai:~#

SEE ALSO

       aoe-discover(8), aoe-interfaces(8), aoe-mkdevs(8), aoe-stat(8), aoetools(8), udev(7).

AUTHOR

       Ed L. Cashin (ecashin@coraid.com)

                                                                                                  aoe-mkshelf(8)