logo

WANDISCO GIT MULTSITE®

The repositories contain binaries built by WANdisco to work with WANdisco Git MultiSite.
JGit is installed in your GitMS installation but C-Git binaries need to be installed additionally. To do this follow the instructions below.

1. Which binaries to install

Everything has to match
It is crucial that your binaries match your version of GitMS.
It is also necessary that all nodes have the same GitMS version.
  • If you are installing an entirely new ecosystem of GitMS then install the latest version of the Git binaries. These are tied to the latest version of GitMS.

  • If you are installing a new node in an existing ecosystem then install the same version of the Git binaries as is installed on the other nodes. You will need to install the same version of GitMS as on your other nodes and the binaries need to match.
    See the release notes for your version of GitMS for more information.

Installing to a non-default location

If you want install Git binaries to a non default location as a non-root user, you first need to set a new template location in the .gitconfig file for that user:

[init]
templatedir = <PathToNonDefaultBinariesLocation>/share/git-core/templates

If you do not set this you may see the following warning when attempting to checkout a repository:

warning: templates not found /usr/share/git-core/templates

2. Supported platforms

The following platforms are supported.

2.1. RedHat Enterprise Linux

To install these packages, run the following as root:

# cat > /etc/yum.repos.d/WANdisco-git.repo << EOF
[WANdisco-git]
name=WANdisco Replicated Git
baseurl=http://opensource.wandisco.com/replication/rhel/\$releasever/git/\$basearch
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-WANdisco
EOF

# curl -s http://opensource.wandisco.com/RPM-GPG-KEY-WANdisco > RPM-GPG-KEY-WANdisco
# rpm --import RPM-GPG-KEY-WANdisco
# rm RPM-GPG-KEY-WANdisco
# yum install <package name>-<version>

For example to install git 2.3.1 the final command would be:

yum install git-2.3.1

Check the release notes for your GitMS version for which version you need.

2.2. SUSE 11

First perform a cleanup

zypper remove git git-core git-gui gitk perl-Git

To install the packages, run the following:

# cat < /etc/zypp/repos.d/WANdisco-git.repo << EOF
[WANdisco-git]
name=WANdisco Replicated Git
baseurl=http://opensource.wandisco.com/replication/suse
type=rpm-md
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-WANdisco
EOF

# curl -s http://opensource.wandisco.com/RPM-GPG-KEY-WANdisco > RPM-GPG-KEY-WANdisco
# rpm --import RPM-GPG-KEY-WANdisco
# rm RPM-GPG-KEY-WANdisco
# zypper in -f <package name>-<version>

For example to install git 2.3.1 the final command would be:

zypper in -f git-2.3.1

Check the release notes for your GitMS version for which version you need.

2.3. Running with Apache

Installation requires the location of the user ~/.gitconfig file. As Suexec will strip out HOME environmental variables you will need to edit the git-http-backend script to include it, i.e.

export HOME=<path_to_home>

2.4. Install the latest version

If you are certain that the binaries you require are the latest version then the version number can be removed in the above commands. E.g.

yum install git

2.5. Tar-ball Installer

If required, a tar-ball based installer is available from WANdisco support.

This installer must not be run as root and the binaries need to be installed in a directory other than the default (a non-/usr location is required). If the install.sh script is run by root and installed into the /usr directory then the system directory owner/group might change.

If you want to install Git binaries using a root account you need to use one of the platform installer specific packages detailed above.

3. Uninstall binaries

If you are updating to a newer version of GitMS, or rolling back to a previous one, then you need to uninstall the current C-Git binaries before installing the correct ones for your new version of GitMS.
To do this use the relevant commands below.

If you use RHEL, run the command:

yum erase git

If you use SUSE, run the command:

zypper remove git