この項には、Oracle NoSQL Databaseのすべてのバージョンに一般的に当てはまるアップグレード情報が含まれています。特定のリリースに関するアップグレードの手順および注意事項は、その後の項に記載されています。

Oracle NoSQL Databaseが初めてインストールされる際、コンピュータごと、または必要に応じて複数のストレージ・ノードによって(NFSを使用するなどして)共有されるKVHOMEディレクトリに配置されます。ここでは、この既存のKVHOMEの場所をOLD_KVHOMEと呼びます。

新規ソフトウェアをインストールする場合、各ノードを再起動する必要があります。Oracle NoSQL Databaseはレプリケートされたシステムであるため、過度なフェイルオーバー・イベントを防ぐには、マスターとして稼働しているノードは、レプリカとマークされているすべてのノードの後に再起動することをお薦めします。次のコマンドによって、マスター・ノードとレプリカ・ノードを区別できます。

java -Xmx256m -Xms256m \
-jar KVHOME/lib/kvstore.jar ping -host <hostname> -port <port>

プロセスをデバッグしやすくするために、ノードをアップグレード中にストレージ・ノードが停止しているときに、KVROOTおよびKVROOT/<storename>/logにある既存のログ・ファイルを他のディレクトリに移動しておく必要があります。

ストア内のアクティブなノードのホストとレジストリ・ポートを使用します。たとえば、次の例では、rg1-rn1およびrg2-rn1はMASTERとして実行され、最後に再起動する必要があります(表示領域に収まるように、ping出力の一部のみを表示しています)。

java -Xmx256m -Xms256m \
-jar KVHOME/lib/kvstore.jar ping -port 5000 -host node01
Pinging components of store mystore based upon topology sequence #315
300 partitions and 6 storage nodes
Time: 2015-03-04 08:37:22 UTC   Ver: 12.1.3.2.15
Storage Node [sn1] on node01:5000  Zone: [name=Boston id=zn1 type=PRIMARY]
    Status: RUNNING   Ver: 12cR1.3.2.15 2015-03-04 06:35:02 UTC ...
        Admin [admin1]          Status: RUNNING,MASTER
        Rep Node [rg1-rn1]      Status: RUNNING,MASTER ...
Storage Node [sn2] on node02:5000  Zone: [name=Boston id=zn1 type=PRIMARY]
    Status: RUNNING   Ver: 12cR1.3.2.15 2015-03-04 06:35:02 UTC ...
        Rep Node [rg1-rn2]      Status: RUNNING,REPLICA ...
Storage Node [sn3] on node03:5000  Zone: [name=Boston id=zn1 type=PRIMARY]
    Status: RUNNING   Ver: 12cR1.3.2.15 2015-03-04 06:35:02 UTC  ...
        Rep Node [rg1-rn3]      Status: RUNNING,REPLICA ...
Storage Node [sn4] on node04:5000  Zone: [name=Boston id=zn1 type=PRIMARY]
    Status: RUNNING   Ver: 12cR1.3.2.15 2015-03-04 06:35:02 UTC  ...
        Rep Node [rg2-rn1]      Status: RUNNING,MASTER ...
Storage Node [sn5] on node05:5000  Zone: [name=Boston id=zn1 type=PRIMARY]
    Status: RUNNING   Ver: 12cR1.3.2.15 2015-03-04 06:35:02 UTC ...
        Rep Node [rg2-rn2]      Status: RUNNING,REPLICA ...
Storage Node [sn6] on node06:5000  Zone: [name=Boston id=zn1 type=PRIMARY]
    Status: RUNNING   Ver: 12cR1.3.2.15 2015-03-04 06:35:02 UTC ...
        Rep Node [rg2-rn3]      Status: RUNNING,REPLICA ...

ストアのアップグレード時に、管理サービスを実行しているストレージ・ノード上の新規KVHOMEディレクトリに、更新されたソフトウェアを配置します。ここでは、新規KVHOMEディレクトリはNEW_KVHOMEとします。KVHOMEおよびNEW_KVHOMEディレクトリが複数のストレージ・ノードによって共有されている場合、(たとえばNFSを使用して)、アップグレードの進行中も両方の場所を維持しておく必要があります。アップグレードが完了すれば、元のKVHOMEディレクトリは必要なくなります。この場合、NEW_KVHOMEの値を参照して新しいソフトウェアが使用されるように、各ノードでの起動手順を変更する必要があります。