Auto-sync: 2026-04-18 17:09
This commit is contained in:
@@ -0,0 +1,120 @@
|
||||
# Upgrade-CMS-from-24.3-to-24.4_688996436
|
||||
## Pre-upgrade tasks
|
||||
|
||||
Because of this defect: [Issue 2405372 - \[SaaS\]Customer startup fails due to having two references towards different repositories in Settings\_LDAP\_SETTING(ZA, PCS 1188476 )](https://internal.almoctane.com/ui/entity-navigation?p=97002/32001&entityType=work_item&id=2405372)
|
||||
|
||||
Please run the following statement from JMX-Console, executeQuery(**UCMDB:service=DAL services**):
|
||||
|
||||
> ```
|
||||
> select * from urm_Resources where type='Settings_LDAP_SETTING' AND RESOURCE_ID !='ldap.setting.UCMDB'
|
||||
> ```
|
||||
|
||||
If it returns any results, there are two options to follow next(either first or the second):
|
||||
|
||||
1\. Delete the inconsistency in db: for each of the returned RESOURCE\_ID, connect to the database and execute the below statement:
|
||||
|
||||
> delete from urm\_Resources where type='Settings\_LDAP\_SETTING' AND RESOURCE\_ID ='resource\_id\_from\_previous\_output'
|
||||
|
||||
2\. Add the param --add-exports=java.naming/com.sun.jndi.ldap=ALL-UNNAMED in values.yaml before the upgrade process.
|
||||
|
||||
For ucmdbserver deployment at the of additionalOpts, like this example:
|
||||
|
||||
> ucmdbserver:
|
||||
>
|
||||
> deployment:
|
||||
>
|
||||
> additionalOpts: -XX:HeapDumpPath=./runtime/log/java\_heapdump.hprof **\--add-exports=java.naming/com.sun.jndi.ldap=ALL-UNNAMED**
|
||||
>
|
||||
> database:
|
||||
>
|
||||
> dbName: cms\_ucmdb\_db
|
||||
>
|
||||
> schema: cms\_ucmdb\_schema
|
||||
>
|
||||
> user: cms\_ucmdb
|
||||
>
|
||||
> jvmXmxMemory: 14336
|
||||
|
||||
## Backup CMS before upgrade
|
||||
|
||||
Refer to the official CMS backup doc: [https://docs.microfocus.com/doc/SMAX/24.3/CmsBackUpManagedK8S](https://docs.microfocus.com/doc/SMAX/24.3/CmsBackUpManagedK8S).
|
||||
|
||||
## Perform CMS upgrade
|
||||
|
||||
Refer to the official [CMS upgrade doc](https://docs.microfocus.com/doc/SMAX/24.3/CmsUpgradeManagedK8S) to do the following steps:
|
||||
|
||||
1. **Download the new CMS charts package**
|
||||
2. **Perform CMS version update**
|
||||
3. **Troubleshooting: unable to access CMS UI after the upgrade**
|
||||
|
||||
## Post upgrade steps
|
||||
|
||||
The following steps are required because of the major version upgrade from Solr 8.x to Solr 9.x:
|
||||
|
||||
1. Run the following command to stop the Solr pod:
|
||||
```
|
||||
kubectl scale deployment itom-ucmdb-solr -n <namespace> --replicas=0
|
||||
```
|
||||
2. Delete the **data** folder from the **nfs: data-volume/ucmdb/solr/data** file:
|
||||
1. Run the following command to navigate to the **NFS** path where the ucmdb persistent volumes are stored:
|
||||
```
|
||||
cd <nfs_path>/data-volume/ucmdb/solr
|
||||
```
|
||||
2. Run the following command to delete the **data** folder:
|
||||
```
|
||||
sudo rm -rf data
|
||||
```
|
||||
3. Run the following command to start the Solr pod:
|
||||
```
|
||||
kubectl scale deployment itom-ucmdb-solr -n <namespace> --replicas=1
|
||||
```
|
||||
4. Restart the UCMDB server:
|
||||
1. Run the following command:
|
||||
```
|
||||
kubectl scale -n NAMESPACE --replicas=0 statefulset/itom-ucmdb
|
||||
```
|
||||
2. Wait until both UCMDB pods (itom-ucmdb-0 and itom-ucmdb-1) are deleted, and then run the following command:
|
||||
`kubectl scale -n NAMESPACE --replicas=2 statefulset/itom-ucmdb `
|
||||
|
||||
`How to check if reindex worked?`
|
||||
|
||||
- `Go to JMX-console under Topology Search Service and execute printStatusReportForAllCustomers:`
|
||||
- `OK example(progress 100%):`
|
||||
|
||||
|
||||
|
||||
- `NOT OK example(see last result null):`
|
||||
|
||||
|
||||
|
||||
`If reindex was not run successful please use the below script to trigger the execution of reindex method from JMX for the entire farm(all customers):`
|
||||
|
||||
1\. get the script - contact Alin Zirbo
|
||||
|
||||
2.put the script and the jar on the cms efs at the path: cms\_data\_vol/ucmdb/server/conf/discovery/customer\_1
|
||||
|
||||
3[.cd](http://2.cd/) to customer\_1
|
||||
|
||||
4\. chmod 775 \*
|
||||
|
||||
5\. chown 1999:1999 \*
|
||||
|
||||
6\. edit the sts of itom-ucmdb and add for JAVA\_OPTS the next 3 lines
|
||||
|
||||
\-Dcom.sun.management.jmxremote.port=29601 -Dcom.sun.management.jmxremote.authenticate=false
|
||||
|
||||
\-Dcom.sun.management.jmxremote.ssl=false -Djava.rmi.server.hostname=localhost
|
||||
|
||||
\-Dcom.sun.management.jmxremote.rmi.port=29601
|
||||
|
||||
7.wait too be fully up
|
||||
|
||||
8.kubectl exec -it itom-ucmdb-1 -n cms -c itom-ucmdb -- /bin/bash -c "bash /ucmdb/conf/discovery/customer\_1/status.sh reindex\_all localhost"
|
||||
|
||||
9\. check the results.txt from customer\_1 folder (cat results.txt)
|
||||
|
||||
10\. Share the results.txt from each farm with Diana Pop(dpop@ [opentext.com](http://opentext.com/))
|
||||
|
||||
[cmdline-jmxclient-0.10.3-patched.jar](#)
|
||||
|
||||
[status.sh](#)
|
||||
Reference in New Issue
Block a user