The Git Connector requires:
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.
- an installation of Helix Core server 2017.1 or later
- that the Git Connector version number match the Helix Core server version number
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.
We recommend that the Git Connector be on a machine that is separate from the machine with the Helix server.
The Git Connector is available in two distribution package formats: Debian
.deb) for Ubuntu systems, and RPM (
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)
- CentOS or Red Hat 6.x, 7.x, 8.x
- SUSE Linux Enterprise Server 11, 12, 15
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
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
One-way mirroring from third-party Git servers is not recommended with Centos6.
- The Helix4Git configuration process removes any SSL certificates in
/etc/apache2/sslbefore generatings new SSL certificates. Therefore, existing sites, such as Helix Swarm, might be disabled.
Do not add custom hooks in the Git Connector because they will not work as expected. However, the Helix Core server does support triggers for depots of type graph. See https://www.perforce.com/perforce/doc.current/manuals/p4sag/#P4SAG/scripting.triggers.graph.html.