Difference between revisions of "GENIE GENIELabInstall"

From SourceWiki
Jump to navigation Jump to search
Line 26: Line 26:
 
   <li>Unzip the distribution archive to a temporary location</li>
 
   <li>Unzip the distribution archive to a temporary location</li>
 
   <li>Navigate to the sub-directory appropriate for your version of Matlab</li>
 
   <li>Navigate to the sub-directory appropriate for your version of Matlab</li>
</ol>
+
  <ul>
#* GENIELab-matlabR13
+
    <li>GENIELab-matlabR13</li>
#*: Matlab 6.5 (release 13) compatible
+
    <ul>
#* GENIELab-matlabR14
+
      <li>Matlab 6.5 (release 13) compatible</li>
#*: Matlab 7.0 (release 14) compatible
+
    </ul>
#*: Matlab 7.0.1 (release 14SP1) compatible  
+
    <li>GENIELab-matlabR14</li>
#* GENIELab-matlabR14SP2
+
    <ul>
#*: Matlab 7.0.4 (release 14SP2) compatible
+
      <li>Matlab 7.0 (release 14) compatible</li>
#*: Matlab 7.1.0 (release 14SP3) compatible
+
      <li>Matlab 7.0.1 (release 14SP1) compatible</li>
#*: Matlab 7.2.0 (release 2006a) compatible
+
    </ul>
#*: Matlab 7.3.0 (release 2006b) compatible
+
    <li>GENIELab-matlabR14SP2</li>
#*: Matlab 7.4.0 (release 2007a) compatible but untested
+
    <ul>
# Invoke the installer
+
      <li>Matlab 7.0.4 (release 14SP2) compatible</li>
#: <tt>~/GENIELab-1.0.1/GENIELab-matlabR13> ./install.sh</tt>
+
      <li>Matlab 7.1.0 (release 14SP3) compatible</li>
 +
      <li>Matlab 7.2.0 (release 2006a) compatible</li>
 +
      <li>Matlab 7.3.0 (release 2006b) compatible</li>
 +
      <li>Matlab 7.4.0 (release 2007a) compatible but untested</li>
 +
    </ul>
 +
  </ul>
 +
  <li>Invoke the installer
 +
  <tt>~/GENIELab-1.0.1/GENIELab-matlabR13> ./install.sh</tt>
 
<pre>Buildfile: build.xml
 
<pre>Buildfile: build.xml
  
Line 47: Line 54:
 
     [input] Please enter the path to the directory containing the Matlab executable
 
     [input] Please enter the path to the directory containing the Matlab executable
 
     (for example '/usr/local/matlab6p5/bin/glnx86/' or 'c:\matlab6p5\bin\win32\'): </pre>
 
     (for example '/usr/local/matlab6p5/bin/glnx86/' or 'c:\matlab6p5\bin\win32\'): </pre>
# Enter the directory containing the Matlab executable
+
  </li>
#: <tt><matlabroot>/bin/glnx86</tt>
+
  <li>Enter the directory containing the Matlab executable
 +
  <tt><matlabroot>/bin/glnx86</tt>
 
<pre>check_matlabhome:
 
<pre>check_matlabhome:
  
 
query_installpath:
 
query_installpath:
 
     [input] Please enter the path of the installation directory [default /home/user/GENIELab/]: </pre>
 
     [input] Please enter the path of the installation directory [default /home/user/GENIELab/]: </pre>
# Enter a directory (that does not already exist) to install the software to
+
  </li>
#: <tt>/home/user/GENIELab</tt>
+
  <li>Enter a directory (that does not already exist) to install the software to
<pre>
+
  <tt>/home/user/GENIELab</tt>
test_installpath:
+
<pre>test_installpath:
  
 
check_installpath:
 
check_installpath:
Line 96: Line 104:
 
     [input] Replace the existing GENIE database configuration at /home/user/.genie? (y/n) [n] (y,n)
 
     [input] Replace the existing GENIE database configuration at /home/user/.genie? (y/n) [n] (y,n)
 
</pre>
 
</pre>
# 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.
+
  </li>
 +
  <li>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.
 
<pre>
 
<pre>
 
newdotgenie:
 
newdotgenie:
Line 128: Line 137:
 
Total time: 0 minutes 25 seconds
 
Total time: 0 minutes 25 seconds
 
</pre>
 
</pre>
 +
  </li>
 +
</ol>
  
 
===Windows===
 
===Windows===

Revision as of 13:01, 31 May 2007

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