Changes between Version 25 and Version 26 of startstop


Ignore:
Timestamp:
11/14/11 13:58:04 (10 years ago)
Author:
branden
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • startstop

    v25 v26  
    2222Startstop will repond to the following commands from the status console window. There are similar command line versions of each command as well. 
    2323 
    24  * [#status status]  
    25    * Startstop will display information about the status of Earthworm, including a listing of the rings and of modules. 
    26    * Within startstop, status can be invoked by hitting the "Enter" key 
    27  * [wiki:restart restart] <pid> or restart <module name> 
    28    * 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. 
    29    * 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. 
    30  * [wiki:stopmodule stopmodule] <pid> or stopmodule <module name> 
    31    * 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. Startstop will not try to start the process back up, and statmgr shouldn't try to restart it either. 
    32    * 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. 
    33    * Within startstop, this can be abbreviated to just "stop <pid> or stop <module name>". 
    34     * 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. 
    35    * 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. 
    36  * [wiki:reconfigure reconfigure] 
    37    * 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. 
    38    * 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. 
    39    * The command line version does the same thing. 
    40    * Within startstop, this can be abbreviated to just "recon". 
    41  * [wiki:quit quit] 
    42    * 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. 
    43    * The command line equivalent to "quit" is called "pau". 
     24=== status === 
     25 * Startstop will display information about the status of Earthworm, including a listing of the rings and of modules. 
     26 * Within startstop, status can be invoked by hitting the "Enter" key 
     27 
     28=== restart === 
     29{{{ 
     30restart <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 
     36=== stopmodule === 
     37{{{ 
     38stopmodule <pid> or stopmodule <module name> 
     39}}} 
     40 
     41 * 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. Startstop will not try to start the process back up, and statmgr shouldn't try to restart it either. 
     42 * 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. 
     43 * Within startstop, this can be abbreviated to just "stop <pid> or stop <module name>". 
     44 * 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. 
     45 * 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". 
    4456 
    4557'''Solaris, Linux, Mac OS X versions'''