This is an old revision of the document!
Access
To request model access, please send a request to noresm-ncc@met.no with some background information on how you plan to use the model.
Installing
Untar NorESM1-M_sourceCode_vXXX.tar.zg in your home directory. This will install the model source code in the folder $HOME/NorESM1-M.
Untar NorESM1-M_inputdata_vXXX.tar.zg to a folder that is available during run-time and has at least 70 GB of free space. This will create a sub-folder inputdata and install NorESM's forcing data and other boundary conditions to it.
Untar NorESM1-M_initialPiHist1_vXXX.tar.zg to a folder that is available during run-time and has at least 2 GB of free space. This will install restart conditions for the CMIP5 PiControl and first member of historical experiment.
Porting
config_machines.xml
Define the characteristics of your HPC system in NorESM1-M/scripts/ccsm_utils/Machines/config_machines.xml.
Edit following section:
<machine MACH="hexagon_intel" DESC="Parallab XE6m (intel), os is CNL, 32 pes/node, batch system is PBS" EXEROOT="/work/$CCSMUSER/noresm/$CASE" OBJROOT="$EXEROOT" INCROOT="$EXEROOT/lib/include" DIN_LOC_ROOT_CSMDATA="/work/$CCSMUSER/inputdata" DIN_LOC_ROOT_CLMQIAN="UNSET" DOUT_S_ROOT="/work/$CCSMUSER/archive/$CASE" DOUT_L_HTAR="FALSE" DOUT_L_MSROOT="/norstore/project/norclim/noresm/cases/$CASE" DOUT_L_MSHOST="norstore-trd-app0.hpc.ntnu.no" CCSM_BASELINE="UNSET" CCSM_CPRNC="UNSET" OS="Linux" BATCHQUERY="qstat -f" BATCHSUBMIT="qsub" GMAKE_J="4" MAX_TASKS_PER_NODE="32" MPISERIAL_SUPPORT="FALSE" />
Set MACH to an acronym/name tag of your choice of your HPC system. Update DESC correspondingly.
Set EXEROOT to the root location where the model should create the build and run-directories. The model will replace $CCSMUSER with your unix user and $CASE with the specific case name (=simulation/experiment name).
Set DIN_LOC_ROOT_CSMDATA to the location where you installed the forcing and boundary condition data (this path should end with “/inputdata”).
Set DOUT_S_ROOT to the root location for the short-term archiving (normally on the work disk area of the HPC system).
Optionally, set DOUT_L_MSROOT to the root location for the long-term archiving (normally a location that is not subject to automatic deletion). Leave unchanged if you don't plan to use automatic long-term archiving (e.g., if you want to move the data manually).
Optionally, set DOUT_L_MSHOST to the name of the (remote)-server for long-term archiving. Leave unchanged if you don't plan to use automatic long-term archiving
Set BATCHSUBMIT to the submit command on your HPC system.
Set GMAKE_J to the number of make instances run in parallel when building the system. Set to 1 if licence or memory issues occur.
Set MAX_TASKS_PER_NODE to the maximum number of MPI tasks that can run on a single node on your HPC system (usually the same as the number of cores per node).
NorESM1-M/scripts/ccsm_utils/Machines/config_pes.xml
Define NorESM1-M CPU-configurations for your HPC system in NorESM1-M/scripts/ccsm_utils/Machines/config_pes.xml.
As a start, we recommend to simply replace all instances of hexagon_intel with your choice for MACH (i.e. the name tag of your machine).