System requirements

The Git Connector requires:

  • that the Git Connector version number match the Helix Core Server version number. For example, GCONN 2022.2 with P4D 2022.2
  • an installation of Helix Core Server 2017.1 or later. For example, P4D 2022.1 supports GCONN 2022.1

  • Git version 1.8.5 or later. If the distribution package comes with an earlier release of Git, upgrade to a supported version.

  • At least 10 GB of free storage space, and in many cases considerably more. Space and memory requirements depend on the size of your Git repos and the number of concurrent Git clients.
    • Note

    If you are Upgrading Git Connector, do so before upgrading Helix Core Server. For example, first upgrade the Git Connector to its 2019.2, and then upgrade Helix Core Server to 2019.2.

    Upgrade the Helix Core Server as soon as possible after upgrading the Git Connector. Otherwise, the Polling Repos feature will not work as expected. For details, see Polling and the server spec.

Tip

We recommend that the Git Connector be on a machine that is separate from the machine with the Helix Core Server.

The Git Connector is available in two distribution package formats: Debian (.deb) for Ubuntu systems, and RPM (.rpm) for CentOS, RedHat Enterprise Linux (RHEL), and SUSE Linux Enterprise Server (SLES). You can install the Git Connector on the following Linux (Intel x86_64) platforms:

  • Ubuntu 12.04 LTS (Precise), 14.04 LTS (Trusty), 16.04 LTS (Xenial), 18.04 LTS (Bionic), 20.04 (Focal), Ubuntu 22.04 (Jammy)
  • CentOS or Red Hat 6.x, 7.x, 8.x, 9.x
  • SUSE Linux Enterprise Server 11, 12, 15

See Release Notes for Git Connector.

Note

CentOs and Red Hat 6.x are not recommended because they would require that you manually install Git and HTTPS.

If the operating system is CentOS, Security-Enhanced Linux (SELinux) and the iptables userspace application must allow:

  • the Git server to contact the helix/gconn service on port 443 (the HTTPS port)

  • gconn to communicate with p4d if they are both on the same machine

Note

System requirements for one-way mirroring from third-party Git servers:

  • git-lfs package (1.1.0 or greater) installed on the Linux server that is running the Git Connector
  • git-lfs package (1.1.0 or greater) installed on each client machine that is working with the Git repositories

See the instructions in the One-way mirroring from Git servers at Git LFS.

One-way mirroring from third-party Git servers is not recommended with Centos6.

Warning