Changes between Version 50 and Version 51 of RoseCylc/Hints


Ignore:
Timestamp:
12/04/17 12:02:42 (3 years ago)
Author:
annette
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • RoseCylc/Hints

    v50 v51  
    1818export ROSE_VERSION=YYYY.MM.DD 
    1919}}} 
    20 Note: You should use same versions of Rose and Cylc on puma and Archer.  
     20Note: You should use same versions of Rose and Cylc on puma and Archer. 
    2121 
    2222=== Viewing the suite run graph without running === 
     
    151151If there are any clashes, you will need to resolve them.  
    152152 
     153=== Check which suites you have running ===  
     154 
     155For a command-line listing of your running suite:  
     156{{{ 
     157rose suite-scan  
     158}}}  
     159 
     160To see a graphical summary status of all of your suites, use:  
     161{{{ 
     162cylc gscan &  
     163}}} 
     164You can then click on each of the suites to open the usual cylc suite control GUI.  
    153165 
    154166== Troubleshooting common errors ==  
     
    248260}}} 
    249261 
    250 === Rose suite running but can't shutdown === 
    251  
    252 A rose suite is supposedly running, i.e. {{{rose suite-scan}}} gives something like:  
     262=== Problems shutting down suites === 
     263 
     264'''Types of shutdown''' 
     265 
     266By default when you try to shutdown a suite, cylc will wait for any currently running tasks to finish before stopping, which may not be what you want to do. You can also tell cylc to kill any active processes or ignore running processes and force the suite to shutdown anyway. The latter is what you will need to do if the suite has got stuck: 
     267{{{ 
     268rose suite-shutdown -- --now 
     269}}}  
     270 
     271To access these options in the cylc GUI, go to "Control" -> "Stop Suite".  
     272See also {{{rose help suite-shutdown}}} for further details.   
     273 
     274'''Forcing shutdown''' 
     275 
     276Sometimes after trying to shutdown a suite, it will still appear to be running.  
     277 
     278First make sure you have used the correct shutdown command and aren't waiting for any unfinished tasks (see above). It can take cylc a little while to shut down everything properly, so be patient and give it a few minutes.  
     279 
     280If it still appears to be running (for example you get an error when you try to re-start the suite), you may have to do the following:  
     281* Manually kill the active processes:[[br]] 
     282  Get a list of processes associated with the suite. For example, for suite `u-ak194`:  
     283{{{ 
     284puma u-ak194$ ps -elf  | grep u-ak194 
     2850 S annette   2735  5230  0  80   0 -  1322 pipe_w 11:53 pts/157  00:00:00 grep u-ak194 
     2861 S annette  18713     1  0  80   0 - 59140 -      08:41 ?        00:00:08 python /home/fcm/cylc-6.11.4/bin/cylc-restart u-ak194 
     2871 S annette  18714 18713  0  80   0 - 28132 futex_ 08:41 ?        00:00:00 python /home/fcm/cylc-6.11.4/bin/cylc-restart u-ak194 
     2881 S annette  18715 18713  0  80   0 - 28132 futex_ 08:41 ?        00:00:00 python /home/fcm/cylc-6.11.4/bin/cylc-restart u-ak194 
     2891 S annette  18717 18713  0  80   0 - 28132 futex_ 08:41 ?        00:00:00 python /home/fcm/cylc-6.11.4/bin/cylc-restart u-ak194 
     2901 S annette  18718 18713  0  80   0 - 28132 pipe_w 08:41 ?        00:00:00 python /home/fcm/cylc-6.11.4/bin/cylc-restart u-ak194 
     291}}} 
     292  This gives a list of processes. The number in the 4h column is the process-id. Use this to kill each of the processes, eg:  
     293{{{ 
     294kill -9 18713 
     295}}} 
     296* Delete the port file: [[br]] 
     297  This lives under `~/.cylc/ports/`. For example:  
     298{{{ 
     299rm ~/.cylc/ports/u-ak194 
     300}}} 
     301 
     302'''Monsoon''' 
     303 
     304On Monsoon, you may need to log in to the cylc VM to force a suite shutdown.  
     305 
     306You may occasionally see that a rose suite looks like it is running, i.e. {{{rose suite-scan}}} gives something like:  
    253307{{{ 
    254308puma-aa046 gmslis@exvmscylc:7767