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:

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.