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.