2.1 Installation of the coupled model IPSLCM4_v1

CVS must be installed on the work station as it is needed to get or update the IPSL Coupled Model.
For the first extraction all the following commands must be entered (on Rhodes) :

cvs -d :pserver:anonymous@cvs.ipsl.jussieu.fr:/home/ioipsl/CVSROOT login
(passwd=anonymous)

cvs -d :pserver:opa@cvs.ipsl.jussieu.fr:/home/opalod/CVSROOT login
(passwd=opa2000)

cvs -d :pserver:lmdzbrowse@piaf.lmd.jussieu.fr:/users/lmdz/cvsroot login
(passwd=lmdzb2000)

cvs -d :pserver:sechiba@cvs.ipsl.jussieu.fr:/home/ssipsl/CVSREP login
(passwd to be asked to Jan POLCHER)

These commands automatically generate the file .$HOME/.cvspass
It regroups the necessary information for the next extractions and releives you (if you have not erased it !) from typing the above commands several times

N.B. : If you erase this file you must type again the above cvs commands.

For each configuration it is advised to perform a complete extraction of each package.
Each extraction must be realised in distinct folders.
The directory used in the following examples is named STD_TEST.
Consequently, STD_TEST is the entry point where will be extracted the selected configuration (Fig. : 1.1) . The choice of the directory name (or entry point) is done by the user and is often linked to the simulation characteristics. (e.g. IPSLCM4_v1_LR for the coupled model in Low Resolution, IPSLCM4_v1_MR for the coupled model in Medium Resolutionpour, ...)
The following commands give the necessary steps so as to extract the IPSL coupled model from CVS servers :

rhodes : mkdir STD_TEST	directory for all sources and scripts
rhodes : cd STD_TEST
rhodes : cvs_ano co modipsl	extract modipsl
rhodes : cd modipsl/util	directory for install scripts

At this point it is possible to verify that the mod.def file (which can be found in the directory util Fig. : 1.1) correctly identifies
for each component (prefix #-C-),
the desired tag (prefix #-T-),
the corresponding CVS server index (prefix #-I-)
in the server list (prefix #-S-).

Help can be obtained from Web CVS
Moreover any text editor gives access to mod.def
(which can thus be modified...) :

rhodes : emacs mod.def &

Change the tag of the component to
modify in the model that used in
mod.def file

Following is a sample mod.def file :

Figure 2.1 : Information relating to the coupled model

Remains to extract the coupled model, as follows :

rhodes : model -h	get the list of available model
rhodes : model IPSLCM4_v1	extract model IPSLCM4_v1 configuration tools and all its components

After having typed these commands, the modeles (Fig. : 2.2) directory is no more empty and contains 8 sub directories :

CPL which contains the coupler sources for general Ocean Atmosphere circulation
CVS
IOIPSL which contains the sources for the IPSL I/O library
IPSLCM4_v1
LMDZ3.3 which contains the sources of general Atmosphere circulation model
OPA which conatains the sources of the general Ocean circulation model as well as the ones of the Ice model
ORCHIDEE which contains the sources of the surfacic processes model (SECHIBA)
UTIL

Figure 2.2 : IPSLCM4_v1 directory tree

CNRS - Institut Pierre Simon Laplace

Université Pierre et Marie Curie
4, place Jussieu
casier 101
75252 PARIS Cedex 5
FRANCE