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 installation

The community webapp is intended to be able to work with any database and hence is expected for you to setup and connect to a known database in your environment. By default the instructions below are for hsqldb, but see the "Configure" page under "Customization" for information on other databases. Below is the sample steps for setting up with hsqldb which is the default installation setup for the community, follow the same steps with your own JDBC (jar/driver) if you use a different database and be sure to see the "Customize" section in the "Configure" page for other databases.

  • 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.