Transcription

HP AllianceONE AdvancedServices zl ModuleCitrix XenServer Installation andGetting Started Guidewww.hp.com/networkingwww.citrix.comVersion 1.009/28/2010

Copyright 2010 Hewlett-Packard Development Company, L.P. Copyright 2010 Citrix Systems, Inc.Software Credits and NoticesSSL on HP networking switches is based on the OpenSSL software toolkit. This productincludes software developed by the OpenSSL Project for use in the OpenSSL Toolkit.For more information on OpenSSL, visit www.openssl.org.Open Source Software AcknowledgementThis software incorporates open source components that are governed by the GNUGeneral Public License (GPL). In accordance with this license, HP will make available acomplete, machine readable copy of the source code components covered by the GNUGPL upon receipt of a written request. Send a request to:Citrix Systems, Inc.4988 Great American ParkwaySanta ClaraCA, 95054Hewlett-Packard Company, L.P.HP AllianceONE Advanced Services zlModuleGNU GPL Source CodeAttn: HP Networking SupportMS: 5551Roseville, CA 95747 USADisclaimerHEWLETT-PACKARD COMPANY MAKES NO WARRANTY OF ANY KIND WITHREGARD TO THIS MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULARPURPOSE. Hewlett-Packard shall not be liable for errors contained herein or forincidental or consequential damages in connection with the furnishing, performance, oruse of this material.The information contained herein is subject to change without notice. The onlywarranties for HP products and services are set forth in the express warrantystatements accompanying such products and services. Nothing herein should beconstrued as constituting an additional warranty. HP shall not be liable for technical oreditorial errors or omissions contained herein.Hewlett-Packard assumes no responsibility for the use or reliability of its software onequipment that is not furnished by Hewlett-Packard.2

Table of ContentsOverview. 4Step-by-step instructions . 41. Install the Services zl Module hardware . 42. Download the software image onto the Services zl Module . 53. Install the software image on the Services zl Module . 64. Access the Citrix XenServer CLI . 75. Configure the Services zl Module ports into a specific VLAN. 76. Configure Citrix XenServer using the CLI . 97. Rebooting the Services zl Module. 168. Technical Support . 163

OverviewThe HP AllianceONE Advanced Services zl Module is shipped from the factory ready forthe Citrix XenServer software image to be downloaded and installed. It does not haveany specific application software or an application-related operating system alreadyinstalled. Instead, a resident Service OS provides the ability to download, install andactivate a complete operating system image that includes the Citrix XenServerapplication.After the Citrix XenServer image is downloaded, installed and activated on the Serviceszl Module, it becomes joined to that one particular module. Since a Services zl Moduleis not shipped with any specific network function or service until a “Product OS” image isadded, it provides a unique ability to become a dedicated “appliance within a switch”after the Citrix XenServer image is installed and activated.This document describes the steps needed to install Citrix XenServer on a Services zlModule. Because a Services zl Module is not a server device, it is necessary to followthe steps described in this document to successfully complete the installation.Step-by-step instructions1. Install the Services zl Module hardwareBefore installing a Services zl Module into the switch chassis, access the switch CLI toverify the switch has the most current module-compatible software installed. The switchsoftware version should be K.14.60 or later. Use the following command to check theswitch software version:hostswitch# show version CR Image stamp:. date, time K.14.XX.Boot Image:PrimaryIf the switch software needs to be updated, follow the directions in the HP AllianceONEAdvanced Services zl Module Installation and Getting Started Guide to update thesoftware.Next, install the Services zl Module following directions and safety precautions in the HPAllianceONE Advanced Services zl Module Installation and Getting Started Guide.Verify the module is installed successfully. When a module is installed, it undergoes aself test that takes a few seconds. The LEDs on the front panel of the module help4

determine if the module has passed the self test. For more information, see the HPAllianceONE Advanced Services zl Module Installation and Getting Started Guide.2. Download the software image onto the Services zl ModuleContact Citrix Systemsfor software licensing options and instructions on how to acquireaccess to the Citrix XenServer product software image.Once the Citrix XenServer product software image is received, it can be downloadedonto a Services zl Module using either a USB flash drive or using FTP file transferthrough the local network.Download Using USB Flash DriveCopy the image onto a USB flash drive. Make sure the drive is FAT/FAT32 formattedand can hold all files that will be downloaded. If the software image is provided in theform of a zip file, first unzip the image directory and copy all files to the followinglocation on the USB drive:/images/AppSW J9647A XXXXXX XXXX/Type "services" to list the services installed on the Services zl Module:hostswitch# services CR SlotBInstalled ServicesIndex Description1. Services ModuleNameservices-moduleThe Services zl Module service is in Slot B at index 1 and has the name servicesmodule. Type either of the following commands to access the Services zl Module CLI:hostswitch# service b 1 CR hostswitch(svcs-mod-B:SvcOS)#orhostswitch# service b name services-module CR hostswitch(svcs-mod-B:SvcOS)#Insert the USB flash drive with the Citrix XenServer image into the USB slot on the frontof the Services zl Module.IMPORTANT: The USB flash drive must be inserted into the USB slot on the front of theServices zl Module, NOT into the USB slot on the switch chassis.5

Type the following commands to copy the image to the image repository on theServices zl Module:hostswitch(svcs-mod-B:SvcOS)# usb mount CR hostswitch(svcs-mod-B:SvcOS)# usb copyfrom AppSW J9647A XXXXXX XXXX CR hostswitch(svcs-mod-B:SvcOS)# usb unmount CR Download Using FTP File TransferIf the software image is provided in the form of a zip file, first unzip the image directoryand copy it (as a sub-directory) to the root directory of an FTP server:/FTP-root/AppSW J9647A XXXXXX XXXX/Type "services" to list the services installed on the Services zl Module:hostswitch services CR SlotBInstalled ServicesIndex Description1. Services ModuleNameservices-moduleThe Services zl Module service is in Slot B at index 1 and has the name servicesmodule. Type either of the following commands to access the Services zl Module CLI:hostswitch# service b 1 CR hostswitch(svcs-mod-B:SvcOS)#orhostswitch# service b name services-module CR hostswitch(svcs-mod-B:SvcOS)#Next, type the following command to initiate FTP file transfer:hostswitch(svcs-mod-B:SvcOS)# download ftp IP-ADDRESS APPSW J9647A XXXXXX XXXX user USERNAME CR IP-ADDRESS is the IP address of the FTP server to which the product imagedirectory was copied, and USERNAME is the optional login ID for the FTP server(enter this login ID only if it’s required for FTP server login).3. Install the software image on the Services zl Module6

After the Citrix XenServer software image is downloaded into the Services zl Moduleimage repository (using either USB file copy or FTP transfer), type the followingcommands to install the image:hostswitch# services b 1 CR hostswitch(svcs-mod-B:SvcOS)# uninstall product CR hostswitch(svcs-mod-B:SvcOS)# install product AppSW J9647A XXXXXX XXXX CR At this point the software image is installed and ready to be activated.4. Access the Citrix XenServer CLIType "services" in the switch CLI to list the services installed on the Services zl Module:hostswitch# services CR Installed ServicesSlotIndex DescriptionB1. Services ModuleB2. Alliance PartnerNameservices-moduleCitrix XenServerThe Citrix XenServer service is now activated in Slot B at index 2 and has the nameCitrix XenServer. Type either of the following commands to access the Citrix XenServerCLI:hostswitch# services b 2 CR hostswitch(AppSW-B)#Orhostswitch# services b name AppSW CR hostswitch(AppSW-B)#5. Configure the Services zl Module ports into a specific VLANThe Services zl Module provides two internal Ethernet port connections into the switchafter installation. By default, both ports are placed in the default VLAN. For example, ifthe Services zl Module is installed into slot B of the switch chassis, the internal portsappear as B1 and B2, and are automatically placed in the default VLAN. Depending onthe VLAN configuration in the switch, one or both of these ports may need to bereassigned into a different VLAN. This is done by using the switch's managementinterface, just like any other port on the switch. The VLAN that the internal ports areplaced in is important when configuring network parameters (e.g. IP address) for the7

services on the zl Module. These network parameters need to match the networkconfiguration of the VLAN they are members of.The VLAN configuration in the switch can be seen using:hostswitch# show vlans CR Status and Counters – VLAN InformationMaximum VLANs to support : 256Primary VLAN : DEFAULT VLANManagement VLAN :VLAN ID------1123Name-------------------DEFAULT VLANVLAN 123 mbo----NoNoFor this example, the ports assigned to the default VLAN can be seen using:hostswitch# show vlan 1 CR Status and Counters – VLAN Information – VLAN 1VLAN ID : 1Name : DEFAULT VLANStatus: Port-basedVoice : NoJumbo : NoPort ntaggedUnknown VLAN-----------LearnLearnStatus-----UpUpIn this example, if all other switch ports are assigned to VLAN 123, the two Services zlModule ports will also need to be assigned to VLAN 123 in order to be accessible.These ports can be assigned as tagged using:hostswitch# configure CR hostswitch(config)# vlan 123 CR hostswitch(vlan-123)# tagged B1,B2 CR or else as untagged using:hostswitch# configure CR hostswitch(config)# vlan 123 CR hostswitch(vlan-123)# untagged B1,B2 CR 8

See the Management and Configuration Guide for the HP Series 3500yl, 6200yl,5400zl, and 8200zl Switches for more information on VLAN configuration.6. Configure Citrix XenServer using the CLIWe recommend only basic network configuration be done via the CLI. Rest of theconfiguration and management of XenServer should be done through XenCenter.XenCenter can be downloaded from http://www.citrix.comThere are two ways to configure the network parameters via the CLI.CLI First way is to useXenConsole and the second one is to use XenServer CLI commands. Each one of themis described below.How to Install and Configure XenServer on HPHP-ProCurveProCurve using XenServerConsoleEnter configuration menu :Command : « services b 2 »Note: b – means module bNavigate into “Network and Management Interface”9

Navigate into “Configure Management Interface”10

Enter Password and press “Enter”“Select NIC for Management Interface11

Select “Static” IP address configurationEnter static IP address configuration and press “Enter”12

Wait for network reconfigurationMake a selection about XenCenter name13

You should get the following message:“Network Configuration Successful”14

Done - You can connect to XenServer from XenCenter and install VPX with regularprocedureHow to Install and Configure XenServer on HPHP-ProCurveProCurve using XenServer CLIWe would recommend using xsconsole unless it is very unusable. If it is unstable youcould use XenServer CLI to do initial network configuration.1. Get to a XenServer shell - this is done by accessing xsconsole (see the previoussection) and selecting the "Local Command Shell" option (final option on themenu). When at the XenServer shell prompt find the UUID of the managementinterface ("eth0", the first of the two 10Gb interfaces to the switch) using the "xepif-list"list" CLI command. Following is example output. xe pif-listlist management trueuuid ( RO): 283726device ( RO): eth0currently-attachedattached ( RO): trueVLAN ( RO): -1network-uuiduuid ( RO): 9bdf1215

2. Configure this interface with the required settings as described on page 169 ofthe Citrix XenServer 5.6 Administrator's Guide. For example to set a static IPaddress of 10.20.30.40 netmask 255.255.255.0 and gateway 10.20.30.1 withDNS servers at 10.20.30.10 and 10.20.40.10, use the following command xe pif-reconfigure-ip uuid 3ffa5a9e-d1af-925a-4f50-7fc7ca283726 mode staticIP 10.20.30.40 netmask 255.255.255.0 gateway 10.20.30.1DNS 10.20.30.10,10.20.40.10When the above command completes the new network configuration will be in use bythe XenServer system.An alternative is to use the default network configuration of 192.168.100.1, netmask255.255.255.0 and configure a host on the same network segment to be on the samesubnet and either use XenCenter or run the xe CLI commands above remotely, or byssh to the XenServer.7. Rebooting the Services zl ModuleRebooting should not normally be required and can potentially result in data loss. If forsome reason the Services zl Module becomes unresponsive, the following commandscan be used to reboot:hostswitch# service b 1hostswitch(services-module-B:PR)# boot CR System will be rebooted, do you want to continue [y/n]? yorhostswitch# service b name services-modulehostswitch(services-module-B:PR)# boot CR System will be rebooted, do you want to continue [y/n]? y8. Technical SupportThe Services zl Module is a hardware platform that allows application vendors to makeminor changes in their existing application software to run in a switch chassis. With a16

wide variety of applications available from several vendors, HP is committed toproviding an "initial point of contact" for technical support. During this process, HP willverify the installation, configuration, activation licensing, and warranty claims on theServices zl Module. For problems concerning the application software, such asconfiguration or licensing of the application from the vendor, HP may have to redirecttechnical support to the application vendor to provide the best resources for solving asupport issue. Consequently, if you are confident that the technical support issueresides within the application, it may be expeditious to contact the application vendordirectly.For access to HP networking support, go to:http://www.hp.com/networking/supportFor access to Citrix support, go .asp?slID 25635&tlID 1687494&flID 168760617

the Citrix XenServer software image to be downloaded and installed. It does not have any specific application software or an application-related operating system already installed. Instead, a resident Service OS provides the ability to download, install and activate a complete operating system image that in