| 1 |
The aoetools are programs that assist in using ATA over Ethernet on |
| 2 |
systems with version 2.6 and newer Linux kernels. |
| 3 |
|
| 4 |
Systems running 2.4 Linux kernels do not need and should not install |
| 5 |
the aoetools. The aoe driver for 2.4 kernels is self sufficient. |
| 6 |
|
| 7 |
Please see the aoetools manpage for a brief list of the tools. |
| 8 |
|
| 9 |
-------------------------------------------------------------------- |
| 10 |
AOE DRIVER COMPATIBILITY |
| 11 |
|
| 12 |
If you are using udev on your system, the aoe-mkdevs and aoe-mkshelf |
| 13 |
should not be used. Just let udev create device nodes for you. If |
| 14 |
you need to configure udev, its manpages, in conjunction with the |
| 15 |
example in the EtherDrive HOWTO FAQ, should help. |
| 16 |
|
| 17 |
If you are not using udev, it is important to ensure that the device |
| 18 |
nodes in /dev/etherd match the aoe driver. Please see devnodes.txt |
| 19 |
for information. |
| 20 |
|
| 21 |
-------------------------------------------------------------------- |
| 22 |
BUILDING THE AOETOOLS |
| 23 |
|
| 24 |
If you need to configure the software, look at the variables at the |
| 25 |
top of the Makefile. The defaults should work for most people. When |
| 26 |
using the defaults there's only one step to configure and install the |
| 27 |
aoetools software and documentation: |
| 28 |
|
| 29 |
make install |
| 30 |
|
| 31 |
You'll need sufficient permissions to install in the default locations |
| 32 |
if you haven't overridden them with your own locations. |
| 33 |
|
| 34 |
The aoe-sancheck tool depends on libpthread. If its header and |
| 35 |
library files are not present, the aoetools makefile skips |
| 36 |
aoe-sancheck. You can install your Linux distribution's "libpthread" |
| 37 |
and "libpthread-devel" packages (They might be called something |
| 38 |
slightly different) to help aoe-sancheck to build successfully. |
| 39 |
|
| 40 |
-------------------------------------------------------------------- |
| 41 |
LEGACY TOOLS |
| 42 |
|
| 43 |
These two are legacy commands for systems without udev. |
| 44 |
|
| 45 |
aoe-mkdevs create character and block device files |
| 46 |
aoe-mkshelf create block device files for one shelf address |
| 47 |
|
| 48 |
-------------------------------------------------------------------- |
| 49 |
RESOURCES |
| 50 |
|
| •51 |
The aoetools on github |
| 52 |
https://github.com/OpenAoE/aoetools |
| 53 |
|
| 54 |
The aoetools homepage |
| 55 |
http://aoetools.sourceforge.net/ |
| 56 |
|
| •57 |
OpenAoE |
| 58 |
http://www.openaoe.org/ |