My Oracle Support Banner

[PCA 2.3.x] Upgrade Checklist and Prerequisites (Doc ID 2242177.1)

Last updated on NOVEMBER 02, 2023

Applies to:

Private Cloud Appliance X5-2 Hardware
Private Cloud Appliance - Version 2.0.5 to 2.3.3 [Release 2.0]
Linux x86-64
Applies to PCA 2.3.1, 2.3.2 and 2.3.3


 This document's purpose is to outline the various checks that needs to be performed before and after the upgrade of a Private Cloud Appliance to release 2.3.1/2.3.2/2.3.3


This document explains the different checks to perform before upgrading a Private Cloud Appliance rack to 2.3.1/2.3.2/2.3.3. Its purpose is not to document the upgrade process itself, but rather list the different aspects that need to be checked before and after performing the actual upgrade.


To view full details, sign in with your My Oracle Support account.

Don't have a My Oracle Support account? Click to get started!

In this Document
 Before upgrading
 0. The following chapters should be carefully reviewed:
 1. Raise a Proactive Service Request with Oracle Support.
 2. Run the pre-upgrade verification tools from ISO image
 a) all 2.3.X releases
 b) PCA 2.3.2 only
 3. Base PCA release
 4. Number of LUNs
 5. ZFS firmware release
 6. Check for multiple tenant groups
 a) pca-admin database (this is applicable to PCA 2.2.1 and higher)
 b) OVM database
 7. External Storage LUNs
 8. Check for OSWatcher customizations
 9. multipath.conf customizations
 10. Check for customized ILOM and Xsigo NTP settings
 11. Check for customized inet settings on MNs
 12. Check to see whether compute nodes have been reprovisioned or replaced
 13. Verify ILOM versions
 14. Verify all Compute Node names
 15. Verify the number of ethernet cards in the Xsigos
 16. Verify the interface labels on the ZFSSA
 17. Check for resilvering jobs on ZFSSA
 18. Check for hardware faults on all components
 a) Compute Nodes
 b) Management nodes
 c) Internal ZFS
 19. Check tinyproxy configuration
 20. Check for the Pool / o2cb Cluster's health
 21. Collect the number of objects in the database
 22. Verify failover works
 23. Customers making use of EM ONLY - Enterprise Manager 13c
 24. List the server profiles on the PCA
 25. Retrieve the OSA Settings of the BIOS of each Node (Compute Nodes and Management Nodes)
 26. No warning or error signs in OVMM GUI
 27. Supply Rack information
 28. Space requirements on the shared storage
 29. Override Global Server Update Group (PCA 2.3.1+)
 30. Network interface configuration.
 a) On the management nodes:
 b) On the compute nodes:
 31. Check for IB Symbol errors
 32. Internal ZFSSA protocols for NFS
 Before starting the actual install
 1. Disable Backup cron job
 2. Customers making use of EM ONLY - Move PCA to blackout state in EM.
 3. Do not make any changes to passwords or configuration while in the middle of an upgrade.
 Post Upgrade
 1. Management Nodes
 1. Names of the Unmanaged Storage Arrays
 2. Check for errors / warnings in Oracle VM
 3. PCA Dashboard status
 4. Networks check
 2. Compute Nodes
 1. [ All 2.3.x Versions ] Change min_free_kbytes on all compute nodes
 2. [ All 2.3.x Versions] Check that the fm package is installed on all compute nodes.
 3. [only for PCA 2.3.2 - MANDATORY] upgrade vmpinfo-sosreport on all compute nodes
 4. [only for PCA 2.3.2 - MANDATORY] Set dom0_vcpu pinning after upgrading compute nodes 
 5. [Only for PCA 2.3.1 - MANDATORY]  Missing parameters
 6. Virtual Machine test
 3. Check Firmware of Components
 4. Customers making use of EM ONLY - Recover PCA management node agent and certificate
 5. Reinstall Automatic Service Request if it was installed before (ASR)
 Known Issues
 1. [ Applies only to PCA 2.3.1] XMS connection from passive node

My Oracle Support provides customers with access to over a million knowledge articles and a vibrant support community of peers and Oracle experts.