Stopping and Immediately Restarting Processes
| Chapter 4. Monitoring and Controlling Server Processes |

## Stopping and Immediately Restarting Processes

Although by default the BOS Server checks each day for new installed binary files and restarts the associated processes, it is sometimes desirable to stop and restart processes immediately. The bos restart command provides this functionality, starting a completely new instance of each affected process:

- To stop and restart the BOS Server, which then restarts all processes marked with the `Run` status flag in the BosConfig file, include the -bosserver flag.

- To stop and restart all processes marked with the `Run` status flag in the BosConfig file, include the -all flag. The BOS Server does not restart

- To stop and restart specific processes regardless of the setting of their status flags in the BosConfig file, specify the name of each process to restart.

Restarting processes causes a service outage. It is usually best to schedule restarts for periods of low usage. The BOS Server automatically restarts all processes once a week, to reduce the potential for the core leaks that can develop as any process runs for an extended time; see Setting the BOS Server's Restart Times.

### To stop and restart all processes including the BOS Server

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 restart command with the -bosserver flag to stop and restart the BOS Server, which restarts every process marked with status flag `Run` in the BosConfig file.

          % bos restart <machine name>  -bosserver

   where

   res

     Is the shortest acceptable abbreviation of restart.

   machine name

     Specifies the server machine on which to restart all processes.

   -bosserver

     Stops the BOS Server and all processes running on the machine. A new BOS Server instance starts; it then starts new instances of all processes marked with status flag `Run` in the BosConfig file.

### To stop and immediately restart all processes except the BOS Server

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 restart command with the -all flag to stop and immediately restart every process marked with status flag `Run` in the BosConfig file. The BOS Server does not restart.

          % bos restart <machine name> -all

   where

   res

     Is the shortest acceptable abbreviation of restart.

   machine name

     Specifies the server machine on which to stop and restart processes.

   -all

     Stops and immediately restarts all processes marked with status flag `Run` in the BosConfig file.

### To stop and immediately restart 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 restart command to stop and immediately restart one or more specified processes, regardless of their status flag setting in the BosConfig file.

          % bos restart <machine name> <instances>+

   where

   res

     Is the shortest acceptable abbreviation of restart.

   machine name

     Names the server machine on which to restart the specified processes.

   instances

     Specifies each process to stop and immediately restart. Use the name assigned to the process at creation.

Stopping and Starting Processes Temporarily |  | Setting the BOS Server's Restart Times