Changes between Version 26 and Version 27 of startstop


Ignore:
Timestamp:
11/15/11 16:35:36 (10 years ago)
Author:
branden
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • startstop

    v26 v27  
    2020== Interactive commands == 
    2121 
    22 Startstop will repond to the following commands from the status console window. There are similar command line versions of each command as well. 
     22Startstop will repond to the following commands from the status console window. There are similar command line versions (e.g., quit and pau) of each command as well. 
     23 
     24=== quit === 
     25Completely shuts down EARTHWORM and all modules/ rings.  
     26 
     27 * Starstop will send all child processes (modules) a request to quit, and will kill them if they don't quit within 30 seconds or so. It will then shut itself down. 
     28 * The command line equivalent to "quit" is called "pau". 
     29 
     30=== pau === 
     31Completely shuts down EARTHWORM and all modules/ rings.  
     32 
     33 * The command line equivalent of "quit".  
     34 
     35=== pidpau === 
     36Given an Earthworm module process ID, pidpau stops it. 
     37 
     38 * The command line equivalent of "stopmodule". 
     39 
     40=== reconfigure === 
     41Allows adding new modules or rings to a running Earthworm.  
     42 
     43 * Startstop will re-read the startstop_nt.d, starstop_unix.d or startstop_sol.d, and allocate any new rings and start up any new modules it finds in the new .d file. In the process it rereads the earthworm.d and earthworm_global.d, in the event that there have been new module IDs or new ring IDs added there. 
     44 * As the final reconfigure step, statmgr is restarted as well so it re-reads it's config file. Any modules that were added to startstop*d should be added to the statmgr.d config file as well. 
     45 * The command line version does the same thing. 
     46 * Within startstop, this can be abbreviated to just "recon". 
     47 
     48=== restart === 
     49Allows manual restarting of individual modules. 
     50{{{ 
     51restart <pid> or restart <module name> 
     52}}} 
     53 
     54 * Startstop will send the module a message to exit, and may try and kill it if it doesn't quit by itself in a certain period of time. Next startstop  will attempt to start the process back up. 
     55 * Note that the <module name> must be unique for this to work as an argument. The command line version can only accept the pid (Process Id) as an argument. 
     56 
     57=== StartstopConsole === 
     58Creates a command prompt window with access to startstop_service (Windows only). 
    2359 
    2460=== status === 
     
    2662 * Within startstop, status can be invoked by hitting the "Enter" key 
    2763 
    28 === restart === 
    29 {{{ 
    30 restart <pid> or restart <module name> 
    31 }}} 
    32  
    33  * Startstop will send the module a message to exit, and may try and kill it if it doesn't quit by itself in a certain period of time. Next startstop  will attempt to start the process back up. 
    34  * Note that the <module name> must be unique for this to work as an argument. The command line version can only accept the pid (Process Id) as an argument. 
    35  
    3664=== stopmodule === 
     65Given an Earthworm module process ID, stopmodule stops it, and startstop marks it as "Stop" to prevent [wiki:statmgr statmgr] from restarting it. 
    3766{{{ 
    3867stopmodule <pid> or stopmodule <module name> 
     
    4473 * The command-line "stopmodule" should mark the module as intentionally stopped, showing up as "Stop" in the status listing. This differes from the command line tool "pidpau" which will simply kill a module. It won't be marked as "Stop" so if statmgr is set to monitor and restart this particular module a process killed by "pidpau" will get started back up again. A module stopped by "stopmodule" should not. 
    4574 * The module is stopped only for the duration that this startstop session is running! If you want to permanently stop a module, you'll also want to remove it from the startstop*d, and the statmgr.d files so it doesn't get started up next time around. 
    46  
    47 === reconfigure === 
    48  * Startstop will re-read the startstop_nt.d, starstop_unix.d or startstop_sol.d, and allocate any new rings and start up any new modules it finds in the new .d file. In the process it rereads the earthworm.d and earthworm_global.d, in the event that there have been new module IDs or new ring IDs added there. 
    49  * As the final reconfigure step, statmgr is restarted as well so it re-reads it's config file. Any modules that were added to startstop*d should be added to the statmgr.d config file as well. 
    50  * The command line version does the same thing. 
    51  * Within startstop, this can be abbreviated to just "recon". 
    52  
    53 === quit === 
    54  * Starstop will send all child processes (modules) a request to quit, and will kill them if they don't quit within 30 seconds or so. It will then shut itself down. 
    55  * The command line equivalent to "quit" is called "pau". 
    5675 
    5776'''Solaris, Linux, Mac OS X versions'''