This document describes how to produce a release and distribution of the GridShib-CA. Steps are meant to be sequentially (with some parallelism possible as noted).It is assume you can build the code. As with building the code, you must have configured your local working copy of the code with '--enable-build'.
In addition to what you need to build the code, you will need the following to make a release:
Set the version number by editing configure.ac and modifying two values, the first is the version number itself which is specified as the second argument to AC_INIT() - e.g. the following shows a version of 2.0.0:
Second, specify the qualifier on the distribution to be made, e.g. 'alpha', 'beta', 'rc1', 'preview' by setting the value of PACKAGE_RELEASE_STATUS:
This value has no semantic meaning, but will appear concatenated with a dash to the version string on the distribution tarball and in version strings in the code. Typically values are "preview" which is used to mark a version as being non-complete, or rc1, rc2, etc. for release candidates that are made public. Usually I leave the value at "preview" unless I'm going to make a tarball public or I'm cutting a final release; for the latter I set it to the empty string, i.e.:
The most basic test is 'make test' - this will check all the perl syntax and run some simple tests on the back end CA code. Hopefully since you thought you were ready for release this will run without a hitch, but this will catch some problems early.
This will generate a tarball from the code in the current working directory (i.e. it doesn't go into CVS). As a result of running this command, you should end up with a file such as "gridshib-ca-2-0-0-preview.tar.gz", where 2-0-0 and preview are based on the values you set in configure.ac in the first step above.
Behind the scenes it's running test/test-dist.sh which is installing the code and then running 'make test-post-install'.
The automated tests cover a lot of the back end functionality, but don't cover the user interface through the web front end. First step is to deploy on shibber.ncsa.uiuc.edu by running the following:
This should result in a working URL similar to the following: https://shibber.ncsa.uiuc.edu/gridshib-ca-test-2.0.0-preview2/ . Note that you will need to update your Apache Configuration in order to have the script execute properly.
Then you can use your Shibboleth and OpenID accounts to verify you can create a session and download credentials.
Run 'make dist-sign' to sign the release using your PGP/GPG key.
This should result in the distribution being available at http://sourceforge.net/projects/cilogon/files/gridshib-ca/
download page on gridshibca.cilogon.org and update the links for the latest version.
cilogon.sourceforge.net and view the documentation.
sourceforge shell service) and change the symlink for the current gridshib-ca documentation:
$ ssh -t USER,firstname.lastname@example.org create
$ cd /home/groups/c/ci/cilogon/htdocs/gridshib-ca/docs
$ rm -f current
$ ln -s gridshib-ca-2.0.0 current
Pointer your web browser at the URL below and check your changes.
Globus bugzilla and close any bugs resolved by the new release.