14.3.13 createcache(キャッシュの作成)
- 〈この項の構成〉
(1) 機能
キャッシュを作成します。
キャッシュはメモリキャッシュ,ディスクキャッシュ,および2Wayキャッシュの合計で,クラスタ内に最大16個作成できます。
(2) 規則
-
このサブコマンドは,クラスタの状態がクラスタ稼働中(AVAILABLE)のときに実行できます。
-
このサブコマンドは,クラスタへの参加状況がonlineのEADSサーバを処理対象とします。ただし,クラスタへの参加状況がstandbyのEADSサーバがクラスタ内にある場合は実行できません。クラスタへの参加状況については,eztool statusコマンドで確認できます。
-
このサブコマンドは,処理対象のEADSサーバが次の状態のときに実行できます。
-
初期化状態(initialized)
-
閉塞状態(closed)
-
-
稼働中のFullGCの発生を抑えるため,このサブコマンドが終了するタイミングで,各EADSサーバがFullGCを実施します。
-
このサブコマンドがEADSサーバから排他を取得している間,EADSサーバは縮退状態(isolated)になりません。なお,EADSサーバから排他を取得している間にプロセスがダウンしたり,EADSサーバが停止したりした場合は,排他を解除したあとに縮退が実行されます。
(3) 形式
eztool createcache <キャッシュ名>
(4) オプションおよび引数
(a) <キャッシュ名>
新しく作成するキャッシュの名称を指定します。
キャッシュ名に指定できる文字を次に示します。
-
キャッシュ定義ファイルを使用しない場合
半角32文字までの,ASCIIコード「0x20」〜「0x7E」の文字が指定できます。
-
キャッシュ定義ファイルを使用する場合
半角32文字までの,半角英数字(0〜9,A〜Z,およびa〜z)が指定できます。
(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) 注意事項
-
キャッシュ定義ファイルを作成していない場合は,メモリキャッシュが作成されます。
-
キャッシュタイプがメモリキャッシュまたは2Wayキャッシュの場合,次に示す条件に該当するとエラーになります。
-
データ総量監視機能が有効な場合
共通設定のeads.java.external.heapsizeパラメタのvalue部分が格納される領域のサイズを多重度で割った結果が1メガバイト未満のとき
-
データ総量監視機能が無効な場合
共通設定のeads.java.external.heapsizeパラメタのvalue部分が格納される領域のサイズが0のとき
-
-
キャッシュを作成すると,キャッシュ1個につき,(データの多重度×2−1)×2個のスレッドが作成されます。スレッド数が多くなると,メモリ使用量が増加するため,注意してください。
-
キャッシュの作成に失敗した場合,次のどれかの手順で再度キャッシュを作成してください。
-
eztool listcacheコマンドでキャッシュの有無を確認してください。キャッシュが存在しているときは,eztool deletecacheコマンドでキャッシュを削除して,再度キャッシュを作成してください。
-
キャッシュタイプがディスクキャッシュまたは2Wayキャッシュのときは,eztool listecfコマンドでキャッシュファイルの有無を確認してください。キャッシュファイルが存在しているときは,eztool deleteecfコマンドでキャッシュファイルを削除して,再度キャッシュを作成してください。
-
キャッシュ定義ファイルに指定したパラメタの指定値を確認してください。誤っているときは,正しい値に変更して,再度キャッシュを作成してください。
-
共通設定のeads.java.external.heapsizeパラメタの指定値を確認してください。誤っているときは,正しい値に変更して,再度キャッシュを作成してください。
-