2.2 Updating procedure for the coupled model IPSLCM4_v1

In case of a first installation, in the working directory (STD_TEST), updating the Coupled model is not necessary as the information found (or modified) in the mod.def file should be satisfying (Fig. : 2.1).
This information determines, for each component, the sources that will be installed in the working directory.
On the other hand if a full installation has already been done it is possible to update the components of the desired model via any of the following two ways depending on the needs :

Either by keeping, for each component, the tag of the branch indicated in the mod.def file
Or by changing the tag of at least one of the components present in the mod.def file.

The mod.def file regroups the information concerning each model.
Explanation on the file structure is given in the file header (Fig. : 1.1).

For a first Installation, paragraphs 2.2.1 and 2.2.2 must not be taken into account.
Jump directly to 2.3

2.3 Defining the configuration

Sub-sections

2.2.1 Keeping the same tag for each component

For advanced users only

If an update for a component is desired while keeping the already used tag and which appears in mod.def file (Fig. : 2.1), it is required to enter for example the following commands in the directory of the component to update :

rhodes : cd /STD_TEST/modipsl/modeles/''COMPONENT_NAME''^2.1

rhodes : cvs update -r ''COMPONENT_TAG''^2.2

N.B. : The success of these commands supposes that no local modifications to the sources have been performed otherwise CVS will report conflicts. It will thus be needed to perform modifications in the files preceeded by a C (for conflict). In order to anticipate potential problems, the following command can be used to list the differences between the version currently used and the one referring to another tag.

rhodes : cvs -n -q update -r ''COMPONENT_TAG'' -A | more

2.2.2 Changing the tag of at least one component

On the other hand, if it is desired to perform an update by changing the tag of a component that is used, it is required to modify the tag refering to the component to update and to proceed to a new extraction.

It is advised to erase the component directory prior to the update.

rhodes : cd /STD_TEST/modipsl/modeles	Go to the model directory
rhodes : \rm -fr COMPONENT_NAME^2.1	Delete the directory
rhodes : cd /STD_TEST/modipsl/util	Go to the util directory
rhodes : emacs mod.def &	Change the tag of the component to modify in the model that used in mod.def file
rhodes : model IPSLCM4_v1	extract model MODEL_NAME MODEL_NAME configuration tools and all its components

CNRS - Institut Pierre Simon Laplace

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