Installation Environnement Commun

en construction(cette page s'adresse aux installateurs/développeurs)

under construction(this page is for installers/developers)

installation procedure for UQAM/SCA version of EC software

• Get bootstrap installer from the SCA  software depot
  use your browser to get the most recent installer bootstrap script
  INSTALL_BOOTSTRAP-8.11.002 (as of writing this documentation)
  into your UNIX/Linux HOME
  make sure there is no directory called ECssm in your HOME
  make sure that there is an empty directory or a link to an empty directory called ssm-domains-base in your HOME
  (it is not necessary but usually a good idea to dedicate an account to EC environment maintenance)
  
• Prepare your account for setup
  get rid of (remove, rename, move, ...) .bashrc, .profile and .bash_profile
  ln -s ECssm/multi/bin/.profile .profile
  the installer will create a soft link called ECssm pointing to the right place
  
• Run installer
  chmod 755 INSTALL_BOOTSTRAP-8.11.002
  ssh localhost ./INSTALL_BOOTSTRAP-8.11.002
  the installer should have created a soft link called ECssm pointing to the right place
  
• logout and login again (with setup this time)
  you should now see the welcoming setup messages
  
• Choose and install (or get installed) a Fortran compiler
  gfortran is available on most Linux distributions (4.4 or better highly recommended)
• Configure compilers and compiling tools (needed for any development work)
  the s.list_ssm_shortcuts command can be used to find where the "shortcuts" reside
  
  • gfortran (version 4.4 or better)
    generic gfortran (versionless) architecture already preconfigured
    gcc4.6 binary tar file available in repository at UQAM (should work on a lot of Linux distributions)
    
  • Portland Group compiler (version 11)
    the pgi11.sh shortcut file will have to be adjusted
  • Portland Group compiler (version 12)
    the pgi12.sh shortcut file will have to be adjusted
  • Portland Group compiler (version >12)
    the pgi_all.sh shortcut file will have to be adjusted (use the generic pgi_all compiler architecture)
    or
    a pginn.sh shortcut file will have to be created (nn is version number) and a proper Compiler_rules file created and installed
    (helper script needed ?)
  • Other compiler
    an appropriate shortcut file will have to be created and a compiler architecture name defined and a proper Compiler_rules file created and installed
    (helper script needed ?)
• Generate librmn_xxx.a (needed for any development work)
  acquire a compiler
  e.g.:   . s.ssmuse.dot gfortran 
  go into the RMNLIB_013 source directory
  
• Configure MPI (needed for EC model work )for the selected compiler architecture
  
• Generate the rpn_comm MPI model toolkit library (needed for EC model work )