The SSM environment

The "SSM environment"

The "SSM environment" is build on SSM, Simple Software Management.

This means one now subscribes to domaines and packages using s.ssmuse.dot to aquire access to certain directories, scripts, binaries, etc. In general the s.ssmuse.dot will add directories to your $PATH, $LD_LIBRARY_PATH, etc and set some environment variables.

To get a list of all the available domaines and packages type:
    s.list_ssm_shortcuts

But first you will have to do the little "setup" below, then you can subscribe to one or more of these domaines and packages by typing for example:

    . s.ssmuse.dot diagtools difftools runtools vistools fulldev

I added this line to my .interactive_profile (see below).

Setup the SSM environment

To use the SSM environment you will first (and only once) have to do a little "setup":

1. Create two links in your HOME
   This part depends on the machine on which you are setting up the SSM environment.
   
   On guillimin:
           cd
           ln -fs ~winger/ssm-domains/setup/v_001~winger/ssm-domains/setup/v_001  ECssm
           ln -fs ECssm/dot-profile-setup_1.0_multi/bin/.profile
       Change the name of two files (or remove them):
           mv .bash_profile .bash_profile-
           mv .bashrc .bashrc-
       Log out and back in.
   
   On st1/2/3, skynet1/2/3 and beluga:
           cd
           ln -fs /unique/armnssm/ECssm/ssm-domains-base/setup/v_001  ECssm
           ln -fs ECssm/multi/bin/.profile
       Log out and back in.
   
   On marvin the SSM environment does not exist.
   
   
2. The file .profile_usr is not used anymore. It got replaced by several .something_profile files which all have to reside in your HOME in a directory called .profile.d.
   
   Your own personal aliases, exports, s.ssmuse.dot etc. for interactive use will go into the file
       ~/.profile.d/.interactive_profile
   which you will have to create.
   If you already have the file .profile_usr  with your own aliases, exports, etc. you can copy them into this file.
   Just make sure you do NOT copy a line in this file like this (or similar):
       source  /usr/local/usr_env/bashrc.tous
   (You might have it in your .profile_usr on some of the UQAM servers. So please be careful.)
   
   Since you now have to acquire packages with s.ssmuse.dot to get access to them I suggest you acquire the basic packages by default and add the following line to your ~/.profile.d/.interactive_profile:
       On guillimin:
           . s.ssmuse.dot ovbin diagtools difftools runtools vistools fulldev pre_dot
       On st1/2/3, skynet1/2/3 and beluga:
           . s.ssmuse.dot ovbin diagtools difftools runtools vistools fulldev netcdf pre_dot
   
   Have a look at my .profile.d if you like (The files are hidden files, so do not forget the '-a'):
       ls -al ~winger/.profile.d
   
   I suggest you create a link to the '.group_profile' as well.
   This will give you some basic aliases I find quite useful. Have a look at them if you like.
   I will keep adding aliases and exports to this file.
       cd ~/.profile.d
       ln -s ~winger/.published_profile.d/.group_profile
   
   Then you either log out and back in again or source the new .profiles.
   
   
3. Allow 'ssh $TRUE_HOST' without typing password:
       cd ~/.ssh
   Only if there is no(!) file 'id_rsa.pub' create it with:
      ssh-keygen         (press just 'Enter' whenever asked a question, 3 times)
   then
       cat id_rsa.pub >> authorized_keys2 <span style="font-weight: bold;" />
   
   
4. Create directories for running CRCM5.
   Create directory/link for the execution directory (where the model will be running):
       mkdir ~/MODEL_EXEC_RUN
       cd ~/MODEL_EXEC_RUN
       mkdir -p /sb/project/xgk-345-ab/${USER}/EXECDIR
       ln -s /sb/project/xgk-345-ab/${USER}/EXECDIR localhost
       ln -s /sb/project/xgk-345-ab/${USER}/EXECDIR guillimin
   Create directory/link for the listings:
       mkdir ~/listings
       cd ~/listings
       mkdir -p /sb/project/xgk-345-ab/${USER}/Listings
       ln -s /sb/project/xgk-345-ab/${USER}/Listings localhost
       ln -s /sb/project/xgk-345-ab/${USER}/Listings guillimin
   
   
5. Set project name of which to use the core allocation
   You will have to create a file in your HOME on guillimin which is called:
     ${HOME}/.CLUMEQ_accnt
   
   This file has to contain 1 variable called 'RAPid', set to the RAPid of the project under which you want to submit your job.
   For people working for or having their account via Pierre Gauthier, Laxmi Sushama, René Laprise or Peter Yau you will have to set in the above file:
     RAPid=xgk-345-ac
   
   Have a look at my file if you like:
     ~winger/.CLUMEQ_accnt
   
6. Open your HOME to the world
   If you do want my or other help I suggest you open your HOME to the world:
       chmod 755 /home/$USER
   

1.