Description :
------------

AoE (ATA Over Ethernet) driver 6-83 and tools for Citrix XenServer 6.2
Build and tested on Citrix XenServer


Informations :
-------------

This is a clean way to install AoE module and tools on your
Xen source host. We hope Citrix/XenSource team will integrate
it in next release (including Xen Center modification for AoE).


Install :
--------

# ssh root@"your Xen host name or IP"
# cd /tmp

# wget ftp://ftp.alyseo.com/contrib/XenServer/v6.1/AoE/aoe-6-83.i386.rpm*
OR
# wget http://download.alyseo.com/contrib/XenServer/v6.1/AoE/aoe-6-83.i386.rpm
# wget http://download.alyseo.com/contrib/XenServer/v6.1/AoE/aoe-6-83.i386.rpm.md5

# md5sum aoe-6-83.i386.rpm
# cat aoe-6-83.i386.rpm.md5

check if rpm is not corrupted (diff md5 outputs)

# rpm -ivh aoe-6-83.i386.rpm

Verify :
# rpm -qa | grep aoe
# rpm -qi aoe-6-83

We strongly recommand to use a dedicated NIC for your SAN, use eth? 
device and not a xen bridge device to be able to use jumbo frames (MTU=9000
in your /etc/sysconfig/network-scripts/ifcfg-eth? file).

Ex using eth1 for AoE :
# xe pif-list
# xe pif-forget uuid=????.eth1_uuid
# cd /etc/sysconfig/network-scripts
# cat > ifcfg-eth1
XEMANAGED=no
DEVICE=eth1
MTU=9000
ONBOOT=yes
TYPE=Ethernet
HWADDR=??:??:??:??:??:??
check_link_down() { return 1 ; }
CTRL-D

# ifup eth1

# vi /etc/init.d/aoe
And modify line below to specify your dedicated SAN NIC :
AOE_IFACE_LIST='eth1'

# service aoe start

Verify :
# aoe-version
              aoetools: 35
  installed aoe driver: 83
    running aoe driver: 83

IMPORTANT: Ensure aoe-stat report you LUN(s) before creating the XS share storage.

Create a share storage using xe commands :
# xe sr-create content-type="LVM" name-label="LVM over AoE" type=lvm shared=true host-uuid=???? device-config-device=/dev/etherd/e?.?

At this stage and if you follow details above you LUN should be visible on XenCenter.

Thanks to AoE, you can use multipathing without any addition configuration (no bonding to setup) : 
just do the same changes as above for your second dedicated AoE NICs and update /etc/init.d/aoe.

Use the new aoe-sancheck command (man pages available), to verify storage network capabilities : very useful.


Rem :
----

Manual pages for each aoe commands have been included (ex: man aoe-stat).

This version include the new tool "coraid-update" to upgrade Coraid firmware, please 
use this tool and read man pages for further information (also include Coraid sos 
command output: coraid-diags). 

See these URLs for further details on Coraid support :
http://www.coraid.com/support


Misc :
-----

For support, question... please email to :
support [AT] alyseo.com

Contrib made by Alyseo :
http://www.alyseo.com/

If you like this contribution, please purchase your XenServer
licenses and Coraid goods from us ;-)

sales [AT] alyseo.com