Upgrading and Downgrading Using SET VERSION

This document describes what you should know about the coexistence of different Tamino versions and upgrading and downgrading between them. In detail, the following topics are described:


Coexistence of Tamino Version 10.3 and Previous Tamino Versions

Tamino version 10.3 can coexist with previous versions on the same computer. After you have installed Tamino Version 10.3, you can use the SET VERSION operation, which is activated using the Tamino Manager SET VERSION button, to upgrade from version 8.0, 8.2, 9.5, 9.7, or 9.12 to version 10.3.

Note:
The authentication mode of the database needs to be set to "none" before a database can be upgraded via Set Version. For more information see section Authentication Modes.

Upgrading from Previous Versions of Tamino to Tamino 10.3

The SET VERSION operation converts a database from an older version to a newer version. This involves updating the database's internal structure level, which is necessary when there is version dependent data for the datastore or X-Machine layer.

Warning:
Before you execute the SET VERSION operation, make a backup of the current state of your database.
Warning:
Downgrading from version 10.3 to any previous version is not supported. (For more information, see the section Downgrading.) As setting the Tamino version to 10.3 is an irreversible process, the only way to return to the old state of your original Tamino database is to restore a backup of that database into an installation of the correct Tamino version.

Before activating the SET VERSION operation the database must be known Tamino 10.3. The database to be upgraded is not known if the database version is older than 9.5 or the Tamino 10.3 installation is using another root directory (side-by-side installation). There are two possibilities to do this:

  • Create the database to be upgraded using a backup

  • Transfer the meta-data of the database to be upgraded to the internal configuration store used by Tamino 10.3 using:

    <PRODUCT_DIR>/v101/bin/MoveDbConfig.[sh|cmd] <database name>

You can activate the SET VERSION operation using inoadmin tool.

When upgrading from a previous version of Tamino to Tamino 10.3, note the following:

  • Whilst an upgrade is in progress, the database cannot be accessed by applications.

  • If, for any reason, the upgrade fails, it can be repeated and restarted at the point where it was interrupted.

  • The upgrade from Tamino version 8.0, 8.2, 9.5, 9.7, 9.12, or 10.1 to Tamino version 10.3 is rejected if one or more of the following conditions is true:

    • The version of the database to be upgraded is not version 4.4, 8.0, 8.2, 9.5, 9.7, 9.12, or 10.1

    • The database to be updated is a replication database.

Downgrading

Downgrading a Tamino 10.3 installation to a prior version is not supported. Setting the version of a database to version 10.3 is irreversible.

However, it is possible to operate multiple Tamino installations with different versions in parallel on a single computer.

If you want to return to a former version of Tamino, you must restore a backup of your original database of that specific version (via restore with the option Don't recover, or via recover until with a timestamp before the SET VERSION was done, or via create from backup).

You can restore the database backup of a former Tamino version even if that version of Tamino is not installed. Check whether the relevant backup is still in the backup list of that database. If it is, you can simply restore that backup with the option "Don't Recover". Afterwards you should do the SET VERSION immediately so that you can start the database again. If your backup is not present in the backup list, then you need a separate copy of the database backup. Use the function Create Database from Backup.

Important:
After you have restored your former installation using this backup, we recommend making a new backup. Use this backup instead of the original one if you later want to recover to the state after restoration of the former Tamino version.