Installation Notes

Current documentation status

To see the current status of installation support and documentation for AstroGrid components, please refer to the InstallationSupportMatrix page.

---

Component-specific Installation Notes

Installing FileStore

Please see these notes for installing and configuring the FileStore component.

Installing CEA

Please see these notes for installing and configuring the CEA component.

Installing Filemanager

install filemanger

---

---

Trial deployment: Installing the latest AGINAB (AstroGrid-In-A-Box) kit

Installing the latest AGINAB kit is a good way of testing your tomcat and maven deployments (if you want to deploy AstroGrid components from source), and getting a look at a full set of AstroGrid components all running on your local machine.

AGINAB is not the recommended way of installing individual components for deployment into the public AstroGrid network; it installs a self-contained "mini-AstroGrid" running entirely on your local machine. Components for public deployment should be installed using their own recommended installation procedure.

Use to following steps to download and install the kit.

1. Make sure that you have pre-installed the required software listed in the Installation Requirements page

2. Download the most recent deployment kit - currently version 0.8.0, e.g. to /tmp/deploy-kit-0.8.0.tar.gz

3. Create a directory (e.g. /home/kea/astrogrid), put the deployment kit in it and extract the contents:

    mkdir /home/kea/deploy
    mv /tmp/deploy-kit-0.8.0.tar.gz /home/kea/deploy
    cd /home/kea/deploy
    zcat deploy-kit-0.8.0.tar.gz | tar xf -

This should create a file called "build.properties" and a folder called "astrogrid" containing further folders "maven-base" and "integrationTests" (and possibly a CVS folder, which you can ignore), in the directory where you extracted the development kit contents.

4. Create a working directory for maven to use, e.g. "/home/kea/astrogrid/working" or "/tmp/working", and chmod this directory to 777 (because tomcat needs to be able to write to it for some of the deployment tests).

5. Move the file "build.properties" to your home directory (where maven expects to find it). Open this file with a text editor and change the tomcat username, password, hostname and port to reflect your local tomcat installation. (See Tomcat simple installation notes for details about setting tomcat's admin/management username and password.) Also change the working directory location to match your working directory created above.

6. Change to the directory astrogrid/integrationTests/autoIntegration in your deployment directory (in the example above, /home/kea/deploy/astrogrid/integrationTests/autoIntegration.

7. Run the following command to deploy the full AstroGrid suite of components on your local tomcat installation:

      maven deploy-all

The first time you do this, you'll find that the first thing maven does is download a vast number of jar/war dependencies, which can take a long time if you're on a slow link! It should only need to fetch these once, however; they are then stored in the user's local maven cache.

Eventually you should see a successful deployment message at the end of the maven output, e.g.:

    BUILD SUCCESSFUL
    Total time: 8 minutes 38 seconds
    Finished at: Thu Feb 24 15:04:44 GMT 2005

If the deployment doesn't complete successfully for any reason, try running "maven deploy-all" again. (Often two attempts will be required in a brand-new tomcat installation, for example).

If you experience multiple failures, let us know, and please give us the details from your maven output.

8. Once the maven deployment completes successfully, restart tomcat and then visit the AstroGrid portal you have installed at:

      http://localhost:8080/astrogrid-portal/

(substitute the relevant port number above if you're not running tomcat on the default 8080 port).

You should be able to log in with the following details:

      username:  frog
      password:  qwerty
      community: org.astrogrid.localhost

9. If you want to re-install from scratch, use the following command:

     maven CLEANTOMCAT

to delete the installed webapps. NOTE THAT THIS COMMAND DOESN'T FULLY CLEAN UP AT THE MOMENT - you may need to delete a remaining AstroGrid webapp or two manually, from within the tomcat manager application. Once you have cleaned up, restart tomcat. Note that the above command will also delete your working directory created in step 4 above, so you'll need to recreate it and chmod it to 777 as previously.

More coming soon.

-- CatherineQin / KonaAndrews - 22 Feb 2005