Tags:
create new tag
view all tags

Astrogrid Installation v. 0.90

To view this page as a PDF document, please click here.

Note: The current version of this document for AstroGrid 1.1 is accessible at AstrogridInstallation.

Introduction

The following Astrogrid components have been installed on msslxx:

Registry http://msslxx.mssl.ucl.ac.uk/esdo-registry
Filestore (using GUI installer) http://msslxx.mssl.ucl.ac.uk/esdo-filestore
Filemanager (using GUI installer) http://msslxx.mssl.ucl.ac.uk/esdo-filemanager
JES (using GUI installer) http://msslxx.mssl.ucl.ac.uk/esdo-jes
Portal (using GUI installer) http://msslxx.mssl.ucl.ac.uk/astrogrid-registry
PAL http://msslxx.mssl.ucl.ac.uk/esdo-pal
CEA http://msslxx.mssl.ucl.ac.uk/esdo-cea
Community http://msslxx.mssl.ucl.ac.uk/esdo-community

Registry

Registry Downloads

Registry Installation

Following "standard installation" instructions from http://www.astrogrid.org/maven/docs/0.10.0/registry/multiproject/astrogrid-registry/

  1. Rename war file to esdo-registry.war
  2. Move exist.war into $TOMCAT_HOME/webapps
  3. Move esdo-registry.war into $TOMCAT_HOME/webapps on msslxx
  4. Edit astrogrid.properties in $TOMCAT_HOME/webapps/esdo-registry/WEB-INF/classes. Make sure the following properties are uncommented. Fill in values appropriate to your registry, particularly for org.astrogrid.registry.authorityid and oai.servlet.url.:
    • org.astrogrid.registry.authorityid=esdo.mssl.ucl.ac.uk
    • exist.db.url=http://localhost:8080/exist
    • exist.query.returncount=25
    • oai.servlet.url=http://msslxx.mssl.ucl.ac.uk:8080/esdo-registry/OAIHandlerv0_9
    • org.astrogrid.registry.version=0_10
    • org.astrogrid.registry.harvest.daemon.interval-hours=1
    • registry.harvest.enabled=true required
    • registry.harvest.onload=false
    • declare.namespace.0_9=declare namespace vr = "http://www.ivoa.net/xml/VOResource/v0.9"; declare namespace vc = "http://www.ivoa.net/xml/VOCommunity/v0.2"; declare namespace vg = "http://www.ivoa.net/xml/VORegistry/v0.2"; declare namespace vs = "http://www.ivoa.net/xml/VODataService/v0.4"; declare namespace vt = "http://www.ivoa.net/xml/VOTable/v0.1"; declare namespace cs = "http://www.ivoa.net/xml/ConeSearch/v0.2"; declare namespace sia = "http://www.ivoa.net/xml/SIA/v0.6"; declare namespace cea="http://www.ivoa.net/xml/CEAService/v0.1"; declare namespace ceapd="http://www.astrogrid.org/schema/AGParameterDefinition/v1";
    • keyword.query.path.0_9=vr:Summary/vr:Description, vr:Title, vr:Subject
    • identifier.path.hasauthorityid.0_9=true
  5. Restart Tomcat

Registry Configuration

  1. Enter Tomcat admin page (http://msslxx.mssl.ucl.ac.uk:8080/admin/)
  2. Edit eSDO environment variables: click through Tomcat Server -> Service -> Host (localhost) -> Context (/esdo-registry) -> Resources -> Environment Entries. Click on the name of each variable to fill in values approriate to your registry. Please note that each registry should manage a unique authorityID, so be sure to edit the value for reg.amend.authorityid:
  3. Click "Commit Changes" button when all variables have been updated
  4. Test configuration: go to http://msslxx.mssl.ucl.ac.uk:8080/esdo-registry. You should see a welcome page with the authority ID you entered on the Tomcat admin page.
  5. Registry registration: go to http://msslxx.mssl.ucl.ac.uk:8080/esdo-registry/admin/index.jsp and login (you should be able to use your Tomcat admin username / password)
    • Self-register the registry:
      • Click "Self Registration" and fill in appropriate values:
        • First box: enter 0.10
        • Authority ID: esdo.mssl.ucl.ac.uk
        • Title: eSDO Registry
        • Publisher: MSSL
        • Contact Name: Elizabeth Auden
        • Contact email: eca@mssl.ucl.ac.uk
      • Press "Submit" - the page will redirect to a generated VOResources XML entry describing the registry. Ensure that all settings are correct (note: you may need to change interface xsi:type="WebService" to interface xsi:type="vs:WebService"). An example entry is attached at the bottom of this page.
      • Check the "Validate" box and click "Register".
    • Optional: Register with other registries
      • Try this first: click "Register with other Registries", and on the next page click the "Set up harvesting by hydra" button.
      • If you get an error of response=500, go on to the following steps.
      • Go to the Astrogrid galahad registry page at http://capc49.ast.cam.ac.uk/galahad-registry/editEntry.jsp
      • Paste your generated registry entry from the self-registration step into the large textbox under "Upload from text", check "Validate", and click "Submit".
      • The galahad registry will pick up your registry entry the next time it performs an automatic harvest (every 2 - 24 hours)
    • Optional: Harvesting other Registries
  6. Optional: reconfigure the eXist database out of the registry webapps area. This has the advantage that if you undeploy the registry webapp (during an upgrade, for example), the entries in your eXist DB will not be lost.
    • Follow "Using eXist internally" instructions on http://msslxx.mssl.ucl.ac.uk:8080/esdo-registry/configure.jsp
    • Create a new directory (outside the Tomcat directory structure if you wish): for example, $HOME/Astrogrid/exist-configuration
    • Copy $TOMCAT/webapps/esdo-registry/WEB-INF/exist.xml to the new directory
    • Copy $TOMCAT/webapps/esdo-registry/WEB-INF/data to the new directory
    • Go to the Tomcat admin page and click through Tomcat Server -> Service -> Host (localhost) -> Context (/esdo-registry) -> Resources -> Environment Entries. Edit variable reg.custom.exist.configuration to the full path to the exist.xml file you just copied. Click "Commit Changes".

Registry Test

  1. Go to the registry home page at http://msslxx.mssl.ucl.ac.uk:8080/esdo-registry
  2. Click "browse" - you should see a table containing resources with entries in your registry
  3. Click on "XML" next to any resource entry; you should see a valid XML GetResourcesByIdentifier entry for the resource.

Filestore

Filestore Downloads

Filestore Installation

  1. For GUI installation: open the directory where astrogrid-filestore-installer-0.10-b000fs.jar is located, and type java -jar astrogrid-filestore-installer-0.10-b000fs.jar.
  2. The Astrogrid Filestore Installer GUI should appear on your screen. Click "Next".
  3. Select the filestore installer tasks (first time: check "Install Filestore", "Register this filestore" and "Save configuration.") Click "Next". Now fill in the following values on successive screens:
    • Filestore repository: $HOME/Astrogrid/filestore/repository, "Next"
    • Tomcat running: click continue, "Next"
    • Tomcat URL: http://msslxx.mssl.ucl.ac.uk:8080
    • Tomcat manager user: , "Next"
    • Tomcat manager password: , "Next"
    • Context path: esdo-filestore, "Next"
    • Authority: esdo.mssl.ucl.ac.uk, "Next"
    • Registry key: esdo-filestore, "Next"
    • Registry URL: http://msslxx.mssl.ucl.ac.uk:8080/esdo-registry/
    • Filename for current settings: $HOME/Astrogrid/filestore-installer.properties
  4. Click "Next" and then "Done"

Filestore Configuration

  1. Go to http://msslxx.mssl.ucl.ac.uk:8080/esdo-filestore
  2. Click "Configure" or "Configure / Install"
  3. Open Tomcat administration GUI at http://msslxx.mssl.ucl.ac.uk:8080/admin
  4. Edit eSDO filestore environment variables: click through Tomcat Server -> Service -> Host (localhost) -> Context (/esdo-filestore) -> Resources -> Environment Entries. Click on the name of each variable to fill in values approriate to your filestore (most values should have been correctly populated by the installer):
  5. Click "Commit Changes"
  6. Go back to http://msslxx.mssl.ucl.ac.uk:8080/esdo-filestore and click
    FileStore Administration"
  7. Click "Register Metadata" under "Setup"
  8. Choose "0.10" and enter a contact name and email address. Click "Submit"
  9. You should see the auto-generated VOResources entry for your filestore. Check through the XML to make sure everything is correct and click "Register."
  10. You'll be returned to the same page showing a text box with the registry entry - if there are no errors printed at the top of the page, the filestore has been successfully configured.

Filestore Test

  1. From the filestore admin page at http://msslxx.mssl.ucl.ac.uk:8080/esdo-filestore/admin, click "Self Test" under "Configure"
  2. Open a terminal window and either run tail -f $TOMCAT_HOME/logs/catalina.out or look at the directory holding your filestore repository, such as $HOME/Astrogrid/filestore/repository.
  3. Click "Test"
  4. If the self test runs successfully, the repository directory will now contain 11 test files. Catalina.out will display a number of debug messages regarding open and closed streams.

Filemanager

Filemanager Downloads

Filemanager Installation

  1. For GUI installation: open the directory where astrogrid-filemanager-installer-0.10-b000fm.jar is located, and type java -jar astrogrid-filemanager-installer-0.10-b000fm.jar.
  2. The Astrogrid Filemanager Installer GUI should appear on your screen. Click "Next".
  3. Select the filemanager installer tasks (first time: check "Install the AstroGrid Filemanager", "Register this Filemanager" and "Save Settings.") Click "Next"
  4. Make sure that Tomcat is running on your system, then click "continue" and "Next". Now fill in the following values on successive screens:
    • URL of Tomcat: http://msslxx.mssl.ucl.ac.uk:8080, "Next"
    • Tomcat manager user: , "Next"
    • Tomcat manager password: , "Next"
    • Ivorn of local filestore: ivo://esdo.mssl.ucl.ac.uk/esdo-filestore, "Next"
    • Context path: /esdo-filemanager, "Next"
    • Authority: esdo.mssl.ucl.ac.uk, "Next"
    • Registry key: esdo-filemanager, "Next"
    • Filemanager repository: $HOME/Astrogrid/filemanager/repository, "Next"
    • URL of registry: http://msslxx.mssl.ucl.ac.uk:8080/esdo-registry/, "Next"
    • Contact name: Elizabeth Auden, "Next"
    • Contact email: eca@mssl.ucl.ac.uk, "Next"
    • Filename for current settings: $HOME/Astrogrid/filemanager-installer.properties, "Next"

Filemanager Configuration

  1. Go to Filemanager home page at http://msslxx.mssl.ucl.ac.uk:8080/esdo-filemanager
  2. Click "File Manager Administration"
  3. Look at the lefthand menu, under "Setup" click "Register Metadata"
  4. On the registration page, select "0.10", enter a contact name and email address, and optionally click "Add Authority Resource" (don't click this box if you added a new authorityID when you set up your registry). Click "Submit".
  5. You should see a textbox containing an auto-generated VOResources entry for the Filemanager. Check the XML to make sure there are no errors and click "Register". Note: this page will state the Astrogrid registry with which your Filemanager will be registered (hydra as of 26/04/05). Make sure that the authority ID you use is registered with this registry.
  6. Note: if the previous registration step did not work, try this instead: (Fix added by ECA on 27/04/05)
    • Open a terminal and open $TOMCAT_HOME/conf/Catalina/localhost/esdo-filestore.xml in a text editor.
    • Copy the variable entries for org.astrogrid.registry.admin.endpoint and org.astrogrid.registry.query.endpoint
    • Paste these two variables into the esdo-filemanager.xml file.
    • Refresh the Tomcat admin GUI to make sure that the new environment variables have been picked up for filemanager.
    • Return to the filemanager admin page at http://msslxx.mssl.ucl.ac.uk:8080/esdo-filemanager/admin
    • Click on "Register Metadata" under "Setup"
    • Select 0.10 and fill in a contact name and email address. Click "Submit"
    • You'll see a textbox containing the auto-generated VOResources entry for your filemanager. The top of the page should now say "You will be publishing this at: http://localhost:8080/esdo-registry/services/RegistryUpdate". Click "Register".
    • You should now be returned to the same page displaying the textbox XML entry with no errors printed at the top.

Filemanager Test

  1. Currently there is no self-test for filemanager, but go to http://msslxx.mssl.ucl.ac.uk:8080/esdo-filemanager/admin and click "Fingerprint" under "Configure" to see a generated report of the filemanager system.

JES

JES Downloads

JES Installation

  1. For GUI installation: open the directory where astrogrid-jes-installer-0.10-b000j.jar is located, and type java -jar astrogrid-portal-installer-0.10-b000j.jar.
  2. The Astrogrid JES Installer GUI should appear on your screen. Click "Next".
  3. Select the JES installer tasks (first time: check "Install the JES" and "Save this configuration.") Click "Next".
  4. Make sure that Tomcat is running on your system, then click "continue" and "Next". Now fill in the following values on successive screens:
  5. Click "Next" and then "Done."

JES Configuration

  1. Go to http://msslxx.mssl.ucl.ac.uk:8080/esdo-jes.
  2. Under "Installation Checks" in the lefthand menu, click "Installation Tests". You should see 7 green checks and no red x's.
  3. Further configuration variables can be set through the JNDI interface or in $TOMCAT/onf/Catalina/localhost. All variables have defaults, but one was changed in this configuration of JES:
    • jes.monitor.endpoint.url=http://msslxx.mssl.ucl.ac.uk:8080/esdo-jes/services/JobMonitorService

JES Test

  1. Go to http://msslxx.mssl.ucl.ac.uk:8080/esdo-jes/query-form.html
  2. Submit a sample workflow in the textbox and click "Submit". (don't have a sample workflow as of 26/04/05)

JES Troubleshooting

  1. Make sure that astrogrid-utils-rev.jar is included in the /esdo-jes/WEB-INF/lib directory; its absence could cause problems generating workflows. This problem was detected on 12 May 2005 and should be resolved in future astrogrid-jes*.war releases.

Portal

Portal Downloads

Portal Installation

  1. For GUI installation: open the directory where astrogrid-portal-installer-0.10-b000p.jar is located, and type java -jar astrogrid-portal-installer-0.10-b000p.jar. Note: if you get an "out of Memory" error during installation, try running java -Xmx128m -jar astrogrid-portal-installer-0.10-b000p.jar instead.
  2. The Astrogrid Portal Installer GUI should appear on your screen. Click "Next".
  3. Select the portal installer tasks (first time: check "Install the AstroGrid Portal" and "Save Settings.") Click "Next".
  4. Make sure that Tomcat is running on your system, then click "yes" and "Next". Now fill in the following values on successive screens:
  5. Click "Next" and "Done".

Portal Configuration

  1. To customize the portal, run java -jar astrogrid-portal-installer-0.10-b000p.jar again.
  2. After clicking "Next", check the boxes for "Customize portal" and "save settings."
  3. Location of jpeg: click "Browse" and select an image like portal_background.gif from your directory. "Next"
  4. Click "Next" and "Done"
  5. You can sneakily change the portal background picture by renaming any JPEG image to "loginBackground.jpg" and placing a copy in $TOMCAT/webapps/astrogrid-portal/web/images.

Portal Test

  1. Go to http://msslxx.mssl.ucl.ac.uk:8080/astrogrid-portal: you should see the Astrogrid login screen with either your background image or the Astrogrid background image
  2. First, test that new users can request registration - click "register"
    • In the AstroGrid Registration box, fill in your name and email address, and click "Register"
    • Note: if you receive an error message:
      • Check $TOMCAT/logs/portal-astrogrid.log - look for a message in this or any of the logs that says "javax.activation.UnsupportedDataTypeException: no object DCH for MIME type text/plain"
      • If the above error occurs, then see how many copies of activation.jar and mail.jar are in your Tomcat system. $TOMCAT/astrogrid-port/WEB-INF/lib includes activation-1.0.2.jar and mail-1.3.1.jar.
      • If other copies of any version of these jar files exist ($TOMCAT/common/libs is a good culprit), try deleting, moving, or renaming the copies not in astrogrid-portal/WEB-INF/lib. Restart Tomcat, try requresting registration again, and see if the problem disappears.

Portal troubleshooting

  1. Make sure that astrogrid-utils-rev.jar is included in the /astrogrid-portal/WEB-INF/lib directory; its absence could cause problems generating workflows. This problem was detected on 12 May 2005 and should be resolved in future astrogrid-portal*.war releases.

Community

Community Downloads

Community Installation

See instructions at http://www.astrogrid.org/maven/docs/0.10/community/multiproject/astrogrid-community/index.html

  1. Rename astrogrid-community-0.10-b000ct.war to esdo-community.war
  2. Copy esdo-community.war into $TOMCAT/webapps
  3. Download the jsqldb database driver from http://www.astrogrid.org/maven/hsqldb/jars/hsqldb-1.7.1.jar
  4. Copy hsqldb-1.7.1.jar into $TOMCAT/common/lib

Community Configuration

  1. Open the Tomcat administration GUI
  2. Edit eSDO community environment variables: click through Tomcat Server -> Service -> Host (localhost) -> Context (/esdo-community) -> Resources -> Environment Entries. Edit the variables approriate to your community (note: if your Tomcat admin GUI will only allow values < 70 characters, edit $TOMCAT/conf/Catalina/localhost/esdo-community.xml instead):
  3. Click "Commit Changes"
  4. Edit the eSDO data source variables: click through Tomcat Server -> Service -> Host (localhost) -> Context (/esdo-community) -> Resources -> Environment Entries. Click jdbc/org.astrogrid.community.database and edit the following variableds:
    • Data Source URL: jdbc:hsqldb:/home/griduser/Astrogrid/community/org.astrogrid.community
    • JDBC Driver Class: org.hsqldb.jdbcDriver
    • User Name: sa
    • Password:
  5. Click "save" and "commit changes"
  6. Go to http://msslxx.mssl.ucl.ac.uk:8080/esdo-community, click "Admin", and enter the Tomcat admin username and password when prompted
  7. For first time configuration, database report should NOT be healthy. Click "Reset DB".
  8. Click "Reset" - message should return saying DB is healthy with value "true".
  9. Click "Register Metadata"
  10. Click "Submit" and you should see a textbox containing the VOResources entry for your community - there will be Resource entries for a number of community services.
  11. Once you have ensured that the XML is correct, hit "Register". The community will be registered with the registry endpoint you specified in the environment entries, and you will be returned to the self-registration page.

Community Test

  1. Test the community by adding an account for yourself.
  2. Go to http://msslxx.mssl.ucl.ac.uk:8080/esdo-community/admin, and click "Account" under "Administration"
  3. In the Add Account page, fill in Username, Display Name, Password, Description, and e-mail. Leave Home Space blank when you are adding a user - this will allow their home space area to be creating automatically.
  4. Press "Add" - you should get a blue message stating that the account was added. The account information will now appear under "list of accounts".
  5. Now go to the portal at http://msslxx.mssl.ucl.ac.uk:8080/astrogrid-portal and log in.

CEA

CEA Downloads

CEA Installation

See instructions at http://www.astrogrid.org/maven/docs/HEAD/applications.

  1. Rename astrogrid-cea-commandline-0.10-b000a.war to esdo-cea.war
  2. Copy esdo-cea.war to $TOMCAT/webapps

CEA Commandline Configuration

  1. Go to http://msslxx.mssl.ucl.ac.uk:8080/esdo-cea
  2. Open the Tomcat administration GUI
  3. Edit eSDO cea environment variables: click through Tomcat Server -> Service -> Host (localhost) -> Context (/esdo-cea) -> Resources -> Environment Entries. Select "Create new env entry" from "Available actions" and add the following new variables (as java.lang.Strings) approriate to your commandline application tools (note: if your Tomcat admin GUI cannot accept values greater than 70 characters, edit these properties in $TOMCAT/conf/Catalina/localhost/esdo-cea.xml):
  4. Click "Commit Changes"
  5. Create the esdoCeaRegistry.xml file specified above in home/griduser/Astrogrid/applications. An example is attached to this page.
  6. Create the esdo.mssl.ucl.ac.uk.xml file specified above in home/griduser/Astrogrid/applications. An example is attached to this page.
  7. Install the commandline application you wish to use as a CEA tool. Specify the application name, input variable types, and output variable types in esdoCeaRegistry.xml and esdo.mssl.ucl.ac.uk. Notes:
    • Currently repeatable input parameters can be specified, but a specific number of output parameters must be declared.
    • Input and output types can be complex, double, text, boolean, anyURI, anyXML, VOTable, RA, Dec, ADQL, binary, or FITS.
  8. For more information on configuring the esdo.mssl.ucl.ac.uk.xml file, please see http://msslxx.mssl.ucl.ac.uk:8080/esdo-cea/provider/ApplicationConfigruation.html.
  9. All new CEA applications can be declared in the same esdoCeaRegistry.xml and esdo.mssl.ucl.ac.uk.xml files.

CEA Test

  1. Open a terminal and make sure that directory you specified in cea.commandline.workingdir.file exists; create this directory if it doesn't.
  2. Go to http://msslxx.mssl.ucl.ac.uk:8080/esdo-cea
  3. First click "Fingerprint" under "Installation" - you should see the system report including a description of your applications and a VODescription of the CEA commandline component.
  4. Next, click "Installation Tests" under "Installation". You should see 4 integration tests with green checkmarks indicating "Passed".

-- ElizabethAuden - 28 Apr 2005

-- ElizabethAuden - 15 Sep 2005

Edit | Attach | Watch | Print version | History: r1 | Backlinks | Raw View | More topic actions
Topic revision: r1 - 2005-09-15 - ElizabethAuden
 
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 2008-2019 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback