Upgrade a Grid to a Patch-Compatible Release
-
Create an installation of the target release on each host in the model.
-
Modify each management instance to use with the new installation and then restart the instance.
-
Modify each data instance to use with the new installation and then restart the instance.
As with any other aspect of administering a grid, all the aforementioned tasks are performed through the ttGridAdmin
utility. The grid topology (number of management instances, K-safety value, and the number of replica sets) and if the upgrade supports to keep at least one full copy of every database available for applications to connect determines which ttGridAdmin
commands need to be run, in which order, and at what time.
To keep things as simple and as straightforward as possible, TimesTen provides the ttGridAdmin gridUpgrade
command. The ttGridAdmin gridUpgrade
command studies the grid and, if possible, runs all the necessary commands to perform either of the aforementioned tasks without further input from the instance administrator. Alternatively, you can perform any and all of the main tasks for an upgrade at your own pace by providing each individual ttGridAdmin
command that the ttGridAdmin gridUpgrade
command would otherwise run in the background.
The next topics describe the release compatibility metadata, the prerequisites for upgrading a grid to a patch-compatible release and how to perform such upgrade either with or without the ttGridAdmin gridUpgrade
command.
Release Compatibility Metadata
Every TimesTen release includes metadata regarding whether the release can be upgraded from or to a previous TimesTen release. The release compatibility metadata includes similar information concerning previous TimesTen releases.
In TimesTen Scaleout, the ttGridAdmin gridUpgrade
command uses this metadata to determine if and what type of upgrade instances of the current release support towards the target release.
Upgrade Prerequisites
Upgrades to a patch-compatible release have these prerequisites:
-
The current version of the model matches the latest version of the model. In other words, there have not been any changes to the model since the latest changes were applied.
-
Including the target release, the grid is running under no more than two different releases. One or more instances operating under a different but compatible release to the rest of the instances is expected. For example, a grid may continue to successfully operate during an upgrade or even after the upgrade is interrupted or one of the operations performed during the upgrade fails; in such cases, you may make a second attempt to complete the upgrade after resolving the issue. However, you should not attempt an upgrade when a previous upgrade with a different target release has yet to be completed.
Upgrading a Grid with the ttGridAdmin gridUpgrade Command
To upgrade a grid to a patch-compatible release with the ttGridAdmin gridUpgrade
command, complete these tasks:
Create Installations of the Target Release
Before you can upgrade a grid to a patch-compatible release, all hosts in the model must have access to an installation of the target release. The -createInstallations
option of the ttGridAdmin gridUpgrade
command creates, for each host, an installation of the provided TimesTen distribution or from an existing TimesTen installation.
Now that every host in the grid has an installation of the target release, you can proceed to upgrade the management and data instances.
For more information on the ttGridAdmin gridUpgrade
command, see
Upgrade a Grid (gridUpgrade) in Oracle TimesTen In-Memory Database
Reference.
Upgrade the Management Instances
Use the -type mgmt
option of the ttGridAdmin gridUpgrade
command to upgrade the management instances to the target release.
Now that you have successfully upgraded the management instances to the target release, you can proceed to upgrading the data instances.
For more information on the ttGridAdmin gridUpgrade
command, see
Upgrade a Grid (gridUpgrade) in Oracle TimesTen In-Memory Database
Reference.
Upgrade the Data Instances
TimesTen supports both online and offline upgrades of data instances between patch-compatible releases on a case by case basis. The metadata TimesTen uses to determine if a grid is patch compatible to another and if either or both type of upgrades are possible is included in every TimesTen installation.
An online upgrade consists on upgrading the data instances in such a manner that there is always at least one copy of the database available for applications to connect. This means that TimesTen only supports online upgrades for grids with k
set to 2
or greater and with at least one loaded database.
An offline upgrade consists of upgrading the data instances while all databases are unloaded from memory. TimesTen supports offline upgrades for all values of K-safety.
These topics describe how to perform an online or offline upgrade of data instances:
Online Upgrade of Data Instances
Use the -type data -online
options of the ttGridAdmin gridUpgrade
command to perform an online upgrade of the data instances to the target release.
Now you have successfully upgraded your grid to the target release.
For more information on the ttGridAdmin gridUpgrade
command, see
Upgrade a Grid (gridUpgrade) in Oracle TimesTen In-Memory Database
Reference.
Offline Upgrade of Data Instances
Use the -type data -offline
options of the ttGridAdmin gridUpgrade
command to perform an online upgrade of the data instances to the target release.
Now you have successfully upgraded your grid to the target release.
For more information on the ttGridAdmin gridUpgrade
command, see
Upgrade a Grid (gridUpgrade) in Oracle TimesTen In-Memory Database
Reference.
Upgrading a Grid Without the ttGridAdmin gridUpgrade Command
To upgrade a grid to a patch-compatible release without the ttGridAdmin gridUpgrade
command, complete these tasks:
Create Installations of the Target Release
You may use the ttGridAdmin installationList
command to determine the hosts that need to be upgraded and the location of the current installations, as shown next.
% ttGridAdmin installationList
Host Install Location Comment
----- ------------- ---------------------------- -------
host1 installation1 /grid/tt22.1.1.27.0
host2 installation1 /grid/tt22.1.1.27.0
host3 installation1 /grid/tt22.1.1.27.0
host4 installation1 /grid/tt22.1.1.27.0
host5 installation1 /grid/tt22.1.1.27.0
host6 installation1 /grid/tt22.1.1.27.0
host7 installation1 /grid/tt22.1.1.27.0
host8 installation1 /grid/tt22.1.1.27.0
For more information on the ttGridAdmin installationList
or
ttGridAdmin installationCreate
command, see List
Installations (installationList) or Create an Installation
(installationCreate), respectively, in Oracle TimesTen In-Memory Database
Reference.
For more information on the ttGridAdmin modelApply
command, see
Applying the Changes Made to the Model and Model Operations in Oracle TimesTen In-Memory Database
Reference.
Upgrade the Management Instances
How to upgrade the management instances depends on whether there is one or two management instances configured in the grid. Follow the procedure that better applies to your configuration:
Active Standby Configuration
When you have an active standby configuration for your management instances, you can upgrade each management instance separately without any interruption of service by ensuring that an active management instance is always up.
For more information on the ttGridAdmin mgmtStandbyStop
,
ttGridAdmin mgmtStandbyStart
, and ttGridAdmin
mgmtStatus
commands, see Management Instance Operations in Oracle TimesTen In-Memory Database
Reference.
For more information on the ttGridAdmin instanceModify
command, see
Modify
an Instance (instanceModify) in Oracle TimesTen In-Memory Database
Reference.
For more information on the ttGridAdmin mgmtActiveSwitch
command,
see Starting, Stopping and Switching Management Instances in this document and Switch the Active Management Instance
(mgmtActiveSwitch) in Oracle TimesTen In-Memory Database
Reference.
For more information on the ttGridAdmin modelApply
command, see
Applying the Changes Made to the Model and Model Operations in Oracle TimesTen In-Memory Database
Reference.
Upgrading a Single Management Instance
In a single management instance configuration, you need to restart the active management instance for the new installation to take effect, as shown next:
For more information on the ttGridAdmin instanceModify
command, see
Modify
an Instance (instanceModify) in Oracle TimesTen In-Memory Database
Reference.
For more information on the ttGridAdmin modelApply
command, see
Applying the Changes Made to the Model and Model Operations in Oracle TimesTen In-Memory Database
Reference.
For more information on the ttGridAdmin mgmtActiveStop
and
ttGridAdmin mgmtActiveStart
, see Management Instance Operations
in Oracle TimesTen In-Memory Database
Reference.
Upgrade the Data Instances
Before you can restart a data instance so that the new installation takes effect, you need to unload all databases:
For more information on the ttGridAdmin instanceExec
or
ttGridAdmin instanceModify
command, see Execute a Command or Script on Grid Instances
(instanceExec) or Modify an Instance (instanceModify), respectively, in Oracle TimesTen In-Memory Database
Reference.
For more information on the ttGridAdmin modelApply
command, see
Applying the Changes Made to the Model and Model Operations in Oracle TimesTen In-Memory Database
Reference.
Optional: Delete the Installations of the Previous Release
To avoid assigning the wrong installation to new instances, it is recommended that you delete the installations of the previous release from your grid.
For more information on the ttGridAdmin installationDelete
command,
see Delete
an Installation (installationDelete) in Oracle TimesTen In-Memory Database
Reference.