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)