* * * 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 /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 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 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 bash b. Run the following commands inside the email-service container you just entered # dpkg -i /root/email_service-.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