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:
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 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.
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 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 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.