This section describes the monitoring tools, the tools to identify and solve problems, and the tools to monitor and restart the post processing jobs if needed.
The batch manager at each computing center provides tools to check the status of your jobs. For example to know if the job is on queue, running or suspended.
You can use ccc_mstat on Irene. To see the available options and useful scripts, see Working on Irene.
You can use squeue on Jean Zay. To see the available options and useful scripts, see Working on Jean Zay.
When the simulation has started, the file run.card is created by libIGCM using the template run.card.init. run.card contains information of the current run period and the previous periods already finished. This file is updated at each run period by libIGCM. You can find here information of the time consumption of each period. The status of the job is set to OnQueue, Running, Completed or Fatal.
Once your simulation is finished you will receive an email saying that the simulation was Completed or that it Failed and two files will be created in the working directory of your experiment:
A Debug directory is created if the Job failed during the simulation part (in other words when the job is executing calculs in modeles). This directory contains diagnostic text files for each configuration components. It won't be created if the job reaches the time limit and is stopped by the batch scheduler.
If the crash is not properly handeld by libIGCM, you will find a lot of files in $RUN_DIR. You can find the path of this directory in Script_Output_JobName, search for RUN_DIR.
IGCM_sys_MkdirWork : /scratch_of_computer/login/RUN_DIR/Job_number/***/ IGCM_sys_Cd : /scratch_of_computer/login/RUN_DIR/Job_number/***/
If the simulation was successfully completed output files will be stored in the following directory:
in case of a DEVT or PROD simulation, you will find the following subdirectories:
in case of a TEST simulation, you will find the following subdirectories:
The TimeSeries_Checker.job can be used in diagnostic mode to check if all time series have been successfully created. Read more further below.
See further below.
Reminder --> This file contains three parts:
These three parts are defined as follows:
####################################### # ANOTHER GREAT SIMULATION # ####################################### 1st part (prepare parameters files, copying the input files) ####################################### # DIR BEFORE RUN EXECUTION # ####################################### 2nd part (running the model) ####################################### # DIR AFTER RUN EXECUTION # ####################################### 3rd part (post processing)
A few common bugs are listed below:
If the following message is displayed in the second part of the file, it's because there was a problem during the execution:
======================================================================== EXECUTION of : /usr/bin/time ccc_mprun -E-K1 -f ./run_file Return code of executable : 1 IGCM_debug_Exit : EXECUTABLE !!!!!!!!!!!!!!!!!!!!!!!!!! !! ERROR TRIGGERED !! !! EXIT FLAG SET !! !------------------------! 0 - IGCM_debug_Exit (_0_) IGCM_sys_Mkdir : /path_of_your_simulation/Debug IGCM_sys_Cp : out_execution /path_of_your_simulation/Debug/JobName_PeriodDateBegin_PeriodDateEnd_out_execution_error ========================================================================
In this case you need to explore the Debug directory.
If the following message is displayed :
======================================================================== EXECUTION of : mpirun -f ./run_file > out_run_file 2>&1 ========================================================================
If there is a message indicating that the restartphy.n file doesn't exist it means that the model simulation was completed but before the end date of your simulation. If this happens you must refer to the output log of each model of your simulation. For example, the output file of the ocean model is stored on the file server under this name:
IGCM_sys_Put_Out : ocean.output xxxxxxxx/OCE/Debug/xxxxxxxx_ocean.output
you can retrieve them in the RUN_DIR directory of your simulation.
In general, if your simulation stops you can look for the keyword "IGCM_debug_CallStack" in this file. This keyword will come after a line explaining the error you are experiencing.
Example : --Debug1--> IGCM_comp_Update IGCM_debug_Exit : IGCM_comp_Update missing executable create_etat0_limit.e !!!!!!!!!!!!!!!!!!!!!!!!!! !! IGCM_debug_CallStack !! !------------------------!
Your problem could come from a programming error. To find it you can use the text output of the model components located in the Debug subdirectories. Your problem could be caused by the computing environment. This problem is not always easy to identify. It is therefore important to perform benchmark simulations to learn about the usual behavior of a successfully completed simulation.
If the simulation failed due to abnormal exit from the executable, a Debug directory is created in the working directory. It contains output text files of all model components for your configuration. You should read them to look for errors.
In models logs files (out_lmdz.x.err, out_lmdz.x.out, out_orchidee, ...) you will find output for each process of the simulation. You can look at the end of the first process to find main error message.
Your best friend is : grep -i error * ; grep -i 'e r r o r' *ocean.output
Please, take the time to read and analyze modifications you have done in the code. Nobody codes perfectly.
In this case, it's possible to relaunch the main job to run again the last period.
If the simulation stopped before coming to the end due to an error, it is possible to relaunch the latest period after eventual modifications. The simulation will then read run.card to know where to start and the simulation will continue until the end (if the problem was solved).
To relaunch manually you first need to be sure that no files have been stored for the same period. In libIGCM there are 2 scripts that help you do this cleaning up :
path/to/libIGCM/clean_PeriodLength.job
path/to/libIGCM/clean_latestPackperiod.job [CCYY] # CCYY = year up to which you are deleting everything (this year included). By default, it's the current year in run.card
Sometimes, that could be useful (and more effective) to have all the information of the run in the same directory : that allows you to run directly into the RUN_DIR directory, using a Job_debug to be launched. To activate this debug functionality (available from libIGCM rev 1569) :
DRYRUN=4
############################################ # DEBUG PHASE : CREATION OF RUN_DIR # ############################################ You are in development or debug phase You can run directly into the running directory which is here /ccc/scratch/cont003/gencmip6/p86caub/RUN_DIR/7485895_33135/DEBUG-LIBIGCM.02.33135 Inside the run directory you will find a Job_debug_DEBUG-LIBIGCM.02 to be used to launch the run as follows : ccc_msub Job_debug_DEBUG-LIBIGCM.02
You can run post processing jobs once the main job is finished (for example if the post processing job was deactivated in config.card or if you encountered a bug).
You can:
For the first option (recommended) you have to copy (or link ln -s) the files and directories config.card POST, COMP and run.card
cd $PATH_MODIPSL/config/IPSLCM5A/ST11 mkdir -p POST_REDO cd POST_REDO/ cp -pr ../COMP . cp -pr ../POST . cp -pr ../config.card . cp -pr ../run.card .
For more informations about the post-processing, see Running simulation and post-processing
Most of configurations no longer has a Rebuild step, due to the use of parallel I/O (done with XIOS). In most of the case, you can go to the next step. The rebuild step is sill use in some ORCHIDEE configurations
StandAlone=true libIGCM= # Points to the libIGCM directory of the experiment PeriodDateBegin= # beginning date of the last serie to be "rebuilded" NbRebuildDir= # Number of directories in the series to be "rebuilded" # until the PeriodDateBegin REBUILD_DIR= # Path for the backup of files waiting to be reconstructed # (looking like $SCRATCHDIR/IGCM_OUT/.../JobName/REBUILD or $SCRATCHDIR/TagName/JobName/REBUILD for version older than libIGCM_v2.0 # if RebuildFromArchive=NONE) MASTER=${MASTER:=irene|jeanzay} # Select the computing machine : MASTER=irene for example
ccc_msub rebuild_fromWorkdir.job # TGCC sbatch rebuild_fromWorkdir.job # IDRIS
The rebuild job submits pack_output.job automatically.
In case you haven't done it yet, copy config.card COMP POST and run.card (post process only part of the simulation) in the POST_REDO/ directory.
Note: you need to do this part in case the pack_output was not submitted by the rebuild job (if used), or if you encountered a bug.
libIGCM=${libIGCM:=::modipsl::/libIGCM} # path of the libIGCM library MASTER=${MASTER:=irene|jeanzay} # machine on which you work DateBegin=${DateBegin:=20000101} # start date of the period to be packed DateEnd=${DateEnd:=20691231} # end date of the period to be packed PeriodPack=${PeriodPack:=10Y} # pack frequency
ccc_msub pack_output.job # TGCC sbatch pack_output.job # IDRIS
create_ts.job and create_se.job are submitted automatically.
For more informations about the "Pack" : see Concatenation of "PACK" outputs.
In case you haven't done it yet, copy config.card COMP POST and run.card (post process only part of the simulation) in the POST_REDO/ directory.
libIGCM=${libIGCM:=::modipsl::/libIGCM} # path of the libIGCM library MASTER=${MASTER:=irene|jeanzay} # machine on which you work DateBegin=${DateBegin:=20000101} # start date of the period to be packed DateEnd=${DateEnd:=20691231} # end date of the period to be packed PeriodPack=${PeriodPack:=10Y} # pack frequency
ccc_msub pack_debug.job ; ccc_msub pack_restart.job # TGCC sbatch pack_debug.job ; sbatch pack_restart.job # IDRIS
In case you haven't done it yet, copy config.card COMP POST and run.card (post process only part of the simulation) in the POST_REDO/ directory.
TimeSeriesCompleted=
./TimeSeries_Checker.job
./TimeSeries_Checker.job 2>&1 | tee TSC_OUT # Create log file grep Batch TSC_OUT # find all the submitted jobs
"Run for real (y/n)"
In case you haven't done it yet, copy config.card COMP POST and run.card (post process only part of the simulation) in the POST_REDO/ directory.
There are two methods:
./SE_Checker.job
# Create logfile: ./SE_Checker.job 2>&1 | tee SE_OUT # Find all started jobs : grep Batch SE_OUT
StandAlone=true libIGCM= # path of the libIGCM library PeriodDateEnd= # end date of the decade to be processed
ccc_msub create_se.job # TGCC sbatch create_se.job # IDRIS
Transfer config.card, COMP, POST, and run.card (post process part of the simulation only) in the POST_REDO/ directory if you have not done so yet.
ccc_msub monitoring.job # TGCC sbatch monitoring.job # IDRIS
Transfer config.card, COMP, POST, and run.card (post process part of the simulation only) in the POST_REDO/ directory if you have not done so yet.
# DateBegin=19600101 # PeriodDateEnd=19691231
ccc_msub create_se.job # TGCC sbatch create_se.job # IDRIS
IPSLCM coupled model runs three executables (atmosphere, ocean and IO server) that use three separate sets of computing cores. The number of cores attributed to each one should be choose such as the execution times of each executable are as close as possible, to reduce the waiting time.
LUCIA is a tool implemented in OASIS that measure execution and waiting times of each executable, and helps to tune the number of execution cores for each model.
http://www.cerfacs.fr/oa4web/papers_oasis/lucia_documentation.pdf
First install and run a coupled model. Then performs some modifications.
cd modipsl : mv oasis-mct oasis-mct_orig cp -rf $CCCHOME/../../igcmg/igcmg/Tools/oasis3-mct_lucia oasis3-mct cd config/IPSLCM6 ; gmake clean ; gmake
Index: oasis.driver =================================================================== --- oasis.driver (revision 3545) +++ oasis.driver (working copy) @@ -117,6 +117,7 @@ # To be changed # On Irene + ~igcmg/Tools/irene/lucia/lucia # To be changed # On Jean Zay # $HOME/../../psl/rpsl035/LUCIA/lucia fi
Index: oasis.card =================================================================== --- oasis.card (revision 3545) +++ oasis.card (working copy) @@ -4,7 +4,7 @@ [UserChoices] OutputMode=n FreqCoupling=5400 -Lucia=n +Lucia=y
Component - Computation - Waiting time (s) - done on tstep nb LMDZ 1385.77 ( +/- 6.69 ) 7.58 ( +/- 6.14 ) 362 oceanx 1319.37 ( +/- 18.68 ) 85.41 ( +/- 18.70 ) 362 xios.x 0.00 ( +/- 0.00 ) 0.00 ( +/- 0.00 ) 0 New analysis Component - Calculations - Waiting time (s) - done on tstep nb: LMDZ 1379.55 6.45 362 oceanx 1300.79 85.21 362 xios.x 0.00 0.00 0
IGCM_OUT/${TagName}/${SpaceName}/${ExperimentName}/${JobName}/CPL/Debug/${JobName}_*******_oasis_balance.eps