vblade(8) [debian man page]

vblade(8)						      System Manager's Manual							 vblade(8)

NAME

       vblade, vbladed - export data via ATA over Ethernet

SYNOPSIS

       vblade [ -m mac[,mac...] ] shelf slot netif filename

DESCRIPTION

       The vblade command starts a process that uses raw sockets to perform ATA over Ethernet, acting like a virtual EtherDrive (R) blade.

       The vbladed script can be used to daemonize the vblade process, detaching it from your terminal and sending its output to the system logs.

   Arguments
       shelf  This should be the shelf address (major AoE address) of the AoE device to create.

       slot   This should be the slot address (minor AoE address) of the AoE device to create.

       netif  The name of the ethernet network interface to use for AoE communications.

       filename
	      The name of the regular file or block device to export.

   Options
       -b     The  -b  flag  takes  an argument, the advertised buffer count, specifying the maximum number of outstanding messages the server can
	      queue for processing.

       -d     The -d flag selects O_DIRECT mode for accessing the underlying block device.

       -s     The -s flag selects O_SYNC mode for accessing the underlying block device, so all writes are committed to disk before  returning	to
	      the client.

       -r     The -r flag restricts the export of the device to be read-only.

       -m     The  -m flag takes an argument, a comma separated list of MAC addresses permitted access to the vblade.  A MAC address can be speci-
	      fied in upper or lower case, with or without colons.

EXAMPLE

       In this example, the root user on a host named nai exports a file named "3TB" to the LAN on eth0  using	AoE  shelf  address  11  and  slot
       address 1.  The process runs in the foreground.	Using vbladed would have resulted in the process running as a daemon in the background.

	      nai:~# vblade 11 1 eth0 /data/3TB

BUGS

       Users of Jumbo frames should read the README file distributed with vblade to learn about a workaround for kernel buffering limitations.

AUTHOR

       Brantley Coile (brantley@coraid.com)

																	 vblade(8)

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

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)