1aoe-mkshelf(8)              System Manager's Manual             aoe-mkshelf(8)
2
3
4

NAME

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

SYNOPSIS

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

DESCRIPTION

13       The  aoe-mkshelf  command  is  not  needed  on  systems  that have udev
14       installed and is incompatible with aoe drivers that have  the  aoe_dyn‐
15       devs module parameter set to 1.
16
17       Systems  lacking  udev  and having an aoe driver that uses static minor
18       device numbers can use aoe-mkshelf to create the  block  special  files
19       necessary to access the AoE devices with the given shelf address.
20
21       All aoe drivers prior to aoe6-50 use static minor device numbers.  Ver‐
22       sions 50 and up use dynamic minor device numbers when the module param‐
23       eter aoe_dyndevs=1 is set.
24
25       If  you  are using static minor device numbers and your aoe driver sup‐
26       ports only one partition per device (whole-disk partitions),  then  the
27       device  files  must match, and you should use the n_partitions environ‐
28       ment variable described below.
29
30   Arguments
31       device-dir
32              This should be the name of the directory where the block  device
33              files will be created.
34
35       shelf-address
36              This  is  the  AoE major address, or shelf address, for which to
37              create device nodes.  For example, specifying a shelf address of
38              1  means  that  the e1.* device nodes will be created in device-
39              dir.
40

ENVIRONMENT VARIABLES

42       If the n_partitions variable is set in the environment, it  will  over‐
43       ride the default number of partitions per aoe disk, namely 16.
44

EXAMPLE

46       In  this  example,  the  root  user on a host named nai creates special
47       files for using the aoe disks in shelf 7.  Then he remembers  that  the
48       driver  doesn't  have partition support, so the command is called again
49       with n_partitions set to 1.
50
51              nai:~# aoe-mkshelf /dev/etherd 7
52              nai:~# ls /dev/etherd/e7.* | wc -l
53              160
54              nai:~# rm /dev/etherd/e7.*
55              nai:~# n_partitions=1 aoe-mkshelf /dev/etherd 7
56              nai:~# ls /dev/etherd/e7.* | wc -l
57              10
58              nai:~#
59

SEE ALSO

61       aoe-discover(8), aoe-interfaces(8),  aoe-mkdevs(8),  aoe-stat(8),  aoe‐
62       tools(8), udev(7).
63

AUTHOR

65       Ed L. Cashin (ecashin@coraid.com)
66
67
68
69                                                                aoe-mkshelf(8)
Impressum