4.3.18.3 DELETE GUEST

This command deletes an existing Oracle VM guest, and removes all of its configuration: instances, software installations, storage, and users from the cluster.

Syntax

DELETE GUEST 
WHERE 
   { SRCNAME=node_name [ STEPNAME=stepname ] |
     SRCNAMES='node_names' [ STEPNAME=stepname ] }

Arguments

• SRCNAME specifies the host name of an existing DomU that you want to delete.

• SRCNAMES specifies a comma-separated list of host names for existing guests that you want to delete. The specified list of host names must be surrounded by quotation marks.

• STEPNAME allows you to undo individual steps of the clone operation.

  The value of stepname can be one of the following:

  • ADD_INSTANCE
  • EXTEND_DBHOME
  • RUN_ROOTSCRIPT
  • CONFIG_CLUSTERWARE
  • CELL_CONNECTIVITY
  • CREATE_USERS
  • CREATE_GUEST

  When used with DELETE GUEST, the STEPNAME clauses should be used in the reverse order of CLONE GUEST steps, and you should not skip any steps. For example, if you want to undo the ADD_NODE and ADD_INSTANCE steps, you would use the following commands:

  DELETE GUEST WHERE SRCNAME=node_name STEPNAME=ADD_INSTANCE
  DELETE GUEST WHERE SRCNAME=node_name STEPNAME=EXTEND_DBHOME
  DELETE GUEST WHERE SRCNAME=node_name STEPNAME=ADD_NODE

Example 4-28 Deleting a Guest

The following example shows an OEDACLI session that uses the DELETE GUEST command along with typical output at each step.

oedacli> delete guest where srcname='dbm01vm103.example.com'
oedacli> save action
oedacli> merge actions
 processMerge
 processMergeActions
 Merging Action : delete guest where srcname='dbm01vm103.example.com'
 Merging DELETE GUEST
 Action Validated and Merged OK
oedacli> deploy actions
 Deploying Action ID : 1 delete guest where srcname='dbm01vm103.example.com'
 Deploying DELETE GUEST
 Delete Guest
 Removing Cell Connectivity...
 Deleting cellip.ora and cellinit.ora on node dbm01vm103.example.com
 Done deleting cellip.ora and cellinit.ora on dbm01vm103.example.com
 Successfully completed removing cell connectivity [elapsed Time [Elapsed = 5018 mS [0.0 minutes] Wed May 05 10:29:51 PDT 2021]]
 Deleting users on dbm01vm103.example.com ...
 Deleting cluster users on node dbm01vm103.example.com
 Deleting cluster users...
 Deleting groups...
 Done deleting users and groups on node dbm01vm103.example.com
 Successfully completed deleting users on node(s) dbm01vm103.example.com[elapsed Time [Elapsed = 6043 mS [0.0 minutes] Wed May 05 10:29:57 PDT 2021]]
 Deleting KVM Guest dbm01vm103.example.com from dom0 dbm01adm03.example.com
 KVM Guest dbm01vm103.example.com deleted successfully.
 Done...
 Done