updatehost

Purpose

Use the updatehost command to instruct Oracle Secure Backup to complete the inclusion of a host in the administrative domain. Typically, you use this command when you initially configured a host when it was offline.

When you execute the mkhost or chhost command for a host, Oracle Secure Backup exchanges messages with the host to inform it of its new state. If you execute mkhost or chhost with the --nocomm option because communication with the host is not possible, then the host contains out-of-date configuration information. When the host becomes available, use an updatehost command to synchronize the Oracle Secure Backup configuration information between the administrative server and the host.

Prerequisites

You must have the modify administrative domain's configuration right to use the updatehost command.

Syntax

updatehost::=

updateh•ost [ --force/-f ] hostname ...

Semantics

--force/-f

Forces an update. The updatehost command normally fails if the internal name (UUID) stored on the subject host disagrees with the internal name for the subject stored on the administrative server. This situation arises if the subject host is reassigned to this administrative domain from another domain. To update the subject host regardless of this situation, use --force.

hostname ...

Specifies the name of the host to update. Note that this command is useful only for hosts accessed by means of the Oracle Secure Backup protocol. NDMP hosts do not maintain any Oracle Secure Backup state data and are therefore not applicable to this function.

Example

Example 2-158 updates a host that had been offline when it was added with the mkhost command.

ob> lshost
brhost2          client                            (via OB)   in service
brhost3          mediaserver,client                (via OB)   in service
dlsun1976        client                            (via OB)   not in service
stadv07          admin,mediaserver,client          (via OB)   in service
ob> updatehost dlsun1976
ob> pinghost dlsun1976
dlsun1976:               Oracle Secure Backup and NDMP services are available