Contents

• About this Release
• What's New
• Installation
• Limitations
• Known Issues
• Legal Notice

The Dimensions CM Git Client brings central control and security to teams using Git, allowing them to store code in a CM stream while enjoying the familiar Git user experience. Streams can be shared by developers using Git or Dimensions CM. The Dimensions CM Git Client is an extension to Git that enables the use of the standard Git command line, Integrated Development Environments (IDEs), and other tools using Dimensions CM as the remote repository.

The Git Client supersedes the Dimensions CM Git Connector and is the recommended solution if want to use Git with Dimensions CM. If you require CAC card support for user authentication, continue to use the Dimensions CM Git Connector.

Important! The Git Client requires the Dimensions CM 14.5.0.1 (or later) server patch.

Helpful Links

Documentation: the most up to date Dimensions CM information including online help and all the documents in PDF format.

Technical Support

Product Support Lifecycle

Contact Us

For specific issues contact Support.

Additional technical information or advice is available from several sources:

• Product documentation, Knowledge Base articles, and videos.
• The Community web pages.

With the Git Client you can perform operations such as:

• Clone into a Git repository from Dimensions CM.
• Push from a Git repository back into Dimensions CM.
• Fetch and pull to obtain changes from Dimensions CM.
• Branch and merge in Git and push to Dimensions CM.

For details see the Git Client Users Guide.

Installing

• Git Client installers are available for Windows and Linux.
• Install the Git Client on users' local machines.
• The installer automatically tries to identify the Git installations present on the local system.
• When installing on Linux, ensure that “git” has been added to your PATH environment variable.
• Run the installer as a user with write access into the Git installation location(s).

Pre-Requisites

• Dimensions CM 14.5.0.1 (or later) server patch
• Git 2.19 or later

Console and Silent Modes

To invoke console use this option: -i console

Use silent mode is used to perform an automatic installation of the software after invoking the installer. In silent mode no further user interaction is required. To invoke silent mode us this option: -i silent -f <response.filename>

The response file must specify the installation location for the software and at least one Git installation location, see the following examples.

Windows silent mode response file example:

#Git installation location

#-----------

CO_GIT_CHOOSER_LOC_INTERNAL=C:\\Program Files\\Git\\mingw64\\libexec\\git-core

#Destination

#-----------

SILENT_INSTALL_DIR=c:\\apps\\Dimensions CM Git

Note Double '\' characters are required.

Linux and macOS silent mode response file example:

#Git installation location

#-----------

CO_GIT_CHOOSER_LOC_INTERNAL=/usr/libexec/git-core

#Destination

#-----------

SILENT_INSTALL_DIR=/apps/dimensions_cm_git

Note

• The SILENT_INSTALL_DIR location is created and then used to install the Dimensions CM software, a JRE, and an uninstaller.
• The CO_GIT_CHOOSER_LOC_INTERNAL location must exist and be writable by the user performing the installation.

Advanced silent options

You can specify multiple Git installation locations in the response file by adding to the CO_GIT_CHOOSER_OC_INTERNAL value.

Windows example:

CO_GIT_CHOOSER_LOC_INTERNAL=C:\\Program Files\\Git\\mingw64\\libexec\\git-core\r\nC:\\Program Files (x86)\\Git\\mingw32\\libexec\\git-core

Linux and macOS example:

CO_GIT_CHOOSER_LOC_INTERNAL=/usr/libexec/git-core\n/opt/git/libexec/git-core/

Note There are different path separators for Windows and non-Windows systems.

The following features and functionality are not supported:

• Projects (only streams are supported)
• IDM requests (only CM requests are supported)
• Normal streams. New Git local branches become topic streams when pushed to Dimensions CM.
• CAC cards for authentication.
• Push a newly initialized Git repository into Dimensions CM. You must clone from Dimensions CM to create a Git repository.
• Jenkins Git Plug-in.

Known issues in this release:

• Unable to clone a stream and all child streams using Visual Studio Code IDE (ENH328802)
• No progress indication when fetching or pulling a large number of changes (ENH329842)
• Unable to clone from Visual Studio if the users HOME directory is the root of a drive (DEF329679)

Copyright © 2019 Micro Focus or one of its affiliates.

The only warranties for products and services of Micro Focus and its affiliates and licensors (“Micro Focus”) are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. Micro Focus shall not be liable for technical or editorial errors or omissions contained herein. The information contained herein is subject to change without notice.

Contains Confidential Information. Except as specifically indicated otherwise, a valid license is required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.