Who are the customer(s) involved?
Are involved customers Enterprise, Hosted, or VPS customers
What companies are being moved? FERC-registered Name and CIDs.
- From the source customer:
- What TariffShark release is the customer running?
- What version of SQL Server are they using?
- Is the customer willing/able to send us a database backup? Does personal data need to be redacted?
- If necessary, how can we transfer files?
- What are we doing with transferred companies' data? Deleting? Updating license to hide data? Updating license to be read-only?
- From the target customer:
- What TariffShark release is the customer running?
- What version of SQL Server are they using?
- Is the customer willing/able to send us a database backup? If not, can the customer run Import Utility within their environment?
- If necessary, how can we transfer files?
- Scheduling
- When can everyone be out of TariffShark?
- We normally budget a day's worth of downtime/quiet period to perform migration
Overview of Steps
Below are the normal steps taken when transferring TariffShark datasets between two companies. Based upon the requirements gathered from the questions above the below steps may deviate depending on the nature of migration.
SC = Source Customer
TC = Target Customer
LT = Links Technology
- SC ensures TariffShark data freeze
- SC performs database backup and transfers backup to LT through the agreed-upon file-sharing method
- SC updates TariffShark license or removes transferred data from their environment
- SC freeze period ends
- TC ensures TariffShark data freeze
- TC performs database backup and transfers backup to LT through the agreed-upon file-sharing method
- LT downloads and restores backups into the migration environment
- LT performs data migration
- LT performs a backup of the new TC dataset and uploads the backup to file sharing portal
- TC downloads and restores backup into the TC environment
- TC updates TariffShark license, adding support for transferred companies
- TC business users verify the new TariffShark dataset
- TC ends the freeze period
- Migration Complete
If the Source Customer is unable to provide a full TariffShark backup
When the source customer cannot provide a full TariffShark backup the following steps replace steps 1 – 4 in the normal procedure.
- LT transfers TariffShark Export utility to SC
- SC ensures TariffShark data freeze
- SC creates a blank database on same SQL Server as source TariffShark database
- SC runs TariffShark Export utility, selecting companies that need to be transferred
- SC performs database backup of export database and transfers backup to LT through the agreed-upon file-sharing method
- SC updates TariffShark license or removes transferred data from their environment
- SC freeze period ends
If the Target Customer is unable to provide a full TariffShark backup
When the target customer cannot provide a full TariffShark backup the following steps replace steps 5 – 12 in the normal procedure.
- LT downloads and restores backup from SC into the migration environment
- LT creates the intermediate migration database
- LT transfers the intermediate migration database, TariffShark Import utility, and any necessary SQL scripts (ex. MapValues.sql) to TC through agreed upon file-sharing method
- TC downloads and restores backup into the TC environment
- TC ensures TariffShark data freeze period
- TC runs TariffShark Import utility procedures
- TC updates TariffShark license, adding support for transferred companies
- TC business users verify the new TariffShark dataset
- TC ends the freeze period
- Migration Complete
Known Complications
- When both the source and target databases contain any of the following custom fields (TCollationValue, TRCollationValue, TRVCollationValue) special steps must be taken not to create duplicate unique custom fields and ensure that the data using those custom fields is correctly mapped to the existing fields in the target database
- Older versions of the migration tool duplicated the defined Custom Field Types defined in the database. When this is encountered, duplicate Field Types need to be removed and any custom field definition using these duplicate types to be remapped.