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, redeploy the End User image, then restore from backup, as needed.
Cleaning Up Incomplete or Failed Installations
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 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 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 cleanup.pl [-griduser grid_user] [-dbuser db_user] [-groups comma separated list of groups] [-erasedata] [f]
When the grid_user and db_user are the same (
roleSeparation=false), you must run the script for each user (
Table 8-1 Command Options for Cleanup Utility
||Describes the Oracle Grid Infrastructure user name. The default user is
||Describes the database user name. The default user is
||Describes the comma-separated list of groups. The default groups are
Completely erases all disks on system. It is mandatory to run this option if intention of cleanup is to reuse or move these disks on other systems.
Example of secure erase:
||Cleans up the default public network.|
Example of checking disk header:
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:
Running the Cleanup Script for a Virtualized Platform Deployment
Use this cleanup deploy script tool to clean up a Virtualized Platform deployment on Oracle Database Appliance.
Run the following command from dom0 on Node 0 to remove ODA_BASE and the initial network configuration.
Restoring an Oracle Database Appliance Baremetal System
Re-image Oracle Database Appliance to perform a bare metal restore of Oracle Database Appliance.
Bare metal restore uses Oracle Integrated Lights Out Manager (ILOM) to re-image the Oracle Database Appliance node. The ILOM must be configured before performing a bare metal restore or re-image. 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 ILOM console.
- Open a browser and connect to Oracle Integrated Lights Out Manager (ILOM) on Node 0 as root. https://ilom-ip-address
- Launch the Remote Console.
- Expand Remote Control in the left navigation.
- Click the Redirection tab.
- Click Launch for the Remote Console in the Actions menu.The state of the system determines what appears on the Console page.
- Add the image.
- Click the KVMS tab, then select Storage.
- Click Add.
- Browse to the Oracle Database Appliance Bare Metal ISO Image, highlight the image, then click Select.
- Click Connect.The mounting of the ISO image is successful when the Connect button changes to a Disconnect button.
- Click OKThe CD-ROM icon in the top right corner is highlighted.
- Configure the CD-ROM as the next boot device.
- Expand Host Management in the left menu of the ILOM Remote Console tab.
- Click Host Control.
- Select CDROM from the Next Boot Device menu, then click Save.
- Power cycle the node.
- Click Power Control in the Host Management menu.
- Select Power Cycle , then click Save.
When the node comes back after the power cycle, re-imaging starts automatically. The Oracle Linux page appears, followed by the Running Post-Install scripts page.
The Running Post-Install scripts page is a static page and might give the impression that the re-imaging process is not progressing. The post-install process during re-imaging will wait until the synchronization between the partitions of the two mirrored local hard disks is complete, which can take 15 to 20 minutes to complete.
To check the progress of re-synchronization, press the ALT-F2 key combination to open a second console and enter the following command:
# cat /proc/mdstat
When the re-synchronization is complete, re-imaging is completed and the machine restarts.
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: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.
oakdand the database and Oracle Grid Infrastructure before running the secure erase tool.On bare metal systems, run the command:
#odaadmcli stop oak
On virtualized platforms:
#oakcli stop oak
To stop Oracle Clusterware resources:
#crsctl stop crs -f
- Run the secure erase tool:
- You can also run the secure erase tool when running the cleanup tool:
# cleanup.pl -erasedata
Example 8-1 Options for the Secure Erase Tool
||Erases all disks. For example:
||Erases specified disks. For example:
||Runs the tool in the test mode|
||Erases the type of disk specified|
||Displays verbose output|
||Displays all CLI options for the tool|
Installing Oracle ORAchk Health Check Tool after Re-imaging the Appliance
For Oracle Database Appliance bare metal systems, you must manually reinstall Oracle ORAchk Health Check Tool after re-imaging the appliance.
- Navigate to the
# ls -l /root/Extras/orachk* -r--r--r--. 1 root root 80315766 Oct 15 14:05 /root/Extras/orachk-18.3.0_20180808-2.x86_64.rpm
- Run the Oracle ORAchk Health Check Tool RPM:
rpm -i /root/Extras/orachk-18.3.0_20180808-2.x86_64.rpm
- Verify that Oracle ORAchk Health Check Tool is installed.
# orachk Clusterware stack is running from /u01/app/184.108.40.206/grid. Is this the correct Clusterware Home?[y/n][y] ...