Demo Installation Instructions

Summary of steps:

1. Install Pacman
2. Fetch and install grappa-demo
3. Start up XCAT Science Portal

Install Pacman:

The software used in this demo has been packaged up with the Pacman packaging tool developed by Saul Youssef at Boston University. The latest version of Pacman can be downloaded here. Note that you need to use version 1.071 or later.

Fetch and install grappa-demo:

grappa-demo relies on the following packages:

• jdk1.3.1: Java 2 Standard Development Kit
• jakarta-tomcat: Jakarta Tomcat Servlet Container
• jakarta-ant: Jakarta Ant Java based build tool'
• xcatsp: XCAT Science Portal
• jsse: Java Secure Socket Extensions (optional)

By default, the grappa-demo pacman package will install all of the above mentioned packages. We also offer a nojava flavor in case you already have java 1.3 installed. Also, by default, we set up the jakarta-tomcat server to run using the https protocol (this relies on the jsse package). Note, however, due to export restrictions on jsse, this version is only available for users in the US; for non-US users, we set up jakarta-tomcat to use http. The four available "flavors" of grappa-demo are summarized in the below table.

	https	http
java	grappa-demo-https-java	grappa-demo-http-java
nojava	grappa-demo-https-nojava	grappa-demo-http-nojava

Note: grappa-demo is an alias for grappa-demo-https-java.

Once you've chosen your flavor, just type

pacman -fetch -install <flavor>

Depending on your system, you may have to page down during the java installation to view the java license agreement; everything else is automated.

Warning: The java flavor of grappa demo requires approximately 250 MB of space while the nojava flavors require about 90 MB of space.

Start up XCAT Science Portal:

Once Pacman finishes installing grappa-demo, source the new setup.csh file to put all of the new tools in your path. To start the portal, just type portal_startup.sh. This script will start up the jakarta-tomcat server on the first unused port that it finds. It will print out a url of where the XCAT Science Portal is running. Copy and paste that url into the web browser of your choice (there can be a bit of startup time the first time you connect). Note, to enable all features of the XCAT Science Portal, please enable javascript. If you'd like to shutdown the portal, just type portal_shutdown.sh.