Table of content
- Downloading the code
- Configuration of your .bashrc
- External packages installation
- Development packages installation
- ISSM compilation
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:
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).
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:
External packages installation
For the next step, go to packages directory:
several packages may be installed depending on what users want to do. At least the following for packages must be installed:
- mpich2
- petsc
- metis
- triangle
To install all the ISSM libraries: type make, or go into each library folder and type:
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
and install these two packages by typing:
To generate the MakeFiles needed to compile ISSM, go to ISSM's main directory and use the following commands:
> ./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:
> make
Once the compilation has ended without error, the installation can be completed with:
> make
ISSM installation is done!