Creates a new process in the BosConfig file and starts it
Synopsis
bos create -server machine -process server_process -type process_type -cmd cmd_line...
[{-noauth |
-localauth}] [-help]
Options
-server machine
Names the server machine on which to create the new process. 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
Names the server process to be created. You can choose any name for a process, but it is recommended that you give the process the same name as
its binary file (and use the same name on every machine running that process). The recommended names are
ftserver
For the Fileset Server process
flserver
For the Fileset Location Server process
upclient
For the client portion of the Update Server, which brings common configuration files and binary files from the System Control and Binary Distribution machines
upserver
For the server portion of the Update Server process
repserver
For the Replication Server process
bakserver
For the Backup Server process
Each process runs under the local identity root and the DCE identity self. However, the process is unauthenticated as far as DFS is concerned.
-type process_type
Specifies the process type. Legal values are simple and cron. Specify simple for continuous processes and cron
for processes that are to run only at specified times.
-cmd
Specifies the commands the BOS Server runs to start the process and, if -type is cron, the time the BOS Server executes the command.
For a simple process, this must be the complete path name to the binary file for the process (for example, dcelocal/bin/flserver for the Fileset Location Server). The commands for some simple processes take options, in which case the entire argument must be surrounded with " " (double quotes).
For a cron process, provide two parameters. The first parameter is either the path name to a binary file to be executed or the complete path name of a command from one of the DFS suites (complete with all of the necessary arguments). Surround this parameter with " " (double quotes) if it contains spaces.
If the specified executable file does not exist, the bos create command does not create an entry in the BosConfig file. Instead, the command displays the following message:
bos: failed to create a new server instance of
type process_type (specified executable not found)
The second parameter for a cron process specifies the time when the BOS Server is to execute the command specified by the first parameter. Use a day and time together to execute the command weekly at the specified time; use a time alone to execute the command daily at the specified time. Day and time specifications have the following format:
[day] hh:mm
Enter the name of the day in all lowercase letters, giving either the whole name or the first three letters as an abbreviation (for example, sunday or sun). Specify the time of day by separating the hours from the minutes with a : (colon). Use 24-hour time (for example, 14:30), or use 1:00 to 12:00 with am or pm (for example, "2:30 pm"). The time part of the option is optional if the day is specified; if the time is excluded, it defaults to 00:00 on the specified day. As shown in the example, enclose the entire entry in " " (double quotes) if it contains a space.
To execute the command only once, specify now instead of a day or a day and time, or issue the command directly; the process entry is removed from the BosConfig file after the command is executed. To place the process entry in the BosConfig file without ever executing it, specify never instead of a time or a day and time.
-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 create command creates a new server process on the server machine specified by -server by creating an entry in the BosConfig file
on the local disk of the machine. The status of the new process entry in both the BosConfig file and memory is set to Run, and the process is started on the server machine (unless
the process is a cron process and the second parameter of the -cmd option is never).
Privilege Required
The issuer must be listed in the admin.bos file on the machine specified by -server.
Examples
The following command creates the simple process flserver on the machine named fs3:
$ bos create /.../abc.com/hosts/fs3 flserver simple dcelocal/bin/flserver
The following command creates the cron process named backup on the machine named fs3. The -localauth option allows the process (which runs unauthenticated) to use the DFS server principal of fs3 to execute the privileged fts clonesys command.
$ bos create /.../abc.com/hosts/fs3 backup cron "dcelocal/bin/fts clonesys -s /.../abc.com/hosts/fs3 -localauth" 5:30
Related Information
Commands: bos delete(8dfs)
Files: BosConfig(4dfs)