Installation Guide Citrix License Server VPX Installation Guide Citrix License Server VPX v1.01 This document provides step-by-step instructions for installing and running the Citrix License Server Appliance for Citrix XenServer. June 2010 www.citrix.com
Introduction The Citrix License Server VPX is a self-contained Linux based virtual appliance that allows you to quickly and easily deploy licensing for Citrix XenServer in your environment. The appliance can be brought online in your environment in just a few easy steps: Import the appliance to your XenServer host or pool of hosts Configure basic networking, specifying IP address, hostname, and other network information Use the License Administration Console to upload licenses for your XenServer hosts. Please Note: This release of the License Server VPX, while capable of hosting any Citrix license file, is fully supported for licensing XenSever hosts only. We do not recommend using this appliance for production deployments of products other than Citrix XenServer. A future release of the License Server VPX will support all Citrix Products. If you have comments, feedback, or feature requests please email LicenseVPX@citrix.com. To learn more about XenServer, please visit http://www.citrix.com/xenserver/. 2
Installing the Appliance System Overview The License Server VPX is a single Virtual Machine which contains pre-installed components designed to run on Citrix XenServer. The License Server VPX requires 128MB of RAM and 8 GB of disk space to run. NOTE: For environments serving more than 150 Citrix servers and/or 2000+ users, we recommend increasing the RAM dedicated to the License Server VPX to 256mb. Prerequisites This virtual appliance is designed to run only on Citrix XenServer 5.6. You must have a running XenServer 5.6 environment configured, with a separate XenCenter management console to proceed with the Appliance import. The Appliance requires approximately 8 GB of disk space on the default Storage Repository inside your XenServer pool. Obtaining the Appliance The License Server VPX is packaged in.zip format. Once you have downloaded the appliance from the Citrix website, place the file into a single folder on your hard drive extract with your Windows or Linux unzip tool. After extraction, you will see the.xva importable appliance file. 3
Running the Appliance on Citrix XenServer The Appliance is distributed as a virtual machine system configured in.xva format. In XenServer, you can import XVA files directly from the XenCenter console. To import the Appliance into XenServer: Open XenCenter. Click on the server you would like to import the Appliance to, and select Import Browse to the location of your extracted package and choose the License_Server_VPX.XVA package. 4
Choose a Home Server for your VM this is the server that the VM will start automatically on. Alternately, you can click on a XenServer pool, in which case the VM will automatically start on the most suitable host in that pool. Choose a storage repository for the VM virtual disk to be stored on. This repository must have a minimum of 8GB of free space. 5
Define network interfaces for your VM. In this release, the License Server VPX is designed to communicate on a single virtual NIC. Choose a network that is accessible to the Citrix Servers you would like to provide license services to. Click Finish to import the Appliance. The import process will take approximately 2-3 minutes, depending on your hardware configuration. Once the VM has been imported, it will appear inside your XenCenter management Console. You can boot the virtual machine in XenServer by right clicking on the VM name and choosing Start. 6
Using the License Server VPX You now have a fully functional Citrix License Server running on your XenServer pool. At first boot, you will be presented with a quick setup wizard to configure networking of the Appliance. 7
Configuring the Appliance for First Use First, choose a root password for the appliance. This should be a strong password that only administrators will know. Next, supply a hostname and domain for the appliance. Important: Choose a hostname carefully: most Citrix license files are tied to the case-sensitive hostname of your license server. 8
If you choose DHCP for your network type, network information will automatically be obtained. Otherwise, enter your IP address, etc. Enter an admin password for the licensing service. This is the password you will use to log in to the License Administration Console. 9
Configuration is complete. Note that licenses themselves are configured from a web-based interface, available on port 8082 as shown in the URL. If you made an error in configuration, you can log into the appliance as root with the password you specified, and type the command reset_licensing.sh to re-run the setup wizard. If you are familiar with Citrix Licensing, you now have a fully functioning License Administration Console available to you at the URL specified above. Full documentation for the Citrix License Server is available at: http://support.citrix.com/proddocs/topic/licensing-1161/lic-licensing-1161.html. If you are unfamiliar with the License Management Console, follow the next steps to import your first license. 10
Using the License Administration Console for the First Time Using a web browser, navigate to the URL given to you on the final page of the License Appliance setup. (e.g. http://licensevpx:8082 ) Click on the Administration link, and log on with username admin and the password you specified during setup. 11
Click on the Vendor Daemon Configuration tab, and then Import License to add a license to this server. Browse to the location of the.lic file you downloaded from MyCitrix, and click Import License to upload to the server. 12
As noted on the previous screen, to ensure that licenses are available for checkout immediately, click the Administer link on the Vendor Daemon Configuration page, and then select Reread license files. 13
That s it! Your license has now been applied and your License Server VPX is available to answer license requests from any Citrix products in your environment. Note for advanced users: the License Server Appliance uses iptables to provide firewall protection. Changing the license server port will require a corresponding change to iptables configuration. 14
Citrix Worldwide Worldwide headquarters Citrix Systems, Inc. 851 West Cypress Creek Road Fort Lauderdale, FL 33309 USA T +1 800 393 1888 T +1 954 267 3000 Regional headquarters Americas Citrix Silicon Valley 4988 Great America Parkway Santa Clara, CA 95054 USA T +1 408 790 8000 Europe Citrix Systems International GmbH Rheinweg 9 8200 Schaffhausen Switzerland T +41 52 635 7700 Asia Pacific Citrix Systems Hong Kong Ltd. Suite 3201, 32nd Floor One International Finance Centre 1 Harbour View Street Central Hong Kong T +852 2100 5000 Citrix Online division 5385 Hollister Avenue Santa Barbara, CA 93111 USA T +1 805 690 6400 www.citrix.com About Citrix Citrix Systems, Inc. (Nasdaq:CTXS) is the global leader and the most trusted name in application delivery infrastructure. More than 200,000 organizations worldwide rely on Citrix to deliver any application to users anywhere with the best performance, highest security and lowest cost. Citrix customers include 100% of the Fortune 100 companies and 98% of the Fortune Global 500, as well as hundreds of thousands of small businesses and prosumers. Citrix has approximately 6,200 channel and alliance partners in more than 100 countries. Annual revenue in 2006 was $1.1 billion. 2010 Citrix Systems, Inc. All rights reserved. Citrix, Citrix XenApp, Citrix XenServer are trademarks of Citrix Systems, Inc. and/or one or more of its subsidiaries, and may be registered in the United States Patent and Trademark Office and in other countries. Microsoft and Windows are registered trademarks of Microsoft Corporation in the United States and/or other countries. UNIX is a registered trademark of The Open Group in the United States and other countries. All other trademarks and registered trademarks are property of their respective owners.