MRG Interactive Developments

This section assumes that you are installing x86-64 binaries on an x86-64 system as the "armnlib" user. If you are on an x86 (or other) system, or you are installing x86 binaries on an x86-64 system, then the architecture extensions of the binary SSM packages must be modified to agree with your build needs.

The model has to be installed in a domain separate from the rest of the RPN Library. This is because multiple versions of the model should be allowed to exist on a single system. Since SSM works by creating directories and links to the "published" packages, there will be a collision for every published file that exists in more than one model distribution. To avoid this problem, we will install the model in a separate domain, and then use the subdomain subscription feature of SSM to select the correct model and version.

1. Select a name for the new model installation (use the model name and version to make the domain easy to select - I use GEM version 3.2.2 in this example): export GEMSSM=/home/armnlib/ssm_gem_3.2.2
2. Create a new domain for model installation: ssm created -y -d ssm_gem_3.2.2
3. Add this repository to your list: echo "" >>~/ssm/etc/ssm.d/sources.list; echo "http://www.atmos.albany.edu/facstaff/rmctc/ssm/repo" >>~/ssm/etc/ssm.d/sources.list
4. Clean the resulting file to remove original cruft if necessary
5. If you are installing from outside the EC intranet, follow these additional instructions
6. In the ${GEMSSM}/etc/ssm.d/profile file, change the word prepend to append to make sure that the local installation does not come before ~/ovbin in the directory tree: perl -pi -e 's/prepend/append/' ${GEMSSM}/etc/ssm.d/profile
7. To install from binaries, add the following background packages (NOTE: you do not need to follow this step if a COMM model has already been installed on the machine - this is done only the first time that the COMM model is built): ssm install -y -p env-configs_1.0_all
ssm publish -y -p env-configs_1.0_all
ssm install -y -p env-etagere_1.0_all
ssm publish -y -p env-etagere_1.0_all
ssm install -y -p environment-lib-pub_1.0_linux24-x86-64
ssm publish -y -p environment-lib-pub_1.0_linux24-x86-64
ssm install -y -p rmnlib-bin_1.0_linux24-x86-64
ssm publish -y -p rmnlib-bin_1.0_linux24-x86-64
ssm install -y -p environment-lib-priv_1.0_linux24-x86-64
ssm publish -y -p environment-lib-priv_1.0_linux24-x86-64
ssm install -y -p rmnlib-bin-extras_1.0_all (see additional information about this package)
ssm publish -y -p rmnlib-bin-extras_1.0_all


   To install from source, use the following packages: ssm install -y -p env-configs_1.0_all
ssm publish -y -p env-configs_1.0_all
ssm install -y -p env-etagere_1.0_all
ssm publish -y -p env-etagere_1.0_all
ssm install -y -p rmnlib-bin-extras_1.0_all (see additional information about this package)
ssm publish -y -p rmnlib-bin-extras_1.0_all
ssm install -y -p rmnlib-bin-extras_1.0_linux24-x86-64
ssm publish -y -p rmnlib-bin-extras_1.0_linux24-x86-64
ssm install -y -p rmnlib-lib_1.0_all
ssm publish -y -p rmnlib-lib_1.0_all


8. Install the following architecture-independent packages (change the value of GEMSSM if you are installing in a different path): echo "http://collaboration.cmc.ec.gc.ca/science/ssm" >>$GEMSSM/etc/ssm.d/sources.list
echo "http://www.atmos.albany.edu/facstaff/rmctc/ssm/repo" >>$GEMSSM/etc/ssm.d/sources.list
ssm install -y -d $GEMSSM -p model-data_1.0_all
ssm publish -y -d $GEMSSM -p model-data_1.0_all
ssm install -y -d $GEMSSM -p gem_3.2.2_all
ssm publish -y -d $GEMSSM -p gem_3.2.2_all
ssm install -y -d $GEMSSM -p phy_4.4_all
ssm publish -y -d $GEMSSM -p phy_4.4_all
ssm install -y -d $GEMSSM -p class_3.0_all
ssm publish -y -d $GEMSSM -p class_3.0_all

9. Install the following model packages: ssm install -y -d $GEMSSM -p gem_3.2.2_linux24-x86-64
ssm publish -y -d $GEMSSM -p gem_3.2.2_linux24-x86-64
ssm install -y -d $GEMSSM -p phy_4.4_linux24-x86-64
ssm publish -y -d $GEMSSM -p phy_4.4_linux24-x86-64

10. WARNING: If your $ARCH environment variable ends with _CUSTOM (i.e. you are not using the CMC Portland Group compilers), then follow these additional instructions.
11. TIP: If you are installing on a new platform, you will need to edit the model make structure, so follow these additional instructions.
12. TIP: If you built the RPN Libraries from source, then follow these additional instructions.
13. TIP: If you wish to build support for OpenMP parallelism, then follow these additional instructions.

1. Subscribe to the appropriate model subdomain (this should be redone each time that you want to change models or model versions) - assuming that you have the GEMSSM environment variable set as shown in the COMM Model Insallation section: ssm subscribe --user -d $GEMSSM
2. If your receive a permission error when running the ssm subscribe command and this is the first time that the command is being run for this profile, then follow these additional instructions.
3. Log out and log back in.
4. Make sure that the current directory (.) is included in your path. If it is not, then modify ~/.profile_usr or ~/.bashrc to include a line like: export PATH=$PATH:.
5. (Optional) If you modified ~/.profile_usr then run: . ~/.profile_usr
6. Create an experiment directory and enter it.
7. Experiment directory setup: ouv_exp base -RCSPATH "/home/armnlib/ssm_gem_3.2.2/all/share/modeles/GEMDM/v_3.2.2/RCS /home/armnlib/ssm_gem_3.2.2/all/share/modeles/PHY/v_4.4/RCS"
8. (Optional): If you will be running with more than 128 MPI jobs (subdomains), then you will need to link against the beta-level libraries (for current version 8 RPN libraries): echo "RMN=rmnbeta" >>mes_recettes
9. Build makefile: r.make_exp
10. Create build directory: mkdir malib${ARCH}
11. Build the COMM model: make gem
12. The data for the benchmark case is now stored in /home/armnlib/ssm_gem_3.2.2/model-data_1.0_all/all/share/data/dfiles, so the -inrep argument and others to Um_runent.sh will need to be modified accordingly (see below).
13. TIP: A simple batch script like this one can be used to to launch the benchmark simulation (left shift and click to download).

The best place to get additional information about the Simple Software Manager (SSM) is at the SSM Homepage. A set of preliminary installation notes using the package manager are available here. More information about the RPN COMMunity modelling system is available at the RPN COMM website.

TIP: For a complete list of the SSM packages avaiable check out the official repository. For a list of the packages avaialable here, check out the local repository.

MRG Interactive is a supporter of open source initiatives and,

Questions or Comments? Contact our WebMaster.