push addional code

Change-Id: Ia427bb3460cda3a896f8faced2de69eaf3807b74
Signed-off-by: Michael Lando <ml636r@att.com>

1 files changed, 88 insertions, 0 deletions

diff --git a/openecomp-be/tools/migration/README b/openecomp-be/tools/migration/README
new file mode 100644
index 0000000000..7bca1f3f5e
--- /dev/null
+++ b/openecomp-be/tools/migration/README
@@ -0,0 +1,88 @@
+Info -
+	Name:		1607 to 1610 ASDC VSP migration tool
+	Version:	4.0
+	Date:		15 Sep, 2016
+
+General -
+	This is a utility used for migration of VSP data from ASDC version 1607 to version 1610.
+	This utility will be executed post upgrade process to 1610.
+	This utility must run from the ASDC backend (BE) machine.
+
+	From version 3.0 the tool can be run several times without changing a VSP version more then once, the first time.
+	Once the VSP is "fixed" it will not be migrated by this tool.
+
+Concept -
+	Once migrating ASDC from 1607 to 1610 changes were made in the VSP load/validation.
+	In order to support these changes and force a valid HEAT file upload, the migration process should be
+	run on the existing data.
+	Not doing so will result in VSPs that will not open for update action.
+
+	The migration will run on VSPs that were upgraded from 1607 to 1610 and are not able to be retrieved.
+
+Pre ASDC upgrade requisite -
+    In order to achieve the best result from this tool users must check-in ALL VSPs.
+
+Limitations -
+
+	* Will not work if user did not create a first version of the VSP, i.e. at least one time check-in action.
+	* Once run, user must checkout a VSP, go to General and re select a license model version.
+
+
+Usage -
+
+	Note: There are default values if the script is run without arguments.
+	      The values are credentials: cs0008/cs0008,  with host: 127.0.0.1
+	1607_to_1610 -h                            --> get help
+	1607_to_1610 -a <username>/<password> [-ip {ip}]
+	Example:
+		using cassandra on localhost  - 1607_to_1610 -a root/secret
+		using cassandra on remote host - 1607_to_1610 -a root/secert -ip 10.147.97.191
+
+	Result:
+		The migration result will be listed in a CSV file: upgradereport.csv
+		"None" is an indication that the VSP was not in a checkout status prior to the upgrade.
+
+	Exmample for a valid output:
+
+		Name: VSP-OK, Id: 9DB0E1563B22481D911ECD33989E1FDD, Vendor: OPENECOMP, locked by: None, status not started
+		Service VSP-OK was tested and does not need a migration
+		Name: VSP02-Checkout, Id: 8DF8D65535414AAAA23682E2532675E6, Vendor: OPENECOMP, locked by: cs0008, status not started
+		Server Error
+		Service VSP02-Checkout was tested and it needs a migration
+		Service VSP02 - Migration start
+		Service VSP02-Checkout is locked - forcing checkin
+		Doing new checkout
+		200 OK Content-Type: application/json
+		Date: Thu, 08 Sep 2016 13:25:21 GMT
+		Server: Jetty(9.3.6.v20151106)
+
+		done upload
+		Doing new checkin
+		Service VSP-EMPTY - Migration end
+		Name: VSP-EMPTY, Id: D26892D2839746E18075EF49C4586320, Vendor: OPENECOMP, locked by: None, status not started
+		Service VSP-EMPTY was tested and does not need a migration
+		Name: VSP01, Id: 98F5DDFD4F684086801E86A88A0D77AB, Vendor: OPENECOMP, locked by: None, status not started
+		Server Error
+		Service VSP01 was tested and it needs a migration
+		Service VSP-EMPTY - Migration start
+		Doing new checkout
+		200 OK Content-Type: application/json
+		Date: Thu, 08 Sep 2016 13:25:22 GMT
+		Server: Jetty(9.3.6.v20151106)
+
+		done upload
+		Doing new checkin
+		Service {0} - Migration end
+
+	Example for a case with no migration needed:
+
+		Name: VSP-OK, Id: 9DB0E1563B22481D911ECD33989E1FDD, Vendor: OPENECOMP, locked by: None, status not started
+		Service VSP-OK was tested and does not need a migration
+		Name: VSP02-Checkout, Id: 8DF8D65535414AAAA23682E2532675E6, Vendor: OPENECOMP, locked by: None, status not started
+		Service VSP02-Checkout was tested and does not need a migration
+		Name: VSP-EMPTY, Id: D26892D2839746E18075EF49C4586320, Vendor: OPENECOMP, locked by: None, status not started
+		Service VSP-EMPTY was tested and does not need a migration
+		Name: VSP01, Id: 98F5DDFD4F684086801E86A88A0D77AB, Vendor: OPENECOMP, locked by: None, status not started
+		Service VSP01 was tested and does not need a migration
+
+