Backup Before Appliance Update

For system-critical components and services, Oracle Private Cloud Appliance runs a scheduled backup service that allows the appliance to be restored to its last known healthy state in case of a catastrophic failure. It is recommended that you implement a backup strategy for the users' cloud resources in the Compute Enclave as well.

Before upgrading or patching any component of the Private Cloud Appliance, you should create a backup of the latest state of the MySQL database, the ZFS Storage Appliance, and the Secret Service (Vault). The backup commands leverage the existing backup service but create an additional restore point that includes the most recent changes from right before you start an upgrade or patch workflow.

Caution:

In appliance software version 3.0.2-b1081557 and newer, the monitoring data from Prometheus is not included in automated backups. To preserve your Prometheus data, create a backup and restore it manually. For more information, refer to the note with Doc ID 3021643.1.

Using the Service CLI

1. Start the three required backup tasks.

   PCA-ADMIN> backup target=vault
   Status: Success
   Data:
     Type = BackupJob
     Job Id = ocid1.brs-job.PCA3X62D9C1.mypca.joopwuv9403uzbfrh4x9mprmoduh3ljais6ex233v1b21ccqywu4a3vqykgm
     Display Name = brs-job-1668419778-backup
     Profile Id = ocid1.backup_profile.PCA3X62D9C1.mypca.wrxfwtxwxw6ydp2mwnypcaaxxzmwpuhsc33gcm3dyte7kgr4etuhb29qbs8q
     Time Created = 2022-11-06T09:56:18Z
     Lifecycle State = CREATING
     Retention = 14
   
   PCA-ADMIN> backup target=zfs
   Status: Success
   Data:
     Type = BackupJob
     Job Id = ocid1.brs-job.PCA3X62D9C1.mypca.9oaeaa2kw5crqfcjkh8kyhbxcv8bwh0f4ud6n3lucf802oj15ss3k39874bc
     Display Name = brs-job-1668419842-backup
     Profile Id = ocid1.backup_profile.PCA3X62D9C1.mypca.p7w0tgbvhtjqsgc8rllca2cvotkpgrtf4huiph7466mjio0dgskij9f0bp06
     Time Created = 2022-11-06T09:57:22Z
     Lifecycle State = CREATING
     Retention = 14
   
   PCA-ADMIN> backup target=mysql
   Status: Success
   Data:
     Type = BackupJob
     Job Id = ocid1.brs-job.PCA3X62D9C1.mypca.iew5tphpgr3h6mhliw2fai2ywvv386a0xc7isfo8kisj0wrcx114irnit6ot
     Display Name = brs-job-1668419850-backup
     Profile Id = ocid1.backup_profile.PCA3X62D9C1.mypca.henfqzdbafs4z3mxeuslb1c6f4t049w0pxvwf1gi3eb8wm1y11v7m932tn4g
     Time Created = 2022-11-06T09:57:30Z
     Lifecycle State = CREATING
     Retention = 14

2. Use the backup job ID to check the status of the backups.

   PCA-ADMIN> getBackupJobs
   Data:
     id                                                                                              displayName                 components
     --                                                                                              -----------                 ----------
     ocid1.brs-job.PCA3X62D9C1.mypca.iew5tphpgr3h6mhliw2fai2ywvv386a0xc7isfo8kisj0wrcx114irnit6ot    brs-job-1668419850-backup   mysql
     ocid1.brs-job.PCA3X62D9C1.mypca.9oaeaa2kw5crqfcjkh8kyhbxcv8bwh0f4ud6n3lucf802oj15ss3k39874bc    brs-job-1668419842-backup   zfs
     ocid1.brs-job.PCA3X62D9C1.mypca.joopwuv9403uzbfrh4x9mprmoduh3ljais6ex233v1b21ccqywu4a3vqykgm    brs-job-1668419778-backup   vault
   
   PCA-ADMIN> getBackupJob backupJobId=ocid1.brs-job.PCA3X62D9C1.mypca.iew5tphpgr3h6mhliw2fai2ywvv386a0xc7isfo8kisj0wrcx114irnit6ot
   Status: Success
   Data:
     Type = BackupJob
     Job Id = ocid1.brs-job.PCA3X62D9C1.mypca.iew5tphpgr3h6mhliw2fai2ywvv386a0xc7isfo8kisj0wrcx114irnit6ot
     Display Name = brs-job-1668419850-backup
     Time Created = 2022-11-06T09:57:30Z
     Status = success
     Components = mysql

3. Confirm that all three backup operations have completed successfully. Then, proceed to the next upgrade preparation phase.