Product Documentation

Installing CloudBridge Virtual Appliances on XenServer

May 24, 2013
To install Citrix CloudBridge virtual appliances on Citrix XenServer, you must first install XenServer on a machine with adequate system resources. To perform the CloudBridge VPX installation, you use Citrix XenCenter, which must be installed on a remote machine that can connect to the XenServer host through the network.
Before you begin installing a virtual appliance, do the following:
  • Install a supported version of XenServer® on hardware that meets the minimum requirements. See the CloudBridge release notes for the supported versions of XenServer.
  • Install XenCenter® on a management workstation that meets the minimum system requirements.
  • Obtain VPX license files.
With the prerequisites met, you are ready to import the virtual appliances and configure them.

To import a CloudBridge virtual appliance to XenServer by using XenCenter

  1. Start XenCenter on your workstation.
  2. On the Server menu, click Add.
  3. In the Add New Server dialog box, in the Hostname text box, type the IP address or DNS name of the XenServer server that you want to connect to.
  4. In the User Name and Password text boxes, type the administrator credentials, and then click Connect. The XenServer name appears in the navigation pane with a green circle, which indicates that the XenServer is connected.
  5. In the navigation pane, click the name of the XenServer server on which you want to install CloudBridge VPX.
  6. On the VM menu, click Import.
  7. In the Import dialog box, in Import file, browse to the location at which you saved the CloudBridge VPX .xva image file. Make sure that the Exported VM option is selected, and then click Next.
  8. Select the XenServer server on which you want to install the virtual appliance, and then click Next.
  9. Select the local storage repository in which to store the virtual appliance, and then click Import to begin the import process.
  10. Add, modify, or delete virtual network interfaces as required. Attach virtual network interfaces, interface 0 and interface 1 to the two different virtual adapters (called Networks on this screen). These two interfaces are used as the accelerated bridge of the virtual appliance. If virtual network interface interface 2 exists, it can be assigned as well, and used as a management interface (equivalent to the Primary port).

    Important: Do not attach both virtual adapters to the same network . Doing so creates forwarding loops, which can cause network outages. Also, do not attach the two physical Ethernet ports associated with CloudBridge VPX to the same Ethernet switch.

    When finished, click Next.

  11. Clear the Start the VM after Import check box

  12. Click Finish to complete the import process. To view the status of the import process, click the Log tab. The newly created virtual machine appears under the server list in the XenCenter interface.

To configure the virtual CloudBridge appliance

  1. In XenCenter, select the icon for the CloudBridge VPX virtual machine. Then, on the Storage tab, select Properties and, in the Properties dialog box , adjust the disk allocation to the desired level.
    • Changing the disk allocation on the CloudBridge VPX virtual machine resizes and reinitializes the compression history. Any accumulated history is lost.
    • Do not attempt to change resource allocation while CloudBridge VPX is running.
    • Do not use the Force Shutdown or Force Reboot commands. They might not work and can cause problems. Use the Shutdown and Reboot commands instead.
    Figure 1. Setting the disk allocation
  2. Right-click the Branch Repeater VPX icon and select the Properties option. Under CPU and Memory, select the number of VCPUs and the amount of VM memory corresponding to a supported configuration. See Supported Configurations for more details.
    Figure 2. Setting the virtual CPU and memory allocations

  3. In the Branch Repeater VPX Properties dialog box, click Startup Options, and then select the Auto-start on server boot check box. (The OS Boot Parameters are not used).
    Figure 3. Setting the start-on-server-boot option

  4. Set the basic network parameters. Depending on which release you are running, do one of the following:
    1. For Release 6.0, after the virtual machine starts, go to the virtual machine console, log into the command-line interpreter, and set the IP parameters for the accelerated bridge, using the following example as a guide:
       Login: admin 
       Password: password 
      admin> set adapter apa -ip -netmask 
       admin> restart
      Figure 4. Setting the IP parameters for the accelerated bridge

    2. For Release 6.1 or later, when a Repeater VPX virtual machine is started for the first time, it automatically runs the Deployment Wizard. Follow the wizard to set the IP parameters.
  5. After the CloudBridge VPX has restarted, log on to the browser-based UI (Default credentials: admin and password ) at the IP address that you assigned to apA
  6. From the Command menu, select Quick Installation.
  7. On the Quick Installation page, perform a quick installation as you would for a physical CloudBridge appliance.
  8. Enable bridging by clicking the Enable Bridging link.
  9. Check the network assignments in XenCenter to make sure that the two accelerated bridge ports are connected to different networks, and then click OK.
    Important: Connecting the two accelerated bridge ports to the same virtual or physical Ethernet segment creates network loops, which can bring down your entire network. In such a case, shut down the CloudBridge VPX virtual machine and fix the network assignments before proceeding.
  10. Complete the configuration.