You may sometimes need to stop and then restart a process (for example, to load a new binary file immediately rather than wait for the BOS Server to perform its daily check for new files, which is described in Setting Scheduled Restart Times). You can use the bos restart command to stop and restart any or all processes on a server machine, including the BOS Server itself. The bos restart command can be used to restart only those processes already controlled by the BOS Server. It does not change the status flag for a process in the BosConfig file.
Caution: Restarting some processes can cause a service outage. You should schedule these outages for times of low usage on the system.
1. Verify that you have the necessary privilege. You must be included in the admin.bos file on the machine on which the processes are to be restarted. If necessary, issue the bos lsadmin command to check.
2. There are three ways to use the bos restart command: you can stop and restart specific processes; you can stop and restart all processes, including the BOS Server; or you can stop and restart all processes except the BOS Server.
To stop and restart specific processes, use the -process option with the bos restart command. Specify the name of each server process to be stopped and restarted. The BOS Server stops and immediately restarts all specified processes, regardless of their status flags in the BosConfig file.
$ bos restart -server machine -process server_process...
To restart all processes including the BOS Server, use the -bosserver option with bos restart the command. The BOS Server stops all processes, including itself. A new BOS Server immediately starts; it then restarts all processes with the status flag Run in the BosConfig file.
$ bos restart -server machine -bosserver
The -bosserver option indicates that the BOS Server on -server is to stop all processes, including itself; a new BOS Server starts, restarting all processes with the status flag Run.
To stop and restart all processes except the BOS Server, omit both the -process and -bosserver options from the bos restart command. The BOS Server stops all processes except itself. It then immediately restarts all processes with the status flag Run in the BosConfig file.
$ bos restart -server machine