17 Migrating from Virtualized Platform to KVM on Oracle Database Appliance

Understand how you can migrate your Oracle Database Appliance deployment from virtualized platform to KVM.

About Migrating Oracle Database Appliance from Virtualized Platform to KVM

Understand how you can migrate your virtualized platform deployment to KVM.

You can migrate your Oracle Database Appliance virtualized platform deployment to KVM using the Data Preserving Reprovisioning feature.

Migration Considerations

Following are migration considerations:

  • Virtualized platform (Oracle VM) local repositories are not migrated. Any objects in the local repositories, such as VM or vdisks, must be backed up and manually migrated after the migration.
  • Mount point for repositories (Oracle ACFS file system) is changed from /u01/app/sharedrepo to /u05/app/sharedrepo.
  • VM templates are migrated as offline VMs. They can be used as templates to clone VMs using the command:
     odacli clone-vm -n source_vm_name -cn cloned_vm_name

    If not needed after the migration, then these VM templates can be deleted using the command odacli delete-vm -n vm_name.

  • CPU pools with odd number of cores are not migrated because CPU pools in KVM must have even number of cores. Manually create the CPU pools after migration and assign the CPU pools to the affected VM.
  • The net1 bridge on dom0, usually used as the public network on OVM and priv1, used as the private network for the ODA_BASE are not migrated to KVM vnetwork.
  • VM with attached VLAN without bridge is migrated as pubnet vnetwork.
  • Manual customizations made directly in vm.cfg are not migrated.
  • By default, VM after migration uses virtio. Earlier Linux versions VM such as Oracle Linux 5 which do not have the required virtio support fail to bootstrap correctly. You can change the bus type from virtio to IDE, and then restart the VM.
    odacli modify-vm -n vm_name -dev bus=ide
    To revert it back to the default virtio:
    odacli modify-vm -n vm_name -dev bus=virtio

    This issue can also occur on Microsoft Windows VMs that do not have virtio installed.

  • If migration fails while migrating any infrastructure resources such as repo, cpu pool, vlan, vdisk and vmtemplate), the created resources are reverted back. After the issue is fixed, rerun the command odacli migrate-ovm2kvm for migration.
  • If migration fails while migrating VMs, the migration continues and an error is displayed when you run the command odacli describe-ovm2kvm for each failed VM migration.

  • After migration, the actual device name inside the VM could change. For example, /dev/xvda on the virtualized platform deployment could change to /dev/vda after migration to KVM. If the device name, for example, /dev/xvda is listed in /etc/fstab inside the VM, then the VM can fail to start due to device name change after the migration. If the virtualized platform deployment uses the device name in /etc/fstab, then rename with the label or UUID before migration. For more information about using label or UUID in the file system mount table, that is, /etc/fstab, then refer to the Oracle Linux 7 Managing File Systems Guide at https://docs.oracle.com/en/operating-systems/oracle-linux/7/fsadmin/ol7-fsadmin.html#ol7-s1-fsadmin.
  • The network configuration of the VM could change after the migration. If you cannot connect to the VM after migration, login to VM from the console using the command virsh console vm_name and review and reconfigure the network, if necessary. The configuration steps are specific to the operating system. For details, refer to the operating system documentation.
  • Before migrating a Microsoft Windows VM, install the virtio driver for Windows. Refer to the My Oracle Support Note 2773840.1 Steps for MS Windows guests on ODA Bare Metal for the configuration procedure.

Steps in the Migration Process

Following are the steps in this process:
  1. Run the odaupgradeutil.sh utility.
  2. Reimage the appliance on both nodes.
  3. Run the command odacli restore-node -g to reprovision with Oracle Grid infrastructure and odacli restore-node -d to reprovision the saved databases.
  4. Run the odacli migrate-ovm2kvm command to migrate from virtualized platform to KVM.
  5. Run the command odacli describe-ovm2kvm and examine the migration report for any errors. Fix the issues and then retry the operation.

Migrating from Virtualized Platform to KVM on Oracle Database Appliance

Understand the procedure to migrate from Virtualized Platform to KVM on Oracle Database Appliance.

WARNING:

Do not run cleanup.pl at any time during the migration process. That will erase all the Oracle ASM disk groups on the storage and you will not be able to reprovision your Oracle Database Appliance system with all the Oracle virtualized platform resources intact.

Note:

After migration, the actual device name inside the VM could change. For example, /dev/xvda on the virtualized platform deployment could change to /dev/vda after migration to KVM. If the device name, for example, /dev/xvda is listed in /etc/fstab inside the VM, then the VM can fail to start due to device name change after the migration. If the virtualized platform deployment uses the device name in /etc/fstab, then rename with the label or UUID before migration. For more information about using label or UUID in the file system mount table, that is, /etc/fstab, then refer to the Oracle Linux 7 Managing File Systems Guide at https://docs.oracle.com/en/operating-systems/oracle-linux/7/fsadmin/ol7-fsadmin.html#ol7-s1-fsadmin.

Note:

Run odaupgradeutil on ODA_BASE at the first node (node0) first. After steps 3-5 complete successfully on node0, run steps 3-5 on ODA_BASE at the second node (node1).
Follow these steps. Run the commands on both nodes.
  1. Download the Oracle Database Appliance odaupgradeutil utility to ODA_BASE.
  2. Unzip the software and save it to /opt/oracle directory.

    For example:

    cd /opt/oracle
    unzip p33594115_1920000_Linux-x86-64.zip

    The utility is saved to the /opt/oracle/odaupgradeutil location.

    The supported Oracle Database appliance releases for the migration from virtualized platform to KVM are 19.13.0.0.0, 18.8.0.0.0, 12.2.1.4.0, and 12.1.2.12.0.

  3. Run pre-checks to evaluate whether the system is ready for upgrade. Ensure that the shared repositories on the system are online so that odaupgradeutil can collect the required information on the OVM platform.
    $ ./odaupgradeutil run-prechecks

    Note:

    The commands for odaupgradeutil must be run on ODA_BASE and not dom0.
    The command runs pre-checks related to Oracle Grid Infrastructure, databases, OAK, firmware, and other components. These checks determine whether the current node of the Oracle Database Appliance can be successfully detached. If there are failures reported, then review the failures in the report and take appropriate action. The precheck report is generated in the location /opt/oracle/oak/restore/prechecks/precheck_report.json. The log of the precheck operation is saved at /opt/oracle/oak/restore/log/odaupgradeutil_prechecks_timestamp.log. The odaupgradeutil utility logs are stored at opt/oracle/oak/restore/log.
    For example, run prechecks on the first node:
    [root@node0 odaupgradeutil]# ./odaupgradeutil run-prechecks
    ******************************
    ODAUPGRADEUTIL
    ------------------------------
    Version : 19.20.0.0.0
      Build : 19.20.0.0.0.230629
    ******************************
    
    ########################## ODAUPGRADEUTIL - PRECHECKS - BEGIN ##########################
    Please check /opt/oracle/oak/restore/log/odaupgradeutil_prechecks_25-10-2023_14:54:48.log for details.
    System Version precheck...BEGIN
    System Version precheck...PASSED
    Required Files precheck...BEGIN
    Required Files precheck...PASSED
    OAK precheck...BEGIN
    OAK precheck...PASSED
    ASM precheck...BEGIN
    ASM precheck...PASSED
    Audit Files precheck...BEGIN
    Need to discover DB homes
    Get Database homes...BEGIN
      Database Home: /u01/app/oracle/product/19.0.0.0/dbhome_1, Database Home Name: OraDb19000_home1, Database Home Version: 19.9.0.0.201020
    Get Database homes...SUCCESS
    DB home discovery...DONE
    Audit Files precheck...WARNING
    Custom rpms precheck...BEGIN
    Custom rpms precheck...PASSED
    OVM Repo precheck...BEGIN
    OVM Repos precheck...PASSED
    OVM Local Resources precheck...BEGIN
    OVM Local Resources precheck...WARNING
    ########################## ODAUPGRADEUTIL - PRECHECKS - END ##########################
    Use 'odaupgradeutil describe-precheck-report [-j]' to view the precheck report.
  4. Review the prechecks report.
    [root@node0 odaupgradeutil]# ./odaupgradeutil describe-precheck-report

    For example:

    [root@node0 odaupgradeutil]# ./odaupgradeutil describe-precheck-report
    ******************************
    ODAUPGRADEUTIL
    ------------------------------
    Version : 19.20.0.0.0
      Build : 19.20.0.0.0.230629
    ******************************
    
    COMPONENT       STATUS  MESSAGE                                                               ACTION
    --------------------------------------------------------------------------------------------------------------------------------------------------------------------
    SYSTEM VERSION  PASSED  PASSED                                                                NONE
     
    REQUIRED FILES  PASSED  PASSED                                                                NONE
     
    OAK             PASSED  PASSED                                                                NONE
     
    ASM             PASSED  PASSED                                                                NONE
     
    AUDIT FILES     WARNING Audit files found under ['/u01/app/oracle/product/19.0.0.0/dbhome_    These files will be lost after reimage, advise is to backup if nec
                            1/rdbms/audit', '/u01/app/oracle/admin', '/var/log']                  essary
     
    OSRPMS          PASSED  PASSED                                                                NONE
     
    OVMREPOS        PASSED  PASSED                                                                NONE
     
    OVMLOCALRES     WARNING The following resources: ol7localvm ol7localvmare on local Repos      Please backup these resources and restore them manually
  5. If there are failures in the precheck report, take corrective action as suggested in the ACTION column. After fixing the failures, rerun the precheck as explained in step 3 in this procedure. If there are no failures in the precheck report, then run the command to detach the node:
    [root@node0 odaupgradeutil]# ./odaupgradeutil detach-node
    ******************************
    ODAUPGRADEUTIL
    ------------------------------
    Version : 19.20.0.0.0
      Build : 19.20.0.0.0.230629
    ******************************
    
    ########################## ODAUPGRADEUTIL - SAVECONF - BEGIN ##########################
    Please check /opt/oracle/oak/restore/log/odaupgradeutil_saveconf_25-10-2023_15:04:22.log for details.
    Setting up passwordless SSH login on node1...BEGIN
    root@node1's password:
    Setting up passwordless SSH login...SUCCESS
    Setting up passwordless SSH login on node 0 DOM0(192.168.xx.xx)...BEGIN
    The authenticity of host '192.168.16.24 (192.168.xx.xx)' can't be established.
    RSA key fingerprint is SHA256:itz6YJz5MOTaPHiHwSlwT+SqygySeyaQOVAdKokbdOw.
    RSA key fingerprint is MD5:b4:03:10:b6:07:2a:d2:e1:a6:cf:52:a6:b7:dd:54:6f.
    Are you sure you want to continue connecting (yes/no)? yes
    root@192.168.xx.xx's password:
    Setting up passwordless SSH login...SUCCESS
    Setting up passwordless SSH login on node 1 DOM0(192.168.xx.xx)...BEGIN
    The authenticity of host '192.168.xx.xx (192.168.xx.xx)' can't be established.
    RSA key fingerprint is SHA256:vRmREMGwtsDzLjDUqnuUEnK7jGRdT/wbcYk+AyI+xLg.
    RSA key fingerprint is MD5:40:09:ab:26:f6:0b:53:ee:0e:ee:5d:50:2f:5e:d8:79.
    Are you sure you want to continue connecting (yes/no)? yes
    root@192.168.xx.xx's password:
    Setting up passwordless SSH login...SUCCESS
    Backup files to /opt/oracle/oak/restore/bkp...BEGIN
    Backup files to /opt/oracle/oak/restore/bkp...SUCCESS
    Get provision instance...BEGIN
    Get provision instance...SUCCESS
    Get network configuration...BEGIN
    Get network configuration...SUCCESS
    Get databases...BEGIN
      Database Name: gui
      Oracle Home: /u01/app/oracle/product/19.0.0.0/dbhome_1
    Get databases...SUCCESS
    Get Database homes...BEGIN
      Database Home: /u01/app/oracle/product/19.0.0.0/dbhome_1, Database Home Name: OraDb19000_home1, Database Home Version: 19.9.0.0.201020
      Get Unified Auditing for DB Homes
      Checking Unified Auditing for dbhome [/u01/app/oracle/product/19.0.0.0/dbhome_1]
      Unified Auditing is set to FALSE
    Get Database homes...SUCCESS
    Get Database storages...BEGIN
      Database Name: gui
            DATA destination: +DATA
            RECO destination: +RECO
            REDO destination: +RECO
            Flash Cache destination:
    Get Database storages...SUCCESS
    Get Volumes...BEGIN
    Get Volumes...SUCCESS
    Get Filesystems...BEGIN
    Get Filesystems...SUCCESS
    SAVECONF: SUCCESS
    ########################## ODAUPGRADEUTIL - SAVECONF - END ##########################
    Saving OVM data
    INFO 2023-06-25 15:05:14.534 - The script is running on Node 0
    INFO 2023-06-25 15:05:14.537 - The script is running on ODA platform: X8_2_ODA_HA
    INFO 2023-06-25 15:05:15.194 - create SSH equivalence login to remote node and DOM0
    INFO 2023-06-25 15:05:15.196 - setting up passwordless SSH login to "remote node 1(192.168.xx.xx)"
    INFO 2023-06-25 15:05:15.344 - SSH login to "192.168.xx.xx" already setup
     
    INFO 2023-06-25 15:05:15.345 - setting up passwordless SSH login to "node 0 DOM0(192.168.xx.xx)"
    INFO 2023-06-25 15:05:15.579 - SSH login to "192.168.xx.xx" already setup
     
    INFO 2023-06-25 15:05:15.580 - setting up passwordless SSH login to "node 1 DOM0(192.168.xx.xx)"
    INFO 2023-06-25 15:05:15.771 - SSH login to "192.168.xx.xx" already setup
     
    INFO 2023-06-25 15:05:15.773 - collect data for odabase
    INFO 2023-06-25 15:05:20.047 - backup ODA base vm.cfg files from DOM0
    INFO 2023-06-25 15:05:20.515 - collect data for share repo
    WARNING 2023-06-25 15:05:21.758 - Please backup the data in the following local repos:
    odarepo1
    odarepo2
    INFO 2023-06-25 15:05:25.673 - collect data for vlan
    INFO 2023-06-25 15:05:27.307 - backup network-script files from DOM0
    INFO 2023-06-25 15:05:27.799 - collect data for vdisk
    INFO 2023-06-25 15:05:33.913 - collect data for cpupool
    INFO 2023-06-25 15:05:39.566 - collect data for vm
    INFO 2023-06-25 15:05:46.278 - collect data for vm template
    INFO 2023-06-25 15:05:50.558 - Fix the network interface name from OVM to BM
    INFO 2023-06-25 15:05:50.562 - Interface "eth1" is used for provision
    INFO 2023-06-25 15:05:50.572 - Change the network interface from "eth1" to "btbond1" for provision after migration
    Warning: Permanently added '192.168.xx.xx' (ECDSA) to the list of known hosts.
    OVM data has been saved
    Stopping OVM resources
    Stopping the Resources on the OVM platform
    OVM resources has been stopped
    Process share repo volume information
    Process share repo volume information finish
    ########################## ODAUPGRADEUTIL - DETACHNODE - BEGIN ##########################
    Please check /opt/oracle/oak/restore/log/odaupgradeutil_detachnode_25-06-2023_15:13:07.log for details.
    Deconfigure databases...BEGIN
      Database Name: gui
      Local Instance: gui1
      Local Instance Status: RUNNING
      Stopping instance [gui1]...
      Removing instance [gui1] from CRS...
    Deconfigure databases...SUCCESS
    Deconfigure Grid Infrastructure...BEGIN
    Deconfigure Grid Infrastructure...SUCCESS
    Delete local node configuration from remote node 'node1'...BEGIN
    Local Node 'node1' deleted from cluster. Cluster nodes now [node1]
    DETACHNODE: SUCCESS
    [CRITICAL] Server data archive file(s) generated at /opt/oracle/oak/restore/out . Please ensure the file(s) are copied outside the ODA system and preserved.
    ########################## ODAUPGRADEUTIL - DETACHNODE - END ##########################
    This command saves all the metadata. The current node is detached from the Oracle Grid Infrastructure cluster by deinstalling database and Oracle Grid Infrastructure. The deinstallation does not affect Oracle ASM disk groups and the stored files such as datafiles, control files, and archive logs. Run all the steps in this procedure on each node separately, one node at a time. In high-availability systems, when the command is run on the first node, the services are brought down and software is deinstalled on that node. At this time, the services continue to run on second node, but all the VMs running on the share repositories are shut down. The database, for example, can still be connected to, and queries can be issued. The second node remains functional, until detached, at which point, there is a full downtime of the database and Oracle Grid Infrastructure.
  6. On successful completion of the command on both nodes, the following zip files are generated:
    For High-Availability systems, three zip files are generated:
    /opt/oracle/oak/restore/out/serverarchive_node0_hostname.zip,
    /opt/oracle/oak/restore/out/serverarchive_node1_hostname.zip, and 
    /opt/oracle/oak/restore/out/serverarchive_cluster_name_common.zip
    The serverarchive_node0_hostname.zip and serverarchive_node1_hostname.zip contain the file configure-firstnet.rsp. This file contains the values that you need to provide when running odacli configure-firstnet after reimaging the system.
  7. Copy the files to a location outside of the Oracle Database Appliance system, to prepare the environment for reimage.
  8. Download the Oracle Database Appliance release 19.20 bare metal ISO image, reimage the appliance as described in the topic Reimaging an Oracle Database Appliance Baremetal System, and plumb the network by running the odacli configure-firstnet command on both nodes.

    WARNING:

    Do not run cleanup.pl at any time during the migration process. That will erase all the Oracle ASM disk groups on the storage and you will not be able to reprovision your Oracle Database Appliance system with all the Oracle virtualized platform resources intact.
  9. Download the Oracle Database Appliance Server Patch for the ODACLI/DCS stack and update the repository with the server software file as described in the topic Patching Oracle Database Appliance Bare Metal Systems Using the Command-Line:
    [root@oda1 opt]# /opt/oracle/dcs/bin/odacli update-repository -f /tmp/software_file
  10. Create the pre-patch report for the odacli update-server command by specifying the -s option.
    [root@oda1 opt]# /opt/oracle/dcs/bin/odacli create-prepatchreport -v 19.15.0.0.0 -s

    Fix the warnings and errors mentioned in the report and proceed with the server patching.

  11. Update the server:
    [root@oda1 opt]# /opt/oracle/dcs/bin/odacli update-server -v version

    Updating the server in this step updates only the Oracle ILOM and boot disk firmware since the appliance is not yet reprovisioned.

  12. Update the storage:
    [root@oda1 opt]# /opt/oracle/dcs/bin/odacli update-storage -v version
  13. Update the repository with the server archive files generated in Step 6 of this migration process.
    For High-Availability systems, specify the three zip files generated in step 5 when the nodes are detached.
    [root@oda1 opt]# /opt/oracle/dcs/bin/odacli update-repository -f serverarchive_node0_hostname.zip,serverarchive_node1_hostname.zip,serverarchive_cluster_name_common.zip
  14. Update the repository with the Oracle Grid Infrastructure clone of release 19.20 or later:
    [root@oda1 opt]# /opt/oracle/dcs/bin/odacli update-repository -f odacli-dcs-19.version.0.0.0-date-GI-19.version.0.0.zip
  15. Reprovision the appliance:
    [root@oda1 opt]# /opt/oracle/dcs/bin/odacli restore-node -g
    This command reconfigures networks, operating system users, and operating system groups and installs the latest Oracle Grid Infrastructure. At this step, the installation reuses the existing Oracle ASM disk groups instead of creating new ones.
    For example:
    [root@oda1 opt]# /opt/oracle/dcs/bin/odacli restore-node -g
    Job details                                                      
    ----------------------------------------------------------------
                         ID:  89c005e3-cf5e-4887-968a-7532bf9f993b
                Description:  Restore node service creation
                     Status:  Success
                    Created:  June 13, 2023 11:33:38 AM UTC
                    Message:  
    
    Task Name                                Start Time                          End
    Time                            Status    
    ---------------------------------------- -----------------------------------
    ----------------------------------- ----------
    Restore node service creation            June 13, 2023 11:33:53 AM UTC  June 13, 2023 12:05:43 PM UTC  Success   
    Setting up Network                       June 13, 2023 11:33:56 AM UTC  June 13, 2023 11:33:56 AM UTC  Success   
    Setting up Vlan                          June 13, 2023 11:34:15 AM UTC  June 13, 2023 11:34:15 AM UTC  Success   
    Setting up Network                       June 13, 2023 11:34:34 AM UTC  June 13, 2023 11:34:34 AM UTC  Success   
    Setting up Network                       June 13, 2023 11:34:57 AM UTC  June 13, 2023 11:34:57 AM UTC  Success   
    Setting up Vlan                          June 13, 2023 11:35:16 AM UTC  June 13, 2023 11:35:16 AM UTC  Success   
    Setting up Network                       June 13, 2023 11:35:35 AM UTC  June 13, 2023 11:35:35 AM UTC  Success   
    network update                           June 13, 2023 11:35:58 AM UTC  June 13, 2023 11:36:18 AM UTC  Success   
    updating network                         June 13, 2023 11:35:58 AM UTC  June 13, 2023 11:36:18 AM UTC  Success   
    Setting up Network                       June 13, 2023 11:35:58 AM UTC  June 13, 2023 11:35:58 AM UTC  Success   
    network update                           June 13, 2023 11:36:18 AM UTC  June 13, 2023 11:36:37 AM UTC  Success   
    updating network                         June 13, 2023 11:36:18 AM UTC  June 13, 2023 11:36:37 AM UTC  Success   
    Setting up Network                       June 13, 2023 11:36:18 AM UTC  June 13, 2023 11:36:18 AM UTC  Success   
    OS usergroup 'asmdba'creation            June 13, 2023 11:36:37 AM UTC  June 13, 2023 11:36:37 AM UTC  Success   
    OS usergroup 'asmoper'creation           June 13, 2023 11:36:37 AM UTC  June 13, 2023 11:36:37 AM UTC  Success   
    OS usergroup 'asmadmin'creation          June 13, 2023 11:36:37 AM UTC  June 13, 2023 11:36:38 AM UTC  Success   
    OS usergroup 'dba'creation               June 13, 2023 11:36:38 AM UTC  June 13, 2023 11:36:38 AM UTC  Success   
    OS usergroup 'dbaoper'creation           June 13, 2023 11:36:38 AM UTC  June 13, 2023 11:36:38 AM UTC  Success   
    OS usergroup 'oinstall'creation          June 13, 2023 11:36:38 AM UTC  June 13, 2023 11:36:38 AM UTC  Success   
    OS user 'grid'creation                   June 13, 2023 11:36:38 AM UTC  June 13, 2023 11:36:38 AM UTC  Success   
    OS user 'oracle'creation                 June 13, 2023 11:36:38 AM UTC  June 13, 2023 11:36:38 AM UTC  Success   
    Default backup policy creation           June 13, 2023 11:36:38 AM UTC  June 13, 2023 11:36:39 AM UTC  Success   
    Backup config metadata persist           June 13, 2023 11:36:38 AM UTC  June 13, 2023 11:36:39 AM UTC  Success   
    Grant permission to RHP files            June 13, 2023 11:36:39 AM UTC  June 13, 2023 11:36:39 AM UTC  Success   
    Add SYSNAME in Env                       June 13, 2023 11:36:40 AM UTC  June 13, 2023 11:36:40 AM UTC  Success   
    SSH equivalance setup                    June 13, 2023 11:36:40 AM UTC  June 13, 2023 11:36:40 AM UTC  Success   
    Install oracle-ahf                       June 13, 2023 11:36:42 AM UTC  June 13, 2023 11:37:46 AM UTC  Success   
    Unzipping storage configuration files    June 13, 2023 11:37:47 AM UTC  June 13, 2023 11:37:47 AM UTC  Success   
    Reloading multipath devices              June 13, 2023 11:37:49 AM UTC  June 13, 2023 11:37:51 AM UTC  Success   
    restart oakd                             June 13, 2023 11:38:02 AM UTC  June 13, 2023 11:38:14 AM UTC  Success   
    Reloading multipath devices              June 13, 2023 11:39:17 AM UTC  June 13, 2023 11:39:20 AM UTC  Success   
    restart oakd                             June 13, 2023 11:39:30 AM UTC  June 13, 2023 11:39:41 AM UTC  Success   
    Creating GI home directories             June 13, 2023 11:39:41 AM UTC  June 13, 2023 11:39:41 AM UTC  Success   
    Extract GI clone                         June 13, 2023 11:39:41 AM UTC  June 13, 2023 11:41:14 AM UTC  Success   
    Extract GI clone                         June 13, 2023 11:41:16 AM UTC  June 13, 2023 11:42:48 AM UTC  Success   
    Creating wallet for Root User            June 13, 2023 11:42:51 AM UTC  June 13, 2023 11:42:54 AM UTC  Success   
    Creating wallet for ASM Client           June 13, 2023 11:42:54 AM UTC  June 13, 2023 11:43:01 AM UTC  Success   
    GI Restore with RHP                      June 13, 2023 11:43:02 AM UTC  June 13, 2023 11:55:52 AM UTC  Success   
    Updating GIHome version                  June 13, 2023 11:55:52 AM UTC  June 13, 2023 11:55:54 AM UTC  Success   
    Updating GIHome version                  June 13, 2023 11:55:52 AM UTC  June 13, 2023 11:55:54 AM UTC  Success   
    Mounting disk group DATA                 June 13, 2023 11:55:56 AM UTC  June 13, 2023 11:55:59 AM UTC  Success   
    Mounting disk group RECO                 June 13, 2023 11:56:07 AM UTC  June 13, 2023 11:56:09 AM UTC  Success   
    Mounting disk group REDO                 June 13, 2023 11:56:17 AM UTC  June 13, 2023 11:56:19 AM UTC  Success   
    Post cluster OAKD configuration          June 13, 2023 11:56:19 AM UTC  June 13, 2023 12:01:47 PM UTC  Success   
    Setting ACL for disk groups              June 13, 2023 12:01:47 PM UTC  June 13, 2023 12:01:52 PM UTC  Success   
    Modify DB file attributes                June 13, 2023 12:01:52 PM UTC  June 13, 2023 12:02:06 PM UTC  Success   
    Register Scan and Vips to Public Network June 13, 2023 12:02:11 PM UTC  June 13, 2023 12:02:16 PM UTC  Success   
    Starting FileSystem                      June 13, 2023 12:02:53 PM UTC  June 13, 2023 12:03:04 PM UTC  Success   
    Enabling Volume(s)                       June 13, 2023 12:03:32 PM UTC  June 13, 2023 12:03:42 PM UTC  Success   
    Adding Volume COMMONSTORE to Clusterware June 13, 2023 12:03:42 PM UTC  June 13, 2023 12:03:47 PM UTC  Success   
    Adding Volume DATTDB to Clusterware      June 13, 2023 12:04:01 PM UTC  June 13, 2023 12:04:04 PM UTC  Success   
    Adding Volume RECO to Clusterware        June 13, 2023 12:04:17 PM UTC  June 13, 2023 12:04:20 PM UTC  Success   
    Adding Volume REDO to Clusterware        June 13, 2023 12:04:33 PM UTC  June 13, 2023 12:04:37 PM UTC  Success   
    Starting FileSystem                      June 13, 2023 12:04:50 PM UTC  June 13, 2023 12:05:00 PM UTC  Success   
    Starting FileSystem                      June 13, 2023 12:05:00 PM UTC  June 13, 2023 12:05:11 PM UTC  Success   
    Starting FileSystem                      June 13, 2023 12:05:11 PM UTC  June 13, 2023 12:05:22 PM UTC  Success   
    Starting FileSystem                      June 13, 2023 12:05:22 PM UTC  June 13, 2023 12:05:32 PM UTC  Success   
    Delete public key                        June 13, 2023 12:05:37 PM UTC  June 13, 2023 12:05:37 PM UTC  Success   
    configure Zk Quorum TLS                  June 13, 2023 12:05:38 PM UTC  June 13, 2023 12:05:39 PM UTC  Success   
    Create Trust Store                       June 13, 2023 12:05:39 PM UTC  June 13, 2023 12:05:40 PM UTC  Success   
    Delete Trust Store                       June 13, 2023 12:05:40 PM UTC  June 13, 2023 12:05:40 PM UTC  Success   
    Create Trust Store                       June 13, 2023 12:05:40 PM UTC  June 13, 2023 12:05:41 PM UTC  Success   
    Provisioning service creation            June 13, 2023 12:05:42 PM UTC  June 13, 2023 12:05:42 PM UTC  Success   
    persist new agent state entry            June 13, 2023 12:05:42 PM UTC  June 13, 2023 12:05:42 PM UTC  Success   
    persist new agent state entry            June 13, 2023 12:05:42 PM UTC  June 13, 2023 12:05:42 PM UTC  Success   
    persist new agent state entry            June 13, 2023 12:05:42 PM UTC  June 13, 2023 12:05:42 PM UTC  Success   
    persist new agent state entry            June 13, 2023 12:05:42 PM UTC  June 13, 2023 12:05:42 PM UTC  Success   
    Restart DCS Agent                        June 13, 2023 12:05:42 PM UTC  June 13, 2023 12:05:43 PM UTC  Success   
  16. Update the repository with the Oracle Database clones as described in /opt/oracle/oak/restore/metadata/dbVersions.list:
    [root@oda1 opt]# /opt/oracle/dcs/bin/odacli update-repository -f /tmp/DB_software_file
    For example:
    [root@oda1 opt]# cat /opt/oracle/oak/restore/metadata/dbVersions.list
    # List of all db versions found, to be used for downloading required clones before DB restore
    11.2.0.4.180417
    12.1.0.2.180417
  17. Configure the storage location and size for database homes on Oracle ACFS. For information about creating database homes on Oracle ACFS, see the topic About Creating Database Homes on Oracle ACFS Storage in this guide.
    [root@oda1 opt]# /opt/oracle/dcs/bin/odacli configure-dbhome-storage -dg DATA -s 80
  18. The database files are intact on Oracle ASM disk groups. However, the database software must be reinstalled and the database instances must be restarted. Run the following command to create the database homes on Oracle ACFS and then restart the instances on the nodes. Single-instance Oracle databases and Oracle RAC One Node databases have only one instance running. For Oracle RAC deployments on high-availability systems, the database instances are restarted on both nodes.
    [root@oda1 opt]# /opt/oracle/dcs/bin/odacli restore-node -d
    This command restores the databases to the same versions previous to the migration, on the bare metal system. The databases are restarted and added to the cluster.
  19. Migrate virtualized platform VMs to VMs on KVM:
    [root@oda1 opt]# odacli migrate-ovm2kvm
  20. Check the virtualized platform VMs to KVM migration completed successfully:
    [root@oda1 opt]# odacli describe-ovm2kvm -i ed891da5-f9b5-4a5d-91c0-7a5b8b792990
     
    OVM to KVM migration report                                                    
    --------------------------------------------------------------------------------
                       Job ID:  ed891da5-f9b5-4a5d-91c0-7a5b8b792990
                       Status:  COMPLETED
                   Start time:  2023-05-06 16:33:22 UTC
                     End time:  2023-05-06 16:34:08 UTC
                      Details: 
     
    Description                               Type        Name                       Status      Start                    End                      Details                                                    
    ----------------------------------------  ----------  -------------------------  ----------  -----------------------  -----------------------  ------------------------------------------------------------
    Parse OVM backup                          METADATA    N/A                        COMPLETED   2023-05-06 16:33:22 UTC  2023-05-06 16:33:22 UTC                                                             
    Validate OVM metadata                     METADATA    N/A                        COMPLETED   2023-05-06 16:33:22 UTC  2023-05-06 16:33:22 UTC                                                             
    Validate OVM with DCS metadata            METADATA    N/A                        COMPLETED   2023-05-06 16:33:22 UTC  2023-05-06 16:33:22 UTC                                                             
    Identify OVM storage layout               STORAGE     N/A                        COMPLETED   2023-05-06 16:33:22 UTC  2023-05-06 16:33:22 UTC                                                             
    Validate storage resources                STORAGE     N/A                        COMPLETED   2023-05-06 16:33:29 UTC  2023-05-06 16:33:29 UTC                                                             
    Validate network resources                NETWORK     N/A                        COMPLETED   2023-05-06 16:33:32 UTC  2023-05-06 16:33:32 UTC                                                             
    Validate CPU resources                    CPU_POOL    N/A                        COMPLETED   2023-05-06 16:33:33 UTC  2023-05-06 16:33:33 UTC                                                             
    Validate VM resources                     VM          N/A                        COMPLETED   2023-05-06 16:33:33 UTC  2023-05-06 16:33:33 UTC                                                             
    Create ACFS base mount point              STORAGE     N/A                        COMPLETED   2023-05-06 16:33:34 UTC  2023-05-06 16:33:34 UTC                                                             
    Migrate OVM repo 'repo1'                  STORAGE     repo1                      COMPLETED   2023-05-06 16:33:34 UTC  2023-05-06 16:33:34 UTC                                                             
    Persist VM storages metadata              STORAGE     N/A                        COMPLETED   2023-05-06 16:33:54 UTC  2023-05-06 16:33:54 UTC                                                             
    Migrate OVM vDisk 'System'                STORAGE     System                     COMPLETED   2023-05-06 16:33:54 UTC  2023-05-06 16:33:54 UTC                                                             
    Migrate OVM vDisk 'vdisk1'                STORAGE     vdisk1                     COMPLETED   2023-05-06 16:33:55 UTC  2023-05-06 16:33:55 UTC                                                             
    Migrate OVM vDisk 'vdisk2'                STORAGE     vdisk2                     COMPLETED   2023-05-06 16:33:55 UTC  2023-05-06 16:33:55 UTC                                                             
    Migrate OVM vDisk 'vdisk3'                STORAGE     vdisk3                     COMPLETED   2023-05-06 16:33:55 UTC  2023-05-06 16:33:55 UTC                                                             
    Persist vDisks metadata                   STORAGE     N/A                        COMPLETED   2023-05-06 16:33:56 UTC  2023-05-06 16:33:56 UTC                                                             
    Migrate OVM VLAN 'net2'                   NETWORK     net2                       COMPLETED   2023-05-06 16:33:56 UTC  2023-05-06 16:33:56 UTC                                                             
    Migrate OVM VLAN 'net1'                   NETWORK     net1                       SKIPPED     2023-05-06 16:33:58 UTC  2023-05-06 16:33:58 UTC                                                             
    Migrate OVM VLAN 'vlan10'                 NETWORK     vlan10                     COMPLETED   2023-05-06 16:33:58 UTC  2023-05-06 16:33:58 UTC                                                             
    Persist vNetworks metadata                NETWORK     N/A                        COMPLETED   2023-05-06 16:34:00 UTC  2023-05-06 16:34:00 UTC                                                             
    Migrate OVM Pool 'odaBaseCpuPool'         CPU_POOL    odaBaseCpuPool             SKIPPED     2023-05-06 16:34:00 UTC  2023-05-06 16:34:00 UTC                                                             
    Migrate OVM Pool 'default-unpinned-pool'  CPU_POOL    default-unpinned-pool      SKIPPED     2023-05-06 16:34:00 UTC  2023-05-06 16:34:00 UTC                                                             
    Migrate OVM Pool 'testBaseCpuPool'        CPU_POOL    testBaseCpuPool            COMPLETED   2023-05-06 16:34:00 UTC  2023-05-06 16:34:00 UTC                                                             
    Persist CPU Pools metadata                CPU_POOL    N/A                        COMPLETED   2023-05-06 16:34:00 UTC  2023-05-06 16:34:00 UTC                                                             
    Migrate OVM VM Template 'vt1'             VM          vt1                        COMPLETED   2023-05-06 16:34:00 UTC  2023-05-06 16:34:00 UTC                                                             
    Persist VM Templates metadata             VM          N/A                        COMPLETED   2023-05-06 16:34:03 UTC  2023-05-06 16:34:03 UTC                                                             
    Migrate OVM VM 'vm2'                      VM          vm2                        COMPLETED   2023-05-06 16:34:03 UTC  2023-05-06 16:34:03 UTC                                                             
    Migrate OVM VM 'vm1'                      VM          vm1                        COMPLETED   2023-05-06 16:34:05 UTC  2023-05-06 16:34:05 UTC                                                             
    Persist VMs metadata                      VM          N/A                        COMPLETED   2023-05-06 16:34:07 UTC  2023-05-06 16:34:07 UTC                                                             
    Start VM 'vm2'                            VM          vm2                        COMPLETED   2023-05-06 16:34:07 UTC  2023-05-06 16:34:07 UTC                                                             
    Start VM 'vm1'                            VM          vm1                        COMPLETED   2023-05-06 16:34:07 UTC  2023-05-06 16:34:07 UTC                                                             
    Persist started VMs metadata              VM          N/A                        COMPLETED   2023-05-06 16:34:08 UTC  2023-05-06 16:34:08 UTC                                                              
  21. Verify that all VMs bootstrap correctly. Refer to the Managing an Oracle Database Appliance KVM Deployment chapter in this guide.
  22. Check all vdisks and vnetworks are attached correctly and are visible within the guest VM.

Note:

You have completed migration of your databases from Oracle Database Appliance virtualized platform to the bare metal system. To migrate the databases from Oracle Database Appliance bare metal system to DB system, refer to My Oracle Support Note 2869506.1 at https://support.oracle.com/rs?type=doc&id=2869506.1.