Helix4Git Administrator Guide (2019.2)

System requirements

The Git Connector requires:

  • an installation of Helix Core server 2017.1 or later
  • that the Git Connector version number match the Helix Core server version number
  • 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 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 14.04 LTS (trusty)
  • Ubuntu 16.04 LTS (xenial)
  • Ubuntu 18.04 LTS (bionic)

  • CentOs or Red Hat 6.x
    • not recommended because it requires that you manually install Git and HTTPS
    • if the operating system is CentOS 6.9, Security-Enhanced Linux (SELinux) and the iptables use-space 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

  • CentOS or Red Hat 7.x
  • SUSE LINUX Enterprise Server 12

10 GB minimum free storage space, but space and memory requirements depend on the size of your Git repos and the number of concurrent Git clients.

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

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