Table of content
- Downloading the code
- Configuration of your .bashrc
- Setting up the configuration file
- Packages installation
- ISSM compilation
Downloading the code
To download ISSM, you can either use the link on the right panel or use CVS.
ISSM is actively managed using a code versioning system called CVS. 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 CVS on their machine.
Once CVS has been installed, issue the following command:
This command will download the stable version of the code ISSM named ice2 from the repository on the wilkes machine, located in the /home/larour/Ice_Repository directory, onto the current local directory (replace useraccount by your user name on wilkes). Users are free to choose whichever location they want and to rename ice1. Users should not forget the -P option. Failing to do so would allow CVS to fetch empty directories. This would result in a code structure not intended by the developers.
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/issm1). When this is done, type in the prompt:
Setting up the configuration file
For the next step, go to etc:
This directory holds configuration files needed by various makefiles across the ICE code to compile "C" code. For this code to compile correctly, ICE needs to know which type of OS the user is running, and pick up the correct configuration file. By default, ICE will look for the config.mk file in the MexConfig directory. If this file does not point to the correct OS dependent configuration file, the compilation will fail.
Users should therefore identify their OS configuration file in the set of configuration files present in the MexConfig directory ( ex: config_linux.mk for a 32 bits linux OS, config_linux64.mk for a 64 bits linux OS, etc ...) and rename this file to config.mk
For example, on a linux 32 bits platform, in the MexConfig directory, find the linux 32 bits configuration file, and type:
Users familiar with symbolic linking can also try:
The rest of the files in this directory are related to matlab compiler settings that have been tweaked for platform compatibility purposes. Users should not modify them, unless familiar with the 'mex' compiler.
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 two packages must be installed:
- 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.
ISSM compilation
The final step consists in compiling all the modules of ISSM. Go to ISSM main directory and type:
>make -f MakefileIce
ISSM installation is done!