This page describes how to build GUMS and set up an environment for deploying it.
The source will soon be downloadable from our Subversion repository at https://svn.usatlas.bnl.gov/svn/privilege. This has not been possible as of yet because of the difficulty in configuring Subversion with write SSL access for specific individuals and at the same time, read SSL access for everyone. You may request a tarball of the source in the meantime by contacting us at firstname.lastname@example.org.
Install Java, Tomcat, MySQL, Maven 2, and Cargo. We recommend using YUM with the JPackage repository for installing these. Instructions can be found at http://www.racf.bnl.gov/experiments/usatlas/griddev/griddevhowto. Another good package to install is Eclipse, for which you can install the Maven Eclipse Plugin.
Follow the instructions at the manual installation page for configuring Tomcat, creating the database, and adding yourself as an administrator.
Unit tests provide an easy way to make a change and quickly ensure you haven't broken anything. gums-core has three levels of unit tests:
The default test is standard. To change this, add the following section to your ~/.m2/settings.xml file:
<settings> ... <profiles> <profile> <id>local-test</id> <activation> <activeByDefault>true</activeByDefault> </activation> </profile> </profiles> </settings>
or with 'local-test' replaced by 'external-test' or 'no-test'.
Build using Maven 2 with:
[root@privilege /]# cd gums-site [root@gums-site /]# mvn install site [root@gums-site /]# cd ../gums-service [root@gums-service /]# mvn cargo:redeploy
or each invididual project as:
[root@privilege /]# cd gums-core [root@gums-core /]# mvn install [root@gums-core /]# cd ../gums-service [root@gums-service /]# mvn install cargo:redeploy [root@gums-service /]# cd ../gums-client [root@gums-client /]# mvn install [root@gums-client /]# cd ../gums-site [root@gums-site /]# mvn site
It is normal to see errors during the testing phase of GUMS since errors are purposefully being created to ensure GUMS catches them. However, you will know that the tests passed by output:
Results : Tests run: 149, Failures: 0, Errors: 0, Skipped: 0