Starts processes by changing their status flags to Run in memory without changing their status flags in the BosConfig file
Synopsis
bos startup -server machine [-process server_process...] [{-noauth | -localauth}] [-help]
Options
-server machine
Names the server machine whose processes are to be started. 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.
-process server_process
Specifies each process to be started after its status flag in memory is set to Run. 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.
If this option is omitted, all server processes with a status flag of Run in the BosConfig file that are not running are started after their status flags in memory are set to Run.
-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
This command instructs the BOS Server running on the server machine specified by -server to start either all server processes with a status flag of
Run in the BosConfig file that are not running (if -process is omitted) or each process specified by -process, even if its status flag in the
BosConfig file is NotRun. The status flags of all started processes are changed from NotRun to Run in memory.
Using -process is useful for testing server processes without enabling them permanently. This command does not change the status flag for a process in the BosConfig file.
Cautions
If an instance of a process is already running, the only effect is to guarantee that its status flag is set to Run in memory; it does not start a new instance
of the process. Issue the bos restart command after this command to start a new instance.
Privilege Required
The issuer must be listed in the admin.bos file on the machine specified by -server.
Examples
The following command causes the BOS Server on fs3 to start all processes on that machine marked with a status flag of Run in the BosConfig
file that are not currently running. The status flags of all such processes are set to Run in memory; their status flags remain set to Run in the BosConfig file.
$ bos startup /.../abc.com/hosts/fs3
The following command causes the BOS Server on fs3 to start the Replication Server (repserver process) on that machine by changing its status flag to Run in memory. The process's status flag remains unchanged in the BosConfig file, regardless of its current setting (Run or NotRun).
$ bos startup /.../abc.com/hosts/fs3 repserver
Related Information
Command: bos create(8dfs)
Files: BosConfig(4dfs)