Installation

This topic assumes you have met the Prerequisites.

The Helix Server is divided into multiple packages, so you can install the components you need. The component package names are:

  • helix-p4d
  • helix-p4dctl
  • helix-proxy
  • helix-broker
  • helix-cli

The helix-p4d package installs the main component of a Perforce service, p4d, as well as the command line interface (p4, which is distributed as helix-cli), the service controller (p4dctl), and a configuration script to set them up.

At minimum, you need to install the helix-p4d package. To install a different package, substitute its name for helix-p4d in the commands below.

Package installation requires sudo or root level privileges.

Verify the Public Key

To ensure you have the correct public key for installing Perforce packages, verify the fingerprint of the Perforce public key against the fingerprint shown below.

  1. Download the public key at https://package.perforce.com/perforce.pubkey
  2. To obtain the fingerprint of the public key:

    For Ubuntu 14.04/16.04 & RHEL/CentOS 6/7: gpg --with-fingerprint perforce.pubkey

    For Ubuntu 18.04/20.04 & RHEL/CentOS 8: gpg -n --import --import-options import-show perforce.pubkey

  3. Verify that it matches this fingerprint:

    E581 31C0 AEA7 B082 C6DC 4C93 7123 CB76 0FF1 8869

Follow the instructions that apply to you:

For APT (Ubuntu)

  1. Add the Perforce packaging key to your APT keyring. For example,

    wget -qO - https://package.perforce.com/perforce.pubkey | sudo apt-key add -

  2. Add the Perforce repository to your APT configuration.

    Create a file called /etc/apt/sources.list.d/perforce.list with the following line:

    deb http://package.perforce.com/apt/ubuntu {distro} release

    Where {distro} is replaced by one of the following: precise, trusty, xenial, bionic, or focal.

  3. Run apt-get update
  4. Install the package by running sudo apt-get install helix-p4d

You can also browse the repository and download a Deb file directly from https://package.perforce.com/apt/

See Post-installation configuration.

For YUM (Red Hat Enterprise Linux or CentOS)

  1. Add Perforce's packaging key to your RPM keyring:

    sudo rpm --import https://package.perforce.com/perforce.pubkey

  2. Add Perforce's repository to your YUM configuration.

    Create a file called /etc/yum.repos.d/perforce.repo with the following content:

    [perforce]
    name=Perforce
    baseurl=http://package.perforce.com/yum/rhel/{version}/x86_64
    enabled=1
    gpgcheck=1

    where {version} is either 6 for RHEL 6 or 7 for RHEL 7

  3. Install the package by running sudo yum install helix-p4d

See Post-installation configuration.

For SUSE Linux Enterprise Server

  1. Add Perforce's packaging key to your RPM keyring:

    sudo rpm --import http://package.perforce.com/perforce.pubkey

  2. Add the Perforce repository.

    sudo zypper addrepo http://package.perforce.com/yum/rhel/7/x86_64/ helix

  3. Install the package by running sudo zypper install helix-p4d

See Post-installation configuration.