14.3.29 deleteecf(キャッシュファイルの削除)
この項の内容は,ディスクキャッシュ,および2Wayキャッシュを使用する場合にお読みください。
- 〈この項の構成〉
(1) 機能
指定したキャッシュ名のキャッシュファイルを削除します。
このサブコマンドを実行すると,各EADSサーバにあるキャッシュ定義ファイルに指定したパラメタに従って,次のキャッシュファイルが削除されます。
-
<キャッシュ定義のeads.cache.disk.info.dirパラメタに指定したディレクトリ>/<キャッシュ名>/eads_info_[EADSサーバID※]_[キャッシュ名].ecf
注※ 01〜96の整数です。
-
<キャッシュ定義のeads.cache.disk.info.dirパラメタに指定したディレクトリ>/<キャッシュ名>/eads_index_[EADSサーバID※1]_[キャッシュ名]_[レンジID※1]_[nnnnn※2].ecf
注※1 01〜96の整数です。
注※2 ファイル数の連番(5桁の整数)です。
-
<キャッシュ定義のeads.cache.disk.<n>.dirパラメタに指定したディレクトリ>/<キャッシュ名>/eads_data_[EADSサーバID※1]_[キャッシュ名]_[レンジID※1]_[nnnnn※2].ecf
注※1 01〜96の整数です。
注※2 ファイル数の連番(5桁の整数)です。
キャッシュファイルの削除後,次のディレクトリ内が空になっていれば,ディレクトリも削除します。
-
<キャッシュ定義のeads.cache.disk.info.dirパラメタに指定したディレクトリ>/<キャッシュ名>
-
<キャッシュ定義のeads.cache.disk.<n>.dirパラメタに指定したディレクトリ>/<キャッシュ名>
- 注
-
ディスクキャッシュの格納先として不揮発性メモリを使用している場合(eads.cache.disk.persistentMemory.enableパラメタにtrueを指定している場合),キャッシュファイルの削除ではなく,eads.cache.disk.persistentMemory.deviceパラメタで指定した不揮発性メモリのデバイスファイルの領域を初期化します。
(2) 規則
-
このサブコマンドは,クラスタが次の状態のときに実行できます。
-
クラスタ稼働中(AVAILABLE)
-
クラスタ一部稼働中(PARTIALLY_AVAILABLE)
-
-
このサブコマンドは,クラスタへの参加状況がonlineのEADSサーバを処理対象とします。ただし,クラスタへの参加状況がstandbyのEADSサーバがクラスタ内にある場合は実行できません。クラスタへの参加状況については,eztool statusコマンドで確認できます。
-
このサブコマンドは,処理対象のEADSサーバが次の状態のときに実行できます。
-
初期化状態(initialized)
-
稼働状態(running)
-
閉塞状態(closed)
なお,-lオプションまたは--localオプションを指定した場合は,EADSサーバが停止状態のときにだけ実行できます。
-
(3) 形式
eztool deleteecf <キャッシュ名> [-l]
(4) オプションおよび引数
(a) <キャッシュ名>
削除したいキャッシュファイルのキャッシュ名を指定します。
キャッシュ名には,半角32文字までの半角英数字(0〜9,A〜Z,およびa〜z)が指定できます。
(b) -lまたは--local
コマンドを実行するEADSサーバのキャッシュファイルだけを削除したい場合に指定します。
例えば,データの更新頻度や削除頻度が高いシステムで縮退状態が発生した場合,復旧に不要なキャッシュファイルをあらかじめ削除して,データの読み込み時間を削減したいときに指定します。
このオプションを指定した場合,処理対象のEADSサーバが停止状態のときにだけ,キャッシュファイルが削除されます。処理対象のEADSサーバが起動中のときは削除されません。
(5) リターンコード
次の表に示すリターンコードが返却されます。
項番 |
リターンコード |
リターンコードの説明 |
|
---|---|---|---|
コマンド定義の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 |
コマンドタイムアウトで失敗しました。 |
(6) 注意事項
-
EADSサーバが使用中のキャッシュのキャッシュファイルは削除できません。また,指定したキャッシュ名のキャッシュ定義ファイルが存在しない場合は,キャッシュファイルを削除できません。
-
キャッシュファイルの削除に失敗した場合,コマンドの排他が解除されていないことがあります。次の手順でコマンドの排他を解除してから,キャッシュファイルを削除してください。
-
eztool status -vコマンドでクラスタの状態を確認する。
-
eztool unlockコマンドで排他を解除する。
-