Start working with GitCentric

This section guides you how to open GitCentric after a successful installation.

In this topic:

Before you log in

Before you log into GitCentric for the first time, ensure that:

• You have an AccuRev login account that belongs to the Admin group. See the table in AccuRev Installation in the GitCentric Installation and Release Notes.

• You have an SSH public key. If you do not already have an SSH key, generate one now from the operating system command line:

  > ssh-keygen -t rsa -C “<your_email>@<your_domain>”

  This creates a populated subdirectory at ~/.ssh. You will need the contents of ~/.ssh/id_rsa.pub in upcoming steps. The topic of SSH keys is beyond the scope of this document, but there is a great deal of information on the web that you can locate with your favorite search engine. For more information, see https://docs.github.com/en.

  The SSH public key representing the GitCentric bridge account is registered automatically when you install GitCentric the first time. If you have upgraded an existing GitCentric installation, you need to register the SSH public key manually. For more information, see the Public Keys menu item.

Back to top

Log in

Navigate to the GitCentric web server. If you chose defaults during installation, the address should be similar to:

http://<gitcentric_server_name>:8080/gitcentric

Adjust the 8080 port if necessary.

Since you are the first user to log into GitCentric after installation, you are presented with a one-time bootstrap screen which asks you to specify the AccuRev server and some additional information. No GitCentric menus are visible in the GUI at this point.

The following table describes the fields of the login screen.

localhost:5050
							acserver2:5050
					<ip_address>:5050

/home/gcadmin/accurev/bin/accurev

Back to top

Register with GitCentric

This section describes how to register with GitCentric.

When any user logs into GitCentric for the first time, GitCentric prompts guides them through a self-registration process. This way, users with valid AccuRev accounts do not need to involve an administrator to begin working with GitCentric.

Enter your information as follows:

1. Full Name: Your real name (unless this is an account for a role such as “Guest User”).
2. Preferred Email: Enter the same email address here that you specify for the Git user.email configuration for your clones. If these do not match, pushes from your clone will fail. If you need to maintain multiple email addresses, you can add them later at My Account > Contact Information. For details, see .

3. SSH key: Click Add and copy the contents of your SSH public key file here (see Before you log in) and Save it.

   

   Note: If your AccuRev user account is already associated with an SSH public key, that key will be automatically inserted in this field.) Your public SSH key file is typically ~/.ssh/id_rsa.pub. You can choose to do this later through My Account > Public Keys, but until this is set, you will not be able to use ssh protocol for Git clone, pull, and push operations. For details, see the Public Keys menu item.

4. Click Continue when done.

Back to top

Install the AccuRev trigger

Once the installation is done and you have completed the initial “bootstrap” page and the self-registration page, you need to install the AccuRev trigger server_master_trig.pl on the AccuRev Server.

To install the trigger:

1. Check to see if a triggers directory exists under <ac_home>/storage/site_slice. If not, create it.
2. Copy the server_master_trig.pl file from <gc_home>/bin to the AccuRev Server triggers directory:

   > cd <gc_home>/bin
   > cp server_master_trig.pl <ac_home>/storage/site_slice/triggers
   > cd <ac_home>/storage/site_slice/triggers
   > chmod +x server_master_trig.pl

3. Locate the ################ ACCUREV CLIENT PATH section in the server_master_trig.pl file and specify the path for your AccuRev Client. For example:

   $::AccuRev = "/usr/accurev/bin/accurev";

4. Establish a persistent AccuRev login on the AccuRev Server with:

   accurev login-n <user><password>

5. Test that server_master_trig.pl can compile:
   • Look at the first line of server_master_trig.pl and note the Perl executable that it expects to find (for example, “#!/usr/bin/perl”).
   • Using this path, use the perl -c command to test the trigger:

     > /usr/bin/perl -c ./server_master_trig.pl

     You know that your installation is complete and functioning when you see the message:

     server_master_trig syntax ok

     If any errors appear, address them before proceeding. For example, if Perl is not installed in the expected location, modify the path in server_master_trig.pl (or install it where the script expects to find it). If any optional Perl modules are missing, such as XML::Simple, install them. For example, as root try installing:

      libxml-sax-expat-perl
     cpan install XML::Simple

   Repeat these steps of copying and configuring the server_master_trig.pl file for all AccuRev Servers that you add to GitCentric.

   Note: For Windows: If you add a Microsoft Windows-based AccuRev Server to your GitCentric installation, you must convert the .pl file to a batch file using the PL2BAT utility, which is part of the Perl distribution: >PL2BAT server_master_trig.pl

Back to top

Open the GUI

Once you have completed all of login steps, you are ready to open the GitCentric user interface.

In your browser, navigate to the GitCentric installation:

http://<gitcentric_server_name>:8080/gitcentric

Adjust the 8080 port if necessary.

Back to top

Next steps:

• Administrator tasks
• User tasks
• Troubleshooting GitCentric