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 9.12 and Previous Tamino Versions

Tamino version 9.12 can coexist with previous versions on the same computer. After you have installed Tamino Version 9.12, 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 or 9.7 to version 9.12.

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 9.12

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 9.12 to any previous version is not supported. (For more information, see the section Downgrading.) As setting the Tamino version to 9.12 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 using the Tamino Manager, the database must be known by SMH 9.6 (System Management Hub) and Tamino 9.12. The database to be upgraded is not known if the database version is older than 9.5 or the Tamino 9.12 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 SMH 9.6 and Tamino 9.12 using:

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

You can activate the SET VERSION operation using the Tamino Manager as follows:

Start of instruction setTo activate the SET VERSION operation

  1. Start the Tamino Manager.

  2. In the list of databases under the Databases node, select the database that you want to upgrade.

  3. In the context menu of the database, choose SET VERSION.

When upgrading from a previous version of Tamino to Tamino 9.12, 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 or 9.7 to Tamino version 9.12 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 or 9.7.

    • The database to be updated is a replication database.

Downgrading

Downgrading a Tamino 9.12 installation to a prior version is not supported. Setting the version of a database to version 9.12 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.