openecomp-be/tools/migration/README

   1 Info -
   2         Name:           1607 to 1610 ASDC VSP migration tool
   3         Version:        4.0
   4         Date:           15 Sep, 2016
   5
   6 General -
   7         This is a utility used for migration of VSP data from ASDC version 1607 to version 1610.
   8         This utility will be executed post upgrade process to 1610.
   9         This utility must run from the ASDC backend (BE) machine.
  10
  11         From version 3.0 the tool can be run several times without changing a VSP version more then once, the first time.
  12         Once the VSP is "fixed" it will not be migrated by this tool.
  13
  14 Concept -
  15         Once migrating ASDC from 1607 to 1610 changes were made in the VSP load/validation.
  16         In order to support these changes and force a valid HEAT file upload, the migration process should be
  17         run on the existing data.
  18         Not doing so will result in VSPs that will not open for update action.
  19
  20         The migration will run on VSPs that were upgraded from 1607 to 1610 and are not able to be retrieved.
  21
  22 Pre ASDC upgrade requisite -
  23     In order to achieve the best result from this tool users must check-in ALL VSPs.
  24
  25 Limitations -
  26
  27         * Will not work if user did not create a first version of the VSP, i.e. at least one time check-in action.
  28         * Once run, user must checkout a VSP, go to General and re select a license model version.
  29
  30
  31 Usage -
  32
  33         Note: There are default values if the script is run without arguments.
  34               The values are credentials: cs0008/cs0008,  with host: 127.0.0.1
  35         1607_to_1610 -h                            --> get help
  36         1607_to_1610 -a <username>/<password> [-ip {ip}]
  37         Example:
  38                 using cassandra on localhost  - 1607_to_1610 -a root/secret
  39                 using cassandra on remote host - 1607_to_1610 -a root/secert -ip 10.147.97.191
  40
  41         Result:
  42                 The migration result will be listed in a CSV file: upgradereport.csv
  43                 "None" is an indication that the VSP was not in a checkout status prior to the upgrade.
  44
  45         Example for a valid output:
  46
  47                 Name: VSP-OK, Id: 9DB0E1563B22481D911ECD33989E1FDD, Vendor: ABC, locked by: None, status not started
  48                 Service VSP-OK was tested and does not need a migration
  49                 Name: VSP02-Checkout, Id: 8DF8D65535414AAAA23682E2532675E6, Vendor: ABC, locked by: cs0008, status not started
  50                 Server Error
  51                 Service VSP02-Checkout was tested and it needs a migration
  52                 Service VSP02 - Migration start
  53                 Service VSP02-Checkout is locked - forcing checkin
  54                 Doing new checkout
  55                 200 OK Content-Type: application/json
  56                 Date: Thu, 08 Sep 2016 13:25:21 GMT
  57                 Server: Jetty(9.3.6.v20151106)
  58
  59                 done upload
  60                 Doing new checkin
  61                 Service VSP-EMPTY - Migration end
  62                 Name: VSP-EMPTY, Id: D26892D2839746E18075EF49C4586320, Vendor: ABC, locked by: None, status not started
  63                 Service VSP-EMPTY was tested and does not need a migration
  64                 Name: VSP01, Id: 98F5DDFD4F684086801E86A88A0D77AB, Vendor: ABC, locked by: None, status not started
  65                 Server Error
  66                 Service VSP01 was tested and it needs a migration
  67                 Service VSP-EMPTY - Migration start
  68                 Doing new checkout
  69                 200 OK Content-Type: application/json
  70                 Date: Thu, 08 Sep 2016 13:25:22 GMT
  71                 Server: Jetty(9.3.6.v20151106)
  72
  73                 done upload
  74                 Doing new checkin
  75                 Service {0} - Migration end
  76
  77         Example for a case with no migration needed:
  78
  79                 Name: VSP-OK, Id: 9DB0E1563B22481D911ECD33989E1FDD, Vendor: ABC, locked by: None, status not started
  80                 Service VSP-OK was tested and does not need a migration
  81                 Name: VSP02-Checkout, Id: 8DF8D65535414AAAA23682E2532675E6, Vendor: ABC, locked by: None, status not started
  82                 Service VSP02-Checkout was tested and does not need a migration
  83                 Name: VSP-EMPTY, Id: D26892D2839746E18075EF49C4586320, Vendor: ABC, locked by: None, status not started
  84                 Service VSP-EMPTY was tested and does not need a migration
  85                 Name: VSP01, Id: 98F5DDFD4F684086801E86A88A0D77AB, Vendor: ABC, locked by: None, status not started
  86                 Service VSP01 was tested and does not need a migration
  87
  88