Index: /issm/trunk/doc/index.html
===================================================================
--- /issm/trunk/doc/index.html (revision 377)
+++ /issm/trunk/doc/index.html (revision 378)
@@ -45,5 +45,6 @@
Download
Installation
- Developers Site
+ Quick start
+ Developers Site
FAQ
Index: /issm/trunk/doc/website/doc_html/about.html
===================================================================
--- /issm/trunk/doc/website/doc_html/about.html (revision 377)
+++ /issm/trunk/doc/website/doc_html/about.html (revision 378)
@@ -63,5 +63,6 @@
Download
Installation
- Developers Site
+ Quick start
+ Developers Site
FAQ
Index: /issm/trunk/doc/website/doc_html/documentation.html
===================================================================
--- /issm/trunk/doc/website/doc_html/documentation.html (revision 377)
+++ /issm/trunk/doc/website/doc_html/documentation.html (revision 378)
@@ -39,5 +39,6 @@
Download
Installation
- Developers Site
+ Quick start
+ Developers Site
FAQ
Index: /issm/trunk/doc/website/doc_html/download.html
===================================================================
--- /issm/trunk/doc/website/doc_html/download.html (revision 377)
+++ /issm/trunk/doc/website/doc_html/download.html (revision 378)
@@ -46,5 +46,6 @@
Download
Installation
- Developers Site
+ Quick start
+ Developers Site
FAQ
Index: /issm/trunk/doc/website/doc_html/faq.html
===================================================================
--- /issm/trunk/doc/website/doc_html/faq.html (revision 377)
+++ /issm/trunk/doc/website/doc_html/faq.html (revision 378)
@@ -34,5 +34,6 @@
Download
Installation
- Developers Site
+ Quick start
+ Developers Site
FAQ
Index: /issm/trunk/doc/website/doc_html/features.html
===================================================================
--- /issm/trunk/doc/website/doc_html/features.html (revision 377)
+++ /issm/trunk/doc/website/doc_html/features.html (revision 378)
@@ -29,5 +29,6 @@
Download
Installation
- Developers Site
+ Quick start
+ Developers Site
FAQ
Index: /issm/trunk/doc/website/doc_html/installation.html
===================================================================
--- /issm/trunk/doc/website/doc_html/installation.html (revision 377)
+++ /issm/trunk/doc/website/doc_html/installation.html (revision 378)
@@ -22,6 +22,6 @@
Downloading the code
Configuration of your .bashrc
- Setting up the configuration file
- Packages installation
+ External packages installation
+ Development packages installation
ISSM compilation
@@ -30,16 +30,13 @@
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.
+
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 CVS on their machine.
- Once CVS has been installed, issue the following command:
- > cvs -d useraccount@wilkes.jpl.nasa.gov:/home/larour/Ice_Repository co -r ice2 -P ice1
- 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.
+ 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.
@@ -51,39 +48,17 @@
source $ISSM_DIR/etc/environment.sh
- Where ISSMPATH is the path of ISSM main directory (ex: /home/user1/issm1).
+
Where ISSMPATH is the path of ISSM main directory (ex: /home/user1/svn/issm/trunk).
When this is done, type in the prompt:
> bash
- Setting up the configuration file
- For the next step, go to etc:
- > cd $ISSM_DIR/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:
- > cp ./config_linux32.mk ./config.mk
- Users familiar with symbolic linking can also try:
- > ln -s ./config_linux32.mk ./config.mk
- 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
+ External packages installation
For the next step, go to packages directory:
- > cd $ISSM_DIR/packages
+ > cd $ISSM_DIR/externalpackages
several packages may be installed depending on what users want to do.
- At least the following two packages must be installed:
+ At least the following for packages must be installed:
+ - mpich2
+ - petsc
- metis
- triangle
@@ -98,11 +73,30 @@
+ 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 -f MakefileIce
+ > make
+
+ Once the compilation has ended without error, the installation can be completed with:
+ > cd $ISSM_DIR
+ > make
ISSM installation is done!
+
+ 
