...
Typically this requires one business day of downtime for the final cutover.
(Side note, while you will be transfering all environments, the actual environment transfer tool supports transfering one environment at a time.)
Transfer Each
Best for an integration where there are multiple sites for each environment.
...
| Note |
|---|
Cutover The cutover is when testing is done and your site is ready to switch all API endpoints from your on-prem install to CHILI publish Online. At this point, you typically want to do another data transfer from your on-prem environment to your CHILI publish Online GraFx Publisher environment so all the files are synchronized. This cutover day must be planned with the CHILI publish support team, and will usually require a few hours to one business day of downtime. Each Cutover Will Cause Downtime!!! |
...
It requires four simple steps:
Getting a dropzone from CHILI publishPrepare the data the environment ID and request a transfer
Transfer with the Data Migration Toolkit
Transfer data to the dropzone
Notify the Customer Success team when the transfer is complete
Step 1: Getting the environment ID and request a
...
transfer
You will first need to create a ticket on https://mysupport.chili-publish.com/ requesting a dropzone for data transfer.
If you are transferring one environment at a time, then you will need to request multiple dropzone URLs. If you are transferring all environments, then you will only need one dropzone URL. Keep in mind that if you transfer all your environments, but you own less CHILI publish Online environments, you need to note which environments you want to be ignored after the transfer.
The Customer Success team will reply back with a URL for your dropzone — like the link below — with in 1 to 3 business daysWhen you make this ticket, please include the environment ID or IDs that you are wishing to transfer. You can find the IDs by clicking on an environment in the https://chiligrafx-dev.com/environments and finding the ID in the URL.
https://chilitennatmigration.blob.core.windows.net/migration-cstest?sv=2019-02-02&si=migration-cstest-72B725F20C&sr=c&sig=ctaDl%2BrzrWQEKsh6Hxs%3df
This URL points to an Azure blob storage. We use blob storage as a temporary space to store your data until you notify the Customer Success team that your transfer is complete. Once notified, one of our SaaS team members will transfer the data from the blob storage to the final environment.
| Note |
|---|
If this transfer is for production, where you are planning to do a cutover, then you need to notify the Customer Success team in your ticket and schedule the transfer from blob to the environment. Without scheduling, it takes 1 to 4 business days, after you notify the Customer Success team, for our SaaS team to transfer blob to the environment. |
The dropzone URL will only be active for a short period. Therefore it is best to make this ticket within a few days before you are ready to do the transfer.
Step 2: Data Migration Toolkit
With the Data Migration Toolkit, you can prepare your local data before you send it to the dropzone.
The tool also has a built in command "CopyEnvironmentToDropzone" to copy data to the Dropzone.
Download the Migration Toolkit (exe file for windows CLI)
https://stchilireleases.blob.core.windows.net/cli/CHILI.Migration.CLI_win-x64.zip
Step 3: Notify the Customer Success team when the transfer is complete
After all the data has transferred with no failures, then you will notify the Customer Succes team via the original ticket that all data has transferred.
If you have not scheduled the transfer, it will take 1 to 4 business days for the data to be transferred from the dropzone blob storage to your environment (or environments).
The Customer Success team will reply back with the environment is ready.
Data Migration Toolkit
The "Data Migration Tool Kit CLI" is a command-line application designed to simplify data migration for CHILI publisher. It various commands to facilitate the migration process:
...
chiligrafx-dev.com/environments and select an environment
...
Grab the ID from the URL
If you are having trouble getting the IDs, please share the environment name or BackOffice URL.
In your ticket, if you are looking to setup a transfer date for a production cutover, please make sure to ask at least 10 days in advance.
The Client Success team may ask you about your environment size, you get this from Windows native tools like file explorer or using the Data Migration Tool.
Step 2: Transfer with the Data Migration Toolkit
Download the Data Migration Toolkit
| Panel | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
Be sure to stop all services (Web and ChiliService) before using the CLI. Otherwise you risk damaging your data.xml files or causing errors during file transfer. |
| Panel | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
We strongly suggest backing up the data.xml files found in the |
You can use this tool to run a report which will gives you environment statistics such as file size, number of files, and average script execution time. This is done by running the command CreateEnvironmentReport and specifying your environment's path.
...
Preparing for Migration: Before using the tool, it's important to stop all related services to prevent changes in certain resource files. After running the tool, a report file is generated in the same folder, highlighting key environment data and any absolute paths in resource files.
...
| Code Block |
|---|
.\CHILI.Migration.CLI CreateEnvironmentReport -d "C:\chili_data\Environments\test" |
-d is the path to your environment
Before Transfer
If you are doing a production transfer (not just testing). You need to fix potential absolute paths in the resource files can cause issues post-migration, especially in cloud environments. To avoid this, the FixAbsolutePathsInDataXml command converts absolute paths to relative ones
...
.
In essence, this tool kit provides a streamlined way to prepare and execute data migration, addressing specific needs such as environment analysis, path conversion, and safe data transfer to cloud storage.
Generate report
To generate a report with environment statistics, run the executable file with the CreateEnvironmentReport command and specify the path to the environment on your disk
Example
| Code Block |
|---|
.\CHILI.Migration.CLI |
...
FixAbsolutePathsInDataXml -d "C:\chili_data\Environments\test" |
...
Update absolute paths
To update absolute paths to relative paths for all resources, run the executable file with the FixAbsolutePathsInDataXml command and specify the path to the environment on your disk
Example
...
-d is the path to your environment
Run this command immediately before copying data. Because after changes in data.xml files, some resources will may not work correctly locally.
Copy data to Dropzone
To copy the environment into a blob container, run the executable file with the CopyEnvironmentToDropzone command and specify the path to the environment on your disk and the Dropzone link URL that was provided to you by CHILI publish earlierThat is why we suggest it only for a production transfer.
If you backed up your data.xml files, you can just restore them to undo the changed made by FixAbsolutePathsInDataXml
Transfering Data
| Info |
|---|
It’s important to note that you are transferring to a temporary cloud-based storage and not directly to your environment. This is due to infrastructure. |
To migrate your environment to a cloud-based storage, use the CopyEnvironmentToDropzone command. This requires the path to your environment and the environment ID. It's recommended to perform this operation when your system is under minimal load and has sufficient free RAM (at least 4GB).
| Code Block |
|---|
.\CHILI.Migration.CLI CopyEnvironmentToDropzone -d "C:\chili_data\Environments\test" - |
...
e "45bbcd53-6334-48a9-8394-0cf4821d7bbc" |
-d is the path to your environment
-e is your environment ID
Step 3: Notify the Customer Success team when the transfer is complete
After all the data has transferred, then you will notify the Customer Success team via the original ticket that all data has transferred.
If there are failures, notify the Customer Success team. In rare cases, a small number of documents will fail to transfer, which usually is small enough to handle manually.
If you did not set a date in Step1, it will take 1 to 4 business days for the data to be transferred from the dropzone to your environment (or environments).
The Customer Success team will reply back with the environment is ready.