This page describes how to build GUMS and set up an environment for deploying it.
Download the source from the download page for projects: gums-core, gums-service, gums-client, and gums-site or from BNL's subversion repository if you have been given access at https://svn.usatlas.bnl.gov/svn/privilege.
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.usatlas.bnl.gov/twiki/bin/view/Projects/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'.
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