Transcription

CH A P T E R4MSE Virtual Appliance on XenServerCitrix XenServer is a complete server virtualization platform, optimized for both Windows and Linuxvirtual servers with all the capabilities required to create and manage a virtual infrastructure.Citrix XenServer runs directly on server hardware without requiring an underlying operating system,which results in an efficient and scalable system. XenServer works by abstracting elements from thephysical machine and allocates them to the Virtual Machines (VMs) running on it.Citrix XenCenter is the Windows-native graphical user interface for managing Citrix XenServer. Importof MSE virtual appliance onto the XenServer is done using the XenCenter.This chapter contains the following sections: Verify Requirements, page 4-2 Downloading the Cisco MSE Virtual Appliance OVA File, page 4-2 Importing the MSE Virtual Appliance Using the XenCenter, page 4-2Workflow for Installing the Cisco MSE Virtual appliance on toXenServerThe following table describes the steps to be followed while deploying the Cisco Mobility ServicesEngine (MSE) virtual appliance.Table 4-1Workflow for MSE Virtual Appliance InstallationProcessDescription1.Verify the requirements andprepare for Cisco MSE VAinstallation.See Verify Requirements, page 4-2 for more information.2.Download the Cisco MSESee Downloading the Cisco MSE Virtual Appliance OVA File,VA OVA file from Cisco.com page 4-2 for more information.3.Importing VMs4.Configure the basic settings. See Configuring the Basic Settings to Start the MSE VirtualAppliance VM, page 4-8 for more information.5.Configure the MSE on Prime See Configuring MSE on the Prime Infrastructure, page 3-19Infrastructurefor more information.See Importing the MSE Virtual Appliance Using theXenCenter, page 4-2 for more information.Cisco MSE Virtual Appliance Installation and Configuration GuideOL-28567-014-1

Chapter 4MSE Virtual Appliance on XenServerWorkflow for Installing the Cisco MSE Virtual appliance on to XenServerVerify RequirementsTable 4-1RequirementsSystem Requirements64 bit processor Intel VT/AMD-V32 GB RAM Memory500 GB HDDEthernet Cards (NIC) of 1 gbpsSoftware RequirementsCitrix XenServer 6.1Citrix XenCenter 6.1LicensesManagement ToolsEnterprise edition or advanced edition XenServer Version 6.1.x XenCenter Version 6.1.xDownloading the Cisco MSE Virtual Appliance OVA FileTo download the MSE .ova file, follow these steps:Step 1Access the Cisco MSE Virtual Appliance image at the following tor.htmlStep 2In the Product/Technology Support section, choose Download Software.Step 3In the Select a Product section, navigate to the Wireless software by choosing Products Wireless Mobility Services Cisco Mobility Services Engine Virtual Appliance.A list of the latest release software for Cisco Mobility Services Engine Virtual Appliance is available fordownload.Step 4In the Latest list, choose 7.6.100.0.Step 5You can select any of the following ova files to download:Step 6 MSE-XEN-VA-7-6-100-0-Generic.ova—Use this file for a new MSE deployment on a Xenplatform. MSE-XEN-VA-7-6-100-0-LowEnd.ova—Use this file for a new MSE deployment on a low-endXen platform.Save the installer to your computer in a place that will be easy to find when you start the deployment.Importing the MSE Virtual Appliance Using the XenCenterYou can import and export Virtual Machines (VMs) in XenCenter using the Import and Export wizards.To import an Open Virtualization Archive (OVA) package, follow these steps:Step 1Launch XenCenter Client application on your desktop and log in using the Administrative privileges.Cisco MSE Virtual Appliance Installation and Configuration Guide4-2OL-28567-01

Chapter 4MSE Virtual Appliance on XenServerWorkflow for Installing the Cisco MSE Virtual appliance on to XenServerStep 2Add the XenServer to XenCenter if it is not added. You can skip this step if you have already connectedthe XenCenter to the XenServer host. See this URL for more ervlet/download/32306-102-691299/QuickStartGuide BasicVersion.pdfStep 3Right-click on XenServer in the XenCenter client and choose Import to import the MSE OVA file (seeFigure 4-1).The Import wizard appears.Figure 4-1Step 4Importing MSE OVA FileIn the Import Source page, click Browse to select the MSE OVA file (see Figure 4-2).Figure 4-2Import Source PageStep 5From the Open dialog box, locate the appropriate .ova file that you downloaded to your computer andclick Open.Step 6Click Next.The Location page appears.Cisco MSE Virtual Appliance Installation and Configuration GuideOL-28567-014-3

Chapter 4MSE Virtual Appliance on XenServerWorkflow for Installing the Cisco MSE Virtual appliance on to XenServerNoteIf the package you are importing includes any EULAs, accept them and click Next to continue. If thereare no EULAs included in the package, the wizard skips this step and goes to the next page. Review andaccept End User License Agreement (EULA).Step 7In the Location page, choose the pool or standalone server where you want to place the VM(s). You canalso specify a Home Server within the selected pool for each imported VM. From the Import VM(s) to drop-down list, choose the destination pool or standalone server whereyou want to place the VMs that you are importing and assign them a home server. The Add NewServer window appears.– In the Server text box, enter the host name or IP address of the server you want add.– In the User name text box, enter the user name for that server.– In the Password text box, enter the password. To assign imported VM(s) to a home server, select the server from the list in the Home Servercolumn (see Figure 4-3). For more information on assigning a home server to new VMs, see theHome Server documentation available at the Citrix Website.Figure 4-3Step 8Location PageClick Next.The Storage page appears.Step 9Configure storage for the imported VMs.On the Storage page, select one or more storage repositories (SRs) to place the virtual disks (seeFigure 4-4).Cisco MSE Virtual Appliance Installation and Configuration Guide4-4OL-28567-01

Chapter 4MSE Virtual Appliance on XenServerWorkflow for Installing the Cisco MSE Virtual appliance on to XenServerFigure 4-4Step 10Storage Page To place all the imported disk images on the same SR, click Place all imported virtual disks onthis target SR radio button and select an SR from the list. To place the disk images of incoming VMs onto different SRs, click Place imported virtual disksonto specified target SR radio button and select the target SR from the drop-down list in theStorage Repository column.Click Next.The Networking page appears.Step 11On the Networking page, map the virtual network interfaces in the VMs you are importing to targetnetworks in the destination pool or standalone server. Select the virtual network interface in the VM-Virtual Network Interface column and select thetarget network from the drop-down list in the Target Network column (see Figure 4-5).Figure 4-5Step 12Networking PageClick Next to continue.The Security page appears.Step 13On the Security page, you can set the security settings to validate the OVF/OVA package that you areimporting. Select the Verify manifest content check box to verify if the manifest matches with the appliancefiles.Step 14Click Next. The OS Fixup Settings page appears.Step 15Configure the following in the OS Fixup Settings page:Cisco MSE Virtual Appliance Installation and Configuration GuideOL-28567-014-5

Chapter 4MSE Virtual Appliance on XenServerWorkflow for Installing the Cisco MSE Virtual appliance on to XenServer If the VMs in the package you are importing were built on a hypervisor other than XenServer, thenselect the Use Operating System Fixup check box to enable the imported VM to boot correctly onthe XenServer (see Figure 4-6). The Operating System Fixup attempts to repair boot device-relatedproblems with imported VMs that might prevent the operating system within the VM from bootingin a XenServer environment.Figure 4-6 If you enable the Use Operating System Fixup check box, then you must select an ISO library wherethe fixup ISO will be copied. Click New ISO library to choose the type of new storage andconfigure (see Figure 4-7).Figure 4-7 OS Fixup Settings PageNew Storage WindowSelect the type of virtual disk storage:– NFS VHD– Software iSCSI– Hardware HBA– StorageLink technology Select ISO library type:– Windows File Sharing (CIFS)– NFS ISOClick Next. Provide a name and description for your SR in the Name and Description text box.Click Next.Cisco MSE Virtual Appliance Installation and Configuration Guide4-6OL-28567-01

Chapter 4MSE Virtual Appliance on XenServerWorkflow for Installing the Cisco MSE Virtual appliance on to XenServer Provide the name of the share where your SR is located in the Share Name text box. You canoptionally specify alternative credentials by setting the server options by providing the usernameand password. Click Finish.Step 16Click Next. The Transfer VM Settings page appears.Step 17On the Transfer VM Settings page, configure the following networking settings: Select the network on which the temporary VM used to perform the import operations from theNetwork drop-down list. Configure either of the following network settings:– Automatically obtain network settings using DHCP.– Use these network settings.Step 18Click Next to continue.Step 19On the Finish page, review all the import settings and click Finish to begin the import process and closethe wizard.Step 20Click the Logs tab in the XenCenter client to check the progress of the OVA import.Step 21The MSE OVA gets imported.The below figure shows the deployed appliance.Figure 4-8Deployed ApplianceStep 22The OVA will be in shutdown state as soon as the import is completed.Step 23Start the Virtual Machine (VM).Right-click on the imported file and select Start (see Figure 4-9).Cisco MSE Virtual Appliance Installation and Configuration GuideOL-28567-014-7

Chapter 4MSE Virtual Appliance on XenServerWorkflow for Installing the Cisco MSE Virtual appliance on to XenServerFigure 4-9Start the Virtual MachineConfiguring the Basic Settings to Start the MSE Virtual Appliance VMYou have completed deploying the MSE virtual appliance on a new virtual machine. A node for thevirtual machine now appears in the resource tree in the XenCenter Client window. After deployment,you need to configure basic settings for the MSE virtual appliance.To start the MSE setup, follow these steps:Step 1In the XenCenter Client, click the MSE virtual appliance node in the resource tree.Step 2Click the Console tab, within the console pane to make the console prompt active for keyboard input.The VM starts booting.Step 3Press Enter for the login prompt to appear to initiate the MSE Installation Wizard. The following ----------------------------Cisco Mobility Service EngineXen-7-6-x-x login: rootPassword: passwordRunning the Cisco Mobility Services Engine installer. It may takeseveral minutes to complete.Preparing to install.Extracting the JRE from the installer archive.Unpacking the JRE.Extracting the installation resources from the installer archive.Configuring the installer for this system’s environment.Launching installer.Preparing CONSOLE Mode Installation.Cisco MSE Virtual Appliance Installation and Configuration Guide4-8OL-28567-01

Chapter 4MSE Virtual Appliance on XenServerWorkflow for Installing the Cisco MSE Virtual appliance on to XenServer Introduction-----------InstallAnywhere will guide you through the installation of CiscoMobility Services Engine.It is strongly recommended that you quit all programs before continuingwith this installation.Respond to each prompt to proceed to the next step in the installation.If you want to change something on a previous step, type ‘back’.Licensing on the Mobility Services Engine is enforced with the releaseof software version 6.x and greater. Please have the ProductAuthorization key (PAK) and refer to the instructions in the User Guideto enable licensing.PRESS ENTER TO CONTINUE:Installing MSE Version: 7.6.100.0 Installation Check------------------ Cisco Mobility Services Engine Installation --------------------Cisco MSE v7.6 upgrade procedure may take several hours to complete,depending on the amount of data on the system.During the upgrade process, please ensure that the session to the MSE isnot terminated. User action is needed at the end of the installationprocess.- 1- Exit2- ContinueENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS ENTER TO ACCEPT THEDEFAULT: [ Installing.-------------Cisco MSE Virtual Appliance Installation and Configuration GuideOL-28567-014-9

Chapter 4MSE Virtual Appliance on XenServerWorkflow for Installing the Cisco MSE Virtual appliance on to XenServer[ ][------------------ ------------------ ------------------ -------------]Installing DB binary filesInstallation Completeprintk: 3 messages suppressed.The system is going down for reboot Now!INIT: Switching to runlevel: 6INIT: Sending processes the TERM signalShutting down smartd:[OK]Stopping yum-updatesd:[OK]Stopping anacron:[OK]Stopping atd:[OK]Shutting down xfs:Shutting down console mouse services[OK]Stopping sshd:[OK]Stopping crond:[OK]Stopping autofs: Stopping automount: [OK]NoteStep 4After the initial installation, you are logged off the newly created VM and you must login to the consolepanel again.The MSE virtual machine shuts down and reboots.GRUB Loading stage2.Press any key to continue.Press any key to -----------------Cisco Mobility Services Enginemse login: rootpassword: passwordLast login: Mon Apr 7 04:11:50 on tty1NoteIf the MSE does not prompt for setup, enter the following command: /opt/mse/setup/setup.sh.Enter whether you would like to set up the initial parameters manually or viathe setup wizard.Setup parameters via Setup Wizard (yes/no) [yes]: ------------Welcome to the Cisco Mobility Services Engine appliance setup.You may exit the setup at any time by typing Ctrl C -------------Cisco MSE Virtual Appliance Installation and Configuration Guide4-10OL-28567-01

Chapter 4MSE Virtual Appliance on XenServerWorkflow for Installing the Cisco MSE Virtual appliance on to XenServerWould you like to configure MSE using menu options (yes/no): yMobility Services Engine SetupPlease select a configuration option below and enter therequested information. You may exit setup at any time bytyping Ctrl C .You will be prompted to choose whether you wish to configure aparameter, skip it, or reset it to its initial default value.Skipping a parameter will leave it unchanged from its currentvalue.Please note that the following parameters (indicated by *)are mandatory and must be configured at least once.- Hostname- Network interface eth0- Timezone- Root password- NCS communication username and- NCS communication passwordChanges made will only be applied once all the modificationsare verified and ----------------------NoteIt is highly recommended that all relevant items be configured during initial setup to ensure optimumoperation of the mobility services engine in your network. The hostname and either the Ethernet-0 (eth0)or the Ethernet-1 (eth1) port must always be configured during the automatic installation.NoteYou can rerun the automatic installation script at any time to add or change parameters using thiscommand:[[email protected]]# /opt/mse/setup/setup.sh.There is no need to re-enter values that you do not want to change during one of these updates.Cisco MSE Virtual Appliance Installation and Configuration GuideOL-28567-014-11

Chapter 4MSE Virtual Appliance on XenServerWorkflow for Installing the Cisco MSE Virtual appliance on to XenServerNoteIf you do not want to configure an item, enter skip and you are prompted for the next configuration step.Any setting skipped is retained and not modified.NoteMinimal configuration is done for the mobility services engine as part of installation using the console.All configurations beyond the initial setup using the automatic installation is done with the Cisco PrimeInfrastructure.Step 5Configure the host namePlease enter your choice [1 - 23]: 2Current hostname [Xen-7-6-x-x]Configure hostname? (Y)es/(S)kip/(U)se default [Skip]: yThe host name should be a unique name that can identifythe device on the network. The hostname should start witha letter, end with a letter or number, and contain onlyletters, numbers, and dashes.Enter a host name [Xen-7-6-x-x]:Step 6Configure eth0 network settingsPlease enter your choice [1 - 23]: 5Current IP address [10.0.0.1]Current eth0 netmask [255.255.255.0]Current IPv4 gateway address [10.0.0.0]Configure eth0 interface parameters? (Y)es/(S)kip/(U)se default [Skip]:yEnter an IP address for first ethernet interface of this machine.Enter eth0 IP address[10.0.0.1]:Enter the network mask for IP address 10.0.0.1Enter network mask [255.255.255.0]:Enter an default gateway address for this machine.Note that the default gateway must be reachable fromthe first ethernet interface.Enter default gateway address [10.0.0.0]:Step 7Configure the DNS Settings:Please enter your choice [1 - 23]:7Domain Name Service (DNS) SetupDNS is currently enabled.No DNS servers currently definedConfigure DNS related parameters? (Y)es/(S)kip/(U)se default [Skip]: yCisco MSE Virtual Appliance Installation and Configuration Guide4-12OL-28567-01

Chapter 4MSE Virtual Appliance on XenServerWorkflow for Installing the Cisco MSE Virtual appliance on to XenServerEnable DNS (yes/no) [no]: yEnter primary DNS server IP address:DNS server address must be in the form #.#.#.#, where # is 0 to 255 orhexadecimal : separated v6 addressEnter primary DNS server IP address:Enter backup DNS server IP address (or none) [none]:Step 8NoteConfigure the time zone:UTC must be used when you are configuring for wIPS. For other services, you must use the same timezone as the controllers.Please enter your choice [1 - 23]:8Current timezone [America/]Configure timezone? (Y)es/(S)kip/(U)se default [Skip]: yEnter the current date and time.Please identify a location so that time zone rules can be set correctly.Please select a continent or ocean.1) Africa2) Americas3) Antarctica4) Arctic Ocean5) Asia6) Atlantic Ocean7) Australia8) Europe9) Indian Ocean10) Pacific Ocean11) UTC - I want to use Coordinated Universal Time.#? 2Please select a country.1) Anguilla27) Honduras2) Antigua & Barbuda28) Jamaica3) Argentina29) Martinique4) Aruba30) Mexico5) Bahamas31) Montserrat6) Barbados32) Netherlands Antilles7) Belize33) Nicaragua8) Bolivia34) Panama9) Brazil35) Paraguay10) Canada36) Peru11) Cayman Islands37) Puerto Rico12) Chile38) St Barthelemy13) Colombia39) St Kitts & Nevis14) Costa Rica40) St Lucia15) Cuba41) St Martin (French part)16) Dominica42) St Pierre & MiquelonCisco MSE Virtual Appliance Installation and Configuration GuideOL-28567-014-13

Chapter 4MSE Virtual Appliance on XenServerWorkflow for Installing the Cisco MSE Virtual appliance on to XenServer17) Dominican Republic43) St Vincent18) Ecuador44) Suriname19) El Salvador45) Trinidad & Tobago20) French Guiana46) Turks & Caicos Is21) Greenland47) United States22) Grenada48) Uruguay23) Guadeloupe49) Venezuela24) Guatemala50) Virgin Islands (UK)25) Guyana51) Virgin Islands (US)26) Haiti#? 47Please select one of the following time zone regions.1) Eastern Time2) Eastern Time - Michigan - most locations3) Eastern Time - Kentucky - Louisville area4) Eastern Time - Kentucky - Wayne County5) Eastern Time - Indiana - most locations6) Eastern Time - Indiana - Daviess, Dubois, Knox & Martin Counties7) Eastern Time - Indiana - Pulaski County8) Eastern Time - Indiana - Crawford County9) Eastern Time - Indiana - Pike County10) Eastern Time - Indiana - Switzerland County11) Central Time12) Central Time - Indiana - Perry County13) Central Time - Indiana - Starke County14) Central Time - Michigan - Dickinson, Gogebic, Iron & MenomineeCounties15) Central Time - North Dakota - Oliver County16) Central Time - North Dakota - Morton County (except Mandan area)17) Mountain Time18) Mountain Time - south Idaho & east Oregon19) Mountain Time - Navajo20) Mountain Standard Time - Arizona21) Pacific Time22) Alaska Time23) Alaska Time - Alaska panhandle24) Alaska Time - Alaska panhandle neck25) Alaska Time - west Alaska26) Aleutian Islands27) Hawaii#? 21The following information has been given:United StatesPacific TimeTherefore TZ 'America/Los Angeles' will be used.Local time is now:Sun Apr 6 18:45:27 PDT 2014.Universal Time is now: Mon Apr 7 01:45:27 UTC 2014.Is the above information OK?1) Yes2) NoCisco MSE Virtual Appliance Installation and Configuration Guide4-14OL-28567-01

Chapter 4MSE Virtual Appliance on XenServerWorkflow for Installing the Cisco MSE Virtual appliance on to XenServer#? 1Step 9Configure the NTP SetupPlease enter your choice [1 - 23]:12Network Time Protocol (NTP) Setup.If you choose to enable NTP, the system time will beconfigured from NTP servers that you select. Otherwise,you will be prompted to enter the current date and time.NTP is currently disabled.Configure NTP related parameters? (Y)es/(S)kip/(U)se default [Skip]: yEnter whether or not you would like to set up theNetwork Time Protocol (NTP) for this machine.If you choose to enable NTP, the system time will beconfigured from NTP servers that you select. Otherwise,you will be prompted to enter the current date and time.Enable NTP (yes/no) [no]: yEnter NTP server name or address [10.234.235.236]: 128.138.141.172NTP server address must be in the form #.#.#.3, where # is 0 to 255hexadecimal : separated v6 address.Enter another NTP server IP address (or none) [10.245.246.247]:Configure NTP Authentication ? (Y)es/(S)kip/(U)se default [Skip]: yEnter NTP Auth key Number [1]:Enter NTP Auth key Value (String) [Secret:Do you want to continue (yes/no) [no]: yStep 10Configure the Root password:NoteIf you do not set the root password, a warning message is displayed when you apply the settings.Pleaseenter your choice [1 - 23]: 18Root password has not been configuredConfigure root password? (Y)es/(S)kip/(U)se default [Skip]:Changing password for user root.You can now choose the new password.A valid password should be a mix of upper and lower case letters,digits, and other characters. You can use an 8 character long passwordwith characters from all of these classes. An upper case letter thatbegins the password and a digit that ends it do not count towards thenumber of character classes used.Enter new password:Step 11Configure the NCS communication username:Cisco MSE Virtual Appliance Installation and Configuration GuideOL-28567-014-15

Chapter 4MSE Virtual Appliance on XenServerWorkflow for Installing the Cisco MSE Virtual appliance on to XenServerNoteThe NCS communication username is required username for setting up the MSE in PI. This isnot the PI username.Please enter your choice [1 - 23]:21NCS communication username has not been configuredConfigure NCS communication username? (Y)es/(S)kip/(U)se default [Skip]:yEnter an admin username.This user is used by the NCS and other northbound systems toauthenticate their SOAP/XML session with the server.Enter a username:Step 12Configure the NCS communication password:NoteIf you do not set the password, a warning message appears when you apply the settings. Thedefault NCS communication password is admin.Please enter your choice [1 - 23]:22NCS password has not been configuredConfigure NCS communication password? (Y)es/(S)kip/(U)se default [Yes]:Enter a password for the admin user.The admin user is used by the NCS and other northbound systems toauthenticate their SOAP/XML session with the server. Once this passwordis updated, it must correspondingly be updated on the NCS page for MSEGeneral Parameters so that the NCS can communicate with the MSE.Enter NCS communication password:Step 13Verify the setup information and apply the changes:Please enter your choice [1 - 23]:23Please verify the following setup -----------------------Hostname Xen-7-6-x-xEth0 IP address , Eth0 network mask 255.255.254.0Time zone America/Los AngelesEnable NTP yes, NTP servers 10.50.171.9Time zone America/Los AngelesRoot password is changed.NCS username is changed.NCS password is changed.Cisco MSE Virtual Appliance Installation and Configuration Guide4-16OL-28567-01

Chapter 4MSE Virtual Appliance on XenServerWorkflow for Installing the Cisco MSE Virtual appliance on to --------------------You may enter "yes" to proceed with configuration, "no" to makemore changes.Configuration ChangedIs the above information correct (yes or no): yesThe figure below shows an example of the completion screen:Figure 4-10NoteStep 14Completion ScreenThe next time you log in using root, only the Linux shell prompt appears and not the setup script. Youcan rerun the setup script at any time to change settings by logging in as root and running/opt/mse/setup/setup.sh.To verify the configuration, run the getserverinfo command.[[email protected]]# getserverinfoStep 15To configure the MSE to automatically launch after boot up, enter the following command:[[email protected]]# chkconfig msed onStep 16Reboot using the following command:[[email protected]]# rebootNoteTo start the MSE service manually, enter the following command:[[email protected]]# service msed startThe setup script generates a log file that can be found at /opt/mse/setup/setup.log.Configuring MSE on the Prime InfrastructureSee Configuring MSE on the Prime Infrastructure, page 3-19 for more information.Cisco MSE Virtual Appliance Installation and Configuration GuideOL-28567-014-17

Chapter 4MSE Virtual Appliance on XenServerWorkflow for Installing the Cisco MSE Virtual appliance on to XenServerSynchronize the Network Design and Tracking ParametersSee Synchronizing the Network Designs, page 3-23 for more information.Cisco MSE Virtual Appliance Installation and Configuration Guide4-18OL-28567-01

XenServer works by abstracting elements from the physical machine and allocates them to the Virtual Machines (VMs) running on it. Citrix XenCenter is the Windows-native graphical us er interface for managing Citrix XenServer. Import of MSE virtual appliance onto the XenServer is done usi