Skip to main content

Migrate from DOMOS5 to DOMOS6

General information​

This manual will guide you through the migration process.

This process allows to restore an already saved configuration backup, but if no backup has ever been performed, all data on the appliance will be lost.

TL;DR​

  1. Update old system to the latest version with DOMOS

  2. Create Configuration-Backup via Backup/Restore -> Config Backup -> Create new configuration backup

  3. Create a new job for BackupClient via BackupClient -> Jobs -> Add backup job

  4. Download Client configuration and Backup Client software (Windows or Linux)

  5. Create backup via

bakresclient -config PATH-TO-CONFIGFILE -bakdir BACKUP-DIRECTORY

  1. Install new DOMOS 6 system with latest ISO from SECUDOS website

  2. Import Configuration-Backup via Backup/Restore NG -> Config Restore

  3. Download new Backup Client software based on DOMOS 6 (Windows or Linux)

  4. Restore backup via

bakresclient -config PATH-TO-CONFIGFILE -resdir BACKUP-DIRECTORY

  1. Reboot the system to finish the restore process

  2. Install your new DOMOS license

Preparation​

Before you migrate an exisiting Qiata installation, you have to install all available updates and then create a backup of the system configuration.

Backup​

Login to the DOMOS WebUI. The DOMOS WebUI is available using the address https://IP-of-your-appliance:10000.

Configuration Backup​

Once you’re logged in, go to Backup/Restore NG → Config Backup and click on the button Create new configuration backup.

Now you can download a file called configuration.dat. This file contains the configuration of the DOMOS system and the Qiata software.

info

This backup consist of:

  • all DOMOS configuration (including all users)
  • email templates (including custom templates)
  • pages templates
  • all images
  • necessary configurations
  • databases (excluding transfer related ones)

This Backup does not include any multispace files nor uploaded files. Thus it also does not include any transfer related database information, for example transferdb.

More information can be found here: Config-Backup

IMPORTANT

Keep the configuration.dat in a safe place. It contains all the important information you need to restore the system.

Data Backup​

Backup via BakRes Client [recommended] ​

The DOMOS backup client, available for Windows and Linux, enables easy pulling of a backup from the DOMOS system and writing of a restore to the DOMOS system. The backup client must be started on an external system and automatically connects to the DOMOS system. The backupclient program is designed to use in batch scripting or running by a backup system automatically.

Windows Backup Client Start Backup

Shown is an example Backup started on Windows.

Windows Backup Client Finished

Shown is an example of a finished Backup within Windows Explorer. In the data structure under \files\var\lib\fta\company\default you will find all files and configurations that have been saved.

The usage of the BakRes Client can be found here: Backup/Restore Client

info

This backup consist of:

  • email templates (including custom templates)
  • pages templates
  • all images
  • necessary configurations
  • all databases
  • all uploaded files (depending on the job with or without MultiSpace)

Backup to FTPs​

Unlike the Bakres client, the backup via BackupNG involves moving files to a specific destination instead of pulling them.

The usage of the BackupNG can be found here: Backup to FTPs

info

This backup consist of:

  • email templates (including custom templates)
  • pages templates
  • all images
  • necessary configurations
  • all databases
  • all uploaded files (depending on the job with or without MultiSpace)

Prepare installation of virtual appliances​

ISO-Image​

If you do not have a DOMOS 6 installation image (ISO image), please download a copy from https://www.secudos.de/en/help-and-support/downloads/category/1-qiata. Please note that a registered user account is necessary to obtain the update.

  1. Create a virtual guest for the Appliance.
caution

Minimum requirements:

  • 1 or more CPU(s)
  • 4096 MB RAM, more recommended
  • 1 or more network interface(s) with fixed MAC addresses
  • min. 50 GB HDD drive

More resources are recommended.

  1. Ensure that you boot from the CD image (ISO) supplied by SECUDOS. Perform a plain installation from the CD image without applying any changes from the virtual hosting software (e.g. setting IP address during the installation). Please avoid using templates provided by your virtualization software. The installation will start automatically after a few moments.

The setup does not require any input or interaction. Once the setup procedure has completed, the virtual appliance will shut down. Before you start your freshly installed appliance, make sure that the installation medium is removed before proceeding. You have now successfully installed Qiata. You may now proceed with restoring the configuration/data files.

danger

Please note that the Secure-Boot function must be disabled for the virtual machine.

Supported Virtual Hostsystems​

HostsystemMinimal Version
VMwareESXi 5.0 U1
Hyper-VWindows Server 2012
LinuxKVM 1.0

Restore​

Restore configuration​

Login to the DOMOS WebUI. The DOMOS WebUI is available using the address https://IP-of-your-appliance:10000. You can use the tool DomosNetConf to do a simple IPv4 network configuration using the console after gaining root privileges.

Open Backup/Restore NG → Config Restore. Now upload the configuration backup (configuration.dat) downloaded at Create configuration Backup.

Once the restore has been successfully completed, you will see the message Restore done in the status display. Now reboot the system to complete the restore.

tip

Keep in mind that restoring the configuration may also set a new primary IP address for the system. So make sure that there is no address conflict.

Restore data​

Restore via BakRes Client [recommended] ​

To restore all files to the system, the BakRes client can be used. As with the backup, this is controlled via the CLI and can point to a directory that is used for the restore with the parameter -resdir.

Windows Backup Client Start Backup Shown is an example Restore started on Windows.

The usage of the BakRes Client can be found here: Backup/Restore Client

danger

Please make sure to reboot the system after a successful restore. This is mandatory for correct operation.

danger

Please note that the encryption key (if available in the old Qiata) may have to be re-entered after a migration!

Restore from FTPs​

To restore all files from a FTPs server, first log in to the DOMOS WebUI. Go to Backup/Restore NG -> Data Restore and click on Scan to begin searching for available backups on the target host. If the data restore was not preceded by a configuration restore, you must first define an appropriate target at Backup/Restore NG -> Targets.

Data Restore from FTPs

Select the desired backup and click Restore. The process may now take some time (depending on the data size). After a successful restore, you will receive a corresponding success message.

The usage of the BackupNG Restore can be found here: Restore from FTPs

danger

Please make sure to reboot the system after a successful restore. This is mandatory for correct operation.

danger

Please note that the encryption key (if available in the old Qiata) may have to be re-entered after a migration!

Important License information​

With DOMOS 6 you need a new license for DOMOS. You have to import this manually after a new installation or a restore. If you have not yet received a new license for your system, please contact your reseller/partner directly.

How to Install new license to DOMOS: Install DOMOS license