If you tend to install or upgrade AstroGrid components manually (by dropping a WAR file into tomcat), rather than with the automated installers, then this list of steps may be helpful.

In the checklist below, "tomcat" refers to the tomcat that is running the component to be upgraded, and $TOMCAT_HOME is the toplevel directory of this tomcat. Items in brackets () refer to general instructions; items not in brackets refer to explicit shell commands.

• Step 1: (stop tomcat)

• Step 2. cd $TOMCAT_HOME

• Step 3. mkdir webappsOLD

• Step 4. cp -r webapps/astrogrid-xxx webappsOLD

• Step 5. cp conf/Catalina/localhost/astrogrid-xxx.xml webappsOLD

• Step 6. (start tomcat)

• Step 7. (undeploy existing AG application using tomcat manager)

• Step 8. (copy new war into webapps/ and wait for auto-deploy - NB remember to change war filename to match the path where you want to install it - typically just strip off the version number, e.g. cp astrogrid-xxx-1.1.war webapps/astrogrid-xxx.war)

• Step 9. (stop tomcat)

• Step 10. cp webappsOLD/astrogrid-xxx.xml conf/Catalina/localhost/

• Step 11. cp webappsOLD/astrogrid-xxx/WEB-INF/classes/astrogrid.properties webapps/astrogrid-x/WEB-INF/classes/ (NB FILE MAY NOT EXIST)

• Step 12. (Read the upgraded component's documentation to see if any new properties etc need to be set; do what is required)

• Step 13. (start tomcat)