GENIE GENIELabInstall

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

• Matlab

• 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
4. 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\'): 

5. 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/]: 

6. 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)
   

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

• Uninstalling GENIELab