Deploying Gitweb additions

With these additions, you can create links between changes and Rational Team Concert™ work items and view and traverse existing links.

Before you begin

Previous post-installation tasks are complete.

About this task

Do these steps for each Gitweb server that you want to integrate with the adapter.

Important: In adapter software 1.1 or earlier the ./rlia folder was named ./static folder in the Gitweb server directory.

Procedure

  1. Go to the folder location where you installed the adapter.

    For example, JazzInstallDir/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.

    Extracting the compressed file adds several files to the./rlia folder.

  4. To add the Gitweb additions to the Gitweb server, from the ./rlia folder, run gitweb_setup.sh with the -i command.

    The -i command performs the initial configuration of the Gitweb additions. The parameter --adapter_url is the root URL to the Rational® Adapter for Git. The parameter --git_conf_loc is the location of the gitweb.conf file on the Gitweb server. For more information about these parameters, see gitweb_setup.sh in the ./rlia folder of the Gitweb server directory.

    Tip: You can run the gitweb_setup.sh script without defining a command and its parameters. The gitweb_setup.sh script when first run, prompts you for the command, either -i to deploy the Gitweb additions, -r to register the Gitweb server, or --hook to deploy the receive hook for Gitweb. When you run the script with the command, for example, gitweb_setup.sh -i, the script prompts you for the required parameters.
    ./rlia/gitweb_setup.sh -i --adapter_url https://your.git.adapter.server.com:9443/gitAdapter --git_conf_loc /etc/gitweb.conf

Results

The adapter Gitweb additions are deployed to the Gitweb server.

Gitweb home with additions

What to do next

Register Gitweb servers to work with the adapter, see Registering Gitweb servers.

Feedback