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 file containing an installation script. Root privileges are usually required to install the Linux release. For installation instructions without root privileges, see the Section called Installation for a single user without root privileges below.

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

Jamaica will be installed in /usr/local/jamaica-<version>. A soft-link /usr/local/jamaica will be generated to refer to this directory.

Soft-links for the commands jamaica, jamaicah, jamaicavm and numblocks will be created in the directory /usr/bin so that the tools can be used without having to adjust the PATH environment variable.

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, unpack and install it into the current directory using tar. Then, set the environment variable JAMAICA to 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] ...
> ...