If the migration of content from Elvis 4 to Elvis 5 failed for some reason, you can roll back any Elvis 4 files that have moved to Elvis 5.
This article explains how this is done.
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 Rollback tab.
Step 5. Enter the following details:
- Elvis 5 Folder. The location of your Elvis 5 config/data folder.
Note: This field is pre-filled with the location of a default Elvis 5 installation, based on the operating system.
- Dump name The name of the dump which is to be rolled-back.
Note: This field is pre-filled with the name of the last dump.
- Move files. Select this option when you are going to move files back from the Elvis 5 storage to the Elvis 4 storage instead of copying them.
Note: Moving files is quicker than copying them.
Step 6. Click Start rollback.
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 files have been moved to your Elvis 4 data folder.
Step 9. (Optional) try migrating your files from Elvis 4 to Elvis 5 again.
- 3 July 2018: Made it clearer how to run the Migration Tool.