Difference between revisions of "Administrator Guide"

From GCube System
Jump to: navigation, search
Line 13: Line 13:
 
* A [http://www.ntp.org/ ntp server] to synchronise your clock with other machines' for correct credential validation.  
 
* A [http://www.ntp.org/ ntp server] to synchronise your clock with other machines' for correct credential validation.  
 
* A static IP address for all but the simplest testing scenarios.
 
* A static IP address for all but the simplest testing scenarios.
 +
  
 
== Installation ==
 
== Installation ==
  
−
gCore may be installed from a SVN repository, or else from pre-packaged archives. In the first case, installing gCore is tantamount to [[Downloads |downloading]] it into a directory of choice, the ''installation directory''. In the second case, simply expand the downloaded archive into the installation directory. In either case, proceed to the installation as a a non-privileged user with read and write permissions  
+
gCore may be installed from a SVN repository, or else from pre-packaged archives.  
−
for the installation directory. At the end of the process, the installation directory will look as follows:
+
 
 +
In the first case, installing gCore is tantamount to [[Downloads |downloading]] it into a directory of choice, the ''gCore location''. In the second case, installing gCore is simply matter of expanding the downloaded archive into the the gCore location. In either case, proceed to the installation as a a non-privileged user with read and write permissions for the gCore location.  
 +
 
 +
== Configuration ==
 +
 
 +
At the end of the process, the gCore location should contain the following structure:
  
 
<pre>
 
<pre>
Line 34: Line 40:
 
|
 
|
 
|-share
 
|-share
−
      |
+
|    
−
      |-gcore_tools
+
−
      |-globus_wsrf_common
+
−
      |-globus_wsrf_core
+
−
      |-globus_wsrf_core_registry
+
−
      |-globus_wsrf_msd_userful_rp_schema
+
−
      |-globus_wsrf_test
+
−
      |-globus_wsrf_tools
+
−
      |-licences
+
−
      |-schema     
+
 
</pre>
 
</pre>
  
−
Here is the list of the most significant folders:
+
Some folders are of immediate interest to administrators and developers alike:
−
* ''bin'' contains the commands
+
 
−
* ''config'' contains the GHN configuration files
+
{| class="wikitable" border="1"
−
* ''etc'' is used to place container and service-specific configurations
+
|-
−
* ''lib'' contains service & 3rd-party software
+
| '''bin'''
−
* ''share/gcube_tools'' contains the gCore build scripts
+
| executables
−
* ''share/schema'' contains service, standard and gCore-specific interfaces
+
|-
 +
| '''config'''
 +
| configuration files
 +
|-
 +
| '''etc'''
 +
| deployed service configuration files
 +
|-
 +
| '''lib'''
 +
| standard and deployed service libraries
 +
|-
 +
| '''share'''
 +
| build tools, standard and deployed service interfaces/schemas
 +
|}
 +
 
 +
 
 +
You should define an environment variables '''GLOBUS_LOCATION''' and point it to the installation directory. Assuming a bash shell:
 +
 
 +
export GLOBUS_LOCATION = <''gCore location''>
 +
 
 +
Adding $GLOBUS_LOCATION/bin to your PATH is also highly recommended:
 +
 
 +
export PATH = $PATH:$GLOBUS_LOCATION/bin
 +
 
  
−
=== Dealing with Globus ===
 
−
In order to deal with the underlying Globus technology, the following steps are needed:
 
−
#export GLOBUS_LOCATION to the gCore LOCATION
 
−
#export PATH to gCore bin
 
 
#configure ''${GLOBUS_LOCATION}/etc/globus_wsrf_core/server-config.wsdd'' by specifying the hostname as value of the logicalHost parameter
 
#configure ''${GLOBUS_LOCATION}/etc/globus_wsrf_core/server-config.wsdd'' by specifying the hostname as value of the logicalHost parameter
 
   
 
   

Revision as of 11:00, 9 April 2008

This Guide covers the installation, configuration, and maintenance of gCore.

Before you Begin

The following software is a prerequisite for the installation of gCore:

  • A platform compatible or made compatible with GT requirements.
  • J2SE 1.5.08 SDK or greater. Sun's reference implementation is recommended, but versions from IBM, HP, or BEA should work equally well.
  • Ant 1.6.5+ to build gCF sources or to develop services with it.
  • a SVN client to install gCore from the SVN repository.
  • GNU tar to install gCore from archived distributions.
  • sudo to execute shell commands with controlled super-user privileges.
  • A ntp server to synchronise your clock with other machines' for correct credential validation.
  • A static IP address for all but the simplest testing scenarios.


Installation

gCore may be installed from a SVN repository, or else from pre-packaged archives.

In the first case, installing gCore is tantamount to downloading it into a directory of choice, the gCore location. In the second case, installing gCore is simply matter of expanding the downloaded archive into the the gCore location. In either case, proceed to the installation as a a non-privileged user with read and write permissions for the gCore location.

Configuration

At the end of the process, the gCore location should contain the following structure: 

|
|-bin
|
|-config
|
|-endorsed
|
|-etc
|
|-lib
|
|-libexec
|
|-share
|

Some folders are of immediate interest to administrators and developers alike:

bin executables
config configuration files
etc deployed service configuration files
lib standard and deployed service libraries
share build tools, standard and deployed service interfaces/schemas


You should define an environment variables GLOBUS_LOCATION and point it to the installation directory. Assuming a bash shell:

export GLOBUS_LOCATION = <gCore location>

Adding $GLOBUS_LOCATION/bin to your PATH is also highly recommended:

export PATH = $PATH:$GLOBUS_LOCATION/bin


  1. configure ${GLOBUS_LOCATION}/etc/globus_wsrf_core/server-config.wsdd by specifying the hostname as value of the logicalHost parameter

<deployment name="defaultServerConfig" xmlns="http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java" xmlns:wsa="http:/
/schemas.xmlsoap.org/ws/2004/03/addressing" xmlns:wsnt="http://docs.oasis-open.org/wsn/2004/06/wsn-WS-BaseNotification-1.2-draft-01.xsd" xmlns:wsrp="http://d
ocs.oasis-open.org/wsrf/2004/06/wsrf-WS-ResourceProperties-1.2-draft-01.xsd" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

    <globalConfiguration>
        <parameter name="logicalHost" value="localhost"/>
        [...]
    <globalConfiguration>
</deployment>

To test it: start GHN gcore-start-container -nosec (by default on 8080, otherwise start with -p <port>)

GHN Passport

The main configuration file of gCore is $GLOBUS_LOCATION/config/GHNConfig.xml: 

<?xml version="1.0" encoding="UTF-8"?>
<jndiConfig xmlns="http://wsrf.globus.org/jndi/config">
    <global>

                <environment
                        name="securityenabled"
                        value="true"
                        type="java.lang.Boolean"
                        override="false" />
                <environment
                        name="mode"
                        value="development"
                        type="java.lang.String"
                        override="false" />
                <environment
                        name="rootVO"
                        value="/gcube"
                        type="java.lang.String"
                        override="false" />
                <environment
                        name="defaultVO"
                        value="/gcube/devsec"
                        type="java.lang.String"
                        override="false" />
                 <environment
                        name="infrastructure"
                        value="development"
                        type="java.lang.String"
                        override="false" />
                <environment
                        name="labels"
                        value="GHNLabels.xml"
                        type="java.lang.String"
                        override="false" />
                <environment
                        name="rootGHN"
                        value="true"
                        type="java.lang.Boolean"
                        override="false" />
                <environment
                        name="GHNtype"
                        value="Dynamic"
                        type="java.lang.String"
                        override="false" />
                <environment
                        name="localProxy"
                        value="/home/globus/..."
                        type="java.lang.String"
                        override="false" />
                <environment
                        name="coordinates"
                        value="43.719627,10.421626"
                        type="java.lang.String"
                        override="false" />
                <environment
                        name="country"
                        value="it"
                        type="java.lang.String"
                        override="false" />
                <environment
                        name="location"
                        value="Pisa"
                        type="java.lang.String"
                        override="false" />
                <environment
                        name="updateInterval"
                        value="60"
                        type="java.lang.Long"
                        override="false" />

    </global>
</jndiConfig>


    1. Prerequisites
    2. Installing from Source
    3. Installing from Binary
  2. Configuration
    1. GT Configuration
    2. gHN Configuration
    3. Security Configuration
  3. Launch & Shutdown
Retrieved from "https://gcore.wiki.gcube-system.org/index.php?title=Administrator_Guide&oldid=470"