4 Upgrading to Release 1.5
Important:
The software described in this documentation is either in Extended Support or Sustaining Support. See Oracle Open Source Support Policies for more information.
We recommend that you upgrade the software described by this documentation as soon as possible.
This section describes how to upgrade Oracle Cloud Native Environment from Release 1.4 to Release 1.5.
When the Oracle Cloud Native Environment packages and the Kubernetes cluster are upgraded to Release 1.5, you can use the new features in this release.
Perform each step in this chapter in order to upgrade your environment from Release 1.4 to Release 1.5.
Changing the Software Packages Source
This section contains information on setting the location for the software packages for the operating system on which you want to upgrade the Oracle Cloud Native Environment software.
Oracle Linux 8
If the operating system on the nodes is Oracle Linux 8, update the package source using the information in this section.
If the systems are registered to use ULN, use the ULN web interface to subscribe each system
to the ol8_x86_64_olcne15
channel. Make sure you unsubscribe each system
from the following channels:
-
ol8_x86_64_olcne14
-
ol8_x86_64_olcne13
-
ol8_x86_64_olcne12
If you are using the Oracle Linux yum server for system updates, on each node update the
oracle-olcne-release-el8
release package. Enable the ol8_olcne15
repository and disable the repositories for the previous
releases. They are:
-
ol8_olcne14
-
ol8_olcne13
-
ol8_olcne12
On each node, run:
sudo dnf update oracle-olcne-release-el8
sudo dnf config-manager --enable ol8_olcne15
sudo dnf config-manager --disable ol8_olcne14 ol8_olcne13 ol8_olcne12
Oracle Linux 7
If the operating system on the nodes is Oracle Linux 7, update the package source using the information in this section.
Disable any ULN channels or Oracle Linux yum server repositories for previous releases and enable the one for Release 1.5.
If the systems are registered to use ULN, use the ULN web interface to subscribe the systems
to the ol7_x86_64_olcne15
channel. Make sure you unsubscribe each system
from the following channels.
-
ol7_x86_64_olcne14
-
ol7_x86_64_olcne13
-
ol7_x86_64_olcne12
-
ol7_x86_64_olcne11
-
ol7_x86_64_olcne
-
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. Enable the ol7_olcne15
repository and disable the following repositories:
-
ol7_olcne14
-
ol7_olcne13
-
ol7_olcne12
-
ol7_olcne11
-
ol7_olcne
-
ol7_developer
On each node, run:
sudo yum update oracle-olcne-release-el7
sudo yum-config-manager --enable ol7_olcne15
sudo yum-config-manager --disable ol7_olcne14 ol7_olcne13 ol7_olcne12 ol7_olcne11 ol7_olcne ol7_developer
Upgrading the Operator Node
Upgrade the operator node with the new Oracle Cloud Native Environment software packages.
To upgrade the operator node on Oracle Linux 8:
-
On the operator node, stop the
olcne-api-server
service:sudo systemctl stop olcne-api-server.service
-
Update the Platform CLI, Platform API Server, and utilities packages:
sudo dnf update olcnectl olcne-api-server olcne-utils
-
Start the
olcne-api-server
service:sudo systemctl start olcne-api-server.service
To upgrade the operator node on Oracle Linux 7:
-
On the operator node, stop the
olcne-api-server
service:sudo systemctl stop olcne-api-server.service
-
Update the Platform CLI, Platform API Server, and utilities packages:
sudo yum update olcnectl olcne-api-server olcne-utils
-
Start the
olcne-api-server
service:sudo systemctl start olcne-api-server.service
Upgrading the Kubernetes Nodes
Upgrade the Kubernetes nodes with the new Oracle Cloud Native Environment software packages.
On the operator node, use the olcnectl environment update
command to upgrade
the Platform Agent on each node in the environment. This example upgrades the Platform Agent
on all nodes in the myenvironment
environment.
olcnectl environment update olcne \ --environment-name myenvironment
The Platform Agent is upgraded and the service is restarted on each node.
Upgrading the Kubernetes Cluster
Upgrade the cluster to Kubernetes Release 1.24.15.
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.5. This example upgrades a Kubernetes module named
mycluster
in the myenvironment
environment to Kubernetes
Release 1.24.15.
olcnectl module update \
--environment-name myenvironment \
--name mycluster \
--kube-version 1.24.15
The --kube-version
option specifies the release to which you
want to upgrade. This example uses release number 1.24.15.
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.5, 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.
Upgrading Istio
If you have the Istio module installed, you must also upgrade it and upgrade the supporting Prometheus and Grafana modules.
Important:
Make sure you upgrade to the latest releases for each component in this section. To get the version numbers of the latest releases for Oracle Cloud Native Environment Release 1.5, see Release Notes.
To upgrade Istio:
-
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.5. This example upgrades an Istio module namedmyistio
in themyenvironment
environment to Istio Release 1.15.7.olcnectl module update \ --environment-name myenvironment \ --name myistio \ --istio-version 1.15.7
The
--istio-version
option specifies the release to which you want to upgrade. This example uses release number 1.15.7.When you upgrade to Istio Release 1.15.7, the update iterates through each Istio release up to Release 1.15.7. 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 Istio release.
-
Upgrade to the latest Prometheus release available for Oracle Cloud Native Environment Release 1.5. This example upgrades the Prometheus module named
prometheus
(the name assigned by default by the Istio module) in themyenvironment
environment to Prometheus Release 2.31.1.olcnectl module update \ --environment-name myenvironment \ --name prometheus \ --prometheus-version 2.31.1
-
Upgrade to the latest Grafana release available for Oracle Cloud Native Environment Release 1.5. This example upgrades the Grafana module named
grafana
(the name assigned by default by the Istio module) in themyenvironment
environment to Grafana Release 7.5.15.olcnectl module update \ --environment-name myenvironment \ --name grafana \ --grafana-version 7.5.15
Upgrading the Oracle Cloud Infrastructure Container Storage Interface Module
If you have the Oracle Cloud Infrastructure Container Storage Interface module installed,
you must also upgrade it. The Oracle Cloud Infrastructure Container Storage Interface module
(oci-csi
) has been renamed to the Oracle Cloud Infrastructure Cloud Controller Manager module (oci-ccm
) in
Release 1.5. The functionality of this module has been improved to add the ability to create
and manage Oracle Cloud Infrastructure load balancers.
During the upgrade of the Oracle Cloud Native Environment Platform API
Server, the module is automatically migrated from oci-csi
to
oci-ccm
, although you still need to update some module options to correctly
configure the module.
To upgrade the oci-ccm
module, on the operator node, use the
olcnectl module update
command. This example upgrades the module named
myoci
in the myenvironment
environment to the
oci-ccm
module Release 1.24.0
olcnectl module update \
--environment-name myenvironment \
--name myoci \
--oci-ccm-version 1.24.0 \
--oci-container-registry "" \
--ccm-container-registry ""
--oci-ccm-version
option specifies the release to which you want to
upgrade. This example uses release number 1.24.0.
Important:
Make sure you upgrade to the latest release of the Oracle Cloud Infrastructure Cloud Controller Manager module. To get the version numbers of the latest releases for Oracle Cloud Native Environment Release 1.5, see Release Notes.
For registry options --oci-container-registry
and
--ccm-container-registry
, the example assumes public registries are being
used, and both options are therefore set to an empty string (""
) to allow the
Platform API Server to automatically configure the correct public container registry from
which to pull the Oracle Cloud Infrastructure Cloud Controller Manager container images. If,
however, you are using private registries, and have already set values for
--oci-container-registry
and --ccm-container-registry
during the installation process, then you do not have to specify these options.
Tip:
If you want to use the Oracle Cloud Infrastructure Cloud Controller Manager module to set up Kubernetes application load balancers, you need to add some additional networking information to the module. For information on the required network settings and how to update the module, see Application Load Balancers.