Chapter 2. Installation

Table of Contents
On Linux Systems
On Sun/Solaris Systems
On Windows
Jamaica Directory structure

On Linux Systems

The release for Linux is available as an RPM archive that can be installed using the rpm tool or as a compressed tar that contains an installations script. To install the Linux release root privileges are usually required. See below for installation instructions without root privileges.

Installation with root privileges

  • Using the RPM archive

    The RPM archive has a name of the form Jamaica-version-linux-gnu-target.rpm. To install this archive, super user (root) privileges are required:

    	  
          > su -
          Password: 
          # 
    	  
    	

    The actual installation can be performed by using the rpm command:

          
          # rpm -i Jamaica-<version>-linux-gnu-<target>.rpm
          #
          
        
  • Using compressed tar archive

    The compressed tar archive has a name of the form Jamaica-version-linux-gnu-target.tar.gz. To install this archive, super user (root) privileges are required:

         
          > su
          Password: 
          # 
         
       

    Before installation can proceed, the archive needs to be unpacked using the tar command:

         
          # tar xzf Jamaica-<version>-linux-gnu-<target>.tar.gz
          #
         
       

    The actual installation can then be performed using the provided install script command:

         
          # ./Jamaica.install
          #
         
       

During the installation, Jamaica will be installed under /usr/local/jamaica-version. A soft-link /usr/local/jamaica will be generated to refer to this directory.

To be able to use the tools without adjusting the PATH environment variable, soft-links for the commands jamaica, jamaicah, jamaicavm and numblocks will be created in the directory /usr/bin.

Installation for a single user without root privileges

If you do not have root permission or you prefer to install Jamaica locally in your home directory instead of in /usr/local, proceed as follows:

You need to install the Jamaica tar-archive named Jamaica-version-linux-gnu-target.tar.gz. First, you have to unpack and install it into the current directory using tar. Then have to set the environment variable JAMAICA to reflect the installation directory.

	
      > tar zxf Jamaica-2.0-3-linux-gnu.tar.gz
      > tar -xpf Jamaica.ss
      > export JAMAICA=`pwd`/usr/local/jamaica-2.0-3
      > export PATH=$JAMAICA/bin:$PATH
      > jamaica -help
      jamaica [-help] [-Xhelp] [-version] ...
      > ...