aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/aoe/aoe.txt
blob: ce84de72bf5f4ed35329734b321e174fc1cb6b0e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
The EtherDrive (R) HOWTO for users of 2.6 kernels is found at ...

  http://www.coraid.com/support/linux/EtherDrive-2.6-HOWTO.html

  It has many tips and hints!

CREATING DEVICE NODES

  Users of udev should find device nodes created automatically.  Two
  scripts are provided in Documentation/aoe as examples of static
  device node creation for using the aoe driver.

    rm -rf /dev/etherd
    sh Documentation/aoe/mkdevs.sh /dev/etherd

  ... or to make just one shelf's worth of block device nodes ...

    sh Documentation/aoe/mkshelf.sh /dev/etherd 0

  There is also an autoload script that shows how to edit
  /etc/modprobe.conf to ensure that the aoe module is loaded when
  necessary.

USING DEVICE NODES

  "cat /dev/etherd/err" blocks, waiting for error diagnostic output,
  like any retransmitted packets.

  "echo eth2 eth4 > /dev/etherd/interfaces" tells the aoe driver to
  limit ATA over Ethernet traffic to eth2 and eth4.  AoE traffic from
  untrusted networks should be ignored as a matter of security.

  "echo > /dev/etherd/discover" tells the driver to find out what AoE
  devices are available.

  The block devices are named like this:

	e{shelf}.{slot}
	e{shelf}.{slot}p{part}

  ... so that "e0.2" is the third blade from the left (slot 2) in the
  first shelf (shelf address zero).  That's the whole disk.  The first
  partition on that disk would be "e0.2p1".

USING SYSFS

  Each aoe block device in /sys/block has the extra attributes of
  state, mac, and netif.  The state attribute is "up" when the device
  is ready for I/O and "down" if detected but unusable.  The
  "down,closewait" state shows that the device is still open and
  cannot come up again until it has been closed.

  The mac attribute is the ethernet address of the remote AoE device.
  The netif attribute is the network interface on the localhost
  through which we are communicating with the remote AoE device.

  There is a script in this directory that formats this information
  in a convenient way.

  root@makki linux# sh Documentation/aoe/status.sh 
    device                 mac       netif           state
      e6.0        0010040010c6        eth0              up
      e6.1        001004001067        eth0              up
      e6.2        001004001068        eth0              up
      e6.3        001004001065        eth0              up
      e6.4        001004001066        eth0              up
      e6.5        0010040010c7        eth0              up
      e6.6        0010040010c8        eth0              up
      e6.7        0010040010c9        eth0              up
      e6.8        0010040010ca        eth0              up
      e6.9        0010040010cb        eth0              up
      e9.0        001004000020        eth1              up
      e9.5        001004000025        eth1              up
      e9.9        001004000029        eth1              up