Swarm 2014.1: User Guide

OVA configuration

Swarm is available as an OVA, an open virtualization appliance that requires minimal configuration.

Use the OVA if you want to:

  • Simplify the installation and configuration steps

  • Experiment with Swarm without using additional hardware

  • Install Swarm without having a Linux-based server available

To use the OVA, follow the instructions on this page and skip to the “Establish trigger token” section.

  1. Download the Swarm OVA.

  2. Import the OVA into your virtualization environment. See “VMWare OVA import”, or “Oracle VirtualBox import”.

  3. Start the virtual machine; diagnostic and boot information appears.

  4. Several configuration prompts appear in sequence:

    Configuring the OVA

    1. Password for the root user

    2. Password for the system swarm user

    3. Hostname for the virtual machine

    4. Mail relay host

    5. Perforce service port

    6. Userid in Perforce service with admin privileges

    7. Ticket, or password, of the admin-level Perforce user

    Once the prompts have been answered successfully, the virtual machine completes its configuration activities. When ready, a welcome screen is displayed:

    OVA in operation

    The welcome screen provides URLs to access Swarm, its documentation, and the virtual machine management console.

  5. Update the OVA with security updates and bug fixes:

    1. Use ssh to log into the OVA as the root user.

    2. Enter the following commands to update the OVA's list of packages and to apply any available upgrades. 

      $ apt-get update
$ apt-get upgrade

      See “OVA Management” for more details.

The OVA setup is now complete. Continue with the steps listed in “Perforce configuration for Swarm” to complete the installation of Swarm.

Note

After the OVA is configured and running, you can adjust the configuration by using ssh to connect to the virtual machine as the system swarm user and editing the “Swarm configuration” file /opt/swarm/data/config.php. Swarm's installation folder is /opt/swarm/.

VMWare OVA import

The Swarm OVA works with several VMWare virtualization products, such as Player, Workstation, or Fusion.

  1. In the VMWare product, select File > Open.

  2. Browse to the swarm.ova file and click Open.

  3. Type a name for the virtual machine, such as Swarm, and click Import.

Oracle VirtualBox import

The Swarm OVA works with Oracle VirtualBox, version 4.x+.

  1. In VirtualBox, select File > Import Appliance...

  2. Click Open Appliance.

  3. Browse to the swarm.ova file and click Open,

  4. Click Continue (might be Next > for some versions of VirtualBox)

  5. Click Import.

0 matching pages