Upgrading the Management Cluster

A full management node cluster upgrade includes all the required components on all three management nodes: the host OS and the services running on the management cluster. A single command combines the component upgrade procedures described in these sections:

Performing a Full Management Node Upgrade

Using the Service Web UI

  1. In the navigation menu, go to the Maintenance section and click Upgrade Plan. This provides an overview of current and target component versions.

  2. Click Upgrade & Patching to display the Upgrade Jobs page.

  3. In the top-right corner of the Upgrade Jobs page, click Create Upgrade or Patch.

    The Create Request window appears. Choose Upgrade as the Request Type.

  4. Select the appropriate upgrade request type.

    For a full management node upgrade, select Upgrade Rack.

  5. Fill out the upgrade request parameters:

    • Action: To perform the upgrade or patch operation, select Apply.

    • Type: For upgrade, select ISO. The ULN option applies to patching.

    • Component: For the management node cluster, select Full MN.

    • Qualifier: This parameter is not required when upgrading the full management node cluster.

    • Verify Only: Enable this option to run the operation in verification only mode.

    • Force: Enable this option to force the operation. Use only when instructed by Oracle.

  6. Click Create Request.

    The new upgrade request appears in the Upgrade Jobs table.

    Note:

    After upgrade, if the upgrade plan specifies that the management nodes must be rebooted for the changes to take effect, a reboot is performed as part of the upgrade process. No administrator action is required.

  7. Confirm that the upgrade workflow is completed without errors.

    For more information, see Browse the Job Framework.

    After successful completion, all management nodes run the updated operating system and tools. The cluster is fully operational and all platform and infrastructure services are at the latest version.

Using the Service CLI

  1. Enter the upgrade command.

    PCA-ADMIN> upgradeRack type=ISO action=APPLY component=FULL_MN
JobId: 08e269eb-64ee-4521-9c57-f3bc3832b86c
Data: Service request has been submitted. Upgrade Request Id = UWS-915f4e0b-938b-41b1-b5e3-c624258fd616

  2. Use the request ID to check the status of this multi-component upgrade process.

    PCA-ADMIN> getUpgradeStatus requestId=UWS-915f4e0b-938b-41b1-b5e3-c624258fd616
Data:
  Request id = UWS-915f4e0b-938b-41b1-b5e3-c624258fd616
  Status = Running
  Composition ID = full_mn
  Type = ISO
  Previous Build = 3.0.2-b1300385
  Target Build = 3.0.2-b1301270
  Jobs 1 = 1738138865639-host-4035603
  Jobs 2 = 1738138888311-host-4037912
  Jobs 3 = 1738138951952-host-4048064
  Jobs 4 = 1738139013828-kubernetes-4059059
  Jobs 5 = 1738139074871-platform-4068124
  Jobs 6 = 1738139135906-oci-4077263
  Completed Components 1 = host(100.96.2.33)
  Completed Components 2 = host(100.96.2.34)
  Completed Components 3 = host(100.96.2.35)
  Completed Components 4 = kubernetes(generic)
  Completed Components 5 = platform(generic)
  Pending Components 1 = ociImages(Oracle-Solaris-11)
  Pending Components 2 = ociImages(Oracle-Linux8-OKE-1.26.15)
  Pending Components 3 = ociImages(Oracle-Linux8-OKE-1.27.12)
  Pending Components 4 = ociImages(Oracle-Linux8-OKE-1.28.8)
  Pending Components 5 = ociImages(Oracle-Linux-8)
  Pending Components 6 = ociImages(Oracle-Linux-9)
  Pending Components 7 = ociImages(Oracle-Linux-7.9)

  3. Optionally, check the details of an individual upgrade job.

    PCA-ADMIN> getUpgradeJobs requestId=UWS-915f4e0b-938b-41b1-b5e3-c624258fd616
Data:
  id                                 Upgrade Request Id                         Command Name   Result
  --                                 ------------------                         ------------   ------
  1738139135906-oci-4077263          UWS-915f4e0b-938b-41b1-b5e3-c624258fd616   oci            None
  1738139074871-platform-4068124     UWS-915f4e0b-938b-41b1-b5e3-c624258fd616   platform       Passed
  1738139013828-kubernetes-4059059   UWS-915f4e0b-938b-41b1-b5e3-c624258fd616   kubernetes     Passed
  1738138951952-host-4048064         UWS-915f4e0b-938b-41b1-b5e3-c624258fd616   host           Passed
  1738138888311-host-4037912         UWS-915f4e0b-938b-41b1-b5e3-c624258fd616   host           Passed
  1738138865639-host-4035603         UWS-915f4e0b-938b-41b1-b5e3-c624258fd616   host           Passed

PCA-ADMIN> getUpgradeJob upgradeJobId=1738138951952-host-4048064
Data:
  Upgrade Request Id = UWS-915f4e0b-938b-41b1-b5e3-c624258fd61
  Composition Id = full_mn
  Name = host
  Pid = 4048064
  Host = pcamn01
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_host_os_pcamn03_2025_01_29-08.22.31.log
  Arguments = {"component_names":null,"diagnostics":false,"display_task_plan":false,"dry_run_tasks":false,"expected_iso_checksum":null,"fail_halt":false,"fail_upgrade":null,"image_location":null,"online_upgrade":null,"precheck_status":false,"repo_config_override":null,"result_override":null,"task_time":0,"test_run":false,"upgrade":false,"upgrade_to":null,"user_uln_base_url":null,"verify_only":false,"host_ip":"100.96.2.35","log_level":null,"switch_type":null,"epld_image_location":null,"checksum":null,"composition_id":"full_mn","request_id":"UWS-915f4e0b-938b-41b1-b5e3-c624258fd616","uln":null,"patch":"false"}
  Status = Passed
  Execution Time(sec) = 1682
[...]

  4. Confirm that the upgrade workflow is completed without errors.

    For more information, see Browse the Job Framework.

    After successful completion, all management nodes run the updated operating system and tools. The cluster is fully operational and all platform and infrastructure services are at the latest version.