Skip to content

Creating the VO Client package

Overview

The VO Client package is just a conversion of the tarball created by GOC into the RPM format.

In order to build the RPM, one needs:

  • The tarball containing the:
    • vomses file
    • edg-mkgridmap.conf file
    • gums.config.template file
    • vomsdir directory tree, containing the lsc files.
  • The RPM spec file

Making the tarball

To make the tarball:

  • start with a clean directory
  • copy in the vomses, gums.template, and edg-mkgridmap.conf files and rename the edg-mkgridmap file:
      wget http://repo.opensciencgrid.org/pacman/tarballs/vo-package/vomses
      wget http://repo.opensciencegrid.org/pacman/tarballs/vo-package/edg-mkgridmap.osg
      mv edg-mkgridmap.osg edg-mkgridmap.conf
      wget http://repo.opensciencegrid.org/pacman/tarballs/vo-package/gums.template # TODO UNSURE
  • Create the vomsdir directory by downloading the .lsc files
     wget --recursive --no-host-directories --cut-dirs=3 -A "*.lsc" http://repo.opensciencegrid.org/pacman/tarballs/vo-package/vomsdir
  • In a separate directory, unpack the old vo-client tarball (from the upstream source cache)
  • diff the two directories, and compare the changes to the expected changes listed in the JIRA ticket for this VO Client package release
  • Follow the instructions in the attached gums-template-conversion.txt file to convert it from GUMS 1.1 (1.2?) format to GUMS 1.3 format. Name the result gums.config.template. See also the Automated GUMS Conversion section below for a scripted version of this step.
  • Move the files into a subdirectory to include in the tarball:
      VERSION=44  # set appropriately
      mkdir vo-client-$VERSION
      mv vomses gums.config.template edg-mkgridmap.conf vomsdir vo-client-$VERSION/
      tar -czf vo-client-$VERSION-osg.tar.gz vo-client-$VERSION/

Upload the tarball into the upstream source cache, in the vo-client/VERSION/ directory.

Automated GUMS Conversion

The above instructions outline a procedure for converting the osg gums.config template from GUMS 1.1 format to 1.3 format. Because setting up a GUMS instance for this can be time consuming and tricky to get right, a script was written to automate the procedure on a Fermi VM. The script lives in svn under: $SVN/software/tools/convert-osg-gums-template-for-vo-client.sh .

To use it:

  • Create a new Fermi VM (el5 or el6)
  • Copy the script and the new gums.template to be converted to the /root homedir on the VM.
  • Log into the VM as root, make sure the script is executable, and run against the gums template:
      $ ssh [email protected]
      # wget https://vdt.cs.wisc.edu/svn/software/tools/convert-osg-gums-template-for-vo-client.sh
      # chmod +x convert-osg-gums-template-for-vo-client.sh
      # ./convert-osg-gums-template-for-vo-client.sh gums.template
  • It takes a little while to install and set up gums and related packages, but if it succeeds, you should see a message that says "User group has been saved.", and a file gums.config.template should be written in the current directory.
  • The newly converted gums.config.template should be compared to the old version of that file (from the previous vo-client package) to ensure that the only the differences are the changes for this release. (I have had to manually strip the extra test account stuff.) The 'meld' program is a nice graphical diff tool that I use for comparing them.

RPM spec file maintenance

The OSG RPM spec file is maintained in Subversion.

The VO Client package is located in native/redhat/trunk/vo-client

There are two files that need to be maintained:

  • osg/vo-client.spec - This is the RPM spec file proper. One needs to update the version (and/or the release number) every time a new RPM is created.
  • upstream/release_tarball.source - This file contains the relative path of the tarball within the upstream source cache. Since the tarball file name will change with every new RPM version, this file has to be changed accordingly.

RPM building

After installing the osg-build tools, check out a clean copy from svn, then:

  • osg-build prebuild .
  • Once there are no errors, run osg-build koji . --scratch This can be done without making any permanent change.
  • Once that builds successfully, run osg-build koji . This is permanent, unlike when you ran with --scratch. You cannot rebuild this version of the RPM again - you must bump the release number and edit the changelog.

This will push the RPMs into the OSG development repository. Koji requires additional setup compared to rpmbuild; see the documentation here.

Promotion to testing and release:

Policies

Read Release Policy.

These should be synchronized internally with other GOC update activities.