Table of content

Downloading the code

To download ISSM, you can either use the link on the right panel or use SVN.

ISSM is actively managed using a code versioning system called SVN. The code is stored in a repository, and can be remotely fetched, modified, updated, and uploaded. This allows for multiple users to develop the code in an organized way. In order to fetch a version of the code, users will need to install SVN on their machine.

Once SVN has been installed, ISSM can be downloaded by the following command:

> svn checkout http://s383-rhat/issm/svn

This command will download the last version of the code ISSM from the repository, onto the current local directory. Users are free to choose whichever location they want and to rename issm.

Configuration of your .bashrc

In order for ISSM to work correctly, you should add the following lines in your shell environment script (.bashrc or .cshrc).

#ISSM
export ISSM_DIR=ISSMPATH
source $ISSM_DIR/etc/environment.sh

Where ISSMPATH is the path of ISSM main directory (ex: /home/user1/svn/issm/trunk). When this is done, type in the prompt:

> bash

External packages installation

For the next step, go to packages directory:

> cd $ISSM_DIR/externalpackages

several packages may be installed depending on what users want to do. At least the following for packages must be installed:

To install all the ISSM libraries: type make, or go into each library folder and type:

> sh install.sh

We advise to do the latter, should any problems arise during the libraries compilation, users will be able to spot the problematic library more easily. Just remember to compile the libraries in the same order as the Makefile.

There is no guarantee the compilation will work on all systems. A lot of tweaking of the install.sh files will probably be involved. Especially, the configuration part of the install.

Development packages installation

To generate the MakeFiles, one needs to install automake and autoconf that automatically generate them. To do so, go to devpackages directory

> cd $ISSM_DIR/devpackages

and install these two packages by typing:

> make

To generate the MakeFiles needed to compile ISSM, go to ISSM's main directory and use the following commands:

> cd $ISSM_DIR
> ./reconfigure.sh
> ./configure.sh

One might need to modify the configure.sh file that holds all the options needed by automake and autoconf. These options are only valid for JPL user's.

ISSM compilation

The final step consists in compiling all the modules of ISSM. Go to ISSM main directory and type:

> cd $ISSM_DIR
> make

Once the compilation has ended without error, the installation can be completed with:

> cd $ISSM_DIR
> make

ISSM installation is done!