The software described in this documentation is either no longer supported or is in extended support.
Oracle recommends that you upgrade to a current supported release.

Chapter 3 Upgrading to Release 1.2

This section describes how to upgrade Oracle Cloud Native Environment from Release 1.1 to Release 1.2.

When the Oracle Cloud Native Environment packages and the Kubernetes cluster are upgraded to Release 1.2, you can use the new features in this release.

Perform each step in this chapter in order to upgrade your environment from Release 1.1 to Release 1.2.

3.1 Changing the Software Packages Source

Disable the ULN channels or Oracle Linux yum server repositories for Releases 1.0, 1.1 and 1.3 and enable the one for Release 1.2.

If the systems are registered to use ULN, use the ULN web interface to subscribe the systems to the ol7_x86_64_olcne12 channel. Make sure you unsubscribe each system from the following channels.

  • ol7_x86_64_olcne

  • ol7_x86_64_olcne11

  • ol7_x86_64_olcne13

  • ol7_x86_64_developer

If you are using the Oracle Linux yum server for system updates, on each node update the oracle-olcne-release-el7 release package and enable the ol7_olcne12 repository. Disable the following repositories:

  • ol7_olcne

  • ol7_olcne11

  • ol7_olcne13

  • ol7_developer

On each node, run: 

sudo yum update oracle-olcne-release-el7
sudo yum-config-manager --enable ol7_olcne12
sudo yum-config-manager --disable ol7_olcne ol7_olcne11 ol7_olcne13 ol7_developer

3.2 Upgrading the Operator Node

Upgrade the operator node with the new Oracle Cloud Native Environment software packages.

To upgrade the operator node:

  1. On the operator node, stop the olcne-api-server service: 

    sudo systemctl stop olcne-api-server.service

  2. Update the Platform CLI, Platform API Server, and utilities packages: 

    sudo yum update olcnectl olcne-api-server olcne-utils

  3. Start the olcne-api-server service: 

    sudo systemctl start olcne-api-server.service

3.3 Upgrading the Kubernetes Nodes

Upgrade the Kubernetes nodes with the new Oracle Cloud Native Environment software packages.

To upgrade the Kubernetes nodes:

  1. On the node to update, stop the olcne-agent service: 

    sudo systemctl stop olcne-agent.service

  2. Update the Platform Agent and utilities packages: 

    sudo yum update olcne-agent olcne-utils

  3. Start the olcne-agent service: 

    sudo systemctl start olcne-agent.service

3.4 Upgrading the Kubernetes Cluster

Upgrade the cluster to Kubernetes Release 1.18.18.

On the operator node, use the olcnectl module update command to upgrade to the latest Kubernetes release available for Oracle Cloud Native Environment Release 1.2. This example upgrades a Kubernetes module named mycluster in the myenvironment environment to Kubernetes Release 1.18.18. 

olcnectl module update \
--environment-name myenvironment \
--name mycluster \
--kube-version 1.18.18

The --kube-version option specifies the release to which you want to upgrade. This example uses release number 1.18.18.

Important

Make sure you upgrade to the latest Kubernetes release. To get the version number of the latest Kubernetes release for Oracle Cloud Native Environment Release 1.2, see Release Notes.

If you are using the NGINX load balancer deployed by the Platform CLI, you should also upgrade NGINX on the control plane nodes. You specify the location from which to pull the NGINX container image used to upgrade NGINX using the --nginx-image option. For example, include this additional line in the olcnectl module update command to upgrade NGINX from the Oracle Container Registry: 

--nginx-image container-registry.oracle.com/olcne/nginx:1.17.7
Important

Make sure you upgrade to the latest NGINX release. To get the version number of the latest NGINX container image for Oracle Cloud Native Environment Release 1.2, see Release Notes.

When each node in the cluster is upgraded to the latest Kubernetes release, the cluster's health is validated and the upgrade completes.

3.5 Upgrading Istio

If you have the Istio module installed, you must also upgrade it.

On the operator node, use the olcnectl module update command to upgrade to the latest Istio release available for Oracle Cloud Native Environment Release 1.2. This example upgrades an Istio module named myistio in the myenvironment environment to Istio Release 1.9.8. 

olcnectl module update \
--environment-name myenvironment \
--name myistio \
--istio-version 1.9.8

The --istio-version option specifies the release to which you want to upgrade. This example uses release number 1.9.8 .

Important

Make sure you upgrade to the latest Istio release. To get the version number of the latest Istio release for Oracle Cloud Native Environment Release 1.2, see Release Notes.

When you upgrade from Istio Release 1.4.10 to 1.9.8, the update iterates through each Istio release up to Release 1.9.8. That is, the nodes are upgraded to Istio Release 1.5.10, then 1.6.12, and finally to 1.9.8.

Important

The Istio Releases 1.5.10 and 1.6.12 should not be used, other than to perform the upgrade to Release 1.9.8.

When each node in the cluster is upgraded to the next Istio release, the cluster's health is validated. If the cluster is healthy, the cycle of back up, upgrade to the next release, and cluster validation starts again, until all nodes are upgraded to the latest release.

Copyright © 2020, 2022, Oracle and/or its affiliates.