db2iupdt - インスタンスの更新コマンド

インスタンスをリリース内のより高いフィックスパック・レベルに更新したり、 Db2® pureScale® インスタンス以外のインスタンスを Db2 pureScale インスタンスに変換したり、 Db2 pureScale インスタンスのトポロジーを変更したりします。

このコマンドを使用して Db2 pureScale インスタンスを更新する場合、メンバーまたはクラスター・キャッシング・ファシリティーに指定する操作によって、インスタンスを実行したままにできるかどうかが決まります。詳しくは、パラメーターの説明を参照してください。そうでない場合、このコマンドを使用して Db2 pureScale インスタンス以外のインスタンスを更新するときは、 db2iupdt コマンドを実行する前に、まずインスタンスとそのインスタンスに対して実行中のすべてのプロセスを停止する必要があります。

注: Db2 pureScale インスタンスでは、構成クォーラムを持たずにリソース・モデルを変更することはできません。つまり、大部分のノードがオンラインになります。 2 つのホストで構成されるセットアップの場合、いずれかがオフラインになっていると db2iupdt コマンドを使用できません。

許可

UNIX および Linux オペレーティング・システムでは、root ユーザー権限と非 root ユーザー権限のいずれでも実行できます。 Windows オペレーティング・システムでは、ローカル管理者権限が必要です。

コマンド構文

For UNIX and Linux® operating systems: Basic-instance-configuration-options
DB2-pureScale-topology-change-options
add-m-options
add-cf-options
update-m-options
update-cf-options
Convert-to-DB2-pureScale-instance-options
DB2-pureScale-fix-pack-update-options
DB2-text-search-configuration-options

For a non-root thin server instance on Linux and AIX operating systems

For Windows operating systems: Db2 Text Search options

コマンド・パラメーター

For root installation on UNIX and Linux operating systems

-h | -?

使用情報を表示します。

-a AuthType

インスタンスの認証タイプ (SERVER、SERVER_ENCRYPT、または CLIENT) を指定します。デフォルトは SERVERです。

-d

デバッグ・モードをオンにします。

-k

アップデート中に現在のインスタンス・タイプを維持します。

-D

あるパスにインストールされた高いコード・レベルから、別のパスにインストールされた低いコード・レベルに、インスタンスを移動します。このパラメーターは推奨されていません。これは、将来のリリースで廃止される可能性があります。このパラメーターは、-f level パラメーターに置き換えられます。

-f level

互換性のために、インスタンスを上位の Db2 バージョン・インスタンス・タイプから下位の Db2 バージョン・インスタンス・タイプに移動します。

-add

Db2 pureScale Feature インスタンスに追加するホスト名とクラスター相互接続ネット名またはホストのネット名を指定します。 db2iupdt -add コマンドは、既に Db2 pureScale インスタンスの一部になっているホストから実行する必要があります。メンバーまたは CFを追加するときに、インスタンスをオンラインのままにすることができます。

-m MemberHostName -mnet MemberNetName -mid MemberID: ホスト名が MemberHostName のホストが、 cluster interconnect netname MemberNetNameを使用して Db2 pureScale Feature インスタンスに追加されます。 MemberHostName に複数のクラスター相互接続ネットワーク・アダプター・ポートがある場合は、 MemberNetName にコンマ区切りリストを指定して、各クラスター相互接続ネット名を区切ることができます。
-mid MemberID パラメーターは、新しく追加されたメンバーのメンバー ID を示します。有効な値の範囲は 0 から 127 です。これが指定されていない場合、値は自動的に生成されます。
-cf CFHostName -cfnet CFNetName: ホスト名 CFHostName のホストが、 cluster interconnect netname CFNetNameを持つクラスター・キャッシング・ファシリティーとして Db2 pureScale Feature インスタンスに追加されます。 CFHostName に複数のクラスター相互接続ネットワーク・アダプター・ポートがある場合は、 CFNetName にコンマ区切りリストを指定して、各クラスター相互接続ネット名を区切ることができます。
-red_grp_id RedundancyGroupID: 地理的に分散した Db2 pureScale クラスター (GDPC) 環境で、メンバー、CF、またはディスクが存在する場所を指定します。このオプションは、ストレージ・レプリケーションがセットアップされた GDPC 環境内のメンバー、CF、またはディスクを追加する場合に必須です。このオプションの有効値は 1 および 2 です。
-tbhost Host_name_for_tiebreaker: IBM® Spectrum Scale 複製ファイル・システムでタイブレーカーとして機能するホストを指定します。このパラメーターは、複製ファイル・システムをセットアップする場合に必須です。
注:
タイブレーカー・ホストは、単一サイトの pureScale クラスター環境でのみ、既存のメンバーまたは CF にすることができます。

-update

このパラメーターは、CF またはメンバーで使用されている相互接続ネット名を更新する場合に使用します。メンバーまたは CF のネット名を更新する場合、インスタンスは実行し続けることができますが、特定のターゲット・メンバーまたは特定のターゲット CF を停止する必要があります。 db2iupdt -update コマンドは、ターゲット CF またはターゲット・メンバーから実行する必要があります。

このオプションは、-m パラメーターおよび -mnet パラメーターとともに、または -cf パラメーターと -cfnet パラメーターとともに使用できます。

-m MemberHostName -mnet MemberNetName: ホスト名が MemberHostName のホストは、 cluster interconnect netname MemberNetNameの Db2 pureScale Feature インスタンスに更新されます。 MemberHostName に複数のクラスター相互接続ネットワーク・アダプター・ポートがある場合は、MemberNetName にコンマ区切りリストを指定して、各クラスター相互接続ネット名を区切ることができます。ネット名を追加する場合は、ネット名のコンマ区切りリストに既存のネット名を含める必要があります。最大 4 つのネット名を使用できます。
-cf CFHostName -cfnet CFNetName: ホスト名 CFHostName のホストは、 cluster interconnect netname CFNetNameを持つクラスター・キャッシング・ファシリティーとして Db2 pureScale Feature インスタンスに更新されます。 CFHostName に複数のクラスター相互接続ネットワーク・アダプター・ポートがある場合は、 CFNetName にコンマ区切りリストを指定して、各クラスター相互接続ネット名を区切ることができます。ネット名を追加する場合は、ネット名のコンマ区切りリストに既存のネット名を含める必要があります。最大 4 つのネット名を使用できます。 CF を更新してクラスター相互接続ネット名を追加する場合は、ネット名を追加した後に、各メンバーを停止して開始する必要があります。
-red_grp_id RedundancyGroupID: 地理的に分散した Db2 pureScale クラスター (GDPC) 環境で、メンバー、CF、またはディスクが存在する場所を指定します。このオプションは、ストレージ・レプリケーションがセットアップされた GDPC 環境内のメンバー、CF、またはディスクを更新する場合に必須です。このオプションの有効値は 1 および 2 です。

-drop -m MemberHostName | -cf CFHostName

Db2 pureScale インスタンスからドロップするホスト (メンバーまたはクラスター・キャッシング・ファシリティー) を指定します。 CF のドロップ中も、インスタンスは実行を続けることができます。ただし、メンバーをドロップする前に、インスタンスを停止する必要があります。

ドロップするホストのタイプを指定するには、メンバーには -m オプションを使用し、クラスター・キャッシング・ファシリティーには -cf オプションを使用します。このオプションは、 -m パラメーターまたは -cf パラメーターのいずれかと一緒に使用できますが、両方と一緒に使用することはできません。

このパラメーターを使用して、最後のメンバーおよび最後の CF を Db2 pureScale インスタンスからドロップすることはできません。このパラメーターは、-add パラメーターと組み合わせて使用しないでください。

-mid MemberID パラメーターは、-m MemberHostName パラメーターとともに使用できます。 -mid MemberID は、ドロップする論理メンバーのメンバー ID を示します。有効な値の範囲は 0 から 127 です。指定しない場合、MemberHostName のすべてのメンバーがドロップされます。

メンバーがドロップされても、そのメンバーの項目は診断ディレクトリー内に保持されます。

-instance_shared_dev instanceSharedDev

インスタンス共有ファイルおよびデフォルトのデータベース・パスを保持するために Db2 pureScale インスタンスをセットアップするのに必要な共有ディスク装置パスを指定します。例えば、装置パス /dev/hdisk1 を指定します。共有ディレクトリーは、 Db2 pureScale インスタンスのすべてのホストでアクセス可能でなければなりません。このパラメーターの値は、-tbdev パラメーターと同じ値であってはなりません。このパラメーターと -instance_shared_dir は、相互に排他的です。

このパラメーターは、 Db2 pureScale インスタンス以外のインスタンスを Db2 pureScale インスタンスに更新する場合にのみ必要です。

-instance_shared_mount sharedMountDir

新規 IBM Spectrum Scale ファイル・システムのマウント・ポイントを指定します。指定するパスは、既存の IBM Spectrum Scale ファイル・システム内にネストされていない新しい空のパスでなければなりません。

-instance_shared_dir instanceSharedDir

インスタンス共有ファイルおよびデフォルト・データベース・パスを保持するように Db2 pureScale インスタンスをセットアップするために必要な共有ファイル・システム (IBM Spectrum Scale) 内のディレクトリーを指定します。例えば、/sharedfs のようになります。ディスクは、 Db2 pureScale インスタンスのすべてのホストでアクセス可能でなければなりません。このパラメーターの値は、-tbdev パラメーターと同じ値であってはなりません。このパラメーターと -instance_shared_dev は、相互に排他的です。

このパラメーターは、 Db2 pureScale インスタンス以外のインスタンスを Db2 pureScale インスタンスに更新する場合にのみ必要です。

-tbdev Shared_device_for_tiebreaker

Db2 pureScale 環境でタイブレーカーとして機能する共有装置パスを指定します。これにより、データの整合性が確実に維持されます。このパラメーターの値は、-instance_shared_dev パラメーターや -instance_shared_dir パラメーターと同じ値であってはなりません。

このパラメーターは、 Db2 クラスター・サービス・タイブレーカーが作成される場合、または Db2 pureScale インスタンス以外のインスタンスを Db2 pureScale インスタンスに更新する場合に必要です。 Db2 クラスター・サービス・ピア・ドメインが存在する場合、このパラメーターは無効です。

-commit_level

pureScale インスタンスを新しいレベルのコードにコミットします。このパラメーターは、 Db2 pureScale 環境では必須です。

-check_commit

Db2 インスタンスがコミットの準備ができているかどうかを検査します。

-j "TEXT_SEARCH"

Db2 Text Search サーバーを、サービス名および TCP/IP ポート番号に対して生成されたデフォルト値で構成します。インスタンス・タイプがクライアントまたは dsf の場合、このパラメーターは使用できません。

-j "TEXT_SEARCH,servicename": 指定されたサービス名と自動生成されたポート番号を使用して、 Db2 Text Search サーバーを構成します。ただし、サービス名に services ファイルで割り当てられたポート番号がある場合は除きます。ファイルでポート番号が割り当てられている場合は、指定したサービス名とそのポート番号が使用されます。
-j "TEXT_SEARCH,servicename,portnumber": 提供されたサービス名とポート番号を使用して Db2 Text Search サーバーを構成します。
-j "TEXT_SEARCH,portnumber": デフォルトのサービス名と指定されたポート番号を使用して Db2 Text Search サーバーを構成します。有効なポート番号は 1024 - 65535 の範囲になければなりません。

-u Fenced ID

fenced ユーザー定義関数および fenced ストアード・プロシージャーを実行するユーザー ID の名前を指定します。このパラメーターが必要になるのは、インスタンスのタイプをクライアント・インスタンスからクライアント以外のインスタンスに変換する場合だけです。現在のインスタンス・タイプを判別するには、GET DBM CFG コマンドからの出力のノード・タイプ・パラメーターを参照してください。インスタンスがすでにクライアント以外のインスタンスである場合や、インスタンスがクライアント・インスタンスであり、なおかつクライアント・インスタンスとして保たれる場合 (例えば、-k パラメーターを使用する場合) は、-u パラメーターは必要ありません。 -u パラメーターによって、既存のインスタンスの fenced ユーザーを変更できます。

-fixtopology

失敗した追加操作またはドロップ操作を手動で修正する場合に使用します。追加操作の場合、このパラメーターはすべての変更をロールバックして、以前のトポロジーに戻します。ドロップ操作の場合、このパラメーターはドロップ操作を完了させます。このパラメーターは、-d を除く他のパラメーターと組み合わせて使用することはできません。

InstName

インスタンスの名前を指定します。

For a non-root thin server instance on Linux and AIX operating systems

-d: Db2 データベース・サポート用にデバッグ・モードをオンにします。
-h | -?: 使用情報を表示します。

For root installation on Windows operating systems

InstName

インスタンスの名前を指定します。

/u:username,password

Db2 サービスのアカウント名およびパスワードを指定します。

/p:instance-profile-path

更新されたインスタンスに対して新規のインスタンス・プロファイル・パスを指定します。

/r:baseport,endport

MPP モードで実行する場合に、パーティション・データベース・インスタンスによって使用される TCP/IP ポートの範囲を指定します。このオプションを指定した場合、ローカル・マシンのサービス・ファイルは、以下の項目で更新されます。

DB2_InstName       baseport/tcp
DB2_InstName_END   endport/tcp

/h:hostname

現行のマシンに対して複数のデフォルトの TCP/IP ホスト名がある場合、それらをオーバーライドします。

/s

インスタンスをパーティション化されたインスタンスにアップデートします。

/q

db2iupdt コマンドを静止モードで発行します。

/a:authType

インスタンスの認証タイプ authType (SERVER、CLIENT、または SERVER_ENCRYPT) を指定します。

/j "TEXT_SEARCH"

Db2 Text Search サーバーを、サービス名および TCP/IP ポート番号に対して生成されたデフォルト値で構成します。インスタンス・タイプがクライアントの場合、このパラメーターは使用できません。

/j "TEXT_SEARCH, servicename": 提供されたサービス名と自動生成されたポート番号を使用して、 Db2 Text Search サーバーを構成します。サービス名に services ファイル内で割り当てられたポート番号がある場合は、それはその割り当てられたポート番号を使用します。
/j "TEXT_SEARCH, servicename, portnumber": 提供されたサービス名とポート番号を使用して Db2 Text Search サーバーを構成します。
/j "TEXT_SEARCH, portnumber": デフォルトのサービス名と指定されたポート番号を使用して Db2 Text Search サーバーを構成します。有効なポート番号は 1024 - 65535 の範囲になければなりません。

/?

db2iupdt コマンドの使用方法を表示します。

例

Reverting an instance to a lower mod pack or fix pack level within a release

Db2 インスタンスを下位レベルに戻すには、次のコマンドを入力します。

<DB2DIR>/instance/db2iupdt -f level <instanceName>

DB2DIR は以前のモディフィケーションパックまたはフィックスパックの場所です。

For UNIX and Linux operating systems

db2inst2 インスタンスは、 DB2DIR1にインストールされている Db2 データベース製品の Db2 コピーに関連付けられています。同じコンピューター上の DB2DIR2 に、 DB2DIR1 ディレクトリーにインストールされている同じバージョンの Db2 データベース製品用の Db2 データベース製品の別のコピーがあります。

DB2DIR1 にインストールされた Db2 コピーから DB2DIR2にインストールされた Db2 コピーに実行するようにインスタンスを更新するには、以下のようにします。次のコマンドを発行します。

DB2DIR2/instance/db2iupdt db2inst2

DB2DIR2 ディレクトリーにインストールされている Db2 コピーのレベルが、 DB2DIR1 ディレクトリーにインストールされている Db2 コピーのレベルより低い場合、次のコマンドを発行します。

DB2DIR2/instance/db2iupdt -D db2inst2

Update an instance to a higher level within a release

Db2 インスタンスを上位レベルに更新するか、またはある Db2 インストール・パスから別のインストール・パスに更新するには、以下のようなコマンドを入力します。

DB2DIR/instance/db2iupdt db2inst1

Db2DIR は、Db2 コピーのインストール場所を表します。このコマンドを Db2 pureScale Feature コピーから実行する場合、既存の db2inst1 のインスタンス・タイプは dsfでなければなりません。

db2inst1 インスタンスが Db2 pureScale インスタンスである場合、この例では、 Db2 pureScale Featureを使用して、あるレベルから別のレベルの Db2 Enterprise Server Edition に更新することができます。この例は、 ese タイプのインスタンスをDb2 pureScale インスタンスに更新する場合には適用されません。次の例は、この手順を略述しています。

Update for an instance other than a Db2 pureScale instance to a Db2 pureScale instance

インスタンスを Db2 pureScale インスタンスに更新するには、以下のようにします。

DB2DIR/instance/db2iupdt 
   -cf host2
   -cfnet host2-ib0
   -m host1
   -mnet host1-ib0
   -instance_shared_dev /dev/hdisk1
   -tbdev /dev/hdisk2
   -u db2fenc1
    db2inst1

Db2DIR は、Db2 コピーのインストール場所を表します。

また、このコマンドは、 /dev/hdisk1 を使用して、インスタンス共有ファイルを保管する共有ファイル・システムを作成し、タイブレーカーとして機能する共有デバイス・パスとして /dev/hdisk2 をセットアップします。 -tbdev パラメーターの値は、-instance_shared_dev パラメーターの値と異なっている必要があります。

Scale a Db2 pureScale instance (by using db2iupdt -add or db2iupdt -drop)

以下の例は、 Db2 pureScale 環境に適用されます。

Db2 pureScale インスタンスを更新して、メンバーを追加します。
ネット名が host1-ib0 の host1 というメンバーを Db2 pureScale インスタンスdb2sdin1 に追加するには、以下のようなコマンドを入力します。
```
DB2DIR/instance/db2iupdt -d -add -m host1 -mnet host1-ib0 db2sdin1 
```
Db2DIR は、Db2 コピーのインストール場所を表します。
Db2 pureScale インスタンスを更新して、2 番目のクラスター・キャッシング・ファシリティーを追加します。
ネット名が host2-ib0 の host2 というクラスター・キャッシング・ファシリティーを Db2 pureScale インスタンス db2sdin1 に追加するには、以下のようなコマンドを入力します。
```
DB2DIR/instance/db2iupdt -d -add -cf host2 -cfnet host2-ib0 db2sdin1 
```
Db2DIR は、Db2 コピーのインストール場所を表します。
Db2 pureScale インスタンスからメンバーをドロップします。
host1 というメンバーを Db2 pureScale インスタンス db2sdin1 からドロップするには、次のようなコマンドを入力します。
```
DB2DIR/instance/db2iupdt -d -drop -m host1 db2sdin1
```
Db2DIR は、Db2 コピーのインストール場所を表します。 host1 が同じインスタンス内で CF 役割を持っていない場合、コマンドは host1以外のホストから実行する必要があります。

注:

CF を追加またはドロップする場合、既存の Db2 pureScale インスタンス上の NTP 構成には、この変更は反映されません。各 pureScale インスタンスの ntp.conf は、新しい CF を反映するために手動で更新する必要があります。
CF (メンバーではない) を追加またはドロップする場合、クラスター内の他のすべてのメンバーおよび CF は、新しい CF (追加または削除) を反映するように NTP 構成ファイルを再構成してから、NTP サービスを再始動する必要があります。

Updating a CF to use an additional cluster interconnect network adapter port on an InfiniBand network

CF を更新する前の db2nodes.cfg の内容は、以下のようになっています。

0   memberhost0    0   memberhost0-ib0
128 cfhost0        0   cfhost0-ib0

注: db2nodes.cfg を直接変更しないでください。

以下のコマンドを実行します。

db2iupdt -update -cf cfhost0:cfhost0-ib0,cfhost0-ib1,cfhost0-ib2,cfhost0-ib3

db2nodes.cfg の内容は以下のようになります。

0   memberhost0    0   memberhost0-ib0
128 cfhost0        0   cfhost0-ib0,cfhost0-ib1,cfhost0-ib2,cfhost0-ib3

使用上の注意

For all supported operating systems

db2iupdt コマンドを使用して、 Db2 インスタンスを、ある Db2 コピーから同じ Db2 バージョンの別の Db2 コピーに更新することができます。ただし、古い Db2 コピー・インストール・パスで定義された Db2 グローバル・プロファイル変数は、新しいインストール場所に更新されません。インスタンスに固有の Db2 インスタンス・プロファイル変数は、インスタンスの更新後に引き継がれます。
パーティション・データベース環境インスタンスの場合は、すべてのノードにフィックスパックをインストールする必要がありますが、インスタンスの更新が必要なのはインスタンス所有ノードに対してのみです。

For UNIX and Linux operating systems

メンバーのドロップなど、メンバー・トポロジーを変更する場合は、データベースにアクセスする前にオフライン・バックアップを取る必要があります。オフライン・バックアップをとる前にデータベースにアクセスしようとすると、データベースはバックアップ・ペンディング状態に入ります。
複数のメンバーを追加したり、複数のメンバーをドロップすることができ、変更ごとに後でバックアップをとらなければならないわけではありません。例えば、3 つのメンバーを追加する場合、バックアップを取る前に 1 つ以上のメンバーをドロップできます。バックアップを取ると、他の追加操作を自由に開始できます。
db2iupdt コマンドは、 DB2DIR/instance ディレクトリーにあります。ここで、 DB2DIR は、 Db2 データベース製品の現行バージョンがインストールされている場所です。
非ルート・インスタンスを更新しない場合は、db2nrupdt 非 root インストール・インスタンス更新コマンドを参照してください。 db2iupdt は、非ルート・インスタンスの更新をサポートしません。
root ユーザーになるために login コマンドではなく su コマンドを使用している場合は、 su コマンドを - オプションを指定して発行して、あたかも login コマンドを使用してシステムにログインしているかのように、プロセス環境を設定することを指示する必要があります。
root ユーザー用の Db2 インスタンス環境を入手しないでください。 Db2 インスタンス環境をソースとする場合の db2iupdt の実行はサポートされていません。
AIX® 7.1 (またはそれ以上) では、システム・ワークロード・パーティション (WPAR) グローバル環境の共有 Db2 コピーからこのコマンドを実行する場合、このコマンドを root ユーザーとして実行する必要があります。 WPAR は、 Db2 pureScale 環境ではサポートされていません。
db2iupdt コマンドを実行してリリース内のより高いレベルにインスタンスを更新すると、ルーチンとライブラリーが各メンバーから共有ロケーションにコピーされます。あるライブラリーが各ホストにあり、その名前は同じでもコンテンツが異なる場合、共有ロケーションに置かれたライブラリー・コンテンツは、db2iupdt コマンドを最後に実行したホストのライブラリー・コンテンツになります。
Db2 pureScale 環境では、メンバー・ホストへのメンバーの追加を可能にするために、 db2iupdt コマンドは /etc/services ファイル内に DB2_instnameという接頭部の 6 つのポートを予約します。同じホスト上に最大 3 つのメンバーを保持して、他の 3 つのポートをアイドル・プロセス用に予約することができます。ベスト・プラクティスとしては、同じホスト上に 3 つのメンバーまで保持することです。ただし、1 つのホスト上に 3 つより多いメンバーが必要な場合、この範囲のポート数を 6 より多い数に拡張することができます。 /etc/services ファイルに対して変更を加える場合は、インスタンスが完全にオフラインでなければなりません。また、くラスター内のすべてのホスト上の /etc/services ファイルを変更する必要があります。
db2iupdt コマンドを実行して Db2 pureScale インスタンスを変更すると、パス <root_home>/db2log が、 Db2 pureScale クラスターの一部であるノードのリモート検証用の一時ワークスペースとして使用されます。このパスの下にあるすべてのファイルは変更されます。

For Windows operating systems

db2iupdt コマンドは、 DB2PATH\bin ディレクトリーにあります。ここで、 DB2PATH は、 Db2 データベース製品の現行バージョンがインストールされている場所です。
インスタンスは、 db2iupdt コマンドを発行した Db2 コピーに更新されます。インスタンス・プロファイルを現在の場所から別の場所に移動するには、/p パラメーターを使用し、インスタンス・プロファイル・パスを指定します。そうしないと、インスタンス更新後もインスタンス・プロファイルは元の場所にそのまま残ってしまいます。代わりに db2iupgrade コマンドを使用して、前のリリースから現行リリースにアップグレードします。