bos setrestart(8dfs)

Synopsis

bos setrestart -server machine {-general time | -newbinary time}
[{-noauth | -localauth}] [-help]

Options

-server machine
Specifies the server machine for which restart times are to be set. 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.

-general time
Sets the time at which the BOS Server restarts first itself and then each server process that has an entry in the BosConfig file with a status flag of Run. Specify a day and time to perform the restart weekly at that time; specify a time to perform the restart daily at that 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 through 12:00 with am or pm (for example, "2:30 pm"). As shown in the example, enclose the entry in " " (double quotes) if it contains a space.

You can use either of two additional specifications instead of a time or a day and time:

never
Directs the BOS Server never to perform the indicated type of restart

now
Directs the BOS Server to use the day and time at which the command is issued (for example, Sunday at 2:00 a.m.) as the day and time for the indicated type of restart

If this option is never used to set the general restart time, the default general restart time is Sunday at 4:00 a.m. If you change the general restart time, the recommended frequency for this type of restart is once per week.

-newbinary time
Sets the time at which the BOS Server restarts any server process whose binary file was installed in dcelocal/bin after the current instance of the process started running. The recommended frequency for this type of restart is once per day, so it is standard to specify only a time of day. Use the conventions described for the -general option to express the time of day. The remarks for the -general option concerning never and now also apply to this option.

If this option is never used to set the binary checking time, the default binary checking time is 5:00 a.m.

-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 setrestart command sets the times at which the BOS Server running on the server machine specified by the -server option is to perform one of two types of restarts. The command records the time settings in the BosConfig file. The two types of restart times are

· The time each week when the BOS Server restarts itself and any processes marked with the status flag Run in the BosConfig file. This is equivalent to executing bos restart with the -bosserver option. The default setting is 4:00 a.m. each Sunday morning.

· The time each day when the BOS Server restarts any process currently running for which the binary file in dcelocal/bin was modified since the process was last started (or restarted). The default setting is 5:00 a.m. each day.

To change both times, you must issue the command twice.

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

Cautions
Restarting processes makes them unavailable for a period of time. It is advisable to set the restarts for times of typically low usage to inconvenience as few users as possible.

If the specified time is within one hour of the current time, the BOS Server does not restart the processes until that time on the next day.

Examples
The following command defines a general restart time in the BosConfig file on fs4 that causes all processes on that machine to stop and restart each Saturday morning at 3:30 a.m.:

$ bos setr -s /.../abc.com/hosts/fs4 -gen "sat 3:30"

The following command defines a new binary restart time in the BosConfig file on fs6, instructing the BOS Server on that machine to check for new binary files each evening at 11:45 p.m. and restart any processes for which it finds a new file at that time:

$ bos setr -s /.../abc.com/hosts/fs6 -new 23:45

Related Information
Commands: bos getrestart(8dfs)

bos restart(8dfs)

Files: BosConfig(4dfs)