As part of the migration of content from Elvis 4 to Elvis 5 a dump needs to be created, describing the locations of files in the Elvis 4 storage.
This article explains how to create this.
Before you start
Step 1. Install the Java SE Development Kit 8u45 in order to run the Migration tool.
Tip: Show me how to install Java on Linux
Enter the following command in the Terminal:
sudo yum install -y java-1.8.0-openjdk
Step 2. Stop Elvis 4 server.
Step 3. Prepare free space for creating the dump.
Note: The size of the dump can be quite large, depending on the available Elvis 4 data. As a general reference, calculate the needed space in one of the following ways:
Creating the dump
Step 1. Download the latest version of the Migration tool from the software download page and unzip it somewhere on the system.
Step 2. Run the Migration tool by entering the following in the command line:
- For Mac OS X: sudo java -jar elvis-migration-tool-x.x.x.jar
- For Linux: sudo -u elvissrv java -jar elvis-migration-tool-x.x.x.jar
- For Windows: java -jar c:\elvis-migration-tool-x.x.x.jar
Note: The default port for the tool is 8080. To change the port, use the 'server.port' command line option:
Step 3. Access the Migration tool by entering the following URL in a Web browser:
Note: Make sure that the port number corresponds to the one that was specified in your command line.
Step 4. In the Export tab enter the following details:
- Application folder. The location where Elvis 4 is installed.
Note: This field is pre-filled with the location of a default Elvis 4 installation, based on the operating system.
- Source folder. The location where Elvis configuration and data folder are stored.
Note: This field is pre-filled with the default location, based on the operating system.
- Destination folder. The location where the dump will be created.
- Priority zones.Optional list of comma-separated folderPaths in Elvis from which assets and index entries need to be migrated first. Use this when migration of important data (such as from production) needs to be prioritized while other data (such as from archive) can be migrated at the end of the migration process. (Example: /Users,/Production/Brand).
Info: This feature requires the Migration Tool version 1.1.25 (shipped with Elvis 5.27) or higher.
- Same server migration. Select this option when you are going to install Elvis 5 on the same system as Elvis 4.
Note: When this option is selected, absolute paths will be used during the storage move.
Step 5. Click Start dump creation to create the dump.
Progress bars appear to indicate the progress of various steps of the process.
Step 6. After the process is completed, click Close.
Step 7. Verify that the dump has been created by accessing the "Destination folder". It should contain a folder with a name starting with 'elvis-dump' and it should itself contain various folders with content.
Continue the migration process
Return to Migrating Elvis 4 to Elvis 5 and continue with the next steps.
- 4 July 2017: Updated section 'Creating the dump' with the 'Priority zones' option.