4 Upgrading OCCM

This chapter provides information about upgrading the OCCM deployment to the latest release. It is recommended to perform OCCM upgrade in a specific order. For more information about the upgrade order, see Oracle Communications Cloud Native Core, Solution Upgrade Guide.

Note:

You must backup the OCCM configmap before performing an upgrade. During rollback, any configurations and certificates created during the upgrade are lost. Backup allows you to reapply these configurations and certificates in future upgrades. To backup the OCCM configuration and for restoring the configuration from a backup, see OCCM Configuration Backup.

Following steps should be followed while preforming upgrade

  1. Take OCCM configuration backup by taking backup OCCM configmap.
  2. Upgrade OCCM

Note:

Before proceeding with OCCM helm upgrade, you must backup the latest OCCM configmap, and store the backup file in a location from where it can be easily restored.

Overview

OCCM can be upgraded from current version to the latest version using helm upgrade feature.

User can upgrade or Rollback OCCM from a source release to a target release using CDCS or CLI procedures as outlined in the following table:

Upgrade /Rollback Task References Supported for CDCS Supported for CLI
OCCM Configuration Backup NA NA Yes
OCCM Upgrade See Oracle Communications Cloud Native Core, CD Control Server User Guide Yes Yes

4.1 Supported Upgrade Paths

The following table lists the supported upgrade paths for OCCM:

Table 4-1 Supported Upgrade Paths

Source Release Target Release Upgrade Sequence Comments
23.4.x 23.4.x
  • CNC Console
  • OCCM
  • NF
  • cnDBtier

  • CNC Console should be upgraded before OCCM.

  • Helm upgrade OCCM using existing release name.

4.2 Preupgrade Tasks

This section provides information about preupgrade tasks to be performed before upgrading OCCM.

Caution:

  • No configuration should be performed during upgrade.
  • Do not exit from helm upgrade command manually. After running the helm upgrade command, it takes some amount of time (depending upon number of PODs to upgrade) to upgrade all of the services. In the meantime, you must not press "ctrl+c" to come out from helm upgrade command. It may lead to anomalous behavior.

Preupgrade steps:

  1. Keep current occm_custom_values_<version>.yaml file as backup.
  2. Update the new custom_values.yaml defined for target OCCM release, that is occm_custom_values_23.4.4.yaml. For more details about helm configurable parameters, see Configuration Options

4.2.1 OCCM Configuration Backup

OCCM configurations are stored in configmap. You muist take a backup before performing upgrade. These backups can be used to restore the OCCM configuration data.

To perform the backup, run the following command to create a temporary directory and save the json file containing configmap data. This can be used if there is any issue with the configmap data.
  1. Log into the deployment cluster and run the following command to take the data backup of the configmap:
    kubectl get cm <configmap name> -n <namespace> -o json > <backup_filen_name>_backup.json
  2. Run the following command to verify the OCCM configmap name:
    $ kubectl get cm <configmap name> -n <namespace>
    For Example:
    $ kubectl get cm occm-occm -n occm
  3. Run the following command to backup OCCM configmap:
    $ kubectl get cm <configmap name> -o json -n <namespace>  > occm-config-map_<version>_backup.json
    For example:
    $ kubectl get cm occm -o json -n occm > occm-config-map_<version>_backup.json

Note:

You are recommended to take a periodic backup of configmap.

Restore OCCM Configuration

To restore the OCCM configuration, log into to the deployment cluster and run the following command to restore the configmap:
kubectl apply -f occm-config-map_<version>_backup.json

4.3 Upgrade Tasks

This section describes the procedure to upgrade OCCM to the latest release.

  1. Prepare occm_custom_values_<version>.yaml file for upgrade.
  2. Run the following command to upgrade OCCM using existing release release name:
    $ helm upgrade <occm_release_name> <helm_chart> -f <occm_custom_values_<version>.yaml> -n <namespace>
    For example:
    $ helm upgrade occm ocspf-helm-repo/occm -f occm_custom_values_<version>.yaml -n occm
  3. Run the following command to check the status of upgrade:
    $ helm status <occm_release_name> -n <namespace>
    For example:
    $ helm status occm -n occm

Note:

You must use the existing release name for upgrade or rollback.

4.4 Post Upgrade Tasks

This section provides the steps to be performed after upgrading OCCM.

For information on verifying OCCM Installation, see Verifying Installation

4.4.1 Parameters and Definitions During OCCM Upgrade

Table 4-2 OCCM Upgrade Parameters and Definitions

Parameters Definitions
<release_name> OCCM Helm release deployed. It could be found in the output of 'helm list' command
<namespace> OCCM namespace in which release deployed
<helm_chart> OCCM helm chart
<chart_version> OCCM helm chart version in case helm charts are referred from helm repo
<helm_repo> OCCM helm repo
<occm_custom_values_<version>.yaml> OCCM customized values.yaml for target release