|Exercise 4||Backup and Migration|
|Overall Goal||Perform Backup and Restore operations for an FME Server installation|
|Demonstrates||Backing up and restoring automatic and manual FME Server configurations|
Your organization has decided to upgrade FME Server to the latest version just released. You want to make sure all the configurations, settings, and resources you have made to your current FME Server will be transferred over to the new FME Server installation. By backing up your current FME Server and then migrating the configurations and settings to the new version you will save lots of time!
|Miss Vector says...|
|If you have completed the Configure for HTTPS exercise, remember that the URL to connect to FME Server is now https://localhost:8443/fmeserver and NOT http://localhost/fmeserver!|
1) Connect to FME Server
Open the FME Server web interface, either through the Web Interface option on the Windows Start Menu or directly in your web browser, and log in using the username and password admin.
2) Backup FME Server
When migrating FME Server, you need to back up your current FME Server configurations.
On the left sidebar, click Backup & Restore.
On the Backup page, make sure the default parameter is set:
- Backup To: Download
Click the Download button to start the FME Server backup process and save the file to your computer.
3) Backup Configuration Files
It is also a best practice to manually back up any FME Server configuration files you have altered to a safe location outside of the FME Server installation directory. Certain configurations are not included in the primary backup procedure and you may want to reference the changes made to these files.
In this training course, if you have completed all exercises up until this point, we have modified server.xml, web.xml, context.xml, cacerts, and created a tomcat.keystore file in the Configuring FME Server for HTTPS exercise.
If we were trying to migrate our current FME Server configurations, these are the files that we would want to have copies of for reference later on when restoring FME Server configurations.
Save these files with your backup configuration file to easily find during a restore.
4) Backup Log Files (Optional)
Like configuration files, FME Server Log Files are not automatically backed up.
FME Server log files can be found on the Resources page of the web interface in the Logs folder.
For this exercise, we will backup only a couple of the log files. Go to Resources > Logs > core > current and place a checkmark in the boxes beside fmeconfiguration.log, fmeconnection.log, and fmeprocessmonitorcore.log.
Click Download and save these log files in the same location where you saved your BackupFMEServer configuration and your configuration files.
Log files from FME Server can be backed up but can not be restored to a new instance of FME Server. However, it is still a good idea to backup log files in case you need to reference them later on. If you do not backup your log files, they will disappear when you uninstall FME Server.
|Dr. Workbench says...|
|If you want to backup the entire logs folder, you can find it on your file system inside the resources folder of the FME Server System Share.|
5) Verify Backup, Install FME Server, Restore Configurations
At this point, during a regular migration workflow, this is when you verify the backup and install your new FME Server. For the purposes of this exercise, we will end the exercise here.
Optional: If you have extra time at the end of the course or your instructor says it's ok, you could try downloading, installing and migrating to the latest FME Server Beta. Please note that betas are not production safe.
It is vitally important that you verify the FME Server backup first, by installing a new instance of FME Server, before you uninstall FME Server. Once you uninstall there isn't an easy way to backtrack unless you regularly perform backups of your entire file system. If you're doing an upgrade on the same machine you won't be able to test this as you cannot install multiple versions of FME Server on the same machine.
When restoring the configuration files that are manually backed up, it is strongly suggested to go through each configuration file instead of simply copying the old configuration file into the new FME Server directory - file structures and parameters may have changed between releases!
By completing this exercise you have learned how to: