* * * READ ME * * *
                 * * * Veritas CloudPoint 2.0.2.5566 * * *
                         * * * Hot Fix 1 * * *
                         Patch Date: 2018-05-07


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.2.5566 Hot Fix 1


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


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


SUMMARY OF INCIDENTS FIXED BY THE PATCH
---------------------------------------
Patch 2.0.2.5566:
* C3PM-5576 (C3PM-5623) Replication of Replicated snapshot is causing exception "TypeError: cannot concatenate 'str' and 'list' objects"
* C3PM-5286 (C3PM-5611) Snapshot replication through policy doesn't get triggered.


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

Patch 2.0.2.5566:

* C3PM-5286 (Tracking ID: C3PM-5611)

SYMPTOM: AWS snapshot replication does not get triggered through policy
May 04 15:54:11 3def368eaba0 flexsnap-coordinator[1] flexsnap.coordinator: DEBUG - replicate-sub-snapshot(aws-ebs-us-east-2-snap-0273fbc65d468afa9)target(aws-region-034284394294-sa-east-1)
May 04 15:54:11 3def368eaba0 flexsnap-coordinator[1] flexsnap.workflow: ERROR - run: failed to load flow None (replicate() takes exactly 5 arguments (4 given))
May 04 15:54:11 3def368eaba0 flexsnap-coordinator[1] flexsnap.coordinator: ERROR - Replicate Group Snap failed > Exception Failed to load flow None (replicate() takes exactly 5 arguments (4 given))
Traceback (most recent call last):
File "/opt/VRTScloudpoint/lib/flexsnap/coordinator.py", line 4243, in execute
task_id = runner.run()
File "/opt/VRTScloudpoint/lib/flexsnap/workflow.py", line 594, in run
"Failed to load flow %s (%s)" % (self._name, exc))
WorkflowError: Failed to load flow None (replicate() takes exactly 5 arguments (4 given))

DESCRIPTION: The replication method excepts 5 arguments, and only 4 were being passed. So it failed with the WorkflowError

RESOLUTION: During the replication of a snapshot through the policy, changes made to pass the required arguments to the method.


* C3PM-5576 (Tracking ID: C3PM-5623)

SYMPTOM: Replication of Replicated snapshot is causing exception "TypeError: cannot concatenate 'str' and 'list' objects".
After replicating a replicated snapshot, the following exception is seen in the coordinator log:

May 09 06:34:37 22975ecb5a14 flexsnap-coordinator[1] flexsnap.connectors.base: ERROR - Exception None
Traceback (most recent call last):
File "/opt/VRTScloudpoint/lib/flexsnap/connectors/base.py", line 109, in run
func(self, user_id, **converted_values)
File "/opt/VRTScloudpoint/bin/flexsnap-coordinator.py", line 352, in handle_list_snapshots
start_from=start_from, snap_source_id=id)
File "/opt/VRTScloudpoint/lib/flexsnap/coordinator.py", line 3218, in paginate_assets
reverse=reverse, search=search)
File "/opt/VRTScloudpoint/lib/flexsnap/coordinator.py", line 985, in paginate
return paginator(total_objs, limit, start_from, self._translator)
File "/opt/VRTScloudpoint/lib/flexsnap/coordinator.py", line 81, in paginator
"items": [translate(o) for o in cursor],
File "/opt/VRTScloudpoint/lib/flexsnap/coordinator.py", line 943, in _translator
return FlexAsset._instantiate(self, obj).info()
File "/opt/VRTScloudpoint/lib/flexsnap/coordinator.py", line 1482, in info
merged["snapSourceId"])
TypeError: cannot concatenate 'str' and 'list' objects

DESCRIPTION: The source for the snapshot of replicated snapshot was getting set to a list, first element being the original asset, and second element with the asset in the first replicated snapshot region. So, where it was expects a str object, it gets a list object, it fails with the TypeError.

RESOLUTION: During replication of a replicated snapshot, when the snapifno, has the info of snap source's region, set that value to source region. Only if when the snapinfo does not contain the snap source's region, set the value of source region to that present in the params passed.



INSTALLING THE PATCH
--------------------
I. Before patching:
  1. Contact Veritas Technical Support for this Hot Fix.
  2. Untar the Hot Fix file to a CloudPoint host.
  3. Run the following commands to load the patch.
    # docker load -i Veritas_CloudPoint_2.0.2.5566.IE.img.gz
    # docker run --rm -it -v /cloudpoint:/cloudpoint -v /var/run/docker.sock:/var/run/docker.sock veritas/flexsnap-cloudpoint:2.0.2.5566 load
  4. Ensure that there are no protection policy snapshots or other operations in progress.
     Estimate the patching time will be 15 minutes to an hour.
  5. Log out from the CloudPoint UI.
  6. Run the following command as root to stop CloudPoint.
    # docker run --rm -it -v /cloudpoint:/cloudpoint -v /var/run/docker.sock:/var/run/docker.sock veritas/flexsnap-cloudpoint:2.0.2.5552 stop

II. Patching:
  Run the following command as root.
    # docker run --rm -it -v /cloudpoint:/cloudpoint -v /var/run/docker.sock:/var/run/docker.sock veritas/flexsnap-cloudpoint:2.0.2.5566 install

III. After patching:
  1. Refresh your web broswer and log in to the CloudPoint UI.
  2. Verify the CloudPoint version. Click on Settings and select About. The following information should show up.
    Current Version: 2.0.2.5566
    Current Commit: 6efca6829982cba4cbf91411441a306deecf1c9d
  3. Verify the CloudPoint data.


KNOWN ISSUES
-----------
* C3PM-3010
SYMPTOM: Restoration of a replicated host snapshot fails with the below error:
May 07 11:12:00 bd4d96307dc6 flexsnap-coordinator[1] Thread-1277 flexsnap.workflow: ERROR - execute: step restore(aws-ec2-us-west-1-ami-b6504ed6) raised Failed to create EC2 Instance: The key pair '<key-pair name>' does not exist [src/aws/aws.py:969]

Could not connect to the instance created by restore of a replicated host snapshot.

Workaround: Manually copy the key-pair associated with source instance to the target region or create a key-pair with the same name in the target region.
And after restoration, change the security group of the created instance to the desired one.

NOTE
----
1. Roll back to the previous version if needed.
  a. Log out from the CloudPoint UI.
  b. Run the following commands as root.
    # docker run --rm -it -v /cloudpoint:/cloudpoint -v /var/run/docker.sock:/var/run/docker.sock veritas/flexsnap-cloudpoint:2.0.2.5566 stop
    # docker run --rm -it -v /cloudpoint:/cloudpoint -v /var/run/docker.sock:/var/run/docker.sock veritas/flexsnap-cloudpoint:2.0.2.5566 uninstall
    # docker run --rm -it -v /cloudpoint:/cloudpoint -v /var/run/docker.sock:/var/run/docker.sock veritas/flexsnap-cloudpoint:2.0.2.5552 install
2. The previous version(s) of Docker container images are not removed. You can remove them to save your CloudPoint instance disk space.