Reconfiguring or adding backup settings after installation of the management subsystem on OpenShift and Cloud Pak for Integration
You can reconfigure the backup settings after installation of the management subsystem on OpenShift and Cloud Pak for Integration.
About this task
Backup configurations under
APIConnectCluster instance can be modified using the OpenShift web console, IBM Cloud Pak Platform UI, or the command-line utility
Using OpenShift web console or Platform UI can prevent updates because
APIConnectCluster CR refreshes very quickly. If you
encounter this problem, use the command line to modify backup configurations; for example:
oc edit apiconnectcluster <name-of-instance>
- Make sure that the management cluster status is
Runningand the READY condition displays the same value before and after the "/".
oc get mgmt NAME READY STATUS VERSION RECONCILED VERSION AGE mgmt 16/16 Running 10.0.1-eus 10.0.1.1-eus-0-eus 19h
- Create backup secret for your backup type. See the appropriate instructions:
- Configuring S3 backup settings for a fresh install of the Management subsystem on OpenShift or Cloud Pak for Integration
Configuring SFTP backup settings for fresh install of the Management subsystem on OpenShift and Cloud Pak for Integration
Note that SFTP backups settings are not supported on v10.0.1.0 or earlier.
- Complete the following steps, based on your storage type:
- S3 storage
In 10.0.1.0 and later, you can change or add the
DatabaseBackups3 configuration via the Management section of the API Connect Cluster CR after a fresh install. However, doing so requires a reconfiguration of the database and a brief downtime. The operator restarts the database with the new backup configurations as soon as the new configuration in the management CR is saved.
spec: management: databaseBackup: protocol: objstore s3provider: ibm host: s3.eu-gb.cloud-object-storage.appdomain.cloud/eu-standard path: apic-backup credentials: mgmt-backup-secret schedule: "0 3 * * *" restartDB: accept: trueNote: Version 10.0.1.0 only: The CR entry does not contain the
databaseBackup: s3provider: ibm host: s3.eu-gb.cloud-object-storage.appdomain.cloud/eu-standard path: apic-backup credentials: mgmt-backup-secret schedule: "0 3 * * *" restartDB: accept: true
Configuration of s3 backups uses a new parameter
restartDBthat is required when changing the backup configuration.
restartDBis not required for initial deployments, only for modifications after the cluster is deployed.
Table 1. Additional parameter for S3 backup type reconfiguration Parameter Description
Required when changing the backup configuration. The parameter
acceptis a boolen: <
value> can be
true, and a new configuration for management CR is saved, the operator:
- Stops the database and any dependent services
- Applies the change
- Restarts the stopped components.
restartDBis not required for initial deployments, only for modifications after the cluster is deployed.Note: Reconfiguration on v10.0.1.0 only:
The operator must create an upgrade CR, because the postgres database is re-created as part of database backup configuration change. The new upgrade CR goes to
Completeas soon postgres comes up.
Example: When you change database backup configurations after upgrading API Connect from v10.0.0.0-ifix2 to v10.0.1.0, the operator restarts the postgres database-related components. The operator also creates an upgrade CR, and reaches the
Completestate as soon as all postgres database components (pgbouncer, postgres database) are in
NAME STATUS MESSAGE A GE managementdbupgrade.management.apiconnect.ibm.com/m1-up-g6lcb Complete Upgrade is Complete (DB Schema/data are up-to-date) 1 6m managementdbupgrade.management.apiconnect.ibm.com/m1-up-zqkk5 Complete Fresh install is Complete (DB Schema/data are up-to-date) 63s5s
- SFTP (Version 10.0.1.1-eus or greater only)
In v10.0.1.1-eus and greater, you can change/add the
DatabaseBackupSFTP configuration via the Management section of the API Connect Cluster CR after a fresh install. This process does not involve any downtime. The same backup settings are used for reconfiguring as for initial configuration. For complete description of backup settings, see Configuring SFTP backup settings for fresh install of the Management subsystem on OpenShift and Cloud Pak for Integration.
spec: management: databaseBackup: protocol: sftp host: <SFTP-hostname> port: <SFTP-port> (Optional, default is 22) path: apic-backup retries: 0 credentials: mgmt-backup-secret schedule: "0 3 * * *"Note: Handling of SFTP backup taken on v10.0.1.0.
In v10.0.1.0, you can manually send backup tar files to an SFTP server, as described in Uploading backup files to an sftp server.
You can upgrade from v10.0.1.0 to v10.0.1.1-eus, and configure SFTP backup settings, as described previously in SFTP.
API Connect resyncs upstream SFTP backups and creates relevant backup CRs of type
Note that the latest local backup is also automatically uploaded to the SFTP server if it was not uploaded to SFTP in v10.0.1.0.
- S3 storage