diff options
| author |   Timoney, Dan (dt5972) <dt5972@att.com> | 2021-10-29 14:47:40 -0400 |
|---|---|---|
| committer |   Dan Timoney <dtimoney@att.com> | 2021-11-01 10:17:41 -0400 |
| commit | 5b935a9086ec1080f896b9a71c52283122aa0163 (patch) | |
| tree | f28aee1327e5b6c8ad423dec5950d46f66ac201b /HOW_TO_MIGRATE_MDSAL.md | |
| parent | 53b2788231f5ab3aeda4f09e1445a02c3a3b6be9 (diff) | |
Sync local changes to support GRA microservice
Sync changes made downstream to support GRA microservice
Change-Id: If3bf5d879f7d61ab91209c63b0344d78128246a8
Issue-ID: CCSDK-3504
Signed-off-by: Dan Timoney <dtimoney@att.com>
Diffstat (limited to 'HOW_TO_MIGRATE_MDSAL.md')
| -rw-r--r-- | HOW_TO_MIGRATE_MDSAL.md | 48 |
1 files changed, 48 insertions, 0 deletions
diff --git a/HOW_TO_MIGRATE_MDSAL.md b/HOW_TO_MIGRATE_MDSAL.md new file mode 100644 index 0000000..df45232 --- /dev/null +++ b/HOW_TO_MIGRATE_MDSAL.md @@ -0,0 +1,48 @@ +## How to migrate GRA MD-SAL data between EOM and MCOM + +Scripts to migrate data from SDN-NFT EOM to SDN-NFT MCOM and to export data +from MCOM to EOM are provided in ms/gra/gra-docker/src/main/scripts. + +### Migrate MD-SAL data from EOM to MCOM +The importGraDaexim.sh script is used to import MD-SAL data +saved using the OpenDaylight daexim feature. The data from this script +is loaded into the MCOM data via multiple "chunks", to work around limits +in file size on posts to the Azure environment. The shell variable +CHUNK_SIZE can be used to adjust the number of entries included in each +chunk. This variable defaults to 75. + +The shell variables ODL_USER and ODL_PASSWORD must also be set to the +mechid / password that should be used for transactions to SDN-NFT. + +The following are the steps to import MD-SAL data with the import script: +1. Use daexim in EOM to export MD-SAL data. +2. Import exported data to MCOM using importGraDaexim.sh (in ms/gra/gra-docker/src/main/scripts) + export ODL_USER=<mechid> + export ODL_PASSWORD=<password for mechid> + importGraDaexim.sh <export-file-name> <controller-url> + + +### Fallback MD-SAL data from MCOM to EOM +The graToMdsal.sh script is used to migrate data from the SDN-NFT MCOM +environment back to EOM. This script should be run in an environment +that can: +* Use kubectl to exec into the SDN-NFT GRA pod +* Use curl to send https POST commands to SDN-NFT EOM + +This script uses the following environment variables: +* NFT_AZURE_USER: SDN-NFT mech id (default: SDN-NFT non-prod mech id) +* NFT_AZURE_PASSWORD: SDN-NFT password (default: SDN-NFT non-prod password) +* NFT_EOM_USER : SDN-NFT EOM user (default: admin) +* NFT_EOM_PASSWORD : SDN-NFT EOM password (default: admin) + +To use this script to copy MD-SAL data from SDN-NFT MCOM data back to SDN-NFT EOM: + + graToMdsal.sh <nft-namespace> <gra pod name> <eom-url> + + + + + + + + |