Git Server administration

This topic describes the tasks performed by administrators for using AccuRev Git Server.

Prerequisites for using AccuRev Server

Administration of the AccuRev Git Server is simple and fast. No changes to AccuRev triggers or security (users, ACL, EACL) are required.

The following are the prerequisites before using AccuRev Server:

Initial configuration of the Git Server must be done by the accurev-admin user, which must first be created in AccuRev. After the initial configuration, any member in the specified admin groups can create repos from streams, view ACLs, and review diagnostics and repo access logs in order to debug problems.
Git version 2.31 or higher must be installed on the system by the normal OS means. None of the AccuRev installers installs the native Git software.

Configuration page

The accurev-admin user must log in at <host>:<port>/git-server and perform the following tasks on the Administration Configuration page to get the Git Server ready for use by developers:

Set up an AccuRev user whose name is used by the Git Server to get background updates from the AccuRev server. This AccuRev user is known as the bridge user.
(Optional) After saving the bridge user credentials, specify AccuRev groups whose members can have administrative privileges in the Git Server.
Click Show All Repos to create repos that developers can clone.

All Repos page

The All Repos page displays all the repos created from AccuRev streams that are ready to be cloned by Git users.

On this page, administrators can do the following tasks:

Action	Details
Create a repo to clone	Click the Create Git Repo button to create a repo for users to clone.
Modify repo description	Click the Description button to modify a repo’s description.
View access rights of a repo	Click the ACL button to see which groups and users can access a repo.
Troubleshoot	Click a warning or error icon to find out the overlap in a stream or a failed push to the repo.

Create Repo page

On the Create Repo page, administrators can create a repo from an AccuRev stream in a selected depot.

To help developers find the repo to clone, write a description for the repo.

To see the list of AccuRev groups and users that can access the new repo, click the Create Repo button.

Tip: Access is dictated by stream ACL settings in AccuRev.

Diagnostics page

The Administration Diagnostics page helps you find and fix problems when the Git Server is not working as expected. It displays installed system software versions, along with the minimum versions required. Any value that does not meet the required minimum is flagged with a click-able error icon. The page also shows connectivity status for receiving background updates from AccuRev.

Logs page

The Administration Logs page displays repo access logs for clone, pull, and push operations. Logs can be downloaded to the local file system.