Table of Contents

  1. Prerequisites
  2. Acquire the VM
    1. VMX Image
  3. System Accounts
  4. Network
  5. SSH Access
  6. Dasi Experiment Software Stack
  7. Environment Variables
  8. MySQL
  9. Web Container Configuration
  10. Eclipse

DASI Experiment VM Release Notes

The following steps describe how to install the dasi experiment virtual machine for the simple data service. The dasi-vm is a linux VM with CentOS-5.3 as the operating system.

Prerequisites

Need VMware server and client software to host the VMs. Supported VMware Server platforms to host dasi-vm are:

  • VMware Server -1.0.6 or greater
  • VMware Fusion
  • VMware Player
  • VMware Workstation

VMware Client software to provision the dasi-vm:

  • vmware-server-console

Acquire the VM

  • Download the vm image tarball to the VM image hosting location on your platform.

VMX Image

  • Download the .vmx format vm 
    wget http://138.26.125.70/vm/dasi-vm.tar.gz
  • Unpack the .vmx image 
    tar -xzf dasi-vm.tar.gz
  • This will create a directory dasi-vm that contains the VM description file dasi-vm.vmx. Add this to your VM collection by opening the vmx file via your vmware-server-console interface. Power on the VM inside vmware-server-console.

System Accounts

This VM contains two user accounts.

dasi (passwd - dasi) root (passwd - root)

Change account default passwords with 

passwd dasi

passwd root

Network

A dynamic IP address (NAT) will be assigned to your VM, as soon as you power it on. Find the IP address of your VM through 

/sbin/ifconfig

SSH Access

Once you find the IP address of the dasi-vm, its convenient to continue your work via a terminal, instead of the vmware-server-console. Connect to dasi-vm through ssh as follows: 

ssh -X dasi@ip.addr.givenby.ifconfig

Dasi Experiment Software Stack

The software stack needed for the simple data service has been installed at /home/dasi. The directory structure and location of installed software is as follows: 

 /home/dasi -|
             |---apps---|
                        |---caAdapter
                        |---caGrid
                        |---ws-core-4.0.3
                        |---apache-ant-1.7.0
                        |---argouml-0.26.2 
             |---bin----|
                        |---eclipse 
             |---dist---|
                        |---caCORE_SDK_41-src.tar
                        |---apache-tomcat-5.5.28.zip
             |---src----|
                        |---jdk1.6.0_16
                        |---caCORE_SDK_41
                        |---caGrid-installer-1.3
                        |---apache-tomcat-5.5.28
                        |---eclipse
             |---var----|          
                        |---log

Environment Variables

The env vars for the simple data service software stack have been defined in /home/dasi/.bashrc. The env vars declared are ANT_HOME, GLOBUS_LOCATION, CAGRID_LOCATION, and CATALINA_HOME.

Since, caGrid applications run on Java-1.5, this has been installed on the system and is located at /usr/share/jvm/java. If there is a need to experiment with Java-1.6, this version also has been installed at /home/dasi/src/jdk1.6.0_16. Users can choose to switch from Java-1.5 to Java-1.6 by uncommenting the last two lines in /home/dasi/.bashrc and then source your bashrc i.e., 

source ~/.bashrc

MySQL

MySQL-5.0.77 has been installed on the dasi-vm. MySQL account details: 

user: root
password: root

Web Container Configuration

The default HTTP port for Tomcat and Globus containers is 8080. This results in a port conflict, when web applications are deployed to both Tomcat and Globus containers. Hence the HTTP port for Tomcat is changed to 9080 ($CATALINA_HOME/conf/server.xml) and Globus port remains unchanged at 8080. The firewall (/etc/sysconfig/iptables) has been updated to accept connections from port 9080.

The tomcat manager console is password protected, defined at $CATALINA_HOME/conf/tomcat-users.xml. The login details for tomcat manager console 

username: tomcat
password: tomcat

Please change the default password for tomcat manager console in the above mentioned file.

Eclipse

The Java IDE, Eclipse is installed at /home/dasi/src/eclipse. A symbolic link exists for eclipse at /home/dasi/bin. Invoke eclipse with 

eclipse &

Eclipse has been configured with the Tomcat plugin. So, Tomcat can be started/stopped within Eclipse or from command line 

$CATALINA_HOME/bin/startup.sh

$CATALINA_HOME/bin/shutdown.sh