アップグレードに関する一般的な注意事項
この項には、Oracle NoSQL Databaseのすべてのバージョンに一般的に当てはまるアップグレード情報が含まれています。特定のリリースに関するアップグレードの手順および注意事項は、その後の項に記載されています。
Oracle NoSQL Databaseは、最初にインストールすると、KVHOME
ディレクトリに配置されます。このディレクトリは、各マシンに配置することも、複数のストレージ・ノードで共有することもできます(NFSを使用するなど)。ここでは、この既存のKVHOME
の場所を
と呼びます。
OLD_KVHOME
注意:
インストールでは、KVHOME
にリリース番号を含める命名規則を適用することをお薦めします。常に/var/kv/kv-M.N.O
(M.N.O
はrelease.major.minor番号を表す)のようなKVHOME
の場所を使用するようにすると、バージョンが一目でわかるようになります。この命名は、ディストリビューションを共通ディレクトリ(この例では/var/kv
)に展開することで実現できます。
新規ソフトウェアをインストールする場合、各ノードを再起動する必要があります。Oracle NoSQL Databaseはレプリケートされたシステムです。過度のフェイルオーバー・イベントを防ぐために、MASTERとして稼働しているノードを再起動する前に、REPLICAとしてマークされているすべてのノードを再起動することをお薦めします。次のコマンドによって、どのノードがMASTERで、どのノードがREPLICAであるかが示されます。
java -Xmx64m -Xms64m \
-jar KVHOME/lib/kvstore.jar ping -host <hostname> -port <port> \
-security USER/security/admin.security
注意:
この情報のリスト表示は、リモート・アクセスでのセキュリティの構成のステップが実行済であることを前提としています。
ストレージ・ノードが停止している間のノードのアップグレード時にアップグレード・プロセスをデバッグしやすくするには、KVROOT
およびKVROOT/<storename>/log
にある既存のログ・ファイルを他のディレクトリに移動します。
ストア内のアクティブなノードのホストとレジストリ・ポートを使用します。たとえば、次の例ではrg1-rn1
およびrg2-rn1
がMASTERとして動作しているため、これらを最後に再起動します。
java -Xmx64m -Xms64m \
-jar KVHOME/lib/kvstore.jar ping -port 5000 -host node01 \
-security USER/security/admin.security
Pinging components of store mystore based upon topology sequence #315
300 partitions and 6 storage nodes
Time: 2018-09-28 07:06:46 UTC Version: 18.3.2
Shard Status: healthy:2 writable-degraded:0 read-only:0 offline:0
Admin Status: healthy
Zone [name=Boston id=zn1 type=PRIMARY allowArbiters=false masterAffinity=false]
RN Status: online:6 offline:0 maxDelayMillis:1 maxCatchupTimeSecs:0
Storage Node [sn1] on node01:5000
Zone: [name=Boston id=zn1 type=PRIMARY allowArbiters=false masterAffinity=false]
Status: RUNNING
Ver: 18.3.2 2018-09-17 09:33:45 UTC Build id: a72484b8b33c
Admin [admin1] Status: RUNNING,MASTER
Rep Node [rg1-rn1] Status: RUNNING,MASTER
sequenceNumber:327 haPort:5011 available storage size:8 GB
Storage Node [sn2] on node02:6000
Zone: [name=Boston id=zn1 type=PRIMARY allowArbiters=false masterAffinity=false]
Status: RUNNING
Ver: 18.3.2 2018-09-17 09:33:45 UTC Build id: a72484b8b33c
Rep Node [rg1-rn2] Status: RUNNING,REPLICA
sequenceNumber:327 haPort:6010 available storage size:6 GB delayMillis:1 catchupTimeSecs:0
Storage Node [sn3] on node03:7000
Zone: [name=Boston id=zn1 type=PRIMARY allowArbiters=false masterAffinity=false]
Status: RUNNING
Ver: 18.3.2 2018-09-17 09:33:45 UTC Build id: a72484b8b33c
Rep Node [rg1-rn3] Status: RUNNING,REPLICA
sequenceNumber:327 haPort:7010 available storage size:4 GB delayMillis:1 catchupTimeSecs:0
Storage Node [sn4] on node04:8000
Zone: [name=Boston id=zn1 type=PRIMARY allowArbiters=false masterAffinity=false]
Status: RUNNING
Ver: 18.3.2 2018-09-17 09:33:45 UTC Build id: a72484b8b33c
Rep Node [rg2-rn1] Status: RUNNING,MASTER
sequenceNumber:327 haPort:8010 available storage size:6 GB
Storage Node [sn5] on node05:9000
Zone: [name=Boston id=zn1 type=PRIMARY allowArbiters=false masterAffinity=false]
Status: RUNNING
Ver: 18.3.2 2018-09-17 09:33:45 UTC Build id: a72484b8b33c
Rep Node [rg2-rn2] Status: RUNNING,REPLICA
sequenceNumber:327 haPort:9010 available storage size:7 GB delayMillis:1 catchupTimeSecs:0
Storage Node [sn6] on node06:10000
Zone: [name=Boston id=zn1 type=PRIMARY allowArbiters=false masterAffinity=false]
Status: RUNNING
Ver: 18.3.2 2018-09-17 09:33:45 UTC Build id: a72484b8b33c
Rep Node [rg2-rn3] Status: RUNNING,REPLICA
sequenceNumber:327 haPort:10010 available storage size:2 GB delayMillis:1 catchupTimeSecs:0
ストアのアップグレード時に、管理サービスを実行しているストレージ・ノード上の新規KVHOME
ディレクトリに、更新されたソフトウェアを配置します。この項では、新規KVHOME
ディレクトリをNEW_KVHOME
と呼びます。KVHOME
およびNEW_KVHOME
ディレクトリが複数のストレージ・ノードによって共有されている場合(たとえばNFSを使用して)、アップグレードの処理中は両方の場所を保持しておきます。アップグレードが完了したら、元のKVHOME
ディレクトリは必要がなくなります。この場合、NEW_KVHOME
ディレクトリを参照するように各ノードの起動手順を変更し、新しいソフトウェアを使用する必要があります。
注意:
各ノードにソフトウェアのコピーがインストールされている場合、KVHOME
の値を変更せずにインストールを置き換えることができます。
非セキュアなストアからのアップグレード後にセキュリティを追加するには、セキュリティ・ガイドの新規インストールへのセキュリティの追加を参照してください。