Updating the Spyre operator

Edit online

As a cluster administrator, you can configure either an automatic or manual update strategy for the IBM Spyre Operator.

Prerequisites

  • You have cluster administrator privileges for your OpenShift Container Platform cluster.
  • The IBM Spyre Operator is already installed in your cluster.
  • You have reviewed the release notes for the target version to identify any breaking changes or new requirements.
  • You have backed up your current SpyreClusterPolicy configuration.

Updating the Spyre operator

As a cluster administrator, you can configure either an automatic or manual update strategy for the IBM Spyre Operator.

By default, the IBM Spyre Operator follows a sequential update process. This means that if there are several versions between the current version and the version that you intend to update to, OpenShift Lifecycle Manager (OLM) updates the Operator to each of the intermediate versions before it updates it to the final, target version. If you configure automatic updates, OLM automatically updates the Operator to the latest available version, without human intervention. If you configure manual updates, a cluster administrator must manually approve each sequential update between the current version and the final, target version.
  1. Select the Subscription Update Channel, click Save.
  2. Verify if the the CatalogSourse and csv are updated.
  3. Recreate the SpyreClusterPolicy to ensure the upgraded cluster is governed correctly.

Updating the Spyre Operator through the OpenShift Web Console

You can update the IBM Spyre Operator to a newer version through the OpenShift Container Platform Web Console.

Prerequisites

  • You have configured a manual update strategy for the IBM Spyre Operator.
  • A new version of the IBM Spyre Operator is available in your configured channel.

Procedure

  1. From the OpenShift Container Platform Web Console, navigate to Operators and select Installed Operators.
  2. Select the spyre-operator namespace from the project dropdown menu.
  3. Locate the IBM Spyre Operator in the list of installed operators. If an update is available, you will see an Upgrade available status indicator.
  4. Click on the operator name to view details.
  5. Navigate to the Subscription tab.
  6. Review the available update channel and version information.
  7. Click Approve to start the update process.
  8. Monitor the update progress in the operator details page. Wait for the status to show Succeeded.
  9. Verify the new operator version by checking the Installed Version field in the operator details.
  10. Navigate to Workloads > Pods and verify that the operator pods are running with the new version.

Updating the Spyre Operator through the CLI

You can update the IBM Spyre Operator to a newer version using the OpenShift CLI.

Prerequisites

  • You have access to the OpenShift CLI (oc).
  • You have cluster administrator privileges.
  • You have configured a manual update strategy for the IBM Spyre Operator.

Procedure

  1. Check the current operator version by running the following command: 
    oc get csv -n spyre-operator | grep spyre-operator
  2. View available update channels and versions: 
    oc get packagemanifest spyre-operator -n openshift-marketplace -o yaml
  3. Check for pending updates: 
    oc get installplan -n spyre-operator

    The output displays any pending install plans that require approval.

  4. Monitor the update progress: 
    oc get csv -n spyre-operator -w

    Wait until the new ClusterServiceVersion (CSV) shows a Succeeded phase.

  5. Verify the operator pods are running with the new version: 
    oc get pods -n spyre-operator
  6. Check the operator logs to ensure there are no errors: 
    oc logs deployment/spyre-operator-controller-manager -n spyre-operator

Updating the SpyreClusterPolicy after operator update

After updating the IBM Spyre Operator, you may need to update the SpyreClusterPolicy to use new component versions.

Prerequisites

  • The IBM Spyre Operator has been successfully updated to the new version.
  • You have reviewed the release notes to identify required component version updates.

Procedure

  1. From the OpenShift Container Platform Web Console, navigate to Operators > Installed Operators > IBM Spyre Operator.
  2. Select the Spyre Cluster Policy tab.
  3. Click on the existing spyreclusterpolicy resource.
  4. Select the YAML tab to edit the policy.
  5. Update the version fields for the components as needed.
  6. Click Save to apply the changes.
  7. Monitor the rollout of updated components by running the following command: 
    oc get pods -n spyre-operator -w

    Wait for all component pods to restart and reach a Running state.

  8. Verify the SpyreClusterPolicy status shows ready: 
    oc get spyreclusterpolicy -n spyre-operator
  9. Check the SpyreNodeState resources to ensure all devices remain healthy: 
    oc get spyrenodestate -A
  10. For each worker node with Spyre cards, verify the device health:

    Ensure all Spyre cards show a healthy status.