Tags:
create new tag
view all tags

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

Pre-requisites

In order to run webservices for all of the AstroGrid components listed in this document, Java, Tomcat and Axis must be installed and configured correctly. Typical installation/configuration instructions follow.

  1. Java
    • Ensure Java SDK 1.4.1_01 already installed
    • Set Unix environment variable JAVA_HOME="/usr/java/j2sdk1.4.1_01".

  2. Tomcat
    • Downloaded and installed (eSDO server msslxx is currently running jakarta-tomcat-5.0.28)
    • Set Unix environment variable CATALINA_HOME="$HOME/jakarta-tomcat-5.0.28"
    • Set Unix environment variable TOMCAT_HOME="$HOME/jakarta-tomcat-5.0.28"
    • Set browser to http://msslxx.mssl.ucl.ac.uk:8080 and check that the Tomcat home page is displayed. Tomcat revision is displayed in the top-lefthand corner.
  3. Axis
    • Downloaded axis-1_2RC2-bin.tar
    • Untar and copy axis-1_2RC2/webapps/axis directory to $TOMCAT_HOME/webapps
    • Install Xerces XML Parser
      • Downloaded / untarred Xerces-J-bin.2.5.0.tar to axis-1_2RC2/webapps/axis/WEB-INF/lib/
      • Copied xml-apis.jar, xercesImpl.jar, xmlParserAPIs.jar to axis-1_2RC2/webapps/axis/WEB-INF/lib/
      • chmod +x for xml-apis.jar, xercesImpl.jar, xmlParserAPIs.jar (may be unnecessary)
    • Install activation.jar
      • Downloaded jaf-1_0_2.upd.zip to $TOMCAT_HOME/common/lib
      • Untarred and copied jaf-1.0.2/activation.jar to TOMCAT_HOME/common/lib
    • Stop and restart Tomcat
    • Check installation at http://msslxx.mssl.ucl.ac.uk:8080/axis and http://msslxx.mssl.ucl.ac.uk:8080/axis/happyaxis.jsp

Details of component specific plug-ins will appear within the installation instructions for that component.

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:
    (URLS and values highlighted in blue are current eSDO settings)
    • 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:
    (URLS and values highlighted in blue are current eSDO settings)
    • 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.
  11. Note: To prevent an error message pop-up being displayed when the "Properties button" is clicked, the following lines are required: (Fix added by MS on 03/10/05)
    • Go to the Registry home page at http://msslxx.mssl.ucl.ac.uk:8080/esdo-registry
    • Click "Browse" under "Investigate" from the lefthand menu
    • Locate the entry "esdo-filestore" under the ResourceKey column and click the corresponding "Edit" from the "Actions" column
    • In the text area find the line that reads <type>Archive</type> in the <content> body and immediately below it add the lines:
      <relationship>
      <relationshipType>derived-from</relationshipType>
      <relatedResource
      ivo-id="ivo://org.astrogrid/FileStoreKind">FileStore</relatedResource>
      </relationship>
    • Tick the "Upload from test: Validate" box then click "Submit" at the bottom of the page.
    • You should now be returned to the same page displaying the textbox XML entry with no errors printed at the top

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:
    (URLS and values highlighted in blue are current eSDO settings)
    • 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:
    (URLS and values highlighted in blue are current eSDO settings)
    • 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:
    (URLS and values highlighted in blue are current eSDO settings)
    • 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 (Common Execution Architecture)

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:
    (URLS and values highlighted in blue are current eSDO settings)
    • 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 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 Configuration.

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

PAL (Publisher's AstroGrid Library)

PAL Downloads

Note
No installer available for this component

Note:PAL will eventally be renamed as DSA

PAL Installation

To run a PAL webservice successfully, a database must be installed and configured correctly. A MySQL database is used by the eSDO server, but other database types are supported. Installation instructions are included for a typical MySQL setup.

  1. Install MySQL (Note: this is the database used by the MSSL eSDO server, but other database types are supported)
    • Download *.rpm from MySQL downloads site
    • Unpack rpm file and copy to relevant directory
    • Configure database:
    • MySQL configured to run as a daemon on machine startup by computer administrator
    • MySQL users “mysql” and “root” created by computer administrator
    • MySQL user “root” should be used to create databases and tables, import data, and perform other table manipuation
    • MySQL grant tables listed user “root” at “localhost”

  2. Install MySQL jdbc driver:
    • Download mysql-connector-java-3.0.16-ga-bin.tar from MySQL downloads site and untar
    • Copy mysql-connector-java-3.0.16-ga-bin.jar to $TOMCAT_HOME/common/lib
      %br%
  3. Create database and table. Import data. Test database.
    • Create database as root:
    • Create table as root
    • Create columns in table(s) as root
    • Import table data from a tab-separated text file
    • Test database from commandline and through jdbc connection

      Note: A duplicate “root" entry at “localhost.localdomain” and a flush privileges may be required to allow connections with the MySQL jdbc driver, which recognizes “localhost.localdomain” in place of “localhost”.

  4. Rename astrogrid-pal-skycatserver-1.0.1-b007pl.war to esdo-pal.war
  5. Copy esdo-community.war into $TOMCAT/webapps
  6. Place war file in $Tomcat/webapps and restart Tomcat
  7. Check esdo-pal directory appears under $TOMCAT/webapps

PAL Configuration

  1. Documentation is bundled with war file: go to http://msslxx.mssl.ucl.ac.uk:8080/esdo-pal/. The left panel contains links to installation, release and configuration notes.
  2. Copy $Tomcat/webapps/warname/WEB-INF/classes/default.properties to $Tomcat/common/classes/astrogrid.properties
  3. Use the Tomcat Administration page to edit these properties in JNDI. Go to Tomcat Admin and click Tomcat Server -> Service -> Host -> Context (astrogrid-pal) -> Resources -> EnvironmentEntries, click on the the context file, and fill in or change any properties in the text boxes to the right of the screen. Click "Commit Changes." This creates an XML file in $Tomcat/conf/Catalina/locahost with your updated properties. Astrogrid and Tomcat will always look for these properties in JNDI - any further changes made in a text editor to $Tomcat/webapps/warname/WEB-INF/classes/default.properties and $Tomcat/common/classes/astrogrid.properties will be ignored. (See PAL Notes below.)

The list below shows some typical PAL JNDI settings. Pay particular attention to the datacenter.plugin and datacenter.resource.plugin parameters.

  • If your database is Postgres, look for "datacenter.queryier.plugin.sql.translator", and uncomment
  • If your database offers circle or crossmatching (mainly astrophysical databases), uncomment

  • datacenter.querier.plugin=org.astrogrid.datacenter.queriers.sql.JdbcPlugin
  • datacenter.plugin.jdbc.drivers=com.mysql.jdbc.Driver
  • datacenter.plugin.jdbc.url=mysql://:3306/
  • datacenter.plugin.jdbc.user=
  • datacenter.plugin.jdbc.password=
  • conesearch.table=SampleStars
  • conesearch.ra.column=RA
  • conesearch.dec.column=DEC
  • conesearch.columns.units=deg
  • db.trigfuncs.in.radians=true
  • datacenter.implements.circle=true
  • datacenter.implements.xmatch=false
  • datacenter.url=http://localhost:8080/pal
  • datacenter.resource.plugin.1=org.astrogrid.datacenter.metadata.TabularDBResources
  • datacenter.resource.plugin.2=org.astrogrid.datacenter.metadata.TabularSkyServiceResources
  • datacenter.resource.plugin.3=org.astrogrid.datacenter.metadata.FileResourcePlugin
  • datacenter.resource.plugin.4=org.astrogrid.datacenter.metadata.CeaResourcePlugin
  • datacenter.resource.plugin.5=org.astrogrid.datacenter.metadata.AuthorityConfigPlugin

PAL Test

  1. Set the browser to localhost:8080/pal and check the PAL home page (entitled "SkyCatServer") is displayed
  2. Select Query/Ask Adql/Sql Query from the links on the left of the page and check the ADQL/sql query page is displayed
  3. Enter a simple query based on the contents of your active database and select "Submit Query"
  4. Check that query results are returned in the default VOTable format

PAL Notes

  1. If you undeploy the PAL component or install a new version of Tomcat, the PAL properties will no longer be in JNDI. Open $Tomcat/common/classes/astrogrid.properties in the Tomcat Administration page again and click "commit changes" to add the properties to JNDI. For this reason, it is good practice to manually add any properties changes you make in JNDI to the $Tomcat/common/classes/astrogrid.properties file.
  2. If your PAL is named anything other than "pal.war", be sure to reflect this change in the astrogrid.properties file.
  3. The astrogrid.properties variable "datacenter.max.return" defines the maximum number of records that will be returned by PAL in response to a query, regardless of the query source. The default setting is 2000.

-- Main.Mike Smith - 29 Sep 2005

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