3 Prepare for Patching

Before you start a patching procedure, make sure that you have the correct permissions, that you refresh the local datacenter mirror and the secondary management node mirror, and that you have downloaded the RPM packages to the appropriate locations. You should also run health checks and perform a system backup before you begin patching procedures.

  1. Verify you have permissions to perform patching operations. Log in to the Service Enclave with an administrator account and enter showcustomcmds patchRequest to ensure you have the correct permissions to use the patching commands.

    PCA-ADMIN> showcustomcmds patchRequest
        patchCN
        patchIlom
        patchOCIImages
        patchSwitch
        patchZfssa
        patchHost
        patchKubernetes
        patchVault
        patchPlatform
        patchMySQL
        patchEtcd
        setUpstreamUlnMirror
        syncUpstreamUlnMirror
        showUpstreamUlnMirror

    Patching permissions are available to these groups: SuperAdmin, Admin, and DR Admin. For more information, see the Administrator Account Management chapter of the Oracle Private Cloud Appliance Administrator Guide.

  2. Log in to the local mirror server and update the Oracle Private Cloud Appliance repositories by entering the following command:

    # /usr/bin/uln-yum-mirror
  3. Ensure the patch RPM files are updated and in the location you expect, and note the path.

  4. After you have updated the local mirror server, update the local repository used for compute node patches by running the syncUpstreamUlnMirror command:

    PCA-ADMIN> syncUpstreamUlnMirror
    Command: syncUpstreamUlnMirror
    Status: Success
    Time: 2022-01-04 15:52:07,120 UTC
    Data:
      Upstream mirror sync started. UpstreamMirror status = success

    View the status of the update using the showUpstreamUlnMirror command.

    PCA-ADMIN> showupstreamUlnMirror
    Command: showupstreamUlnMirror
    Status: Success
    Time: 2022-01-24 17:29:48,965 UTC
    Data:
      Mirror URI = https://host.example.com/yum

    Alternatively, you can perform this step in the GUI.

Using the Service Web UI

  1. In the navigation menu, click ULN Mirror.

  2. In the top-right corner of the ULN Mirror page, click Update ULN Mirror.

    The ULN Mirror window appears.

  3. Click Sync ULN Mirror.

    The ULN mirror is updated.

  4. Ensure the system is in a ready state for patching by performing system health checks. Fix any errors before you proceed with patching a component.

    See the Status and Health Monitoring chapter of the Oracle Private Cloud Appliance Administrator Guide.

  5. Perform a system backup before you apply a patch.

    See the Backup and Restore chapter of the Oracle Private Cloud Appliance Administrator Guide.