Open topic with navigation

OVA configuration

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

Note

Helix Versioning Engine can refer to a Helix server machine (p4d), proxy, broker, replica, edge server, or commit server. It does not refer to a service user; service users are used to coordinate replication in a Helix Versioning Engine. For simplicity, the term Helix server is used to refer to any configuration of a Helix Versioning Engine machine.

Use the OVA if you want to:

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:

    1. Password for the root user
    2. Password for the system swarm user
    3. Hostname for the virtual machine

    4. Helix Versioning Engine port (P4PORT)

      Important

      If your Helix Versioning Engine is deployed using the commit-edge architecture, ensure that the Swarm port value points to the commit server.

      For more information, see "Commit-edge Architecture" in the Helix Versioning Engine Administrator Guide: Multi-Site Deployment.

    5. Userid of a normal user in the Helix server with admin privileges
    6. Ticket, or password, of the admin-level Perforce user
    7. Mail relay host

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

    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.

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/perforce/swarm/data/config.php. The Swarm installation folder is /opt/perforce/swarm/.

The OVA setup is now complete. Continue with the steps listed in Helix Core configuration for Swarm to complete the installation of 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.