This section illustrates the 10.1 upgrade procedure.

Prerequisites

If VCO is already existing in the topology, run the following command to find all the VeloCloud instances:

<BASEDIR>/smarts/bin/dmctl -s <ESM-DOMAIN-NAME> invoke ICF_PersistentDataSet::VCOTopologyCollectorInstanceIds get

Procedure

  1. Stop ESM server.
    Refer VMware Smart Assurance Server Manager User and Configuration Guide.
  2. Upgrade to DCF 10.1.0.0.
    Refer Performing Upgrade for more details.
  3. If VeloCloud collector instances are already existing in DCF, recreate Kafka topics.
    To recreate Kafka topics:
    1. Ensure /config/server.properties file has "delete.topic.enable=true"
    2. Execute the following commands, and wait for one minute:
      export KAFKA_OPTS="-Djava.security.auth.login.config=<KAFKA_HOME>/config/
zookeeper_jaas.conf"
<KAFKA_HOME>/bin/kafka-topics.sh --zookeeper
<KAFKA_CLUSTER_HOST1_IPADDRESS>:2181 <KAFKA_CLUSTER_HOST2_IPADDRESS>:2181
<KAFKA_CLUSTER_HOST3_IPADDRESS>:2181 --delete --topic <discovery topic name>
    3. Run the following command, and wait for one minute:
      <KAFKA_HOME>/bin/kafka-topics.sh --zookeeper
<KAFKA_CLUSTER_HOST1_IPADDRESS>:2181 <KAFKA_CLUSTER_HOST2_IPADDRESS>:2181
<KAFKA_CLUSTER_HOST3_IPADDRESS>:2181 --delete --topic <monitoring topic name>
    4. Execute the following command to ensure the successful deletion of the topics mentioned in steps b and d. The command does not list any topic if the deletion is successful.
      <KAFKA_HOME>/bin/kafka-topics.sh --zookeeper
<KAFKA_CLUSTER_HOST1_IPADDRESS>:2181 <KAFKA_CLUSTER_HOST2_IPADDRESS>:2181
<KAFKA_CLUSTER_HOST3_IPADDRESS>:2181 --list
    5. Execute the command:
      export KAFKA_OPTS="-Djava.security.auth.login.config=<KAFKA_HOME>/config/
kafka_server_jaas.conf"
    6. Run the command, and wait for 30 seconds:
      <KAFKA_HOME>/bin/kafka-topics.sh --create --zookeeper
<KAFKA_CLUSTER_HOST1_IPADDRESS>:2181 <KAFKA_CLUSTER_HOST2_IPADDRESS>:2181
<KAFKA_CLUSTER_HOST3_IPADDRESS>:2181 --replication-factor 3 --partitions 1 --
topic <Discovery Topic Name>
      • The value for --replication-factor must be equal to number of nodes in the cluster.
      • At present, only 1 partition is supported per topic.
    7. Execute the command, and wait for 30 seconds:
      <KAFKA_HOME>/bin/kafka-topics.sh --create --zookeeper
<KAFKA_CLUSTER_HOST1_IPADDRESS>:2181 <KAFKA_CLUSTER_HOST2_IPADDRESS>:2181
<KAFKA_CLUSTER_HOST3_IPADDRESS>:2181 --replication-factor 3 --partitions 1 --
<topic <Monitoring Topic Name>
      • The value for --replication-factor should be equal to number of nodes in the cluster.
      • At present, only 1 partition is supported per topic.
  4. Upgrade to ESM 10.1.0.0.
    Refer VMware Smart Assurance Installation Guide for SAM, IP, ESM, MPLS, NPM, OTM, ACM, MCAST and VoIP Managers for upgrade details.
  5. Add new params related to VeloCloud in <BASEDIR>/smarts/local/conf/esm-param.conf file.
    Refer Configuring Users and Tenant Filtering section.
    Refer Configure ESM to send VCO Link Performance and Topology Data to MnR for more details about providing performance data to MnR.
  6. Start the ESM server.
    Refer VMware Smart Assurance Server Manager User and Configuration Guide.