rmhost

Purpose

Use the rmhost command to remove a host from the Oracle Secure Backup administrative domain. When you remove a host, Oracle Secure Backup destroys all information pertinent to the host, including:

• Configuration data

• Incremental backup state information

• Metadata in the backup catalog

• Device attachments

• Preferred network interface references

Moreover, when you remove a UNIX or Windows host, Oracle Secure Backup contacts that host and directs it to delete the administrative domain membership information that it maintains locally. You can suppress this communication if the host is no longer accessible.

Prerequisites

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

Syntax

rmhost::=

rmh•ost [ --nq ] [ --nocomm/-N ] hostname ...

Semantics

--nq

Does not display a confirmation message. If you do not specify this option, then the command displays a confirmation message. The message is described in "Command Execution in Interactive Mode".

--nocomm/-N

Suppresses communication with the host machine. Use this option if you want to remove a machine that is not connected to the network. This option does not apply to hosts accessible only through NDMP.

hostname ...

Specifies the name of the host that you want to remove.

Example

Example 2-129 shows that brhost4 is not in service and then removes brhost4 from the administrative domain.

ob> lshost
brhost2          client                            (via OB)   in service
brhost3          mediaserver,client                (via OB)   in service
brhost4          client                            (via OB)   not in service
dlsun1976        client                            (via OB)   in service
stadv07          admin,mediaserver,client          (via OB)   in service
ob> rmhost --nq --nocomm brhost4
ob> lshost
brhost2          client                            (via OB)   in service
brhost3          mediaserver,client                (via OB)   in service
dlsun1976        client                            (via OB)   in service
stadv07          admin,mediaserver,client          (via OB)   in service