nexus/knowledgebase/csd-wiki/ICSD/ESM-SaaS-Upgrade-to-version-25.1_688988231.md

# ESM-SaaS-Upgrade-to-version-25.1_688988231
## Upgrade Procedures

<table><colgroup><col> <col> <col> <col> <col> <col> <col></colgroup><thead><tr><th><p>No</p></th><th><p>Phase</p></th><th><p>Upgrade Tasks</p></th><th><p>Upgrade Duration</p></th><th><p>Downtime (min)</p></th><th><p>Doc Link</p></th><th></th></tr></thead><tbody><tr><td><p>0</p></td><td><p>Get release package</p></td><td><p>Check ESM release package</p></td><td></td><td></td><td></td><td><ul><li>OMT: 25.1-14</li><li>SMAX/HCMX: 2.1.0+25.1.0</li><li>UCMDB: 2.1.0-45+25.1.0</li><li>OO: 1.6.0+25.1.0</li><li>Audit Service: 1.7.0-59+25.1.0</li><li>OP: 1.1.0+25.1.0-70</li><li>Aviator installer: 25.1.0-8</li><li>Aviator add-on: 25.1.0-5</li><li>OO CP content pack: please download the content package and tool from market place after release</li></ul></td></tr><tr><td rowspan="7"><p>1</p></td><td rowspan="7"><p>Upgrade Preparation</p></td><td><p>SMAX/HCMX:</p><ul><li><p><strong>Run Content Pack Deployer Tool</strong></p></li><li><strong>Perform suite version update precheck<br></strong></li><li>OPB agent status check</li></ul></td><td><ul><li>Run Content Pack Deployer Tool: 6 <em>mins/8 tenants</em></li><li>Perform Pre upgrade check: 5mins</li></ul></td><td></td><td><ul><li><a href="https://docs.microfocus.com/doc/SMAX/25.1/upgradesuitehelm#Run_Content_Pack_Deployer_tool_(for_Cloud_Management)">Run Content Pack Deployer tool (for Cloud Management)</a><br></li><li><a href="https://docs.microfocus.com/doc/SMAX/25.1/upgrademanagedsuitehelm#Perform_pre-upgrade_checks">Perform pre-upgrade update precheck</a><br></li><li><a href="https://rndwiki.houston.softwaregrp.net/confluence/display/ICS/Collect+customer+owned+SMAX+OPB+Agent+information+and+check+status">How to check SMAX OPB agent status</a></li></ul></td><td></td></tr><tr><td><p>UCMDB:</p></td><td>/</td><td></td><td></td><td></td></tr><tr><td><p>Audit Service:</p></td><td>Update values yaml file: 1min</td><td></td><td><a href="https://docs.microfocus.com/doc/SMAX/25.1/ConfigureAuditYamlEKS#Access_parameters">Update Values.yaml file</a></td><td><p>Screenshot for reference</p><p><img height="250" src="attachments/688988231/688988230.png"></p><p>Add the parameter in the audit yaml file:</p><p><strong>cluster:</strong></p><p><strong>k8sProvider: aws</strong></p></td></tr><tr><td><p>OO:</p></td><td>/</td><td></td><td></td><td></td></tr><tr><td><p>Aviator:</p></td><td>/</td><td></td><td></td><td></td></tr><tr><td><p>OP:</p></td><td>/</td><td></td><td></td><td></td></tr><tr><td><p><strong>Backup SaaS Farm including Aviator</strong></p></td><td></td><td></td><td><ul><li><a href="https://docs.microfocus.com/doc/SMAX/25.1/BackUpManagedK8SSuite">ESM cloud backup solution</a><br></li><li><a href="https://staging.docs.microfocus.com/doc/ITOM_Aviator/25.1/AviatorUpgradeBackup">Aviator backup</a></li></ul></td><td></td></tr><tr><td><p>2</p></td><td><p>Upgrade Aviator</p></td><td><ul><li>Disable linkerd<br></li><li>Upgrade Aviator<br></li><li>Upgrade ingress-nginx<br></li><li>Upgrade llama3<br></li><li>Upgrade Monitoring<br></li><li>Upgrade linkerd<br></li><li>Enable linkerd</li></ul></td><td><ul><li><em>Disable linkerd:1min<br><br></em></li><li>Upgrade Aviator:<em>1mins<br><br></em></li><li><em>Upgrade ingress-nginx:1min<br><br></em></li><li><em>Upgrade llama3:15mins<br><br></em></li><li><em>Upgrade Monitoring:3mins<br><br></em></li><li><em>Upgrade linkerd:1min<br><br></em></li><li><em>Enable linkerd, rolling restart the pods:15mins</em></li></ul></td><td>0</td><td><a href="https://staging.docs.microfocus.com/doc/ITOM_Aviator/25.1/Upgrade">25.1 Aviator Upgrade</a></td><td></td></tr><tr><td rowspan="5"><p>3</p></td><td rowspan="4"><p>Upgrade Maintenance Window</p></td><td><p><strong>Upgrade OMT</strong></p></td><td><p><em>10mins</em></p><p><em>(including Prometheus)</em></p></td><td><p>SMAX: 0</p><p>CMS: 0</p></td><td><a href="https://docs.microfocus.com/doc/SMAX/25.1/UpgdManagedK8SCdf">Upgrade OMT to 25.1</a></td><td></td></tr><tr><td rowspan="3"><p><strong>Upgrade SMAX/HCMX, UCMDB, Audit in parallel</strong></p><ul><li>Upgrade SMAX/HCMX<br></li><li>Upgrade UCMDB<br></li><li><strong>Upgrade Audit service</strong></li></ul></td><td rowspan="3"><ul><li>SMAX/HCMX: 21 <em>mins<br>(</em><em>xie: 10mins</em><em>)<br><br></em></li><li>UCMDB: 15 <em>mins<br></em></li><li>Audit Service: <em>18mins</em></li></ul></td><td rowspan="3"><p>SMAX: 0</p><p>UCMDB: 0</p><p>Audit Services: <em>0</em></p></td><td><a href="https://docs.microfocus.com/doc/SMAX/25.1/upgrademanagedsuitehelm#Upgrade">Upgrade SMAX/HCMX to 25.1</a></td><td></td></tr><tr><td><p><a href="https://docs.microfocus.com/doc/SMAX/25.1/CmsUpgradeManagedK8S">Upgrade UCMDB to 25.1</a></p></td><td></td></tr><tr><td><p><a href="https://docs.microfocus.com/doc/SMAX/25.1/UpgradeAuditManagedK8S">Upgrade Audit to 25.1</a></p></td><td></td></tr><tr><td></td><td><p><strong>Upgrade OO</strong></p><p>Upgrade OO when SMAX/HCMX upgrade finish</p><p>(watch the pod of dnd-upgrade-job-xxx and cgro-deploy-controller, until they become to Completed, then you can start to upgrade OO)</p></td><td><p><em>22mins</em></p></td><td>0</td><td><p><a href="https://docs.microfocus.com/doc/SMAX/25.1/UpgradeContainerizedOOManagedK8S">Upgrade Containerized OO to 25.1</a></p></td><td></td></tr><tr><td></td><td></td><td><p><strong>Upgrade OP</strong></p><p>OP can be upgrade post upgrade of OMT</p></td><td><p><em>10 mins</em></p></td><td>10 mins</td><td><p><a href="https://staging.docs.microfocus.com/doc/oppl/25.1/upgrade">Upgrade Operations Platform to 25.1</a></p></td><td></td></tr><tr><td rowspan="3"><p>4</p></td><td rowspan="3"><p>Post-Upgrade</p></td><td><p>SMAX/HCMX post upgrade task:</p><ul><li>Upgrade EKS cluster</li></ul></td><td></td><td></td><td><ul><li><a href="https://docs.microfocus.com/doc/SMAX/25.1/PostUpgradeSuiteAdminManagedK8SSuite">Perform post-upgrade tasks as the suite admin</a></li></ul></td><td><ul><li>Database Support matrix:<br>PostgreSQL 15.x, 14.x, 13.x, 12.x</li></ul><ul><li>Managed Kubernetes clusters:<br>Amazon Elastic Kubernetes Service (EKS) v 1.28.x, 1.29.x, 1.30.x</li></ul></td></tr><tr><td><p>SMAX OPB agent status check</p></td><td></td><td></td><td></td><td><p>25.1 include OPB agent upgrade.</p><p>Compare the OPB agent status check before the upgrade and ensure all live OPB agent are upgrades successfully with new version and connection keep live</p></td></tr><tr><td><p>Upgrade external OO RAS</p></td><td>20 minutes for one external ras</td><td></td><td><a href="https://docs.microfocus.com/doc/SMAX/25.1/UpgradeonpremRAS">Upgrade External OO RAS - Service Management</a></td><td><p>Need to upgrade OO RAS or internal owned tenants:</p><ul><li>X4X Prod</li><li>X4X Dev OpsB</li><li>X4X Dev DCA</li></ul></td></tr><tr><td></td><td></td><td><p>OP</p></td><td><p>Vertica DB stop & start: 5mins</p><p>Upgrade UDX plugin: 10mins</p><p>Verify upgrade:</p><p>2mins</p></td><td></td><td><p><a href="https://staging.docs.microfocus.com/doc/oppl/25.1/upgradeoperationsplatform#Upgrade_OPTIC_Data_Lake_plugin">Post upgrade tasks of OP 25.1</a></p><p><a href="https://staging.docs.microfocus.com/doc/oppl/25.1/verifyupgrade">Verify post upgrade</a></p></td><td><p>If this plugin was already upgraded to 24.4.1 then you can ignore in this upgrade</p></td></tr><tr><td><p>5</p></td><td><p>Rollback</p></td><td></td><td></td><td></td><td><p><a href="https://rndwiki.houston.softwaregrp.net/confluence/display/ICS/ESM+Cloud+Disaster+and+Recovery+Guide">ESM Disaster & Recovery Solution</a></p></td><td></td></tr></tbody></table>