14.3.26 resume(キャッシュの再開)
この項の内容は,ディスクキャッシュ,および2Wayキャッシュを使用する場合にお読みください。
- 〈この項の構成〉
(1) 機能
ディスクキャッシュ,および2Wayキャッシュを再開します。
このコマンドを実行すると,キャッシュ定義ファイルとキャッシュ情報ファイルが存在するキャッシュが再開されます。
次の場合は,このサブコマンドを使用して,キャッシュを再開します。
-
正常にクラスタを停止したあとで,EADSサーバを再起動する場合
-
クラスタ動作不能(NOT_AVAILABLE)またはクラスタ一部稼働中(PARTIALLY_AVAILABLE)の状態から,クラスタを復旧する場合
(2) 規則
-
このサブコマンドは,クラスタが次の状態のときに実行できます。
-
クラスタ稼働中(AVAILABLE)
-
-
このサブコマンドは,クラスタへの参加状況がonlineのEADSサーバを処理対象とします。ただし,クラスタへの参加状況がofflineおよびstandbyのEADSサーバがクラスタ内にある場合は実行できません。クラスタへの参加状況については,eztool statusコマンドで確認できます。
-
このサブコマンドは,処理対象のEADSサーバが次の状態のときに実行できます。
-
初期化状態(initialized)
-
-
稼働中のFullGCの発生を抑えるため,このサブコマンドが終了するタイミングで,各EADSサーバがFullGCを実施します。
-
このサブコマンドがEADSサーバから排他を取得している間,EADSサーバは縮退状態(isolated)になりません。なお,EADSサーバから排他を取得している間にプロセスがダウンしたり,EADSサーバが停止したりした場合は,排他を解除したあとに縮退が実行されます。
(3) 形式
eztool resume
(4) リターンコード
次の表に示すリターンコードが返却されます。
項番 |
リターンコード |
リターンコードの説明 |
|
---|---|---|---|
コマンド定義のeads.command.compatパラメタを指定していない場合 |
コマンド定義のeads.command.compatパラメタに0300を指定した場合 |
||
1 |
0 |
0 |
コマンドの実行に成功しました。 |
2 |
101 |
101 |
コマンドの初期化に失敗しました。 |
3 |
110 |
接続に失敗しました。 |
|
4 |
111 |
通信タイムアウトで失敗しました。 |
|
5 |
120 |
構文不正で失敗しました。 |
|
6 |
130 |
コマンドを実行できない状態のため失敗しました。 |
|
7 |
131 |
ほかのコマンドが実行中のため失敗しました。 |
|
8 |
150 |
コマンド実行中に失敗しました。 |
|
9 |
200 |
コマンドタイムアウトで失敗しました。 |
(5) 注意事項
-
キャッシュの再開の対象とならないキャッシュのキャッシュ定義の定義内容も,クラスタを構成する全EADSサーバで同じになるようにしてください(eads.cache.disk.info.dirパラメタおよびeads.cache.disk.<n>.dirパラメタは除きます)。
-
正常にクラスタを停止していない場合,削除したデータが復活することがあります。
-
キャッシュの再開が異常終了やコマンドタイムアウトによって中途半端に終了した場合,排他は解除されません。キャッシュの再開を実行後,排他が解除されていない場合は,データが不整合になっているおそれがあります。そのまま運用を継続するとデータが破壊されたり,消失したりするおそれがあるため,次の手順で対処してください。
-
eztool status -vコマンドでクラスタの状態を確認する。
-
eztool unlockコマンドで排他を解除する。
-
eztool listcacheコマンドでキャッシュの一覧を確認する。
-
キャッシュの再開が失敗したキャッシュをeztool deletecacheコマンドで削除する。
-
EADSサーバが縮退しているときは,EADSサーバを復旧する。
-
キャッシュの再開を,再度実行する。
-
-
キャッシュの再開に失敗した場合は,次の項目を確認して,再度キャッシュを再開してください。
-
クラスタ定義ファイルまたは共通設定ファイルに指定したパラメタの指定値が誤っていないかどうか
-
キャッシュ定義ファイルに指定したパラメタの指定値が誤っていないかどうか
-
キャッシュファイルが不正な状態になっていないかどうか
-
-
このサブコマンドの実行中,データ総量監視機能は動作しません。