Creation of caGrid VM:
- Follow the steps in VirtualMachineSetup, but in #5 we will not do the CentOS-4 instructions. Instead we will install openSUSE 10.3.
- After the VM has been created and booted from the ISO image, install openSUSE 10.3 by following DesktopInstall instructions. For the partition, just make it one big partition instead of separate ones for swap and system.
- Install caGrid: Reference: CAGRID 1.2 Installer Guide, National Cancer Institute, Center for Bioinformatics, March 28, 2008
To install caGrid 1.2 using the installer, Java 1.5 JDK is a prerequisite, and a MySql database is also a prerequisite if you want to deploy caGrid services locally. Other prerequisites are Ant 1.6.5, Globus WS-Core with WS-Enum Support, and Tomcat at least version 5.0.28 (if you want to deploy services to Tomcat). The Ant, Globus, and Tomcat prerequisites are installed for you by the installer.
You must set JAVA_HOME to the Java 1.5 Java Development Kit (JDK), not the Java Runtime Environment (JRE), before beginning the installation. Other environment variables must be set later, but may be set after Ant, Globus, and Tomcat are installed:
- ANT_HOME: Ant installation directory. The caGrid development environment requires this variable, but running caGrid services do not.
- GLOBUS_LOCATION: caGrid Globus 4.0.3 distribution installation directory. This is required by the caGrid development environment and caGrid services that are running in the Globus container.
- CATALINA_HOME: Tomcat installation directory. This is required by the caGrid development environment and is necessary to run the Tomcat container.
Download the installer from http://gforge.nci.nih.gov/frs/?group_id=25 and unzip to a directory of your choosing. The contents of the directory will be:
- caGrid-installer-1.2.jar
- caGrid-installer-1.2.zip
- lib/
o caGrid-1.2-wizard.jar o commons-logging.jar o jce-jdk13-125.jar o log4j-1.2.14.jar o mysql-connectory-java-3.0.16-ga-bin.jar o tools.jar o xmltask-v1.14.jar
- scripts/
o build.xml o resources/
+ spring-beans.dtd + web-app_2_3.dtd + web-facesconfig_1_1.dtd
Change to the directory where you unzipped the file, and start the installer with this command:
java -jar caGrid-installer-1.2.jar
Running the installer
When the installer successfully starts, first you are asked to agree to the caGrid license. If you agree, put a check in I agree and click Next. Then the installer asks which of the following it should do:
- Install caGrid
- Configure Container
- Install caGrid Services
- Install caGrid Portal
For this installation just select Install caGrid. The installer reminds the user to set ANT_HOME and GLOBUS_LOCATION before it exits.
- Keep the mysql root user having blank password (or change back to blank if you have already set a password for root). Likewise, create cagrid mysql user and grant all to it. Password = cagrid.
- Set up so that cagrid user can perform all functions. As root:
cd /etc visudo
Change sudoers file to comment or delete the lines indicated when configuring sudo, and add
cagrid ALL = (ALL) NOPASSWORD : ALL
- Change root password. It is not necessary for anyone to have this password since the cagrid user will be able to sudo and perform all tasks by first issuing the command:
sudo su
without a password required.
