#
# Before you setup the DSA/catalog service, please check that you have 
# a working Registry service to register it in.
 
# This script assumes that the following environment variables have already been set :
# JAVA_HOME
# CATALINA_HOME
# ASTROGRID_HOME
# ASTROGRID_HOSTNAME

# ASTROGRID_REGISTRY_AUTH
# ASTROGRID_REGISTRY_ADMIN
# ASTROGRID_REGISTRY_QUERY

# IMPORTANT NOTE
# This script assumes that you are installing your DSA/catalog in 
# tomcat version 5.5.20, as per the workshop instructions.
# The war-based deployment described below MAY NOT WORK in other versions
# of tomcat (e.g. tomcat 5.0.x).  
# If you need to install a DSA/catalog in a version of tomcat other than 
# 5.5.20, please refer to the DSA/catalog installation documentation here:
#   http://software.astrogrid.org/components/dsa/index.html
#
# -------- -------- -------- --------
# Install DSA/catalog webapp.
#

#
# Set the DSA/catalog version.
export ASTROGRID_DSA_CATALOG_VERSION=2006.3.05ox

#
# Create DSA/catalog directories.
mkdir ${ASTROGRID_HOME}/DSA
mkdir ${ASTROGRID_HOME}/DSA/webapp
mkdir ${ASTROGRID_HOME}/DSA/properties
mkdir ${ASTROGRID_HOME}/DSA/metadoc

#
# Get the DSA/catalog webapp.
wget -P ${ASTROGRID_HOME}/DSA/webapp http://www.astrogrid.org/maven/org.astrogrid/wars/astrogrid-dsa-catalog-${ASTROGRID_DSA_CATALOG_VERSION}.war

#
# Extract the default DSA configuration file.
unzip -j -d ${ASTROGRID_HOME}/DSA/properties $ASTROGRID_HOME/DSA/webapp/astrogrid-dsa-catalog-${ASTROGRID_DSA_CATALOG_VERSION}.war WEB-INF/classes/default.properties

#
# Create DSA/catalog context file.
vi ${CATALINA_HOME}/conf/Catalina/localhost/astrogrid-dsa-catalog.xml

** Replace {ASTROGRID_HOME} with the full path (two places)
** Replace {ASTROGRID_DSA_CATALOG_VERSION} with the webapp version (one place)

<?xml version='1.0' encoding='utf-8'?>
<!-- Configure the docBase -->
<Context
    displayName="AstroGrid DSA/catalog"
    docBase="{ASTROGRID_HOME}/DSA/webapp/astrogrid-dsa-catalog-{ASTROGRID_DSA_CATALOG_VERSION}.war"
    path="/astrogrid-dsa-catalog"
>
    <!-- Configure the location of your DSA/catalog configuration 
       properties file -->
    <Environment 
        description="Location of DSA properties file" 
        name="org.astrogrid.config.filename" 
        type="java.lang.String"
        value="{ASTROGRID_HOME}/DSA/properties/default.properties"
    />
</Context>

#
# Restart your tomcat
${CATALINA_HOME}/bin/shutdown.sh
${CATALINA_HOME}/bin/startup.sh

#
# Check the DSA/catalog home page.
# http://${ASTROGRID_HOSTNAME}:8080/astrogrid-dsa-catalog/

#
# Now please work through the in-component configuration documentation, step 
# by step, to complete your installation and register it.
# http://${ASTROGRID_HOSTNAME}:8080/astrogrid-dsa-catalog/configure.jsp
#
# If you have no data of your own to wrap, see the notes below re 
# "PRECANNED DATA".
#
# NOTES RE CONFIGURATION STEP 4:
#-------------------------------
# You have already installed a copy of the default properties file 
# in ${ASTROGRID_HOME}/DSA/properties/default.properties, and configured 
# your tomcat context file to point to it, so you *don't* need to take 
# another copy of this file.
#
# PLEASE EDIT YOUR LOCAL COPY OF THE PROPERTIES FILE IN 
# ${ASTROGRID_HOME}/DSA/properties/default.properties.
#
# The default.properties file is extensively commented and is intended to be
# self-documenting; work through it carefully, following the instructions and
# examples within the file, to customise your DSA/catalog configuration.
#
# In particular, you should set the following properties as shown
# (replacing {ASTROGRID_REGISTRY_AUTH}, {ASTROGRID_REGISTRY_ADMIN},
# {ASTROGRID_REGISTRY_QUERY} with the appropriate settings for your
# own publishing registry):
#
# datacenter.authorityId={ASTROGRID_REGISTRY_AUTH}
# org.astrogrid.registry.admin.endpoint={ASTROGRID_REGISTRY_ADMIN}
# org.astrogrid.registry.query.endpoint={ASTROGRID_REGISTRY_QUERY}
#
#
# NOTES RE CONFIGURATION STEP 5:
#-------------------------------
# When you create your metadoc file, we recommend keeping it in
# the ${ASTROGRID_HOME}/DSA/metadoc/ directory you created earlier.
#
#
# PRECANNED DATA
#---------------
# If you have no data of your own to configure, and wish to set up a 
# DSA/catalog installation as an exercise, the FIRST dataset is available
# in a publically-accessible MySQL DBMS.  Please include the properties
# described in following page in your default.properties configuration:
#
#    http://ag03.ast.cam.ac.uk:8080/radionet/mysql-first.properties
#
# There is also a pre-completed metadoc file for FIRST available here:
#
#    http://ag03.ast.cam.ac.uk:8080/radionet/mysql-first-metadoc.xml
#
#
#=====================================================
#
# Once you have completed all of the configuration steps, and registered
# your new DSA/catalog installation in your local publishing registry, ask 
# the AstroGrid registry to harvest your local registry.
# Check your service is visible in the AstroGrid registry.
# ** You only need to do this step if you are setting up a live service.
# ** This needs to be done by a member of the AstroGrid team at Leicester **
#