Domain Setting Migration from VMware Telco Cloud Service Assurance 2.2 to 2.3

This topic describes the steps and prerequisite for migration of Domain Setting from VMware Telco Cloud Service Assurance 2.2 to 2.3. The Domain Setting is used in 5G integration.

Prerequisites

• VMware Telco Cloud Service Assurance and the Domain Managers (ESM and OI) must be upgraded to 2.3 version.
• All the VMware Telco Cloud Service Assurance Domain Managers (ESM and OI) must be up and running.
• All the Domain Managers must be connected to the VMware Telco Cloud Service Assurance as they were before upgrade.

Procedure

1. Copy the Python script upgrade_kafka_dcc_setting.py from ESM/smarts/conf/util-scripts to the deployment host (VM from where VMware Telco Cloud Service Assurance is deployed).
2. Run the following command to obtain the existing domain setting dump.

   python3  upgrade_kafka_dcc_setting.py -ip <tcsa-ui-ip>  -p <tcsa-ui-port>  -u <tcsa-user> -a <tcsa-password> -o d

   This will dump the existing setting in kafka_setting_dumo.txt file in the current directory.

3. Run the following command to create the configuration from the existing Domain Setting configuration.

   python3 upgrade_kafka_dcc_setting.py -ip <tcsa-ui-ip> -p <tcsa-ui-port> -u <tcsa-user> -a <tcsa-password> -o l

   This command will delete the existing setting and create a new Domain Setting compatible with VMware Telco Cloud Service Assurance 2.3.

   Note:

   • The VMware Telco Cloud Service Assurance UI (<tcsa-ui-ip>) IP is the address which is used to launch the VMware Telco Cloud Service Assurance UI operation dashboard.
   • The VMware Telco Cloud Service Assurance port (<tcsa-ui-port>) is 30002 for VMware Tanzu Kubernetes Grid and 443 for AKS, AWS, and VM-based deployment.

   The new combined setting name is a concatenation of the previous Kafka Collector Setting separated by underscore (_). For example, if the previous Kafka Setting name was kafka_setting__esm and the Collector Setting name was dcf_setting_esm. The new name of the combined setting is kafka_setting_esm_dcf_setting_esm.

4. Restart the OI Server.

Note:

• If for any reason, upgrade_kafka_dcc_setting.py fails, then you must remove the setting from the Domain Manager and Postgres and recreate the settings. For more information on remove the Kafka and DCF settings, refer the Remove Kafka and DCF Settings section.
• The above script cannot be used for partial migration of settings. All Domain Manager setting is migrated at the same time.