Installing the broker

Non-package-based installation of the Broker

  1. Download the p4broker executable from the Perforce website at https://www.perforce.com/downloads/helix-broker-p4broker
  2. Copy the download to a suitable directory on the host (such as /usr/local/bin), and ensure that the binary is executable:

    $ chmod +x p4broker

Linux package-based installation of the Broker

This topic assumes you have met the Prerequisites of Linux package-based installation.

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-broker package installs the main component of the Broker, p4broker, as well as the command line interface (p4), the service controller (p4dctl), and a configuration script to set them up.

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, run one of the following:

    for Ubuntu 18.04/20.04 and RHEL/CentOS 8

    gpg -n --import --import-options import-show perforce.pubkey

    for Ubuntu 14.04/16.04 and RHEL/CentOS 6/7

    gpg --with-fingerprint 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

    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 or bionic.

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

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

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 broker

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 broker