Backup and Migration

LDAP Directory Server

Most configurations, especially for thin clients and applications, are stored in the LDAP directory. Export and import the entire LDAP tree or selected parts as LDIF.

Note, the LDAP directory stores data independently, and it's best to perform consistency checks. Take particular care when importing individual LDAP branches to ensure intended name consistency.

Manager Home

All data for the openthinclient server is stored in the Manager Home. In addition to the LDAP directory and configuration files, the following backup-relevant folders are located there: User Home and Custom.

openthinclient Installer:

The home path is specified during installation.

openthinclient Virtual Appliance:

/home/openthinclient/otc-manager-home

User Home Folder

If a persistent home directory on an NFS server is used and an external NFS server isn't configured at the site, store the user directories here <Manager-Home>/nfs/home.

Custom folder

The custom folder (e.g., for Citrix licenses and wallpapers) is located at <Manager-Home>/nfs/custom.

Database

Select the database type during installation.

In particular, the state of the package manager is stored in the database. Therefore, when restoring a database backup, ensure the same state of the Manager Home is also restored. Maintain consistency between the package manager state stored in the database and the file contents in the Manager Home to prevent errors.

For migration, set up a new installation, manually install the necessary client packages, and start with a fresh database.

MySQL/MariaDB

MySQL/MariaDB offers the best options for database administration and backup.

Derby

Back up a Derby database by copying all files to <Manager-Home>/db . To do this, stop the openthinclient Management Server beforehand.

Virtual Appliance

Full System Backup

In addition to the options listed above, the Virtual Appliance offers the ability to save the state of the entire system as a snapshot. Create a snapshot before package updates whenever possible, so that a functioning state of the system can be quickly and easily restored if issues arise.

In addition to snapshots, clone the Virtual Appliance to create a test system that closely matches production.

Local LDIF Backup on the Appliance

The appliance includes an automatic LDIF backup script that exports data from the LDAP directory server daily at 02:00. The system retains backups for 100 d and automatically removes older copies.

Backup script directory: /usr/local/sbin/openthinclient-ldapbackup

Backup directory containing the exported LDIF files: /var/backups/openthinclient/