GENIE GENIELabInstall

From SourceWiki
Revision as of 12:49, 31 May 2007 by Genie-user (talk | contribs)
Jump to navigation Jump to search

Andrew Price, University of Southampton, (a.r.price@soton.ac.uk)

Installing GENIELab

GENIELab exploits the GeodiseLab installer to provide a convenient means to deploy the software. Essentially, you just need to download the software archive, unzip and run the install scripts appropriate for your version of Matlab. The install script prompts the user for the location of Matlab in the file system and a directory into which the software can be installed. Please view the post-installation tasks once complete.

Downloads

Please download the latest version of GENIELab from the link provided in the Downloads section of the GENIELab page. The software archive contains releases of GENIELab that target specific versions of the Java Virtual Machine. As Matlab has developed over time it has upgraded the JVM that it uses. Consequently you must select the appropriate release of the software for your version of Matlab as described below.

Prerequisites

  • Java Runtime Environment
    • The installer uses the Java build tool ant. In order to install the software using ant you will need to have a Java Runtime Environment (JRE) available on your PATH. This is a common piece of software that is usually available by default on a Linux system. Under Windows you can install a JRE yourself if it is not already present. The JRE can be downloaded from the Sun Developer Network.
    • Alternatively, the JRE upon which Matlab executes can be used. Simply add the following Matlab directory to your PATH:
      • Linux
        • bash: export PATH=$PATH:<matlabroot>/sys/java/jre/glnx86/jre1.4.2/bin
        • tcsh: setenv PATH $PATH:<matlabroot>/sys/java/jre/glnx86/jre1.4.2/bin
      • Windows
        • Command prompt: set PATH=%PATH%;<matlabroot>\sys\java\jre\win32\jre1.4.2\bin

Installation

UNIX/Linux

  1. Open a UNIX/Linux shell
  2. Unzip the distribution archive to a temporary location
  3. Navigate to the sub-directory appropriate for your version of Matlab
    • GENIELab-matlabR13
      Matlab 6.5 (release 13) compatible
    • GENIELab-matlabR14
      Matlab 7.0 (release 14) compatible
      Matlab 7.0.1 (release 14SP1) compatible
    • GENIELab-matlabR14SP2
      Matlab 7.0.4 (release 14SP2) compatible
      Matlab 7.1.0 (release 14SP3) compatible
      Matlab 7.2.0 (release 2006a) compatible
      Matlab 7.3.0 (release 2006b) compatible
      Matlab 7.4.0 (release 2007a) compatible but untested
  1. Invoke the installer
    ~/GENIELab-1.0.1/GENIELab-matlabR13> ./install.sh
Buildfile: build.xml

init:

query_matlabhome:
    [input] Please enter the path to the directory containing the Matlab executable
    (for example '/usr/local/matlab6p5/bin/glnx86/' or 'c:\matlab6p5\bin\win32\'): 
  1. Enter the directory containing the Matlab executable
    <matlabroot>/bin/glnx86
check_matlabhome:

query_installpath:
    [input] Please enter the path of the installation directory [default /home/user/GENIELab/]: 
  1. Enter a directory (that does not already exist) to install the software to
    /home/user/GENIELab
test_installpath:

check_installpath:

delete_installpath:

make_installpath:
    [mkdir] Created dir: /home/user/GENIELab
     [copy] Copying 341 files to /home/user/GENIELab

local_install:
     [echo] local installation
     [copy] Copying 1 file to /home/user/GENIELab
    [touch] Creating /home/user/GENIELab/startup.m
    [touch] Creating /home/user/GENIELab/GeodiseLab.properties
    [touch] Creating /home/user/GENIELab/uninstall.sh



shared_install:

make_shortcut:

query_subbuildfile:

subtasks:
     [echo] Invoking the subbuild.xml build activities...

query_genie:

build_genie:

local_install:
     [echo] local installation

query_dotgenie:

exists_dotgenie:
    [input] Replace the existing GENIE database configuration at /home/user/.genie? (y/n) [n] (y,n)
  1. If you have an existing installation of the Database Toolbox you will be asked whether the configuration files should be replaced. The installer will back up your existing files if you answer yes to this question.
newdotgenie:

replacedotgenie:

configure:

install_genie:

query_options:

build_options:

init:

untar_options:
    [untar] Expanding: /home/user/GENIELab-1.0.1/GENIELab-matlabR14/OptionsMatlab_0.12.0_R14.tar.gz into /home/user/GENIELab
   [delete] Deleting: /home/user/GENIELab/OptionsMatlab_0.12.0_R14.tar.gz

local_install:
     [echo] local installation

install_options:

subbuild:

pre-install:

BUILD SUCCESSFUL
Total time: 0 minutes 25 seconds

Windows

  1. Open a command prompt
  2. Unzip the distribution archive to a temporary location
  3. Navigate to the sub-directory appropriate for your version of Matlab
    • GENIELab-matlabR13
      Matlab 6.5 (release 13) compatible
    • GENIELab-matlabR14
      Matlab 7.0 (release 14) compatible
      Matlab 7.0.1 (release 14SP1) compatible
    • GENIELab-matlabR14SP2
      Matlab 7.0.4 (release 14SP2) compatible
      Matlab 7.1.0 (release 14SP3) compatible
      Matlab 7.2.0 (release 2006a) compatible
      Matlab 7.3.0 (release 2006b) compatible
      Matlab 7.4.0 (release 2007a) compatible but untested
  4. Invoke the installer
    C:\GENIELab-1.0.1\GENIELab-matlabR13> install.bat

Uninstalling GENIELab