8 Re-imaging Oracle Database Appliance
Bare metal operating system re-imaging installs Oracle Database Appliance operating system software on the local (boot) drive.
Bare Metal is a non-virtualized Oracle Database Appliance configuration. Oracle Database Appliance ships from the factory with a bare metal configuration, default ISO image and Appliance Manager installed. Use the OS ISO Image to restore the OS to the "shipped from factory" state. Use only when necessary. Reimaging does not patch the firmware or update the component versions; it only re-images the local system disk from an operating system perspective. After imaging is completed, provision the bare metal system.
- Uninstalling Oracle Database Appliance Components
Use the Oracle Database Appliance cleanup deploy utility,/opt/oracle/oak/onecmd/cleanup.pl
to uninstall Oracle Database Appliance components. - Reimaging an Oracle Database Appliance Baremetal System
Reimage Oracle Database Appliance to perform a bare metal restore of Oracle Database Appliance. - Performing Secure Erase of Data on Storage Disks
With this release, you can securely erase data from storage devices. Running the secure erase tool deletes the data on the storage disk permanently. - Redeployment of Oracle Database Appliance
Understand the process to redeploy Oracle Database Appliance.
Related Topics
Uninstalling Oracle Database Appliance Components
Use the Oracle Database Appliance cleanup deploy utility, /opt/oracle/oak/onecmd/cleanup.pl
to uninstall Oracle Database Appliance components.
About the Cleanup Utility
Use the cleanup deploy utility to do the following:
-
Uninstall Oracle Auto Service Request (Oracle ASR)
-
Uninstall Oracle Trace File Analyzer (TFA)
- Uninstall Oracle ORAchk Health Check Tool
-
Uninstall Oracle Grid Infrastructure and the Oracle stack
-
Reset or delete the Oracle Linux udev rules
-
Delete users and groups that were created when the appliance was created.
The script removes the firstnet config and the client access VLAN UNIX_DB, but does not delete any other VLANs. The script also resets any disabled CPU cores and enables all of the cores.
The cleanup utility runs in two modes: default and force mode. In the default mode, the commands used as part of cleanup do not use the force option. The Oracle ASM disk status is changed from MEMBER to FORMER, but ASM header on the disk is not erased. The default mode can be used only for cleaning up or re-provisioning of the same system.
Note:
For High-Availability systems, run the cleanup utility on both nodes sequentially. Ensure that the cleanup utility has completed on the first node, and then start the process on the second node.Running the Cleanup Utility for a Baremetal Deployment
# perl /opt/oracle/oak/onecmd/cleanup.pl [-griduser grid_user] [-dbuser db_user] [-groups comma separated list of groups] [-omausers dbuser1,dbuser2,dbuser3][-erasedata][-nodpr] [-nossh] [f]
When the grid_user and db_user are the same (roleSeparation=false
), you must run the script for each user (-gridUser
and -dbUser
).
cleanup.pl -griduser grid -dbuser oracle -omausers dbuser1,dbuser2,dbuser3
Table 8-1 Command Options for Cleanup Utility
Option | Description |
---|---|
grid_user |
Describes the Oracle Grid Infrastructure user name. The default user is grid .
|
db_user |
Describes the database user name. The default user is oracle Example with
|
groups |
Describes the comma-separated list of groups. The default groups are
oinstall,dba,dbaoper,asmadmin,asmoper,asmdba .
|
omausers |
Describes the comma-separated list of custom users created on a multi-user access enabled Oracle Database Appliance environment. All custom users created after provisioning a multi-user access enabled environment must be removed completely before you reprovision the appliance. |
erasedata |
Completely erases all disks on the Oracle Database system. It is mandatory to run this option if intention of cleanup is to reuse or move these disks on other systems. This option needs to be run on the first node when running on high-availability systems. Example of secure erase:
|
cleanDefNet |
Cleans up the default public network. |
checkHeader |
Checks for OAK/ASM header on disks after successfully running the cleanup script. Use this to validate if the OAK/ASM header was erased by the cleanup script or not.
Example of checking disk header:
|
nodpr |
Forces regular cleanup even if Data Preserving
Reprovisioning environment is detected.Wipes out all data on Oracle
ASM disks. You cannot run the command odacli restore-node
-g after this operation.
On Data
Preserving Reprovisioning environments, the default cleanup mode
is Data Preserving Reprovisioning mode which cleans the
appliance without erasing Oracle SM disks to allow the command
Example:
|
nossh |
Does not attempt to set up SSH on high-availability
deployments. Use this option in cases such as when the scripts using
cleanup.pl are not updated to handle stopping DCS agent,
or if you have forgotten the SSH password, or if SSH is not set up
on the system.
Example:
|
f |
In the force mode, all commands use the force option. The ASM disk header is erased. The Example of default mode:
Example of force mode:
|
Note:
The cleanup utility for bare metal deployments produces a log file. The utility tries to create the log file at/opt/oracle/oak/log/hostname/cleanup/cleanup_timestamp.log
.
If the log cannot be created in that location, then the log is created at
/tmp/cleanup_timestamp.log
.
Reimaging an Oracle Database Appliance Baremetal System
Reimage Oracle Database Appliance to perform a bare metal restore of Oracle Database Appliance.
Bare metal restore uses Oracle Integrated Lights Out Manager (Oracle ILOM) to re-image the Oracle Database Appliance node. The ILOM must be configured before performing a bare metal restore or reimage. Generally, the ILOM is configured as part of readying for deploying Oracle Database Appliance.
Download the Oracle Database Appliance Bare Metal ISO image to your local machine before you launch the Oracle ILOM console.
Parent topic: Re-imaging Oracle Database Appliance
Performing Secure Erase of Data on Storage Disks
With this release, you can securely erase data from storage devices. Running the secure erase tool deletes the data on the storage disk permanently.
Note:
The secure erase tool conforms to the NIST 800-88 standard, also called NIST Special Publication 800-88 (NIST SP 800-88), Guidelines for Media Sanitization.Running the secure erase tool removes data from storage disks permanently. If you have any data on the disk, then take a backup of your storage disk before running the secure erase tool.
Example 8-1 Options for the Secure Erase Tool
Option | Description |
---|---|
-a , --all |
Erases all disks. For example:
|
--disk disk1,disk2
|
Erases specified disks. For example:
|
--dryrun |
Runs the tool in the test mode |
--type HDD|SSD|NVMe |
Erases the type of disk specified |
-v , --verbose |
Displays verbose output |
-h , --help |
Displays all CLI options for the tool |
Parent topic: Re-imaging Oracle Database Appliance
Redeployment of Oracle Database Appliance
Understand the process to redeploy Oracle Database Appliance.
- Download Oracle Database Appliance software.
- Install Oracle Database Appliance software.
- Create the appliance.
For the above steps, run the procedures as described in this guide.
Parent topic: Re-imaging Oracle Database Appliance