README 2.1 KB

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