logo

WANDISCO GIT MULTISITE®
USER GUIDE

Version 1.10.2 Build: 7906f912 Released: 9 February 2023
Last updated: 9 February 2023

Release notes support the installation of the latest product version.

For additional information go to:

Latest Release details

Statements on Common Vulnerabilities and Exposures

WANdisco constantly monitors the possible impact of common vulnerabilities and exposures on all its products. See the WANdisco Community website for the latest ALM Product CVE Statements.

Release 1.10.2

Version: 1.10.2.4 Build: 7906f912
Release: 9 February 2023

This is a patch release fixes an issue where pack files could become excessively large.

  • GER-1824 - Minimize pack file size for replicating repository updates.

For deployment requirements, see the notes for the major release.

Version: 1.10.2.2 Build: 28d8ab9f
Release: 17 November 2022

This is a patch release is intended only for use with Access Control Plus (ACP) AuthZ policy enforcement, not Gerrit. The following fixes are included.

  • NV-9046 - Properly enable M+ privilege.

  • NV-9056 - properly implement default AuthZ policy.

Version: 1.10.2.1 Build: 1086e0da
Release: 3 March 2022

Git MultiSite 1.10.2 provides fixes for two issues found in the previous release. For deployment requirements, see the notes for the major release.

  • NV-8617 - Fixed an issue where content delivery could be mistakenly removed, requiring a time-consuming workaround that included loss of repository access for a short time and required a restart of all replicators in the containing replication group.

  • NV-8650 - Added a check that the pack files used to update the repository do not contain any corruption. Due to the graph nature of Git, sometimes these pack files can contain objects that the repository already has. If the repository is corrupt, then the pack files can be corrupt, and the update to the repository will fail.

    The code that does this check in GitMS 1.10.1 is flawed and may only catch the corruption on the nodes remote from the initial push (originating node). The repository on the remote nodes will go Local Read-only (LRO). We are fixing this flaw.

    The new code included in this release will ensure that the pack file makes health checks before creating the update proposal and will reject the update request at that time. This will prevent a slip into the LRO state. However, the real cause may very well be that the repository is already corrupt. You should run a “git fsck --full --strict” to validate that the repository is healthy (and it was the pack file(s) that were corrupt). Run that command on all nodes in the replica family and repair the other sites with an uncorrupt version. If all replicas are corrupt, then please contact WANdisco support.

Release 1.10.1

Version: 1.10.1.0 Build:de3f8378
Release: 20 May 2021

Git MultiSite 1.10.1 provides fixes for a number of issues found in the previous release. For deployment requirements, see the notes for the major release.

Fixed

  • NV-8003 - GitMS account licensing update protocol is now more efficient

  • NV-8178 - logrotation.ser file is now human readable

  • NV-8182 - Additional warnings when adding node to a replication group

  • NV-8201 - Fixed bug that could cause two emails to be sent for a single event

  • NV-8237 - Enable keystores with multiple keys

  • NV-8263 - Periodically cleanup JGit pack file cache to enable proper file system release of deleted file space

Release 1.10.0

Version: 1.10.0.0 Build:88a42bfb
Release: 4 February 2021

Git MultiSite 1.10.0.0 is exclusive for use with GerritMS 1.10.0.
Do not install or deploy if you are not also running GerritMS 1.10.0.

Fixed

  • NV-4185 - A consistency check is now run whenever a repository is deployed

  • NV-4229 - An attempt to browse to an invalid repository path is now an INFO

  • NV-5360 - Moving the scheduling-managing node is now done consistently across timezones

  • NV-5768 - Can now delete an incompletely created replication group

  • NV-6404 - Permissions for "not this team" and "not this user" are implemented when GitMS is configured to do AuthZ

  • NV-6534 - Flume SSL passwords are now stored encrypted

  • NV-6550 - Content Delivery is now cleaned up after unsidelining a repository

  • NV-6689 - Java 8 is now required

  • NV-6703 - Installation of GitMS can now be automated without a UI driver

  • NV-6751 - Disk space warnings now easier to understand

  • NV-6865 - The “CheckRepositoryResultSuccessProposal” event in notifications is now deprecated and will not trigger a notification email

  • NV-6890 - EULA acceptance is now done on WANdisco downloads page and has been removed from the product

  • NV-7006 - Removed nodes will no longer show up on "map" page

  • NV-7291 - New property to disable stack tracebacks from showing up in REST API output, see Enable/Disable Stack Traces

  • NV-7354 - Now able to remove repository from replication even if it has pending transactions

  • NV-7512 - UI for Replication Group node roles will now show correct roles

  • NV-7546 - Repository Repair UI is now more robust

  • NV-7555 - Proper error message now displayed when incorrect file system path specified during repository addition

  • NV-7563 - Proper error message now displayed when trying to add a repository with a duplicate name

  • NV-7603 - REST API Breaking change: <replicationgroup/> has been renamed to <replicationGroup/> in some APIs to match other APIs

  • NV-7615 - SUSE 11 / SLES 11 is no longer supported as a platform

  • NV-7698 - Fixed a bug causing talkback to infinite loop with eco-system > 3 nodes

  • NV-7715 - GitMS will now periodically check for proper replicated Git Binaries and log ERROR if fails

  • NV-7725 - The repository GC REST API invoked operation can now be tracked to completion (on all nodes) by following all returned tasks

  • NV-7752 - Intermittent missing Index event bug has been fixed

  • NV-7797 - Upgrade from prior GitMS version requires WD_SYSTEMD_TASKSMAX setting in "main.conf" file, see Check main.conf Configuration File

  • NV-7921 - Large proposals will now use Content Delivery automatically

  • NV-7951 - Content Delivery will now prevent CPU over-use and possible NODE_OFFLINE issues

  • NV-8037 - Proposals with small associated data will transfer data inline (not via Content Delivery)

  • NV-8166 - CentOS 6 is no longer a supported platform

Additional fixes

  • Many defects were fixed in the GitMS installer

  • Many defects were fixed in the talkback utility

Software versions required or supported

The tested versions are listed below, we support these and higher patch levels. While we make every attempt to continue to support older Linux patch levels, it is sometimes not possible. In addition, because we do not test every patch level we may not know about an incompatibility that exists. For absolute compatibility it is best to choose the tested patch level.

  • CentOS 7.6

    • Contact WANdisco Support for more information about running on this platform.

  • JDK 8

    • Important: JDK 7 is no longer supported. You must now run JDK 8.

We don’t support GitMS on 32-bit architecture because this would impose serious limits on scalability. You must deploy on a 64-bit OS.

System user and group assignment for GitMS

During install you are asked which user and group you want to run GitMS as. The primary group of the user account that GitMS will be run as should ALWAYS be used as the group that GitMS should be run as or else there will be a mix of directory entries (directories, files) that contain either theAccount:theGroup or theAccount:thePrimaryGroup since the running process is most likely to run as theAccount:thePrimaryGroup and not theAccount:theGroup.

Required software versions:

  • C-Git - 2.19.1 (WANdisco version)

Other software versions:

  • JGit version installed with GitMS - 5.1.13-WDv1

Browser compatibility:

The following browsers are used in testing:

  • Firefox 36 or later

  • Google Chrome 56 or later

The latest versions of these browsers can also be used:

  • Internet Explorer

  • Safari

  • Opera

Previous GitMS releases

Release 1.9.6.3

Version: 1.9.6.3 Build: a6cd3666
Release: 12 June 2019

Fixed

  • NV-7359 - Critical bug in JGit that could cause repository data loss fixed.

  • NV-7392 - Fixed bug that prevented the "update-config" REST API from working properly on Java 8

  • NV-7406 - Fixed bug that prevented large some LFS implementations from working

  • NV-7408 - Stopped filling log files with "Object went to …​"

  • NV-7440 - Fixed "rp-git-update" to properly handle white-space within certain fields

Release 1.9.5.5

Version: 1.9.5.5 Build dd32d91e
Release: 10 January 2019

New

  • NV-6983/NV-7042/NV-7130 - Enabled SystemD configuration files for SLES 12, CentOS/RHEL 7.

  • NV-7051 - For GerritMS, the following versions of MariaDB are now required: 10.1.36 on SLES 11, 10.2.21 on SLES 12.

  • NV-7078 - Incorporated a fix for CVE-2018-17456.

  • NV-7124 - GitMS now requires the replicated version of Git 2.19.1.

  • NV-7141 - Included a mechanism to disable the fix for CVE-2018-17456. See Submodule Verification for more information.

Fixed

  • NV-7133 - Fixed a bug causing the initial startup after install to fail.

Software versions required or supported

The tested versions are listed below, we support these and higher patch levels:

  • RHEL 6.6

    • Red Hat 6 requires the RHEL Server Optional repository to be enabled in Red Hat Network.

  • CentOS 6.9

    • See Red Hat note above.

  • RHEL 7.1

  • CentOS 7.5

  • SUSE 11.4

  • SUSE 12.3

    • Contact WANdisco Support for more information about running on this platform.

  • JDK 7

    • JDK 8 is only tested with CentOS currently but is supported on all platforms.

We don’t support GitMS on 32-bit architecture because this would impose serious limits on scalability. You must deploy on a 64-bit OS.

During install you are asked which user and group you want to run GitMS as. On Ubuntu this change does not apply system-wide, so some files have the default group set. This is not a problem, but something to consider when deciding on your OS.

Required software versions:

  • C-Git - 2.19.1 (WANdisco version)

Other software versions:

  • JGit version installed with GitMS - 4.5.2.201704071617-r_WDv4

Browser compatibility:

The following browsers are used in testing:

  • Firefox 36 or later

  • Google Chrome 56 or later

The latest versions of these browsers can also be used:

  • Internet Explorer

  • Safari

  • Opera

Release 1.9.4.1

Version: 1.9.4.1 Build e10f07f0
Release: 22 October 2018

New

  • NV-6796 - New Git repos will always be deployed in GRO with the final state transitioning it out of GRO.

  • NV-6844 - GitMS will now always log either an ACCEPTED or DENIED on all AuthZ requests.

  • NV-6873 - Updated to use C language Git version 2.17.1.

  • NV-6919 - A clarification message has been added to the on Consistency Check UI when overlapping runs cause inconclusive/mismatched results.

  • NV-6924 - CRITICAL: AuthZ file is now parsed on product startup (instead of waiting until 1st change) thereby providing proper checking (it had been denying every request until the AuthZ file changed.

  • NV-6927 - The configurable max time to wait for Consistency Check to complete can now be enabled. See the Consistency check timeouts section for more information.

  • NV-6953 - Upgrade to use JGit version **.

  • NV-6963 - Enable alternate path to git gc command used during replicated garbage collection. See Command line JGit GC for more information.

  • NV-6976 - GitMS can poll GerritMS for account information and import information into GitMS.

  • NV-6990 - Downgraded all AuthZ requests to INFO level to prevent Dashboard spamming.

  • NV-6998 - GitMS installation now depends on the "net-tools" package. A future release will eliminate this dependency.

Fixed

  • NV-6471 - Prevented "comment size overflow" for JGit.

  • NV-6647 - Prevented PANIC during consecutive sync start/sync stops in a rare case.

  • NV-6709 - Properly remove the "git-multisite-hook" package when removing "git-multisite".

  • NV-6812 - PANIC prevented if adding a new repository to an replication group that the local node is not a member of.

Known Issues

  • NV-6988 - There is a required change to the log configuration file in this release. If you are upgrading to GitMS 1.9.4, and the logging configuration was modified in the previous version, then after upgrade has completed you will see the following warning:

    IMPORTANT: For gitms release 1.9.4, please ensure that you add the following to the log4j.properties file before restarting gitms. This additional log configuration stops spamming of the gitms.log file:

# CryptoFactory
log4j.logger.com.wandisco.security.crypto=INFO
# jsonpath
log4j.logger.com.jayway.jsonpath=INFO

    You need to add this property to to the log4j.properties file before restarting GitMS.

  • NV-6984 - Logging configuration warnings during upgrade
    There are changes to logging configuration files so if you are upgrading GitMS you will need to copy the new template configuration files into place after making sure that any local customizations have been preserved (in most cases there will be no local customizations).

    If you see the following message during upgrade then you need to determine if any changes were made to the configuration file. The message may be buried in installer output, the Linux "script" command can be used to help with searching. These changes then need to be added to the new configuration file and it copied into place.

    WARNING: Custom changes to logging configuration have been detected. The previous logging configuration
has been left in place. Please merge the changes from the latest version into your local configuration

    It is possible that changes were not made as our code does have the potential for false positives. This is something we will fix in a future release.

Please turn off thread dumps unless asked to enable them by WANdisco support. To do this edit the application.properties file and set threaddump.enabled=false.

Software versions required or supported

The tested versions are listed below, we support these and higher patch levels:

  • RHEL 6.6

    • Red Hat 6 requires the RHEL Server Optional repository to be enabled in Red Hat Network.

  • CentOS 6.9

    • See Red Hat note above.

  • RHEL 7.1

  • CentOS 7.5

  • SUSE 11.4

    • Contact WANdisco Support for more information about running on this platform.

  • JDK 7

    • JDK 8 is only tested with CentOS currently but is supported on all platforms.

We don’t support GitMS on 32-bit architecture because this would impose serious limits on scalability. You must deploy on a 64-bit OS.

During install you are asked which user and group you want to run GitMS as. On Ubuntu this change does not apply system-wide, so some files have the default group set. This is not a problem, but something to consider when deciding on your OS.

Required software versions:

  • C-Git - 2.17.1 (WANdisco version)

Other software versions:

  • JGit version installed with GitMS - 4.5.2.201704071617-r_WDv3

Browser compatibility:

The following browsers are used in testing:

  • Firefox 36 or later

  • Google Chrome 56 or later

The latest versions of these browsers can also be used:

  • Internet Explorer

  • Safari

  • Opera

Release 1.9.3.3

Version: 1.9.3.3 Build d3b85284
Release: 2nd March 2018

New

  • NV-6650 - The talkback.sh script now supports invocation via the full path.

  • NV-6682 - It is now checked during upgrade that GITMS_UMASK is defined in main.conf, if not then upgrade will fail.

    Check GITMS_UMASK before upgrade

    Before upgrading you must check that GITMS_UMASK is set in the main.conf file on all machines. E.g.

    GITMS_UMASK=0022

    The value is normally 0000, 0002 or 0022, it is what you would want to use for a 'umask'. Before choosing a number, consider the current repository permissions and the desired level of security.

    Note: The account that GitMS runs as must be the account that owns every file system object in the repositories (including any directory in which the repositories reside).

  • NV-6712 - GFR RPM will now install into a symlinked installation directory.

  • NV-6752, NV-6783 - An autosftp script has been added to help upload talkbacks to the WANdisco support site. For more information see Uploading talkback files.

Fixed

  • NV-5948 - Eliminated duplicate warning messages on the dashboard for certain failed repository creation operations.

  • NV-6420 - The GitMS AuthZ parser now runs only once per AuthZ file update.

  • NV-6755 - Incorrect dashboard messages during repository moves from one replication group to another have been eliminated.

  • NV-6771, NV-6781, NV-6782 - Fixed the repository deployment process to eliminate race conditions. We advise that consistency checks are run (after upgrade) once per repository to find any damage caused by this bug. Please contact WANdisco support if any issues are found.

  • NV-6798, NV-6799 - Fixed many bugs impacting the performance of UI.

Known Issues

Please turn off thread dumps unless asked to enable them by WANdisco support. To do this edit the application.properties file and set threaddump.enabled=false.
If using one of the newer RHEL/CentOS 7.x platforms, you will need to run yum install net-tools before running the installer. The installation will fail without this.

  • NV-6848 - If you are upgrading using the tarball installer then "WRITE" permissions may need to temporarily be added to any files being upgraded. If a permission error is displayed then add the 'w'-bit (e.g. chmod a+w file1 file2 …​) and re-run the installation.

Software versions required or supported

The tested versions are listed below, we support these and higher patch levels:

  • RHEL 6.6

    • Red Hat 6 requires the RHEL Server Optional repository to be enabled in Red Hat Network.

  • CentOS 6.6

    • See Red Hat note above.

  • RHEL 7.1

  • CentOS 7.1

  • SUSE 11.3

    • Contact WANdisco Support for more information about running on this platform.

  • JDK 7

    • JDK 8 is only tested with CentOS currently but is supported on all platforms.

We don’t support GitMS on 32-bit architecture because this would impose serious limits on scalability. You must deploy on a 64-bit OS.

During install you are asked which user and group you want to run GitMS as. On Ubuntu this change does not apply system-wide, so some files have the default group set. This is not a problem, but something to consider when deciding on your OS.

Required software versions:

  • C-Git - 2.14.1

Other software versions:

  • JGit version installed with GitMS - 4.5.2.201704071617-r_WDv3

Browser compatibility:

The following browsers are used in testing:

  • Firefox 36 or later

  • Google Chrome 56 or later

The latest versions of these browsers can also be used:

  • Internet Explorer

  • Safari

  • Opera

Release 1.9.2.3

Version: 1.9.2.3 Build e03f180a
Release: 17th October 2017

Fixed

  • NV-6686 - Fixed a critical GitMS bug preventing Gerrit reindexing.

NV-6471 change reverted
We had to revert the change needed to prevent commits with comments larger than JGit can handle. This bug will be fixed in a later release. In the meantime, please be careful not to commit with comments larger than 5MiB.

Software versions required or supported

The tested versions are listed below, we support these and higher patch levels:

  • RHEL 6.6

    • Red Hat 6 requires the RHEL Server Optional repository to be enabled in Red Hat Network.

  • CentOS 6.6

    • See Red Hat note above.

  • RHEL 7.1

  • CentOS 7.1

  • SUSE 11.3

    • Contact WANdisco Support for more information about running on this platform.

  • JDK 7

    • JDK 8 is only tested with CentOS currently but is supported on all platforms.

We don’t support GitMS on 32-bit architecture because this would impose serious limits on scalability. You must deploy on a 64-bit OS.

During install you are asked which user and group you want to run GitMS as. On Ubuntu this change does not apply system-wide, so some files have the default group set. This is not a problem, but something to consider when deciding on your OS.

Required software versions:

  • C-Git - 2.14.1

Other software versions:

  • JGit version installed with GitMS - 4.5.2.201704071617-r_WDv2

Browser compatibility:

The following browsers are used in testing:

  • Firefox 36 or later

  • Google Chrome 56 or later

The latest versions of these browsers can also be used:

  • Internet Explorer

  • Safari

  • Opera

Release 1.9.1.1

Version: 1.9.1.1 Build dbb6359c
Release: 26th September 2017

New

  • NV-6025, NV-6612 - Updated C Git implementation to 2.14.1

  • NV-6051 - The Gerrit Delete Project plugin is now supported if using GitMS with Gerrit (GerritMS).

  • NV-6532 - Switched to using the Java G1 garbage collector.

Fixed

  • NV-5924 - You can no longer click the Complete Repair Process button before the repair process has started.

  • NV-6087 - There is now better logging for specific SSL configuration mistakes.

  • NV-6448 - The Flume Installation is now prevented from deleting the wrong data.

  • NV-6471 - An error message is now returned when a commit message exceeds the JGit limitation.

  • NV-6472 - A rare PANIC during node induction has been eliminated.

  • NV-6521 - The removal of online nodes is now prevented.

  • NV-6648 - DConE is prevented from trying to communicate with removed node endpoints.

Known Issues

  • NV-6604 - If you want to run GitMS with a specific umask you should edit the /opt/wandisco/git-multisite/config/main.conf file and set the variable GITMS_UMASK to your desired value (default is 0022).
    If you alter umask in the application.properties file then any changes will be lost on upgrade.
    Note - if there are "" around the values in the main.conf file then remove them.

    Essential for upgrades from GitMS 1.6.0.1
    If you are upgrading from GitMS 1.6.0.1 you must set a GITMS_UMASK value before upgrade (NV-6678).

Software versions required or supported

The tested versions are listed below, we support these and higher patch levels:

  • RHEL 6.6

    • Red Hat 6 requires the RHEL Server Optional repository to be enabled in Red Hat Network.

  • CentOS 6.6

    • See Red Hat note above.

  • RHEL 7.1

  • CentOS 7.1

  • SUSE 11.3

    • Contact WANdisco Support for more information about running on this platform.

  • JDK 7

    • JDK 8 is only tested with CentOS currently but is supported on all platforms.

We don’t support GitMS on 32-bit architecture because this would impose serious limits on scalability. You must deploy on a 64-bit OS.

During install you are asked which user and group you want to run GitMS as. On Ubuntu this change does not apply system-wide, so some files have the default group set. This is not a problem, but something to consider when deciding on your OS.

Required software versions:

  • C-Git - 2.14.1

Other software versions:

  • JGit version installed with GitMS - 4.5.2.201704071617-r_WDv2

Browser compatibility:

The following browsers are used in testing:

  • Firefox 36 or later

  • Google Chrome 56 or later

The latest versions of these browsers can also be used:

  • Internet Explorer

  • Safari

  • Opera

Release 1.9.0.3

Version: 1.9.0.3 Build 21f6a437
Release: 4th May 2017

New

  • NV-5123 - Unattended installation is now documented, including all required environment variables.

  • NV-5346 - Documented the property setting needed to specify when to send license warnings.

  • NV-5539 - There is now wildcard support for branch and tag reference authorizations.

  • NV-5715 - The need to change "TasksMax" for Linux systems with systemd implementations is now documented.

  • NV-5888 - Authorization settings for controlling merge and NFF pushes have been added.

  • NV-5976 - Authorization based on "Account-Specific Branch Access" model (similar to gitolite) has been added.

  • NV-5993 - Encrypted passwords are enabled in Flume Sender config files (also NV-6164).

  • NV-6011 - Created a new REST endpoint to enable changing logging settings on the fly.

  • NV-6019 - GitMS is now supported to run with Java 8.

  • NV-6029 - The race condition free process for removing repositories from replication/service has been documented.

  • NV-6058 - Logging settings can now be changed though the UI on the fly and/or permanently.

  • NV-6129 - The UI will now grey out the Sync Stop button if any node is offline.

  • NV-6154 - The GitMS documentation has been converted to Asciidoctor - hope you like the new format!

  • NV-6183 - TLS mutual authentication is now supported for bi-directional communication connections.

  • NV-6223 - The list of email template variables for use during notifications has been documented.

  • NV-6236 - The GitMS UI will now display the state of the "Deny Non-Fast-Forward" setting for each repository and enable its modification.

  • NV-6303 - The repositories page no longer allows you to sort on "Last Modified" due to scalability issues.

Fixed

  • NV-4030 - Reference to the unused delegate.port in the application.properties file has been removed.

  • NV-4570 - Unnecessary warnings during node addition to a replication group have been eliminated.

  • NV-4930 - Pending replication groups now show even if a node is down during creation.

  • NV-5028 - A growl message now shown if the message body is empty in an e-mail template.

  • NV-5323 - Fixed replicator panic during induction when under load.

  • NV-5902 - You can no longer add a new node as Voter Only to an existing replication group. This is to prevent a panic.

  • NV-5913 - Fixed an issue that could cause a replicator to continuously try to remove a repository.

  • NV-5944 - GitMS will no longer remove repositories from the server without archiving first.

  • NV-5963 - Attempts to remove the Git master branch will be prevented.

  • NV-5979 - APIs are prevented from accepting references that begin with a '/' (this was causing divergence).

  • NV-5995 - ACP confusion prevented by returning inappropriate data during repository poll.

  • NV-6093 - The Replication Group sort header is fixed to say "Replication Group Name".

  • NV-6107 - Enabled the post-installation setup/maintenance of SSL by adding wd_cryptPassword.jar.

  • NV-6114 - Fixed the display of long notification template names in the UI.

  • NV-6171 - The deletion of a notification template if it is in use is prevented.

  • NV-6208 - The list of Git references is prevented from being printed into the logs.

  • NV-6224 - Fixed a rare bug that prevented the Sync Stop operation (also NV-6245).

  • NV-6258 - Fixed REST API endpoints to return 401 for authentication requests (not 405).

  • NV-6267 - Fixed a bug that caused a replication group to be sidelined inappropriately.

  • NV-6291 - Fixed the display of Perpetual licenses to properly display Perpetual.

  • NV-6292 - Fixed a number of scalability/performance bugs when large numbers of repositories are present.

  • NV-6302 - Fixed "PartialResultException" when LDAP provider is Active Directory.

  • NV-6323 - Fixed a rare bug that prevented the proper deployment of Gerrit .

  • NV-6338 - Fixed rare race condition exacerbated by bad networking that required an unnecessary replicator restart.

  • NV-6369 - The priority of the log message has dropped when REST API is used and bad path specification for repository is given.

Known Issues

  • NV-6108 - After an IP change the restart of a node can sometimes be significantly delayed. To avoid this the node can be manually restarted.

  • NV-6426 - If you remove a node which had an untrusted SSL certificate then a pending task will appear on the dashboard of the node that was used to remove it, even though the Nodes page shows it as removed.

  • NV-6604 - If you want to run GitMS with a specific umask you should edit the /opt/wandisco/git-multisite/config/main.conf file and set the variable GITMS_UMASK to your desired value (default is 0022).
    If you alter umask in the application.properties file then any changes will be lost on upgrade.
    Note - if there are "" around the values in the main.conf file then remove them.

    Essential for upgrades from GitMS 1.6.0.1
    If you are upgrading from GitMS 1.6.0.1 you must set a GITMS_UMASK value before upgrade (NV-6678).

Software versions required or supported

The tested versions are listed below, we support these and higher patch levels:

  • RHEL 6.6

    • Red Hat 6 requires the RHEL Server Optional repository to be enabled in Red Hat Network.

  • CentOS 6.6

    • See Red Hat note above.

  • RHEL 7.1

  • CentOS 7.1

  • SUSE 11.3

    • Contact WANdisco Support for more information about running on this platform.

  • JDK 7

    • JDK 8 is only tested with CentOS currently but is supported on all platforms.

We don’t support GitMS on 32-bit architecture because this would impose serious limits on scalability. You must deploy on a 64-bit OS.

During install you are asked which user and group you want to run GitMS as. On Ubuntu this change does not apply system-wide, so some files have the default group set. This is not a problem, but something to consider when deciding on your OS.

Required software versions:

  • C-Git - 2.12.0

Other software versions:

  • JGit version installed with GitMS - 4.5.0.201609210915-r_WDv1

Browser compatibility:

The following browsers are used in testing:

  • Firefox 36 or later

  • Google Chrome 56 or later

The latest versions of these browsers can also be used:

  • Internet Explorer

  • Safari

  • Opera

Earlier product versions

For Release Notes and documentation for earlier versions of Git MultiSite, see GitMS 1.7 Release Notes