JavaScript must be enabled to correctly display this content

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 2 Updating to an Errata Release

This section describes how to update Oracle Cloud Native Environment to an errata release. You can use this procedure to update Kubernetes to the latest errata release. This updates the environment within the same major.minor release. For example, Release 1.1 is updated to the latest available software, or Release 1.2 is updated to the latest software.

Perform each step in this chapter in order to update your environment to an errata release.

Important

Do not change the ULN channel or Oracle Linux yum server repository. They should remain as you set them during the installation.

2.1 Updating the Operator Node

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

To update the operator node:

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.

On Oracle Linux 7 enter:
```
sudo yum update olcnectl olcne-api-server olcne-utils
```
On Oracle Linux 8 enter:
```
sudo dnf upgrade olcnectl olcne-api-server olcne-utils
```

Start the olcne-api-server service:

sudo systemctl start olcne-api-server.service

2.2 Updating the Kubernetes Nodes

Update the Kubernetes nodes with the new Oracle Cloud Native Environment packages.

To update the Kubernetes nodes:

On the node to update, stop the olcne-agent service:
```
sudo systemctl stop olcne-agent.service
```
Update the Platform Agent and utilities packages.

On Oracle Linux 7 enter:
```
sudo yum update olcne-agent olcne-utils
```
On Oracle Linux 8 enter:
```
sudo dnf upgrade olcne-agent olcne-utils
```

Start the olcne-agent service:

sudo systemctl start olcne-agent.service

2.3 Updating the Kubernetes Cluster

Update the cluster to the latest Kubernetes errata release.

On the operator node, use the olcnectl module update command to update to the latest Kubernetes errata release. This example updates a Kubernetes module named mycluster in the myenvironment environment to the latest Kubernetes errata release.

olcnectl module update \
--environment-name myenvironment \
--name mycluster

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

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

Important

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

The nodes in the cluster are updated to the latest errata release and the cluster's health is validated.

Important

If you are updating from Release 1.2.0 to 1.2.2, or from Release 1.1.x to 1.1.10, you must also update your cluster to configure access to externalIPs. For information on the steps required, see Chapter 5, Updating to Release 1.2.2 and 1.1.10.