Recommendation: Make sure to create regular backups of the configuration files to save the work invested in designing and optimizing your data extraction processes.
A backup allows you to easily switch back to the previous product version, if needed. See also section Installation and Update.
Configuration Files #
All configuration files of extractions, sources, destinations and the server are stored in the sub-directory
config of the Xtract Universal program directory.
C:\Program Files\XtractUniversal\config by default.
||Directory containing the destinations. Each
||Directory containing the extractions. Each sub-directory contains an extraction of the same name.|
||Directory containing the server settings.|
||Directory containing SAP connections. Each sub-directory contains a source of the same name.|
||Text file containing the product version of the current configuration. See also New Installation and Update.|
How do I Create a Backup? #
Copy the complete
config directory (
C:\Program Files\XtractUniversal\config by default) of the machine running the Xtract Universal Service and store the files in safe and secure locations.
Optionally, copy the complete
logs directory (
C:\Program Files\XtractUniversal\logs by default) to create a backup of the log files.
To backup your licence, create a copy of your
Warning! Data security.
logs directories may contain sensitive information.
How to Restore a Backup? #
Warning! Data Loss!
Restoring the backup of the
config directory replaces the exisiting configuration. Make sure to remove the existing files before restoring the backups.
- To restore the configuration files, remove the
configdirectory from the program directory (
C:\Program Files\XtractUniversalby deafult) of the machine running the Xtract Universal Service.
- Copy the backup of the
configdirectory into the program directory.
- To restore the licence replace the
XtractUniversalLicense.jsonfile within the program directory with the backup.
Migration to a Different Machine #
Configuration files can be migrated partially or entirely (full migration).
Depending on your scenario it can make sense to conduct a partial migration - e.g., if you transport extractions from a test to a production environment. When replacing a machine completely, conduct a full migration.
Note: When you update your test environment by copying single
config folders from the production environment, the
version.txt file must be copied, too.
version.txtis located in the
Prerequisite: Xtract Universal versions installed on both machines match.
To install the matching version on the different machine, use the
XtractUniversalSetup.exe from the program directory (
C:\Program Files\XtractUniversal) of the current machine.
To check the version of your product, open the Designer and navigate to Help > Info or press [F12].
- Create a backup of the
configdirectory of the current machine.
- Decide whether you need a partial or a full migration.
For a full migration you can restore the entire
configdirectory on the different machine. You can alternatively restore parts of the backup, by copying e.g., only the destinations or extractions directories.
- Restart the Xtract Universal Service, when performing a full migration or copying the
serverdirectory onto the different machine.
Note: When migrating to a new server, a new license file must be issued for that server. Contact our sales team at email@example.com for more information.