Stopping and Starting Processes Temporarily
| Chapter 4. Monitoring and Controlling Server Processes |

## Stopping and Starting Processes Temporarily

It is sometimes necessary to halt a process temporarily (for example, to make slight configuration changes or to perform maintenance). The commands described in this section change a process's status in the BOS Server's memory only; the effect is immediate and lasts until you change the memory state again (or until the BOS Server restarts, at which time it starts the process according to its entry in the BosConfig file).

To stop a process temporarily by changing its status flag in BOS Server memory to `NotRun`, use the bos shutdown command. To restart a stopped process by changing its status flag in the BOS Server's memory to `Run`, use the bos startup command. The process starts regardless of its status flag in the BosConfig file. You can also use the bos startup command to start all processes marked with status flag `Run` in the BosConfig file, as described in the following instructions.

Because the bos startup command starts a process without changing it status flag in the BosConfig file, it is useful for testing a server process without enabling it permanently. To stop and start processes by changing their status flags in the BosConfig file, see Stopping and Starting Processes Permanently; to stop and immediately restart a process, see Stopping and Immediately Restarting Processes.

### Note

Do not temporarily stop a database server process on all machines at once. Doing so makes the database completely unavailable.

### To stop processes temporarily

1. Verify that you are listed in the /usr/afs/etc/UserList file. If necessary, issue the bos listusers command, which is fully described in To display the users in the UserList file.

          % bos listusers <machine name>

2. Issue the bos shutdown command to stop each process by changing its status flag in the BOS Server's memory to `NotRun`.

          % bos shutdown <machine name> [<instances>+] [-wait]

   where

   sh

     Is the shortest acceptable abbreviation of shutdown.

   machine name

     Specifies the server machine on which to stop processes temporarily.

   instances

     Specifies each process to stop temporarily. Use the name assigned to the process at creation.

   -wait

     Delays the return of the command shell prompt until all specified processes have actually stopped. If you omit the flag, the prompt returns almost immediately, even if all processes are not yet stopped.

### To start all stopped processes that have status flag Run in the BosConfig file

1. Verify that you are listed in the /usr/afs/etc/UserList file. If necessary, issue the bos listusers command, which is fully described in To display the users in the UserList file.

          % bos listusers <machine name>

2. Issue the bos startup command to start each process on a machine that has status flag `Run` in the BosConfig file by changing its status flag in the BOS Server's memory from `NotRun` to `Run`.

          % bos startup <machine name>

   where

   startup

     Must be typed in full.

   machine name

     Specifies the server machine on which you wish to start all processes that have status flag `Run` in the BosConfig file.

### To start specific processes

1. Verify that you are listed in the /usr/afs/etc/UserList file. If necessary, issue the bos listusers command, which is fully described in To display the users in the UserList file.

          % bos listusers <machine name>

2. Issue the bos startup command to start specific processes by changing their status flags in the BOS Server's memory to `Run` without changing their status flags in the BosConfig file.

          % bos startup <machine name> <instances>+

   where

   startup

     Must be typed in full.

   machine name

     Names the server machine on which to start processes.

   instances

     Specifies each process to start. Use the name assigned to the process at creation.

Stopping and Starting Processes Permanently |  | Stopping and Immediately Restarting Processes