Applies To:

Show Versions Show Versions

Manual Chapter: Deploying iWorkflow Virtual Edition
Manual Chapter
Table of Contents   |   << Previous Chapter   |   Next Chapter >>

About VE Xen Project deployment

To deploy the iWorkflow® Virtual Edition (VE) system on Xen Project, you perform these tasks:

  • Verify the host machine requirements.
  • Deploy an iWorkflow® system as a virtual machine.
  • Deploy a BIG-IP® system.
  • After you have deployed the virtual machines, log in to the iWorkflow VE system and run the Setup utility. Using the Setup utility, you perform basic network configuration tasks, such as assigning VLANs to interfaces.
  • Configure secure communication between the iWorkflow system and the BIG-IP device.

Host machine requirements and recommendations

To successfully deploy and run the iWorkflow® VE system, the host system must satisfy minimum requirements.

The host system must include these elements:

  • CentOS, Debian, Fedora, RHEL, or Ubuntu with the Community Xen package. The F5 iWorkflow Supported Hypervisors Matrix, published on the AskF5™ web site, identifies the Linux versions that are supported.

Deploying the iWorkflow VE virtual machine

The primary task in deploying iWorkflow™ VE on the open source Xen Project environment is creating and executing a configuration file that sets up most of what you need to get up and running.

Important: Do not modify the configuration of the Xen Project guest environment with settings less powerful than the ones recommended in this document. This includes the settings for the CPU, RAM, and network adapters. Doing so might produce unexpected results.
  1. In a browser, open the F5 Downloads page (
  2. Download the iWorkflow v2.x/Virtual Edition file package. The file name ends in
    The file package creates a 95GB disk footprint at installation.
  3. Extract the two files from the Zip archive and save it where your qcow2 files reside on the Xen Project server.
    Important: Two files are created when you extract the qcow file. You must install the larger file first.
    • The name of the larger file is similar to iWorkflow-<build_number>.qcow2.
    • The name of the smaller file is similar to iWorkflow-<build_number>.DATASTOR.LTM.qcow2.
  4. Generate a MAC address for the network interface card associated with the management interface.
    Important: Be sure that the MAC address you create starts with the prefix 00:16:3e:.
    To create this address, you can use a tool such as MAC Address Generator (
  5. Use an editor to create an iWorkflow VM definition file that specifies the required parameters for your VM.
    # vi /etc/xen/<config_file_name>
    Important: The sample configuration file provided here serves only as an example of the kinds of parameters you need to specify for your virtual machine. The actual file that you create will likely contain different parameters and settings.
                        name = <config_file_name>
                        maxmem = 4096
                        memory = 4096
                        vcpus = 2
                        builder = "hvm"
                        boot = "c"
                        pae = 1
                        acpi = 1
                        apic = 1
                        hpet = 1
                        localtime = 0
                        on_poweroff = "destroy"
                        on_reboot = "restart"
                        on_crash = "restart"
                        sdl = 0
                        vnc = 1
                        vncunused = 1
                        keymap = "en-us"
                        disk = [ 'tap:qcow2:/<vdisk_path>/iWorkflow-<build_number>.qcow2,hda,w', 
                        vif = [ "mac=00:16:<mgmt_interface_mac>,bridge=mgmtbr,script=vif-bridge",
                        parallel = "none"
                        serial = "pty"
                        #pci = [ '05:10.0', '05:10.1' ]
    Important: The last line of the example configuration file contains an optional entry that specifies the IDs for PCI external and internal network interface cards (NIC). This optional entry is required for SR-IOV support. Naturally, if you use this entry, you omit the external and internal bridges specified in the vif section.
    Once you have perfected and saved your configuration file, you are ready to create the iWorkflow VM,
  6. Run the configuration file using an open source tool such as xm.
    xm create /etc/xen/<config_file_name>
    The console should indicate a successful start up by displaying something similar to this: Started domain <config_file_name>(id=444).
  7. Allow some time for the boot-up process; then, you should be able to connect to the iWorkflow console.
    # xm console <config_file_name>

Powering on the virtual machine

You must power on the virtual machine before you can begin assigning IP addresses.

    Assigning a management IP address to a virtual machine

    The virtual machine needs an IP address assigned to its virtual management port.
    Tip: The default configuration for new deployments and installations is for DHCP to acquire the management port IP address.
    1. At the password prompt, type default.
    2. Type config and press Enter.
      The F5 Management Port Setup screen opens.
    3. Click OK.
    4. If you want DHCP to automatically assign an address for the management port, select Yes. Otherwise, select No and follow the instructions for manually assigning an IP address and netmask for the management port.
    Tip: F5 Networks® highly recommends that you specify a default route for the virtual management port, but it is not required for operation of the virtual machine.
    Table of Contents   |   << Previous Chapter   |   Next Chapter >>

    Was this resource helpful in solving your issue?

    NOTE: Please do not provide personal information.

    Additional Comments (optional)