Configuration Files #

The configuration of services, sources, users and the server are stored in the config folder of the yunIO installation directory, e.g., C:\Program Files\Theobald Software\yunIO\config. Use the config folder for setting up a version control system or for creating manual backups.

Filename Description
extractions Contains the service definitions.
servers Contains the server settings.
sources Contains the SAP connections.
users Contains the user settings.

Backup #

Recommendation: Make sure to create regular backups of the yunIO configuration files to save the work invested in designing and optimizing your services. Alternatively, we recommend using a version control system, e.g. Git or Azure DevOps.

A backup allows you to easily switch back to the previous product version, if needed. See also Installation and Update.

How to Create a Backup

  1. Open the yunIO installation directory of the machine that runs yunIO, e.g., C:\Program Files\Theobald Software\yunIO.
  2. Copy the complete config folder of the yunIO installation directory and save the folder at a secure location.
  3. Optional: copy the complete logs folder of the yunIO installation directory to create a backup of the log files.
  4. To backup your license, create a copy of your yunIOLicense.json file.

Warning! Data security.
Both config and logs directories may contain sensitive information.

How to Restore a Backup

  1. Open the yunIO installation directory of the machine that runs yunIO, e.g., C:\Program Files\Theobald Software\yunIO.
  2. Remove the config folder from the installation directory.
  3. Copy the backup of the config folder into the installation directory.
  4. To restore the license, replace the yunIOLicense.json file in the installation directory with the 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.

Migration to a Different Machine #

Note: When migrating to a new server, a new license file must be issued for that server.
Contact our sales team at sales@theobald-software.com for more information.

Prerequisite

The same software version must be installed on both machines.
Use the YunIOSetup.exe from the installation directory of the current machine to install the matching version on the new machine. To check the version of your product, open the Designer and navigate to the About menu.

How to Migrate

  1. Open the yunIO installation directory of the current machine, e.g., C:\Program Files\Theobald Software\yunIO.
  2. Create a backup of the config folder from the installation directory.
  3. Decide whether you need a partial or a full migration.
    For a full migration copy the entire config folder to the yunIO installation directory on the new machine.
    For a partial migration only copy subfolders of the config folder to the new machine, see Configuration Files.
  4. Restart the yunIO Windows service on the new machine.