stager.cmd ファイルについて

`stager.cmd` ファイルについて

stager.cmd ファイルには、デフォルト動作をオーバーライドするための指示を指定できます。ステージャーを構成して、ファイルをただちに書き込んだり、ファイルをまったく書き込まなかったり、部分的に書き込んだり、ほかの書き込みアクションを指定したりできます。たとえば、非書き込み属性を使用すると、ファイルをオンラインで書き込まずにアーカイブメディアから直接データにアクセスできるため、大きいファイルから小さいレコードにアクセスするアプリケーションに有益です。

このセクションでは、ステージャー指示について説明します。ステージャー指示の詳細は、『Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual』の「stager.cmd(4)」を参照してください。SAM-QFS Manager ソフトウェアを使用している場合は、「ファイルシステム概要」ページまたは「ファイルシステムの詳細」ページから書き込みを制御できます。ファイルシステムをブラウズし、個々のファイルの状態を表示できます。また、フィルタを使用して特定のファイルを表示し、書き込むファイルを選択することができます。書き込み元のコピーを選択することも、システムにコピーを選択させることもできます。

例 15-1 stager.cmd ファイル

次の例は、指定可能な指示をすべて設定したあとの stager.cmd ファイルを示しています。

# This is stager.cmd file /etc/opt/SUNWsamfs/stager.cmd
drives=dog 1
bufsize=od 8 lock
logfile=/var/adm/stage.log
maxactive=500

`stager.cmd` ファイルを作成する方法

次のセクションの情報に従って、/etc/opt/SUNWsamfs/stager.cmd ファイルにサイトの書き込みを制御する指示を追加します。
stager.cmd ファイルを保存して閉じます。
ファイルの変更を伝達し、システムを再起動します。
```
# samd config
```

`drives` 指示: 書き込みに使用するドライブ数の制御

デフォルトでは、ステージャーはファイルの書き込みを行うときに利用可能なすべてのドライブを使用します。ステージャーによってすべてのドライブが使用中の状態のままになると、アーカイバのアクティビティーに支障を来す恐れがあります。drives 指示は、ステージャーが利用できるドライブの数を指定します。この指示の形式は、次のとおりです。

drives = library count

引数	定義
library	`mcf` ファイルに定義されている、ライブラリのファミリセット名。
count	使用する最大ドライブ数。デフォルトでは、このライブラリ用として `mcf` ファイルに構成されているドライブ数。

例 15-2 drives 指示

次の例は、dog ファミリセットのライブラリの 1 つのドライブだけをファイルの書き込みに使用することを指定しています。

drives = dog 1

`bufsize` 指示: 書き込みバッファーサイズの設定

デフォルトでは、書き込み対象ファイルは、アーカイブメディアからディスクキャッシュに復元される前に、メモリーバッファーに読み取られます。bufsize 指示を使用して、バッファーサイズを指定したり、オプションでバッファーをロックしたりできます。これらの操作により、パフォーマンスを向上させることができます。さまざまな buffer-size 値を試すことができます。この指示の形式は、次のとおりです。

bufsize = media buffer-size [lock]

引数	定義
media	`mcf`(4) のマニュアルページに記載されているリストから、アーカイブメディアタイプを選択して指定します。
buffer-size	2 - 8192 の数字。デフォルトは 16 です。この値にメディアタイプの `dev_blksize` 値が乗算され、その結果がバッファーサイズとして使用されます。`dev_blksize` 値は、`defaults.conf` ファイルで指定します。`buffer-size` の値が高ければ高いほど、多くのメモリーが使用されます。詳細は、『Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual』の「defaults.conf(4)」を参照してください。
`lock`	`lock` 引数は、アーカイブのコピーの書き込みのときにステージャーがロックバッファーを使用すべきかどうかを指示します。`lock` が指定されている場合、コピー中は、ステージャーがメモリー内の書き込みバッファーにファイルロックを設定します。これにより、入出力リクエストごとにバッファーをロックまたはロック解除することに伴うオーバーヘッドが回避され、その結果システムの CPU 時間を短縮できます。`lock` 引数は、大容量メモリーを備えた大型システムだけで指定します。十分なメモリーがないと、メモリー不足状態となります。`lock` 引数が有益なのは、書き込み対象のファイルに対して直接入出力が使用可能となっている場合のみです。デフォルトでは、`lock` は指定されておらず、書き込みバッファーを含むあらゆる直接入出力バッファーがロックされています。直接入出力を使用可能にする方法の詳細は、『Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual』の「setfa(1)」、『Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual』の「sam_setfa(3)」、または『Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual』の「mount_samfs(1M)」の `-O forcedirectio` オプションを参照してください。

`logfile` 指示: ログファイルの指定

SAM-QFS ソフトウェアがファイル書き込みイベント情報を収集し、それをログファイルに書き込むようにリクエストできます。デフォルトでは、ログファイルへの書き込みは行われません。logfile 指示は、ステージャーがログ情報を書き込むことができるログファイルを指定します。ステージャーは、書き込みを行なったファイルごとに 1 つまたは複数の行をログファイルに書き込みます。この 1 行には、ファイル名、書き込みを行なった日時、ボリュームシリアル番号 (VSN) などが含まれます。この指示の形式は、次のとおりです。

logfile=filename [event]

引数

定義

filename

フルパス名を指定します。

event

1 つまたは複数の書き込みイベントを指定します。複数のイベントを指定した場合、それぞれのイベントは空白文字で区切ります。指定可能なイベントは次のとおりです。

all - すべての書き込みイベントを記録します。

start - ファイルの書き込みが開始されたときに記録します。

finish - ファイルの書き込みが終了したときに記録します。デフォルトで有効になっています。

cancel - オペレータが書き込みを取り消したときに記録します。デフォルトで有効になっています。

error - 書き込みエラーを記録します。デフォルトで有効になっています。

例 15-3 ステージャーログファイルの指定

次の指示は、/var/adm/stage.log ファイルを作成します。

logfile=/var/adm/stage.log

例 15-4 ステージャーログファイル

S 2003/12/16 14:06:27 dk disk01 e.76d 2557.1759 1743132 /sam1/testdir0/filebu 1 root other root 0 -
F 2003/12/16 14:06:27 dk disk01 e.76d 2557.1759 1743132 /sam1/testdir0/filebu 1 root other root 0 -
S 2003/12/16 14:06:27 dk disk02 4.a68 1218.1387 519464 /sam1/testdir1/fileaq 1 root other root 0 -
S 2003/12/16 14:06:43 dk disk01 13.ba5 3179.41 750880 /sam1/testdir0/filecl 1 root other root 0 -
F 2003/12/16 14:06:43 dk disk01 13.ba5 3179.41 750880 /sam1/testdir0/filecl 1 root other root 0 -
S 2003/12/16 14:06:59 dk disk01 17.167b 1155.1677 1354160 /sam1/testdir0/filedb 1 root other root 0  /
-
F 2003/12/16 14:06:59 dk disk01 17.167b 1155.1677 1354160 /sam1/testdir0/filedb 1 root other root 0  /
-
S 2003/12/16 14:06:59 dk disk02 f.f82 3501.115 1458848 /sam1/testdir1/filecb 1 root other root 0 -
S 2003/12/16 14:07:15 dk disk01 1f.473 1368.1419 636473 /sam1/testdir0/fileed 1 root other root 0 -
S 2003/12/16 14:07:15 dk disk02 16.f15 3362.45 1065457 /sam1/testdir1/filecz 1 root other root 0 -
S 2003/12/16 14:07:31 dk disk01 23.201d 3005.1381 556807 /sam1/testdir0/fileeq 1 root other root 0 -
S 2003/12/16 14:07:47 dk disk01 26.c4d 2831.1113 1428718 /sam1/testdir0/fileez 1 root other root 0 -
S 2003/12/16 14:07:47 dk disk02 1b.835 3736.59 1787855 /sam1/testdir1/filedp 1 root other root 0 -

次の表は、ステージャーログファイルのフィールドの内容を示しています。

フィールド	値の例	内容の説明
1	S	書き込みのアクティビティー - `S` は開始、`C` は取り消し、`E` はエラー、`F` は完了。
2	2003/12/16	書き込み実施日 (yyyymm`/`dd 形式)。
3	14:06:27	書き込み実施時間 (hhmm`:`ss 形式)。
4	dk	アーカイブメディアタイプ。メディアタイプについては、『Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual』の「mcf(4)」を参照してください。
5	disk01	VSN。
6	e.76d	メディア上のアーカイブファイル (`tar` ファイル) の物理的な開始位置とアーカイブファイル内のファイルオフセット (16 進形式を使用)。
7	2557.1759	i ノード番号と生成番号。i ノード番号は再利用されるので、一意性を確保するため、i ノード番号に加えて生成番号が使用されます。
8	1743132	ファイルの長さ。
9	`/sam1/testdir0/filebu`	ファイルの名前。
10	1	アーカイブのコピー番号。
11	root	ファイルのユーザー ID。
12	other	ファイルのグループ ID。
13	root	要求元のグループ ID。
14	0	ファイルの書き込みを行なったドライブの装置番号。
15	`-`	このフィールドが `V` の場合は、ファイルに対してデータ検証が使用されていることを示しています。

`maxactive` 指示: 書き込みリクエスト数の指定

maxactive 指示では、一度にアクティブにできる書き込みリクエストの数を指定できます。この指示の形式は、次のとおりです。

maxactive=number

デフォルトでは、number は 4000 です。指定できる最小数は 1 です。指定できる最大数は 500,000 です。

次の例は、待ち行列に同時に存在できる書き込みリクエストが 500 個までであることを指定しています。

maxactive=500

ナビゲーションリンクをスキップ
印刷ビューの終了
	Sun Storage Archive Manager 5.3 構成および管理ガイド Sun QFS and Sun Storage Archive Manager 5.3 Information Library (日本語)

stager.cmd ファイルを作成する方法

drives 指示: 書き込みに使用するドライブ数の制御

bufsize 指示: 書き込みバッファーサイズの設定

logfile 指示: ログファイルの指定

maxactive 指示: 書き込みリクエスト数の指定