1. リファレンス
  2. TimesTen Scaleoutのユーティリティ
  3. ttGridAdmin
  4. グリッド操作
  5. グリッドのアップグレード(gridUpgrade)

グリッドのアップグレード(gridUpgrade)

gridUpgradeコマンドは、次の3つの主なタスクを実行して、グリッドをパッチ適用に対応したリリースにアップグレードします。
  1. モデル内のホストごとに、指定したTimesTenインストールまたはディストリビューションのインストールを作成します。
  2. 管理インスタンスを指定したリリースにアップグレードします。
  3. データ・インスタンスを指定されたリリースにアップグレードします。
ttGridAdmin gridUpgrade -createInstallations -source where
                        [-dryrun]

ttGridAdmin gridUpgrade -type mgmt -to release 
                        [-force] 
                        [-metadata file] 
                        [-dryrun]

ttGridAdmin gridUpgrade -type data -to release 
                        -online|-offline 
                        [-force] 
                        [-metadata file] 
                        [-dryrun]

gridUpgradeコマンドを使用してグリッドを完全にアップグレードするには、gridUpgradeコマンドを少なくとも3回、メイン・タスクごとに1回、および前述の順序で実行する必要があります。詳細は、『Oracle TimesTen In-Memory Database Scaleoutユーザーズ・ガイド』の「グリッドのアップグレード」を参照してください。

オプション

gridUpgradeコマンドには、次のオプションがあります。

オプション 説明

-createInstallations

指定したTimesTenディストリビューションのインストールまたはホストごとのインストールを作成します。

-type mgmt|data

アップグレード、管理またはデータのインスタンス・タイプを指定します。

-source where

このオプションを-createInstallationsオプションとともに使用して、TimesTenディストリビューションの場所を指定します。この場所は、グリッドの一部であるシステム上にある必要はありません。必要に応じて、次のいずれかの形式で指定できます。 

/path
address:/path
address!/path
[address]:/path

pathがディレクトリの場合は、既存のTimesTenインストールの最上位のtt22.1.x.y.zディレクトリである必要があります。ファイルの場合は、TimesTenインストールに展開される.zipファイルである必要があります。addressはDNSまたはIPアドレスです。

addressを指定した場合は、パスワードなしSSHを使用して、そのアドレスを持つシステムからインストール・ソースをフェッチします。IPv6アドレスのようにアドレス自体にコロンがある場合は、4つ目の形式を使用する必要があります。

また、「アドレス形式」も参照してください。

-to release

このオプションを-typeオプションとともに使用して、アップグレードのターゲット・リリースを指定します。リリース番号の5つの部分すべてをピリオドで区切って指定する必要があります(22.1.1.21.0など)。

-online

サポートされている場合は、このオプションを-type dataオプションとともに使用して、ロード済で接続に対してオープンの各データベースの少なくとも1つのコピーを保持しながら、データ・インスタンスをアップグレードします。

-offline

このオプションを-type dataオプションとともに使用して、グリッド内のすべてのデータベースがアンロードされたときにデータ・インスタンスをアップグレードします。

-force

このオプションを-typeオプションとともに使用して、現在のリリースがターゲット・リリースへのアップグレードをサポートしているかどうかを確認するのを停止します。

指定しない場合、このコマンドは、-metadataオプションで指定されたリリース互換性メタデータ、または使用可能なインストールに含まれているリリース互換性メタデータを使用します。

リリース互換性メタデータの詳細は、『Oracle TimesTen In-Memory Database Scaleoutユーザーズ・ガイド』の「リリース互換性メタデータ」を参照してください。

-dryrun

実行するコマンドを表示しますが、実行はしません。指定したその他のオプションは、実行するコマンドのリストに反映されます。

-metadata file

このオプションを-typeオプションとともに使用して、サポートされているアップグレードに関するメタデータを含むファイルのパスと名前を指定します。

指定しない場合、このコマンドは、使用可能なインストールに含まれるリリース互換性メタデータを使用します。

リリース互換性メタデータの詳細は、『Oracle TimesTen In-Memory Database Scaleoutユーザーズ・ガイド』の「リリース互換性メタデータ」を参照してください。

例

この例では、TimesTen 22.1.1.22.0ディストリビューションからインストールを作成します。次に、この例では、モデル内のすべてのTimesTenインストールをリストします。 

% ttGridAdmin gridUpgrade -createInstallations -source /mydir/timesten2211220.server.linux8664.zip 
Checking for existing installations of TimesTen 22.1.1.22.0............OK
Creating missing installation objects.................................OK
Applying model to create new installations............................OK

% ttGridAdmin installationList
Host  Install       Location                         Comment
----- ------------- -------------------------------- -------
host1 installation1 /grid/tt22.1.1.21.0
host1 installation2 /grid/installation2/tt22.1.1.22.0
host2 installation1 /grid/tt22.1.1.21.0
host2 installation2 /grid/installation2/tt22.1.1.22.0
host3 installation1 /grid/tt22.1.1.21.0
host3 installation2 /grid/installation2/tt22.1.1.22.0
host4 installation1 /grid/tt22.1.1.21.0
host4 installation2 /grid/installation2/tt22.1.1.22.0
host5 installation1 /grid/tt22.1.1.21.0
host5 installation2 /grid/installation2/tt22.1.1.22.0
host6 installation1 /grid/tt22.1.1.21.0
host6 installation2 /grid/installation2/tt22.1.1.22.0
host7 installation1 /grid/tt22.1.1.21.0
host7 installation2 /grid/installation2/tt22.1.1.22.0
host8 installation1 /grid/tt22.1.1.21.0
host8 installation2 /grid/installation2/tt22.1.1.22.0

この例では、管理インスタンスをTimesTen 22.1.1.22.0リリースにアップグレードします。 

% ttGridAdmin gridUpgrade -type mgmt -to 22.1.1.22.0
Checking prerequisites................................................OK
Checking for existing installations of TimesTen 22.1.1.22.0............OK
Verify that upgrade is known to be supported..........................OK
Verify that instances are running the expected releases...............OK
Determining management instance state.................................OK
Modify instance host2.instance1.......................................OK
Apply change..........................................................OK
Stop standby management instance host2.instance1......................OK
Start standby management instance host2.instance1.....................OK
Fail over to management instance host2.instance1......................OK
Start standby management instance host1.instance1.....................OK
Modify instance host1.instance1.......................................OK
Apply change..........................................................OK
Stop standby management instance host1.instance1......................OK
Start standby management instance host1.instance1.....................OK
Fail over to management instance host1.instance1......................OK
Start standby management instance host2.instance1.....................OK

この例では、TimesTen 22.1.1.22.0リリースへのデータ・インスタンスのオンライン・アップグレードを実行します。 

% ttGridAdmin gridUpgrade -type data -to 22.1.1.22.0 -online
Checking prerequisites................................................OK
Checking for existing installations of TimesTen 22.1.1.22.0............OK
Verify that upgrade is known to be supported..........................OK
Verify that instances are running the expected releases...............OK
Modify instance host3.instance1.......................................OK
Apply model...........................................................OK
Stop host3.instance1..................................................OK
Start host3.instance1.................................................OK
Waiting for host3.instance1 database database1 to reload..............OK     
Modify instance host6.instance1.......................................OK
Apply model...........................................................OK
Stop host6.instance1..................................................OK
Start host6.instance1.................................................OK
Waiting for host6.instance1 database database1 to reload..............OK     
Modify instance host4.instance1.......................................OK
Apply model...........................................................OK
Stop host4.instance1..................................................OK
Start host4.instance1.................................................OK
Waiting for host4.instance1 database database1 to reload..............OK     
Modify instance host7.instance1.......................................OK
Apply model...........................................................OK
Stop host7.instance1..................................................OK
Start host7.instance1.................................................OK
Waiting for host7.instance1 database database1 to reload..............OK     
Modify instance host5.instance1.......................................OK
Apply model...........................................................OK
Stop host5.instance1..................................................OK
Start host5.instance1.................................................OK
Waiting for host5.instance1 database database1 to reload..............OK     
Modify instance host8.instance1.......................................OK
Apply model...........................................................OK
Stop host8.instance1..................................................OK
Start host8.instance1.................................................OK
Waiting for host8.instance1 database database1 to reload..............OK

この例では、TimesTen 22.1.1.22.0リリースへのデータ・インスタンスのオフライン・アップグレードを実行します。 

% ttGridAdmin gridUpgrade -type data -to 22.1.1.22.0 -offline
Checking prerequisites................................................OK
Checking for existing installations of TimesTen 22.1.1.22.0............OK
Verify that upgrade is known to be supported..........................OK
Verify that instances are running the expected releases...............OK
Waiting for host3.instance1 database database1 to reload..............OK
Waiting for host6.instance1 database database1 to reload..............OK
Waiting for host4.instance1 database database1 to reload..............OK
Waiting for host7.instance1 database database1 to reload..............OK
Waiting for host5.instance1 database database1 to reload..............OK
Waiting for host8.instance1 database database1 to reload..............OK

ノート

  • 指定されたリリースのインストールがホストに関連付けられていない場合、-createInstallationsオプションは、そのホストのインストールを作成し、現在のインストールの親ディレクトリ、およびデフォルトのインストール名を新しいインストールのパスとして使用します。たとえば、host1ホストの現在のインストールの場所が/grid/tt22.1.1.21.0の場合、新しいインストールのパスは/grid/installation1になります。インストールが作成されると、ターゲット・リリースのインストール・ファイルは/grid/installation1/tt22.1.1.22.0にあります。installation1がすでにインストール名として使用されている場合、TimesTenはinstallation2などを使用します。

  • -onlineオプションは、現在のリリースでターゲット・リリースへのオンライン・アップグレードがサポートされている場合にのみ使用できます。『Oracle TimesTen In-Memory Database Scaleoutユーザーズ・ガイド』の「データ・インスタンスのアップグレード」を参照してください。

  • kが1に設定されたグリッドまたはロード済データベースがないグリッドでは、-onlineオプションを使用できません。

  • データベースのいずれかがロードされている場合、-offlineオプションはエラーを返します。