Deploying Gitweb additions

These additions support the creation of links between commits and Rational Team Concert™ work items as well as enabling you to see and traverse existing links.

Before you begin

Prior configuration tasks about registering the Jazz™ Team Server and requesting and approving friend servers from the Rational® Adapter for Git to the Change and Configuration Management server are complete.

About this task

Perform these steps for each Gitweb server that you want to integrate with the Rational Adapter for Git.

Procedure

  1. Go to the folder location where you installed Rational Adapter for Git . For example, JazzTeamServerDir/server/conf/gitAdapter
  2. Find the gitwebAdditions-yyyymmdd-hhmm.zip file.
  3. Uncompress the gitwebAdditions-yyyymmdd-hhmm.zip file to your Gitweb installation folder; for example /usr/share/gitweb.
    Warning: If you are using a custom site header(etc/GitwebSiteHeader), a custom style sheet (etc/GitwebSite.css) or both, you must merge or replace these files with the ones provided.
    This adds a number of files to the./static folder at that location.
  4. Set gitweb.conf variables. The gitweb.conf file is typically found in your /etc folder. Use the following settings, also described in the ./static/gitweb.conf.README file that was added in the previous step.
    #User must modify gitweb.conf by adding the entries below
    
    #OSLC Configurations
    #Add the following entry to support OSLC Style Sheets
    
    push @stylesheets, "./static/OSLC.css";
    push @stylesheets, "./static/dojo/dijit/themes/claro/claro.css";
    push @stylesheets, "./static/jaf/jazz/app/internal/templates/BannerButtons.css";
    push @stylesheets, "./static/jaf/jazz/ui/templates/MenuPopup.css";
    push @stylesheets, "./static/jaf/jazz/ui/templates/Menu.css";
    push @stylesheets, "./static/jaf/jazz/ui/templates/MessageBox.css";
    push @stylesheets, "./static/jaf/jazz/ui/menu/templates/MenuItem.css";
    
    #Point gitweb site header to the html file we've packaged.
    #Otherwise, if one already exists - modify the existing site header
    #by merging or appending the GitwebSiteHeader.html code
    
    our $site_header = './static/GitwebSiteHeader.html';
  5. Edit the oslcConfig.js in the ./static folder to assign the variable OSLC.GIT.AdaptedProjectURL to the Rational Adapter for Git URL as follows:
    OSLC.GIT.AdaptedProjectURL = "https://[fully qualified hostname]:[port]/gitAdapter";
    Important: [fully qualified hostname] is the host name where the Rational Adapter for Git application was deployed.
  6. Save the file and exit.

Results

The Rational Adapter for Git Gitweb additions are deployed to the Gitweb server.

Gitweb home with additions

What to do next

Set up Gerrit servers to work with the Rational Adapter for Git, see Deploying Gerrit additions. Otherwise measure PVUs by which the adapter is licensed by setting up PVU licensing for the Rational Adapter for Git, see Setting up processor value unit pricing.

Feedback