-- MikeSmith - 28 Sep 2005

Astrogrid Installation version 1.1

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 (using GUI installer) 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-portal
PAL http://msslxx.mssl.ucl.ac.uk/esdo-pal
CEA (using GUI installer) http://msslxx.mssl.ucl.ac.uk/esdo-cea
Community http://msslxx.mssl.ucl.ac.uk/esdo-community

Registry

Registry Downloads

  1. Go to the AstroGrid home page at http://www.astrogrid.org
  2. Click "AstroGrid V1.1 Release"
  3. On displayed page, click "Download and Install AstroGrid Services"
  4. On displayed page, click "Download Installers"
  5. On displayed page, click "Registry"
  6. On displayed page, click "astrogrid-registry-installer-1.1-000r.jar"

Registry Installation

  1. Move exist.war into $TOMCAT_HOME/webapps
  2. For GUI installation: open the directory where astrogrid-registry-installer-1.1-000r.jar is located, and type java -jar astrogrid-filestore-registry-1.1-b000r.jar.
  3. The Astrogrid Registry Installer GUI should appear on your screen. Click "Next".

First time installation:

  1. Select following Registry Installer options:
    • "Install an AstroGrid Registry"
    • "Self-register this registry"
    • "Add a managed authority ID" (optional)
    • "Save this configuration for future use"

  2. Click "Next" and then enter appropriate values on successive screens:
    (eSDO values highlighted in blue for reference - usernames and passwords not given)
    • Ensure Tomcat is running on your target system with the Manager app. enabled: select "continue" then click "Next"
    • Please enter the URL of Tomcat on your system: http://msslxx.mssl.ucl.ac.uk:8080/, then click "Next"
    • Please enter the Tomcat manager username: TOMCAT manager username, then click "Next"
    • Please enter the Tomcat manager password: TOMCAT manager password, then click "Next"
    • Please enter the context path on the webserver for registry: esdo-registry, then click "Next"
    • Is this the correct public URL for the registry ? Please amend if you are using a proxy : http://msslxx.mssl.ucl.ac.uk:8080/esdo-registry/, then click "Next"
    • Please enter the Authority ID for this registry: esdo.mssl.ucl.ac.uk, then click "Next"
    • Enter a title for the registry: eSDO registry, then click "Next"
    • Enter a contact name for the registry: Elizabeth Auden, then click "Next"
    • Enter a contact email for the registry: eca@mssl.ucl.ac.uk, then click "Next"
    • Enter a file name for saving your current settings: $HOME/Astrogrid/registry-installer.properties, then click "Next"

  3. Check that a second Installer GUI pops-up upon completion of the installation and contains the line: "The reinstallation process is now complete"
  4. Click "Next" and then "Done"
  5. Restart TOMCAT

Installation is now complete. Proceed to Registry Configuration steps.

Updating existing installation:

  1. Select the following Registry Installer options:
    • "Load a previously saved configuration"
    • "Remove an existing AstroGrid registry"
    • "Install an AstroGrid registry"
    • "Self-register this registry"
    • "Save this configuration for future use"

  2. Click "Next":
  3. A pop-up is displayed with the words: "Enter the filename of your previously saved settings". Enter $HOME/Astrogrid/registry-installer.properties, "Next"
  4. Check that installation progress is displayed in textbox area of installer GUI.
  5. Check that a second Installer GUI pops-up upon completion of the installation and contains the line: "The reinstallation process is now complete"
  6. Click "Next" and then "Done"

Update installation is now complete using previous configuration settings. To check settings, and modify if necessary, follow steps in Registry Configuration.

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. Some of the values shown are taken from the those supplied by the user during the GUI installation, others are defaults automatically provided by the component installer. The values of some of the eSDO Registry environment variables are shown below. Please note that each registry should manage a unique authorityID, so be sure to edit the value for reg.amend.authorityid:

  3. To amend an environment entry, click on the corresponding variable and modify as necessary.
  4. Click "Commit Changes" button when all variables have been updated
  5. 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.
  6. 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
  7. 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

  1. Go to the AstroGrid home page at http://www.astrogrid.org
  2. Click "AstroGrid V1.1 Release"
  3. On displayed page, click "Download and Install AstroGrid Services"
  4. On displayed page, click "Download Installers"
  5. On displayed page, click "FileStore"
  6. On displayed page, click "astrogrid-filestore-installer-1.1-000fs.jar"

FileStore Installation

  1. For GUI installation: open the directory where astrogrid-filestore-installer-1.1-000fs.jar is located, and type java -jar astrogrid-filestore-installer-1.1-b000fs.jar.
  2. The Astrogrid Filestore Installer GUI should appear on your screen. Click "Next".

First time installation:

  1. Select following FileStore Installer options:
    • "Install FileStore"
    • "Register this FileStore"
    • "Save this configuration for future use"

  2. Click "Next" and then enter appropriate values on successive screens:
    (eSDO values highlighted in blue for reference - usernames and passwords not given)
    • Tomcat running: click "continue" then click "Next"
    • FileStore repository: $HOME/Astrogrid/filestore/repository, then click "Next"
    • Tomcat URL: http://msslxx.mssl.ucl.ac.uk:8080, then click "Next"
    • Tomcat manager user: TOMCAT manager username, then click "Next"
    • Tomcat manager password: TOMCAT manager password, then click "Next"
    • Context path: esdo-filestore, then click "Next"
    • Authority: esdo.mssl.ucl.ac.uk, then click "Next"
    • Registry key: esdo-filestore, then click "Next"
    • Registry URL: http://msslxx.mssl.ucl.ac.uk:8080/esdo-registry/, then click "Next"
    • Filename for current settings: $HOME/Astrogrid/filestore-installer.properties, then click "Next"

  3. Check that a second Installer GUI pops-up upon completion of the installation and contains the line: "The reinstallation process is now complete"
  4. Click "Next" and then "Done"

Installation is now complete. Proceed to FileStore Configuration steps.

Updating existing installation:

  1. Select following FileStore Installer options:
    • "Load a previously saved configuration"
    • "Remove FileStore (...)"
    • "Install FileStore"
    • "Register this FileStore"
    • "Save this configuration for future use"

  2. Click "Next":
  3. A pop-up is displayed with the words: "Enter the filename of your previously saved settings". Enter $HOME/Astrogrid/filestore-installer.properties, then click "Next"
  4. Check that installation progress is displayed in textbox area of installer GUI.
  5. Check that a second Installer GUI pops-up upon completion of the installation and contains the line: "The reinstallation process is now complete"
  6. Click "Next" and then "Done"

Update installation is now complete using previous configuration settings. To check settings, and modify if necessary, follow steps in FileStore Configuration.

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 appropriate 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

  1. Go to the AstroGrid home page at http://www.astrogrid.org
  2. Click "AstroGrid V1.1 Release"
  3. On displayed page, click "Download and Install AstroGrid Services"
  4. On displayed page, click "Download Installers"
  5. On displayed page, click "FileManager"
  6. On displayed page, click "astrogrid-filemanager-installer-1.1-000fm.jar"

FileManager Installation

  1. For GUI installation: open the directory where astrogrid-filemanager-installer-1.1-000fm.jar is located, and type java -jar astrogrid-filemanager-installer-1.1-000fm.jar.
  2. The Astrogrid Filemanager Installer GUI should appear on your screen. Click "Next".

First time installation:

  1. Select following FileManager Installer options:
    • "Install FileManager"
    • "Register this FileManager"
    • "Save this configuration for future use"

  2. Click "Next" and then enter appropriate values on successive screens:
    (eSDO values highlighted in blue for reference - usernames and passwords not given)
    • Tomcat running: click "continue" then "Next"
    • URL of Tomcat: http://msslxx.mssl.ucl.ac.uk:8080, then click "Next"
    • Tomcat manager user: TOMCAT manager username, then click "Next"
    • Tomcat manager password: TOMCAT manager password, then click "Next"
    • Ivorn of local filestore: ivo://esdo.mssl.ucl.ac.uk/esdo-filestore, then click "Next"
    • Context path: esdo-filemanager, then click "Next"
    • Authority: esdo.mssl.ucl.ac.uk, then click "Next"
    • Registry key: esdo-filemanager, then click "Next"
    • Filemanager repository: $HOME/Astrogrid/filemanager/repository, then click "Next"
    • URL of registry: http://msslxx.mssl.ucl.ac.uk:8080/esdo-registry/, then click "Next"
    • Contact name: Elizabeth Auden, then click "Next"
    • Contact email: eca@mssl.ucl.ac.uk, then click "Next"
    • Filename for current settings: $HOME/Astrogrid/filemanager-installer.properties, then click "Next"

  3. Check that a second Installer GUI pops-up upon completion of the installation and contains the line: "The reinstallation process is now complete"
  4. Click "Next" and then "Done"

Installation is now complete. Proceed to FileManager Configuration steps.

Updating existing installation:

  1. Select following FileManager Installer options:
    • "Load a previously saved configuration"
    • "Remove FileManager"
    • "Install FileManager"
    • "Register this FileManager"
    • "Save this configuration for future use"

  2. Click "Next":
  3. A pop-up is displayed with the words: "Enter the filename of your previously saved settings". Enter $HOME/Astrogrid/filemanager-installer.properties, "Next"
  4. Check that installation progress is displayed in textbox area of installer GUI.
  5. Check that a second Installer GUI pops-up upon completion of the installation and contains the line: "The reinstallation process is now complete"
  6. Click "Next" and then "Done"

Update installation is now complete using previous configuration settings. To check settings, and modify if necessary, follow steps in FileManager Configuration.

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

  1. Go to the AstroGrid home page at http://www.astrogrid.org
  2. Click "AstroGrid V1.1 Release"
  3. On displayed page, click "Download and Install AstroGrid Services"
  4. On displayed page, click "Download Installers"
  5. On displayed page, click "JES"
  6. On displayed page, click "astrogrid-jes-installer-1.1-000j.jar"

JES Installation

  1. For GUI installation: open the directory where astrogrid-jes-installer-1.1-000j.jar is located, and type java -jar astrogrid-jes-installer-1.1-000j.jar.
  2. The Astrogrid Filestore Installer GUI should appear on your screen. Click "Next".

First time installation:

  1. Select following JES Installer options:
    • "Install JES"
    • "Save this configuration for future use"

  2. Click "Next" and then enter appropriate values on successive screens:
    (eSDO values highlighted in blue for reference - usernames and passwords not given)
    • Tomcat running: click "continue" then "Next"
    • URL of Tomcat: http://msslxx.mssl.ucl.ac.uk:8080, then click "Next"
    • Tomcat manager user: TOMCAT manager username, then click "Next"
    • Tomcat manager password: TOMCAT manager password, then click "Next"
    • Context path: esdo-jes, then click "Next"
    • JES working directory: $HOME/Astrogrid/jes, then click "Next"
    • URL of registry: http://msslxx.mssl.ucl.ac.uk:8080/esdo-registry/, then click "Next"
    • Filename for current settings: $HOME/Astrogrid/jes-installer.properties, then click "Next"

  3. Check that a second Installer GUI pops-up upon completion of the installation and contains the line: "The reinstallation process is now complete"
  4. Click "Next" and then "Done"

Installation is now complete. Proceed to JES Configuration steps.

Updating existing installation:

  1. Select following JES Installer options:
    • "Load a previously saved configuration"
    • "Remove JES (does not remove the JES working dir)"
    • "Install JES"
    • "Save this configuration for future use"

  2. Click "Next":
  3. A pop-up is displayed with the words: "Enter the filename of your previously saved settings". Enter $HOME/Astrogrid/jes-installer.properties, then click "Next"
  4. Check that installation progress is displayed in textbox area of installer GUI.
  5. Check that a second Installer GUI pops-up upon completion of the installation and contains the line: "The reinstallation process is now complete"
  6. Click "Next" and then "Done"

Update installation is now complete using previous configuration settings. To check settings, and modify if necessary, follow steps in JES Configuration.

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

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

  1. Go to the AstroGrid home page at http://www.astrogrid.org
  2. Click "AstroGrid V1.1 Release"
  3. On displayed page, click "Download and Install AstroGrid Services"
  4. On displayed page, click "Download Installers"
  5. On displayed page, click "Portal"
  6. On displayed page, click "astrogrid-portal-installer-1.1-000p.jar"

Portal Installation

  1. For GUI installation: open the directory where astrogrid-portal-installer-1.1-000p.jar is located, and type java -jar astrogrid-portal-installer-1.1-000p.jar. Note: if you get an "out of Memory" error during installation, try running java -Xmx128m -jar astrogrid-portal-installer-1.1-000p.jar instead.
  2. The Astrogrid Portal Installer GUI should appear on your screen. Click "Next".

First time installation:

  1. Select following Portal Installer options:
    • "Install the AstroGrid Portal"
    • "Save your settings for next time"

  2. Click "Next" and then enter appropriate values on successive screens:
    (eSDO values highlighted in blue for reference - usernames and passwords not given)
    • Tomcat running: click "continue" then "Next"
    • URL of Tomcat: http://msslxx.mssl.ucl.ac.uk:8080, then click "Next"
    • Tomcat manager user: TOMCAT manager username, then click "Next"
    • Tomcat manager password: TOMCAT Manager password , then click "Next"
    • URL of registry endpoint: http://msslxx.mssl.ucl.ac.uk:8080/esdo-registry/, then click "Next"
    • Location of JES: http://msslxx.mssl.ucl.ac.uk:8080/esdo-jes, then click "Next"
    • Location of SMTP server: mail.mssl.ucl.ac.uk, then click "Next"
    • SMTP username: SMTP username, then click "Next"
    • SMTP password: SMTP password, then click "Next"
    • Filename for current settings: $HOME/Astrogrid/portal-installer.properties, then click "Next"

  3. Check that a second Installer GUI pops-up upon completion of the installation and contains the line: "The reinstallation process is now complete"
  4. Click "Next" and then "Done"

Installation is now complete. Proceed to Portal Configuration steps.

Updating existing installation:

  1. Select following Portal Installer options:
    • "Load a previously saved configuration"
    • "Uninstall the AstroGrid Portal"
    • "Customise the login page background"
    • "Install the AstroGrid Portal"
    • "Save your settings for next time"

  2. Click "Next":
  3. A pop-up is displayed with the words: "Enter the filename of your previously saved settings". Enter $HOME/Astrogrid/portal-installer.properties, then click "Next"
  4. Check that installation progress is displayed in textbox area of installer GUI.
  5. Check that a second Installer GUI pops-up upon completion of the installation and contains the line: "The reinstallation process is now complete"
  6. Click "Next" and then "Done"

Update installation is now complete using previous configuration settings. To check settings, and modify if necessary, follow steps in Portal Configuration.

Portal Configuration

  1. To customize the portal, run java -jar astrogrid-portal-installer-1.1-000p.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

Note
No installer available for this component

Community Installation

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

  1. Rename astrogrid-community-1.0.1-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 appropriate 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

  1. Go to the AstroGrid home page at http://www.astrogrid.org
  2. Click "AstroGrid V1.1 Release"
  3. On displayed page, click "Download and Install AstroGrid Services"
  4. On displayed page, click "Download Installers"
  5. On displayed page, click "CEA"
  6. On displayed page, click "astrogrid-cea-installer-1.1-000a.jar"

CEA Installation

  1. For GUI installation: open the directory where astrogrid-cea-installer-1.1-000a.jar is located, and type java -jar astrogrid-cea-installer-1.1-000a.jar
  2. The Astrogrid CEA Installer GUI should appear on your screen. Click "Next".

First time installation:

  1. Select following CEA Installer options:
    • "Install cea"
    • "Register this cea"
    • "Save this configuration for future use"

  2. Click "Next" and then enter appropriate values on successive screens:
    (eSDO values highlighted in blue for reference - usernames and passwords not given)
    • Ensure Tomcat is running on your target system with the Manager app. enabled: select "continue" then click "Next"
    • Please enter the URL of Tomcat on your system: http://msslxx.mssl.ucl.ac.uk:8080/, then click "Next"
    • Please enter the Tomcat manager username: TOMCAT manager username, then click "Next"
    • Please enter the Tomcat manager password: TOMCAT manager password, then click "Next"
    • Which flavour of CEA do you wish to (un)install ?: select commandline then click "Next"
    • Please enter the context path on the webserver for cea: esdo-cea, then click "Next"
    • Please enter the location of your working directory: /home/griduser/Astrogrid/applications/cea/commandline/work, then click "Next"
    • Please enter the URL of your registry: http://msslxx.mssl.ucl.ac.uk:8080/esdo-registry/, then click "Next"
    • Please enter the Authority under which this CEA will be registered: esdo.mssl.ucl.ac.uk, then click "Next"
    • Please enter the registry key for this CEA server: file:///home/griduser/Astrogrid/applications/esdoCeaRegistry.xml, then click "Next"
    • Enter a contact name for the registry: Elizabeth Auden, then click "Next"
    • Please locate the commandline config file for this cea: home/griduser/Astrogrid/applications/esdo.mssl.ucl.ac.uk.xml, then click "Next"
    • Please enter the contact name you wish to put in the registry: Elizabeth Auden, then click "Next"
    • Please enter the contact email you wish to put in the registry: eca@mssl.ucl.ac.uk, then click "Next"
    • Enter a file name for saving your current settings: $HOME/Astrogrid/registry-installer.properties, then click "Next"

  3. Check that a second Installer GUI pops-up upon completion of the installation and contains the line: "The reinstallation process is now complete"
  4. Click "Next" and then "Done"

Installation is now complete. Proceed to CEA Commandline Configuration steps.

Updating existing installation:

  1. Select following CEA Installer options:
    • "Load a previously saved configuration"
    • "Remove cea"
    • "Install cea"
    • "Save this configuration for future use"

  2. Click "Next":
  3. A pop-up is displayed with the words: "Enter the filename of your previously saved settings". Enter $HOME/Astrogrid/cea-installer.properties, then click "Next"
  4. Check that installation progress is displayed in textbox area of installer GUI.
  5. Check that a second Installer GUI pops-up upon completion of the installation and contains the line: "The reinstallation process is now complete"
  6. Click "Next" and then "Done"

Update installation is now complete using previous configuration settings. To check settings, and modify if necessary, follow steps in CEA Commandline Configuration.

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) appropriate 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".

-- MikeSmith - 28 Sep 2005

Edit | Attach | Watch | Print version | History: r10 | r8 < r7 < r6 < r5 | Backlinks | Raw View | More topic actions...
Topic revision: r6 - 2005-09-29 - MikeSmith
 
  • Edit
  • Attach
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 2008-2020 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback