Installation

The installations below have mainly been tested on tomcat versions 5.0.19-5.0.28. But the "Manual Installation" could be carried out on other servlet/j2ee containers. For the purpose of most instructions here the guide will refer to tomcat.

Download Location of war: http://www.astrogrid.org/maven/org.astrogrid/wars/

See astrogrid-community-???.war where ??? is a version number. Look at dates for latest release.

Manual installation/Drop-In - Preferred

Most of the work is in the configure page, for installation.

  • Take the war file and rename it if you do not like the name (be sure to keep the .war ending). Typical names are "astrogrid-community.war" or "community.war"
  • Now simply drop it into the webapps directory under where your tomcat is installed.
  • Tomcat by default should unpack the war file into a directory in that webapps directory. Directory Name should be the same as the war file minus the ".war" part.
  • Your done Read "Database" section below; then go to Configuration.
  • If it does not unpack it then you may have it turned off in your tomcat. This will require you to deploy it through the tomcat manager.
  • Go to your tomcat manager and login. A link is found at the main tomcat page example if tomcat is on the local/same machine with default port set: http://localhost:8080
  • If you relize you don't know how to login, then you will need to view a particular file located where you installed tomcat at: {tomcat install}/conf/tomcat-users.xml
  • Unless your admin has setup tomcat to run on ldap or relational db for users; then this file should give you the username, password, and there roles for logging in.
  • If this is a brand new tomcat then you will need to make a "manager" role and add it to a user or create a user in this file. You should go ahead and add a "admin" as well for configuration purposes later.

CommandLine installer

Most of the work is in the configure page, for installation. This step is quite easy take the war file and drop it into the webapps directory.

Database installatin

  • Find the hsqldb database driver. You can download from here: HSQLDB 1.7.1
  • Place the hsqldb jar into a place that can be located by the servlet container, ex: for tomcat is the common/lib directory is the recommendation, You may elect to put it in your community/WEB-INF/lib but remember you will need to place it back on any upgrading.
  • Restart tomcat this is so that tomcat will pickup this new jar
  • That is all.