bos restart(8dfs)

Synopsis

bos restart -server machine [{-bosserver | -process server_process...}]
[{-noauth | -localauth}] [-help]

Options

-server machine
Names the server machine on which to stop and restart indicated processes. The BOS Server on this machine executes the command. To run this command using a privileged identity, specify the full DCE path name of the machine. To run this command using the unprivileged identity nobody (the equivalent of running the command with the -noauth option), specify the machine's host name or IP address.

-bosserver
Indicates that all processes, including the current BOS Server, are to stop running. A new BOS Server immediately starts; it then restarts all processes with the status flag Run in the dcelocal/var/dfs/BosConfig file.

Provide this option or provide the -process option. Omit both options to stop all processes except the BOS Server; those with the status flag Run in the BosConfig file are immediately restarted.

-process server_process
Specifies each process to be stopped and immediately restarted. The BOS Server stops all specified processes that are currently running; it then restarts all of the specified processes, regardless of their status flags in the BosConfig file. Refer to a process by the name assigned with the -process option of the bos create command (this name appears in the output from the bos status command). Do not include bosserver in the list of processes; use the -bosserver option instead.

Provide this option or provide the -bosserver option. Omit both options to stop all processes except the BOS Server; those with the status flag Run in the BosConfig file are immediately restarted.

-noauth
Directs bos to use the unprivileged identity nobody as the identity of the issuer of the command. The command fails if you use this option and DFS authorization checking is not disabled on the machine specified by -server. If you use this option, do not use the -localauth option.

-localauth
Directs bos to use the DFS server principal name of the machine on which the command is issued as the identity of the issuer. Use this option only if the command is issued from a DFS server machine (a machine that has a DFS server principal in the local Registry Database). You must be logged into the server machine as root for this option to work. If you use this option, do not use the -noauth option.

-help
Prints the online help for this command. All other valid options specified with this option are ignored.

Description
The bos restart command instructs the BOS Server running on the server machine specified by -server to stop all indicated processes on the machine. The BOS Server then immediately restarts some or all of the processes, depending on the options included with the command. The processes to be stopped and possibly restarted are specified with the following options:

· The -bosserver option causes the BOS Server to stop all processes, including itself. A new BOS Server immediately starts; it then restarts all processes with the status flag Run in the BosConfig file.

· The -process option causes the BOS Server to stop and immediately restart all specified processes, regardless of their status flags in the BosConfig file. All restarted processes with the status flag NotRun in the BosConfig file have the status temporarily enabled in the output of the bos status command.

· The absence of both the -bosserver and -process options causes the BOS Server to stop all processes except itself. The BOS Server then immediately restarts all processes with the status flag Run in the BosConfig file.

This command can be used to stop only those processes the BOS Server controls. Also, it does not change the status flag for a process in the BosConfig file.

Privilege Required
The issuer must be listed in the admin.bos file on the machine specified by -server.

Examples
The following command instructs the BOS Server on /.../abc.com/hosts/fs3 to stop all processes, including itself. A new BOS Server immediately starts, after which it restarts all processes with the status flag Run in the BosConfig file.

$ bos restart /.../abc.com/hosts/fs3 -bos

The following command instructs the BOS Server on /.../abc.com/hosts/fs5 to stop all processes except itself. The BOS Server then restarts all processes with the status flag Run in the BosConfig file.

$ bos res /.../abc.com/hosts/fs5

Related Information
Commands: bos create(8dfs)

bos status(8dfs)

Files: BosConfig(4dfs)