* * * READ ME * * *
                 * * * Veritas CloudPoint 2.0.1.5300 * * *
                    * * * Email-Service 2.0.1.116 * * *
                         * * * Hot Fix 1 * * *
                    * * * Patch Date: 2018-04-10 * * *


This document provides the following information:

   * PATCH NAME
   * OPERATING SYSTEMS SUPPORTED BY THE PATCH
   * BASE PRODUCT VERSION FOR THE PATCH
   * SUMMARY OF INCIDENTS FIXED BY THE PATCH
   * DETAILS OF INCIDENTS FIXED BY THE PATCH
   * INSTALLING THE PATCH
   * KNOWN ISSUES
   * NOTE


PATCH NAME
----------
Veritas CloudPoint 2.0.1.5300 Email Service 2.0.1.116 Hot Fix 1

OPERATING SYSTEMS SUPPORTED BY THE PATCH
----------------------------------------
Ubuntu 16.04 x86-64


BASE PRODUCT VERSION FOR THE PATCH
-----------------------------------
   * Veritas CloudPoint 2.0.1


SUMMARY OF INCIDENTS FIXED BY THE PATCH
---------------------------------------
Patch 2.0.1.5300 - Email Service 2.0.1.116:
* C3PM-4214: (C3PM-4604) Anonymous email relay (SMTP)


DETAILS OF INCIDENTS FIXED BY THE PATCH
--------------------------------------------
This patch fixes the following JIRA incidents:

Patch 2.0.1.5300 - Email Service 2.0.1.116:
* C3PM-4214 (Tracking ID: C3PM-4604)

SYMPTOM: Configuring SMTP with anonymous relay was not allowed.

DESCRIPTION: When trying to configure SMTP email without credentials for Anonymous Relay, 
its gives an error since SMTP without credentials are not permitted.

RESOLUTION: Fix has been added for the username and password both be entered as "anonymous" 
to configure SMTP with Anonymous Relay.



INSTALLING THE PATCH
--------------------
I. Before patching:
  1. Copy the 'deb' package email_service-2.0.1.116.deb to /cloudpoint directory on your CloudPoint host.
    # cp <path to deb pkg>/email_service-2.0.1.116.deb /cloudpoint
  2. Run this as root to check all containers are up and running healthy:
    # docker ps
  3. Make note of the 'Container ID' or 'Names' of the email-service container. (Most likely the 
     name should be 'flexsnap-email-service')

II. Patching:
  1. Run the following command as root (To enter the email-service container)
    # docker exec -it flexsnap-email-service bash OR # docker exec -it <container-id/image-name(if other)> bash
  2. Run the following commands inside the email-service container you just entered:
     
      Run this command to check the current version installed:
    # dpkg --list | grep email

      Run these commands to install the patch version package in your container:

    # dpkg -i /cloudpoint/email_service-2.0.1.116.deb
    # sed -i "s/localhost/flexsnap-rabbitmq/g" /opt/VRTScloudpoint/services/email_service/config/amqpconfig.properties
    # sed -i "s/127.0.0.1/flexsnap-mongodb/g"  /opt/VRTScloudpoint/services/email_service/config/mongo.properties
    # sed -i "s/127.0.0.1/0.0.0.0/g"           /opt/VRTScloudpoint/services/email_service/config/application.properties

      Run this command again to verify the current version of email-service installed is the patch version 2.0.1.116:
    # dpkg --list | grep email

      Then exit the container:
    # exit
  3. Run the following command after exiting the container as root on CLoudPoint host:
    # docker restart flexsnap-email-service OR docker restart <container-id/image-name(if other)>

III. After patching:
  1. Wait for 15-20 seconds for the 'flexsnap-email-service' container to completely restart the service with the new installation.
  2. Refresh your web broswer and log in to the CloudPoint UI.
  3. Click on Settings >> Email Settings >> SMTP.
  4. Enter host and port details. Enter "anonymous" as username and password to configure an SMTP server with Anonymous Relay.
  5. Click Finish.


NOTE
----
1. Roll back to the previous version of email-service if needed.
  a. Run the following command as root (To enter the email-service container)
    # docker exec -it flexsnap-email-service bash OR # docker exec -it <container-id/image-name(if other)> bash
  b. Run the following commands inside the email-service container you just entered
    # dpkg -i /root/email_service-<version>.deb
    # sed -i "s/localhost/flexsnap-rabbitmq/g" /opt/VRTScloudpoint/services/email_service/config/amqpconfig.properties
    # sed -i "s/127.0.0.1/flexsnap-mongodb/g"  /opt/VRTScloudpoint/services/email_service/config/mongo.properties
    # sed -i "s/127.0.0.1/0.0.0.0/g"           /opt/VRTScloudpoint/services/email_service/config/application.properties

      Run this command to verify the current version of email-service installed is the original version 
      (what it was before installing the patch in the container in Step II(2) of "Installing the Patch"):
    # dpkg --list | grep email

      Then exit the container:
    # exit
  c. Run the following command after exiting the container as root on CLoudPoint host:
    # docker restart flexsnap-email-service OR docker restart <container-id/image-name(if other)>