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
- 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. Open a Terminal, navigate to the folder where the Migration Tool is installed, and run the tool by entering the following in the command line:
- For MacOS and Linux: sudo 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 2. Access the 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 3. Select the version of Elvis that you are upgrading to.
Step 4. Select the Export tab.
Step 5. 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).
- 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 6. Click Start dump creation to create the dump.
Progress bars appear to indicate the progress of various steps of the process.
Step 7. After the process is completed, click Close.
Step 8. 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.
- 3 July 2018: Updated section 'Creating the dump' by making it clear how to open the Migration Tool.
- 3 July 2018: Updated section 'Creating the dump' by adding a step for selecting the version of Elvis to upgrade to.