リストア実行時の後処理のスクリプトファイル名は、以下のとおりです。
非クラスタ運用の場合
<環境設定ディレクトリ>¥etc¥backup¥scripts¥OpcRestorePost.js
クラスタ運用の場合
<共有ディスク>:¥etc¥opt¥swstorage¥etc¥backup¥scripts¥OpcRestorePost.js
リストア時の後処理シェルスクリプト
1: // AdvancedCopy Manager for Windows
2: // All Rights Reserved, Copyright FUJITSU LIMITED, 2002-2006
3: //
4: // OpcRestorePost.js: Post-Processing Script for swstrestore
5: //
6: // [Parameters]
7: // 1st argument: device name of transaction volume
8: //
9: // [Return Values]
10: // 0: The script ended normally.
11: // 2: The number of the arguments is incorrect.
12: // (3,5): not used, but must not be used because older versions use these values.
13: // 4: An error other than the above occurred.
14:
15: try {
16: // create global objects
17: var WshShell = WScript.CreateObject("WScript.Shell"); // create Shell object
18: var WshEnv = WshShell.Environment("PROCESS"); // create Environment object
19: var fsObj = WScript.CreateObject("Scripting.FileSystemObject"); // create FileSystemObject object
20:
21: // create SwstRestorePostProc object
22: var proc = new SwstRestorePostProc();
23:
24: // do nothing if postprocessing file exists
25: if (fsObj.FileExists(proc.postFileName) == false) {
26: proc.doNothing();
27: }
28: // get postprocessing type
29: else {
30: var postProcType = proc.getPostProcType();
31: switch(postProcType) {
32: case "none":
33: proc.doNothing();
34: break;
35: }
36: }
37:
38: // clear temporary file
39: proc.deletePostFile();
40: SwstQuit(0);
41: } catch (e) {
42: SwstQuit(6);
43: }
44:
45: function SwstRestorePostProc()
46: {
47: // member variables
48: this.tvName = WScript.Arguments.length!=1?SwstQuit(1):WScript.Arguments.Item(0); // device name of transaction volume
49: this.postFileName = getDataPathName() + "¥¥" + getPutFileName(this.tvName) + ".pre"; // name of postprocessing file
50:
51: // member functions
52: this.getPostProcType = getPostProcType; // self-explanatory
53: this.doNothing = doNothing; // self-explanatory
54: this.deletePostFile = deletePostFile; // self-explanatory
55: }
56:
57: function getPostProcType()
58: {
59: var iomode = 1; // means read-only mode
60: var create = false; // means not to create a file
61: var postFileStream = fsObj.OpenTextFile(this.postFileName, iomode, create);
62: var postProc = postFileStream.ReadAll();
63: postFileStream.Close();
64: return postProc;
65: }
66:
67: function doNothing()
68: {
69: // do nothing
70: }
71:
72: function deletePostFile()
73: {
74: if (fsObj.FileExists(this.postFileName) == true) {
75: fsObj.DeleteFile(this.postFileName);
76: }
77: }
78:
79: function SwstQuit(exitStatus)
80: {
81: switch(exitStatus) {
82: case 0:
83: WScript.Quit(0);
84: case 1:
85: WScript.Echo("[Restore Postprocessing] The number of the arguments is incorrect.");
86: WScript.Quit(2);
87: default:
88: WScript.Echo("[Restore Postprocessing] The script exited abnormally.");
89: WScript.Quit(4);
90: }
91: }
92:
93: function getDataPathName()
94: {
95: return WshShell.RegRead(getSetupInfoKey() + "¥¥etcPathName") + "¥¥etc¥¥backup¥¥data¥¥DEFAULT";
96: }
97:
98: function getBinPathName()
99: {
100: return WshShell.RegRead(getSetupInfoKey() + "¥¥PathName") + "¥¥bin";
101: }
102:
103: function getSetupInfoKey()
104: {
105: var nodeName = WshEnv.Item("SWSTGNODE");
106: if( nodeName != "" ){
107: return "HKEY_LOCAL_MACHINE¥¥SOFTWARE¥¥Fujitsu¥¥AdvancedCopy Manager¥¥CurrentVersion¥¥" + nodeName;
108: }
109: return "HKEY_LOCAL_MACHINE¥¥SOFTWARE¥¥Fujitsu¥¥AdvancedCopy Manager¥¥CurrentVersion";
110: }
111:
112: function getPutFileName(deviceName){
113: var fileName;
114: if( isSafeDISKName(deviceName) ){
115: var re = /(¥S+)¥/(¥S+):(¥S+)/;
116: fileName = deviceName.replace(re, "$1_$2_$3");
117: }else{
118: fileName = deviceName;
119: }
120: return(fileName);
121: }
122:
123: function getGXDXPX(deviceName){
124: var gXdXpX;
125: if( isSafeDISKName(deviceName) ){
126: var re = /(¥S+)¥/(¥S+):(¥S+)/;
127: gXdXpX = deviceName.replace(re, "$3");
128: }else{
129: gXdXpX = deviceName;
130: }
131: return(gXdXpX);
132: }
133:
134: function isSafeDISKName(deviceName){
135: var key = ":g";
136: var s = deviceName.indexOf(key);
137: if ( s < 0 ) {
138: return (false);
139: } else {
140: return (true);
141: }
142: }ポイント
業務ボリュームのロック／ロック解除処理はスクリプトではなく、コマンド内で実施されています。したがって、リストア前処理スクリプト、リストア後処理スクリプトは、業務ボリュームのロック／ロック解除処理の直前、直後にそれぞれ実行されます。
図A.5 リストア
注意
リストア前処理では、他アプリケーションとの一時的なアクセス競合を回避するために、ロック処理に失敗した場合、ロック処理のリトライを実施します。既定のリトライ回数を超えた場合、コマンドは異常終了します。この場合、リストア先ボリュームを使用しているプロセスが存在していますので、アプリケーションやサービスの停止を行う等の対処を実施して、他のプロセスからボリュームが使用されていない状態にしてください。なお、ボリュームロック動作指定ファイルと呼ばれる設定ファイルを作成することにより、規定のリトライ回数の変更を行うことが可能ですが(詳細については、「A.3.2.1 リストア先ボリュームロック動作指定ファイル」を参照してください）、リストア処理実行時に他のプロセスが処理対象ボリュームを使用しないための対策が適切に行われている場合は、通常、これらのファイルを作成する必要はありません。
リストア前処理では、他アプリケーションとの一時的なアクセス競合を回避するために、リストア先ボリュームのロック処理に失敗した場合、ロック処理のリトライを実施します。標準のリトライ動作は以下のとおりです。
ロック処理に失敗した場合は、1秒間待った後、再度、ロック処理を実施します。
ロック処理のリトライを20回(初回と合わせて計21回)実施しても、ロックが取得できない場合は、処理を中断してコマンドを異常終了させます。
リトライ上限(デフォルト値=20回)とリトライ間隔(デフォルト値=1秒)は、リストア先ボリュームロック動作指定ファイルと呼ばれる設定ファイルを作成することにより変更できます。また、この設定ファイルでは、リストア先ボリュームのリストア前処理に対して、以下の動作を指示することもできます。
ロック処理のリトライを行う前に、そのボリューム内の全てのファイルハンドルを無効にすることを指定する(強制ロック機能）。
注意
リストア先ボリュームロック動作指定ファイルは、12.2.3.2 資源バックアップコマンド(swstresback)ではバックアップされません。リストア先ボリュームロック動作指定ファイルを使用する運用の場合は、copyコマンド等を使用してバックアップしておく必要があります。
リストア先ボリュームロック動作指定ファイルは以下のファイル名で作成してください。
ファイル名 | [クラスタ運用でない場合] |
リストア先ボリュームロック動作指定ファイルの設定例を以下に示します。
[g1d1p1] LockForceMode=on LockRetryNumber=10 LockRetryInterval=10 [ANY] LockForceMode=off LockRetryNumber=20 LockRetryInterval=100
リストア先ボリュームロック動作指定ファイルの作成方法は以下のとおりです。
ロック動作を変更するボリュームのセクションを作成し、パラメーターを記述します(上記の例ではg1d1p1のセクションが作成されています）。変更可能なパラメーターは下表に示された3つのパラメーターですが、3つ全てを記述する必要はなく、変更したいパラメーターのみを記述してください。記述しなかったパラメーターについては、デフォルト値が使用されます。
また、デフォルトのロック動作を変更するためには「ANY」というセクションを作成し、パラメーターを記述します。これにより、リストア先ボリュームロック動作指定ファイルに明示的に記述されているボリューム以外の全てのボリュームのロック動作を変更することができます(上記の例ではg1d1p1以外の全てのボリュームのロック動作は「ANY」セクションの値にしたがって動作します)。
RDSTLOCK.INIの設定項目
キー | 説明 |
|---|---|
LockForceMode | リストア先ボリュームのロックに失敗した場合、ロック処理のリトライを実施しますが、リトライを実施する前にボリュームのマウントを解除することを指定します。 off(デフォルト値)=ロックのリトライ前にマウント解除を実施しない on=ロックのリトライ前にマウント解除を実施する ボリュームのマウントが解除されると、そのボリュームに対して開いているハンドルは、全て無効となります。 ※マウント解除後にすぐにボリュームが使用中になってしまう場合には、ロックが取得できないことがあります。 |
LockRetryNumber | リストア先ボリュームのロックに失敗した場合、ロック処理のリトライを実施しますが、本パラメーターでリトライ回数を指定します。指定可能な数値は、1から10000までです。 デフォルトの設定値は20(回)です。 指定されたリトライ回数、リトライを実施してもリストア先ボリュームのロックができない場合は、処理を中断してコマンドを異常終了させます。 |
LockRetryInterval | リストア先ボリュームのロックに失敗した場合、ロック処理のリトライを実施しますが、本オプションでリトライの間隔(ミリ秒単位)を指定します。指定可能な数値は、1から600000(10分)までです。デフォルトの設定値は1000(1秒)です。 |