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

## Stopping and Starting Processes Permanently

To stop a process so that the BOS Server no longer attempts to monitor it, issue the bos stop command. The process's status flag is set to `NotRun` in both the BOS Server's memory and in the BosConfig file. The process does not run again until you issue the bos start command, which sets its status flag back to `Run` in both the BOS Server's memory and in the BosConfig file. (You can also use the bos startup command to start the process again without changing its status flag in the BosConfig file; see Stopping and Starting Processes Temporarily.)

There is no entry for the BOS Server in the BosConfig file, so the bos stop and bos start commands do not control it. To stop and immediately restart the BOS Server along with all other processes, use the -bosserver flag to the bos restart command as described in Stopping and Immediately Restarting Processes.

### Note

If you are starting or stopping a database server process in the manner described in this section, follow the complete instructions in the OpenAFS Quick Beginnings for creating or removing a database server machine. If you run one database server process on a given machine, you must run them all; for more information, see About Starting and Stopping the Database Server Processes. Similarly, if you are stopping the upserver process on the system control machine or a binary distribution machine, you must complete the additional tasks described in About Starting and Stopping the Update Server.

### To stop a process by changing its status to NotRun

1. Verify that you are authenticated as a user 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 stop command to stop each process and set its status flag to `NotRun` in the BosConfig file and the BOS Server's memory.

          % bos stop <machine name> <server process name>+ [-wait]

   where

   sto

     Is the shortest acceptable abbreviation of stop.

   machine name

     Specifies the server machine on which to stop the process.

   server process name

     Names each process to stop, using the name assigned when its entry was defined with the bos create command.

   -wait

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

### To start processes by changing their status flags to Run

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 start command to change each process's status flag to `Run` in both the BosConfig file and the BOS Server's memory and to start it.

          %  bos start <machine name> <server process name>+

   where

   start

     Must be typed in full.

   machine name

     Specifies the server machine on which to start running each process.

   server process name

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

Creating and Removing Processes |  | Stopping and Starting Processes Temporarily