5 Upgrading OSO

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

Note:

While performing OSO upgrade from 23.3.x and 23.4.0 to 24.1.0, a small outage is expected.

5.1 Supported Upgrade Paths

The following table lists the supported upgrade paths for OSO:

Table 5-1 Supported Upgrade Path

Source Release Target Release
23.4.0 24.1.0
23.3.1 24.1.0

5.2 Prerequisites

Following are the prerequisites for upgrading OSO:
  • Ensure that the system has OSO 23.4.0 or 23.3.x installed and the OSO is working properly.
  • Verify if all the pods and services are up and running.
  • Ensure that the NFs are upgraded after the OSO upgrade.

5.3 Upgrading OSO using CSAR

This section describes the procedure to upgrade an existing OSO using CSAR.

  1. Prepare the ocoso_csar_24_1_0_0_0_custom_values.yaml file by performing the following steps. These .yaml file is used as the input during the upgrade process.
    1. Download OSO CSAR zip file from My Oracle Support (MOS).
    2. Unzip the CSAR zip file:
      $ unzip <OSO CSAR package>
    3. Upload all the artifacts present in the Artifacts/Images folder to the configured repository. For more information on the artifacts, see the Installation Prerequisite section.
    4. Update the Prometheus and Alertmanager ocoso_csar_24_1_0_0_0_custom_values.yaml file present in the Artifacts/Scripts directory with the required values as mentioned in OSO Configuration Parameters.
    5. Untar the Helm charts tgz file available in the Artifacts/Scripts directory.
      cd Artifacts/Scripts
$ tar -xvzf <helm charts.tgz file>
  2. Run the following command to upgrade the existing OSO release:
    $ helm upgrade <release-name> <path to the OSO helm chart> -n <namespace> -f <path to ocoso_csar_24.1.0_custom_values.yaml file>
  3. Post the Helm upgrade a new Prometheus pod spuns up, which is in container creating state. To make it into running state, detach the PVC from old pod in K8s and let it attach to this new upgraded pod. 
    
$ kubectl get deployment -n <oso-namespace>
# Find Prometheus deployment name and replace it in below commands, Both the commands below needs to be run at the same time
$ kubectl -n <oso-namespace> scale deploy <oso-deployment-name> --replicas=0
$ kubectl -n <oso-namespace> scale deploy <oso-deployment-name> --replicas=1
  4. Verify if all the pods are up and running with the latest versions and changes.
  5. Verify if the upgraded OSO is working as expected by performing the Verifying Installation procedure.