A Simple Installation

A simple installation is where a package or bundle is installed into an empty installation location. For example, here is how to install a test bundle found here. The steps shown here use the linux GPT bundle installed on a Redhat system.

  1. Download the bundle.

  2. Run gpt-install -location=YOUR_PREFIX newfoo-2.0-i686-pc-linux-gnu-bin.tar.gz. This installs all of the packages and stores data about the packages in $GLOBUS_LOCATION/etc/globus_packages. You should see something like this:

    bash$ gpt-install -location=/home/mbletzin/install/globus/ newfoo-2.2.3-i686-pc-linux-gnu-bin.tar.gz 
    Bundle newfoo successfully installed.
    
  3. gpt-query shows you what packages where installed:

    bash$ gpt-query
    16 packages were found in /home/mbletzin/install/globus that matched your query:
    packages found that matched your query 
    	globus_common-gcc32-pgm pkg version: 3.5.0
    	globus_common-gcc32-rtl pkg version: 3.5.0
    	globus_common_setup-noflavor-pgm pkg version: 2.1.0
    	globus_gsi_callback-gcc32-rtl pkg version: 0.3.0
    	globus_gsi_cert_utils-gcc32-pgm pkg version: 0.4.0
    	globus_gsi_cert_utils-gcc32-rtl pkg version: 0.4.0
    	globus_gsi_credential-gcc32-rtl pkg version: 0.5.0
    	globus_gsi_openssl_error-gcc32-rtl pkg version: 0.2.0
    	globus_gsi_proxy_core-gcc32-rtl pkg version: 0.3.0
    	globus_gsi_proxy_ssl-gcc32-rtl pkg version: 0.1.0
    	globus_gsi_sysconfig-gcc32-rtl pkg version: 0.3.0
    	globus_openssl-gcc32-pgm pkg version: 0.10.0
    	globus_openssl-gcc32-rtl pkg version: 0.10.0
    	globus_openssl_module-gcc32-rtl pkg version: 0.2.0
    	globus_proxy_utils-gcc32-pgm pkg version: 0.5.0
    	globus_trusted_ca_42864e48_setup-noflavor-pgm pkg version: 0.5.0
    

    The -what-bundles flag shows the installed bundle

    bash$ gpt-query -what-bundles
    System Bundles
    	newfoo ver: 2.2.3
    
  4. Run gpt-postinstall to execute any post install scripts that need to be run. You should see something like this:

    bash$ gpt-postinstall
    "running" message shows which setup script is running
    running /home/mbletzin/install/globus/setup/globus/setup-globus-common...
    creating globus-sh-tools-vars.sh
    creating globus-script-initializer
    creating Globus::Core::Paths
    checking globus-hostname
    Done
    running /home/mbletzin/install/globus/setup/globus/setup-ssl-utils...
    setup-ssl-utils: Configuring ssl-utils package
    Running setup-ssl-utils-sh-scripts...
    
    
    Occasionally packages will require additional scripts to be run.
    
    ***************************************************************************
    
    Note: To complete setup of the GSI software you need to run the
    following script as root to configure your security configuration
    directory:
    
    /home/mbletzin/install/globus/setup/globus/setup-gsi
    
    For further information on using the setup-gsi script, use the -help
    option.  The -nonroot can be used on systems where root access is 
    not available.
    
    ***************************************************************************
    
    setup-ssl-utils: Complete
    
  5. Run gpt-verify to make sure that the installation is correct. You should see something like this:

    bash$ gpt-verify
    

    This reports if there are packages missing from an installed bundle or if there are package version mis-matches. Nothing to report for now.

    Verifying Bundles...
    Bundle: newfoo
    
    

    This reports if there are any missing or version mis-matches with packages that are required by other packages.

    Verifying run-time dependencies...
    
    

    The above reports if any setup packages which contain configuration files and scripts for other packages are missing.

    Verifying setup dependencies...
    
    Verifying setup packages...
    The following setup packages still need to be configured via gpt-postinstall:
    	globus_trusted_ca_42864e48_setup-noflavor-pgm
    
    ERROR: The collection of packages in /home/mbletzin/install/globus is not coherent!
    

    The error comes from the fact that the /home/mbletzin/install/globus/setup/globus/setup-gsi script mentioned in the gpt-postinstall output had not been run. After running this script gpt-verify is satisfied:

    bash$ gpt-verify
    Verifying Bundles...
    Bundle: newfoo
    
    Verifying run-time dependencies...
    
    Verifying setup dependencies...
    
    Verifying setup packages...
    
    The collection of packages in /home/mbletzin/install/globus appear to be coherent.