Upgrade Procedure

This section describes the upgrade procedure when upgrading MURAL from version 5.0.2.p5 to version 5.0.2.p6.

Running the installer

Perform the following steps on management node to upgrade MURAL from version 5.0.2.p5 to version 5.0.2.p6:

  1. Run the following command to navigate to the reflex-provisioner directory:

    cd /etc/reflex-provisioner
  2. Run the solution installer using following command:

    ansible-playbook -i \
    inventory/generated/prod/mural/hosts \
    playbooks/mrx/deploy.yml -k --skip-tag azkacli
  3. Run the following command to edit the value of odsClassification in tomcat-mrxui config map from True to true.

    kubectl edit cm tomcat-mrxui
  4. Run the following command to validate the value updated in Step-3:

    kubectl describe cm tomcat-mrxui | grep odsClassification

    The sample output may resemble as follows:

    "odsClassification\":true\n}\n"
  5. Run the following command to restart the pods:

    kubectl get po  | grep tomcat-mrxui | awk '{print $1}' | xargs kubectl delete po
  6. To verify that the preceding step is successfully executed and the UI is up and running, enter the URL https://<lb-vip-fqdn>/login in the browser.

  7. Run the following command to update the app_protocol_list file on both the master nodes and on HDFS:

    For master nodes:

    gunzip /opt/repos/mrx/5.6/5.6.2.rc1/app_protocol_list.gz 
    scp /opt/repos/mrx/5.6/5.6.2.rc1/app_protocol_list  <master-nodes>:/opt/etc/scripts/
    

    For HDFS:

    hdfs dfs -put -f /opt/repos/mrx/5.6/5.6.2.rc1/app_protocol_list /data/streaming/protocol-values.txt
  8. Run the following command to copy job scheduler scripts to both the master nodes:

    scp /opt/repos/mrx/5.6/5.6.2.rc1/mural5Jobs.tgz  <master-nodes>:.

Verify Core Analytics Report Configurations

Perform the following steps on both the master nodes in the same order to verify and update the CAR files:

  1. Run the following command to verify gds_listfile:

    cat /opt/etc/scripts/gds_list
    

    The sample output may resemble the following:

    VoIP
    web applications
    streaming applications
    file transfer
    peer to peer
    IM
  2. Run the following command to verify ods_list file:

    cat /opt/etc/scripts/ods_list

    The sample output may resemble as follows:

    amazon-video
    netFlix
    NowTV
    sky-sport-streaming
  3. Run the following command to verify app_protocol_list file:

    head /opt/etc/scripts/app_protocol_list

    The sample output file may resemble as follows:

    youtube=YouTube
    https=HTTPS
    google-play=Google Play
    whatsapp-voice=WhatsApp Voice
    whatsapp-transfer=WhatsApp Transfer

    Note: The sample output generated is in form of key-value pair wherein key is the actual value generated in aggregation table and value is the name of protocol used for representation. If the key generated from aggregation job is different then update the app_protocol_list file based on key generated by your file.

  4. Run the following command to verify monthly_conf_vodafone: file:

    cat /opt/etc/scripts/monthly_conf_vodafone

    The sample output file may resemble as follows:

    table_name=kafkaconnectdb.monthly_points
    output_dir=/data/customer
    run_duration=monthly
    hive_server=192.168.193.15
    hive_port=10000
    smtp_server=192.168.104.25
    server_port=25
    sender_address=support-mrx@guavus.com
    receiver_addresses=receiver-address1@gdomain.com,receiver-address2@gdomain.com
    ods3_file=/opt/etc/scripts/ods_list

    Note: You can change the config file based on your set up and email details.

  5. Run the following command to verify weekly_conf_vodafone file:

    cat /opt/etc/scripts/weekly_conf_vodafone

    The sample output may resemble as follows:

    table_name=kafkaconnectdb.hourly_points
    output_dir=/data/customer
    run_duration=weekly
    hive_server=192.168.193.15
    hive_port=10000
    smtp_server=192.168.104.25
    server_port=25
    sender_address=support-mrx@guavus.com
    receiver_addresses=receiver-address1@gdomain.com,receiver-address2@gdomain.com
    gds_file=/opt/etc/scripts/gds_list

    Note: You can change the config file based on your set up and email details.