Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

aoe-stat(8) [debian man page]

aoe-stat(8)						      System Manager's Manual						       aoe-stat(8)

NAME

       aoe-stat - print aoe device status report

SYNOPSIS

       modprobe aoe
       aoe-stat
       env sysfs_dir=/sys aoe-stat

DESCRIPTION

       The aoe-stat script collects information on ATA over Ethernet devices from sysfs.

       For each AoE device the kernel has discovered, there is one row in the script's output.	Each row has the following columns.

       devicename
	      The device name is of the form eX.Y,
	       with X being the AoE device shelf address, and Y being the AoE slot address.

       size   The size of the AoE device is in gigabytes (billions of bytes).

       ifname The network interface name is printed in the third column.

       payload
	      The  number  of  bytes  read  from  or written to the storage target in each AoE packet appears in the fourth column, unless the aoe
	      driver does not export this information.

       status The device status is in the last column.	Possible values are  up,  down, and  down,closewait.  The "up" status means the aoe driver
	      considers  this  device  ready for I/O.  The "down" status means the opposite.  The "down,closewait" status means that some software
	      still has the device open, and when this straggler closes the device, it will enter the "down" state.

ENVIRONMENT VARIABLES

       If the sysfs_dir variable is set in the environment, it will override the default location where  aoe-stat  will  look  for  sysfs,  namely
       /sys.

WARNINGS

       If the minor device number of a device node does not match that of its namesake, aoe-stat will print a warning as shown below.

	      nai:~# aoe-stat
		    e0.3	 0.104GB   eth0 up
		    e0.4      4398.046GB   eth0 up
		   e20.0      1000.215GB   eth0 up
		   e42.0      2000.431GB   eth0 up
	      aoe-stat Warning: device node /dev/etherd/e45.1 has wrong minor device number
		   e45.1      1152.874GB   eth0 up

       Using  such  a  device  node  is dangerous, because its name doesn't match the actual device that you would be reading from and writing to.
       Such a broken device node should be removed.  Device nodes are created by udev or (on systems without udev) by aoe-mkdevs.

EXAMPLE

       In this example, the root user on a host named nai loads the aoe driver module and then prints a list of all  the  available  aoe  devices.
       Then  he  remembers to bring up the storage network interfaces, does an AoE discovery, and prints the list again.  This time the list shows
       all the devices in shelf seven.

	      nai:~# modprobe aoe
	      nai:~# aoe-stat
	      nai:~# ifconfig eth3 up
	      nai:~# aoe-discover
	      nai:~# aoe-stat
		    e0.0     10995.116GB   eth0 up
		    e0.1     10995.116GB   eth0 up
		    e0.2     10995.116GB   eth0 up
		    e1.0      1152.874GB   eth0 up
		    e7.0       370.566GB   eth0 up
	      nai:~#

SEE ALSO

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

AUTHOR

       Ed L. Cashin (ecashin@coraid.com)

																       aoe-stat(8)

Check Out this Related Man Page

aoe-mkdevs(8)						      System Manager's Manual						     aoe-mkdevs(8)

NAME

       aoe-mkdevs - create special device files for aoe driver

SYNOPSIS

       aoe-mkdevs {device-dir}
       env n_partitions=1 aoe-mkdevs {device-dir}

DESCRIPTION

       The aoe-mkdevs command is deprecated in favor of udev.  Systems with udev do not need to use the aoe-mkdevs or aoe-mkself commands, because
       udev will create device nodes as needed.

       Systems without udev use aoe-mkdevs to create the character special files necessary to control the aoe driver.  The aoe-mkdevs command uses
       aoe-mkshelf to also create block special files.

       The aoe drivers after version 49 support dynamic minor device numbers so that a greater number of devices can be supported.  The aoe-mkdevs
       command is incompatible with dynamic device numbers.  If your system lacks udev, and you are using an aoe driver version 50 or  above,  use
       the aoe_dyndevs=0 module option to force the aoe driver to use static device numbers.

       If  you	are  not  using  dynamic device numbers, and you built your aoe driver to support only one partition per device (whole-disk parti-
       tions), 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 special device files will be created.

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.  After  remembering  that  the
       driver  doesn't have partition support, this sysadmin gets rid of the mismatching device nodes and calls aoe-mkdevs again with n_partitions
       set to 1.

	      nai:~# rm -rf /dev/etherd
	      nai:~# aoe-mkdevs /dev/etherd
	      nai:~# ls /dev/etherd | wc -l
	      1603
	      nai:~# rm -rf /dev/etherd
	      nai:~# n_partitions=1 aoe-mkdevs /dev/etherd
	      nai:~# ls /dev/etherd | wc -l
	      103

SEE ALSO

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

AUTHOR

       Ed L. Cashin (ecashin@coraid.com)

																     aoe-mkdevs(8)
Man Page