Summary: Instructions explaining how to export application data from one CAST Imaging and import it into another - i.e. to transfer data between CAST Imaging instances.
Introduction
If you have multiple CAST Imaging instances and would like to be able to export application data from one CAST Imaging and import it into another, you can do so following the instructions below. This feature is mainly aimed at supporting pilots and assessments and also for System Integrators who support CAST Imaging for multiple customers. The tool uses a two-step action:
- Run export on source host CAST Imaging and transfer output ZIP to target host CAST Imaging
- Run import of ZIP file on source host CAST Imaging
This feature should not be confused with Export and import the Application data which is the process used to transfer application data from CAST AIP into CAST Imaging.
Note that this tool is only available for CAST Imaging ≥ 1.12.x
Microsoft Windows via traditional installer
Step 1 - Locate the tool
The tool is located here and is shipped with CAST Imaging:
%PROGRAMFILES%\CAST\ImagingSystem\imagingetl\exportimport.exe
Step 2 - View available options
You can view a list of available options by running:
exportimport.exe -h
| -h help | View a list of available options. |
|---|---|
| --importapp APPNAME | Imports the ZIP file created by the --exportapp command. |
| --exportapp APPNAME | Exports the specified Application from CAST Imaging. |
| --listofapplications | Lists the applications that already exist on the target neo4j server.
|
| --user USER |
|
| --password PASSWORD |
|
| --port PORT |
|
| --location LOCATION |
|
Step 3 - Find your chosen Application on source CAST Imaging
Use the following command to find the name of the Application you want to export on the source CAST Imaging:
exportimport.exe --listofapplications
Step 4 - Export your chosen Application on source CAST Imaging
Use the following command on the chosen source CAST Imaging instance to export the Application, for example for an Application called MEUDON. This will create a ZIP file called MEUDON.zip in the current folder. You will then need to transfer this ZIP file to the chosen target CAST Imaging host for import:
exportimport.exe --exportapp MEUDON
Step 5 - Import your chosen Application on target CAST Imaging
Use the following command on the chosen target CAST Imaging instance to import the ZIP file created with the --exportapp command on the source CAST Imaging:
exportimport.exe --importapp MEUDON
Docker for Linux/Windows
Step 1 - obtain the tool(s)
≥ v. 1.12.0-beta4
The tools are provided with the Docker images, therefore as long as CAST Imaging has been installed, you can proceed.
≤ v. 1.12.0-beta3
Step 2 - View available options
Lists the applications that already exist on the target neo4j server. Windows: "C:\\ProgramData\\CAST\\ImagingSystem\\Neo4j_data\\import" Linux: "/opt/CAST/container-support/neo4j/csv/"-h help View a list of available options. --importapp APPNAME Imports the ZIP file created by the --exportapp command. --exportapp APPNAME Exports the specified Application from CAST Imaging. --listofapplications --user USER --password PASSWORD --port PORT --location LOCATION
Step 3 - Export your chosen Application on source CAST Imaging
Use the following command on the chosen source CAST Imaging instance to export the Application, for example for an Application called MEUDON. This will create a ZIP file called MEUDON.zip in the current folder. You will then need to transfer this ZIP file to the chosen target CAST Imaging host for import:
≥ v. 1.12.0-beta4
Docker Installer extension (run the command from the folder created when unzipping the extension): Linux: ./imaging --exportapp MEUDON Microsoft Windows: imaging.exe --exportapp MEUDON Linux Docker Installer extension (deprecated): imaging --exportapp MEUDON
≤ v. 1.12.0-beta3
Step 4 - Import your chosen Application on target CAST Imaging
Use the following command on the chosen target CAST Imaging instance to import the ZIP file created with the --exportapp command on the source CAST Imaging:
≥ v. 1.12.0-beta4
Docker Installer extension (run the command from the folder created when unzipping the extension): Linux: ./imaging --restoreapp MEUDON Microsoft Windows: imaging.exe --restoreapp MEUDON Linux Docker Installer extension (deprecated): imaging --restoreapp MEUDON
≤ v. 1.12.0-beta3
Known Issues
When using the tool on a Linux operating system, a permissions issue may arise which will not allow the creation of the files in the neo4j/csv folder. To resolve this, run the following command to change the permissions:
Linux Docker Installer extension (deprecated): chmod -R 777 /opt/CAST/container-support/neo4j/csv/