Oracle Cloud Infrastructure Documentation

Upgrading the ZFS Storage Appliance

To upgrade the ZFS Storage Appliance outside of the Private Cloud Appliance full rack upgrade workflow, follow these instructions.

To upgrade the operating software of the system's ZFS Storage Appliance, you enter the upgrade command with no additional parameters. The IP addresses of the storage controllers and the location of the firmware package are known, and a single upgrade command initiates a rolling upgrade of both controllers. If a new ILOM firmware version is included for the two controllers, it will be installed as part of this upgrade process.

Caution

Ensure that no users are logged in to the ZFS Storage Appliance or the storage controller ILOMs during the upgrade process.

Do not make storage configuration changes while an upgrade is in progress. While controllers are running different software versions, configuration changes made to one controller are not propagated to its peer controller.

During firmware upgrade the storage controllers are placed in active/passive mode. They automatically return to active/active after the upgrade is completed.

Before You Begin

Before you initiate a ZFS Storage Appliance upgrade, you must disable the node state service to prevent errors in node states after the upgrade.

  1. From a management node, set the provisioning lock by issuing this command:

    pca-admin locks set system provisioning

  2. Perform the ZFS Storage Appliance upgrade using either the Service Web UI or the Service CLI procedure below.

  3. Release the provisioning lock.

    pca-admin locks unset system provisioning

  4. Confirm the lock state.

    pca-admin locks show system

Upgrading the Operating Software

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: 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 ZFS Storage Appliance operating software, select ZFSSA.

    • Qualifier: This parameter is not required when upgrading the ZFS Storage Appliance.

    • 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.

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

    For more information, see Browse the Job Framework.

Using the Service CLI

  1. Enter the upgrade command.

    PCA-ADMIN> upgradeRack type=ISO action=APPLY component=ZFSSA
JobId: 6e6afce0-31bf-47fa-9d82-04e0634cc22b
Data: Service request has been submitted. Upgrade Job Id = 1737620335404-zfssa-658852 Upgrade Request Id = UWS-19412b1f-002d-44cd-bc7c-9c8b5de14e2d

  2. Use the job ID to check the status of the upgrade process.

    PCA-ADMIN> getUpgradeJob upgradeJobId=1737620335404-zfssa-658852
Data:
  Upgrade Request Id = UWS-19412b1f-002d-44cd-bc7c-9c8b5de14e2d
  Name = zfssa
  Pid = 658852
  Host = pcamn01
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_zfssa_ak_2025_01_23-08.18.55.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":null,"log_level":null,"switch_type":null,"epld_image_location":null,"checksum":null,"composition_id":null,"request_id":"UWS-19412b1f-002d-44cd-bc7c-9c8b5de14e2d","uln":null,"patch":"false"}
  Status = Passed
  Execution Time(sec) = 739
[...]

  3. Confirm that the upgrade process is completed without errors.

    For more information, see Browse the Job Framework.