目的
fs プロセスのファイル・サーバー・コンポーネントを初期化します。
構文
fileserver [-d <debug level>] [-p <number of processes>] [-spare <number of spare blocks>] [-pctspare <percentage spare>] [-b <buffers>] [-l <large vnodes>] [-s <small nodes>] [-vc <volume cachesize>] [-w <call back wait interval>] [-cb <number of call backs>] [-banner (print banner every 10 minutes)] [-novbc (whole volume cbs disabled)] [-implicit <admin mode bits: rlidwka>] [-hr <number of hours between refreshing the host cps>] [-busyat <redirect clients when queue > n>] [-rxpck <number of rx extra packets>] [-rxdbg (enable rx debugging)] [-rxdbge (enable rxevent debugging)] [-m <min percentage spare in partition>] [-lock (keep fileserver from swapping)] [-L (large server conf)] [-S (small server conf)] [-k <stack size>] [-realm <Kerberos realm name>] [-udpsize <size of socket buffer in bytes>] [-enable_peer_stats] [-enable_process_stats] [-help]
このコマンドは、AFS コマンド・セットの構文規則に準拠していません。コマンド名およびすべてのオプション名は省略せずにすべて指定してください。
構文
fileserver コマンドは、fs プロセスのファイル・サーバー・コンポーネントを初期化します。通常の構成では、バイナリー・ファイルはファイル・サーバー・マシンの /usr/afs/bin ディレクトリーにあります。
fileserver コマンドは、通常はコマンド・シェル・プロンプトでは発行せず、データベース・サーバー・マシンの /usr/afs/local/BosConfig ファイルに bos create コマンドと一緒に記述します。このコマンドをコマンド・シェル・プロンプトで発行する場合には、発行者はローカルのスーパーユーザー root としてログオンしなければなりません。
ファイルが存在していない場合は、ファイル・サーバーは初期化時に /usr/afs/logs/FileLog ログ・ファイルを作成します。このファイルにはデフォルトでは詳細なトレースは書き込まれませんが、-d オプションを指定するとより詳細なトレースを書き込むことができます。 bos getlog コマンドを使用して、ログ・ファイルの内容を表示します。
このコマンドに引き数を指定すると、ファイル・サーバーのパフォーマンスの多くの性質を制御することができます。詳細は「オプション」セクションを参照してください。デフォルトでは、fileserver コマンドは、中規模のファイル・サーバー・マシンに適した値を引き数に設定します。小規模あるいは大規模のファイル・サーバー・マシンに適した値を設定する場合には、それぞれ -S また -L フラグを使用してください。以下のリストは、fileserver コマンドがデフォルトの値を設定するパラメーターとそれに対応する引き数を説明したもので、表 1 は 3 つのマシン・サイズのそれぞれの設定を要約したものです。
パラメーター (引き数) | 小規模構成 (-S) | 中規模構成 (デフォルト) | 大規模構成 (-L) |
LWP 数 (-p) | 6 | 9 | 12 |
キャッシュ・ディレクトリー・ブロック数 (-b) | 70 | 90 | 120 |
キャッシュされるラージ vnodes 数 (-l) | 200 | 400 | 600 |
キャッシュされるスモール vnodes 数 (-s) | 200 | 400 | 600 |
ボリュームの最大キャッシュ・サイズ (-vc) | 200 | 400 | 600 |
コールバック数 (-cb) | 20,000 | 60,000 | 64,000 |
Rx パケット数 (-rxpck) | 100 | 150 | 200 |
これらの値を上書きするには、上に示した引き数を指定します (引き数には -S または -L フラグを組み合わせることができます)。
ファイル・サーバーに必要なメモリー量は、場合によって異なります。デフォルトのおおよそのメモリー使用量は、-S フラグを使用している場合 (小規模構成) は 751 KB、すべてデフォルト設定としている場合 (中規模構成) は 1.1 MB、-L フラグを使用している場合 (大規模構成) は 1.4 MB です。メモリーを追加できる場合には、-cb と -vc 引き数の値を大きくすれば、ファイル・サーバーのパフォーマンスを直接向上することができます。
デフォルトでは、アプリケーションがいっぱいになったボリュームの既存ファイルにデータを書き込む場合、ファイル・サーバーはボリュームの割り当て量を 1MB 大きくすることができます。ただし、ファイル・サーバーは、ユーザーに対して、いっぱいになっているボリュームに新規のファイルを作成することは許可しません。デフォルトを変更するには、以下の引き数の 1 つを使用してください。
デフォルトでは、ファイル・サーバーはファイル・サーバー・マシンに格納されているボリュームの各ディレクトリーのアクセス制御リスト (ACL) の system:administratorsに、a (管理) および l (検索) アクセス権を暗黙的に許可します。すなわち、グループのメンバーは、グループの項目が ACL に表示されなくても、これらの 2 つのアクセス権を行使することができます。デフォルトのアクセス権セットを変更するには、-implicit 引き数を使用します。
ファイル・サーバーは、データ・アクセス要求の発行元のクライアント・マシンごとに、現在のホスト保護サブグループ (host CPS) を保守しています。ユーザーの CPS のように、ホスト CPS は、マシンが付属する保護データベース・グループのすべてをリストし、ファイル・サーバーはホスト CPS をディレクトリーの ACL と比較して、マシン上のユーザーがディレクトリーの内容にアクセスすることを許可する方法を決定します。 pts adduser または pts removeuser コマンドを使用してマシンが属するグループを変更する場合、ファイル・サーバーはその変更を通知するためにマシンのホスト CPS を再計算しなければなりません。デフォルトでは、ファイル・サーバーは 2 時間ごとに保護サーバーに接続してホストの CPS を再計算します。つまり、グループのメンバーシップの変更が有効になるまでには時間がかかるということです。この頻度を変更するには、-hr 引き数を使用します。
注: | AIX オペレーティング・システムは、自動的に各区画の一部を予約し、区画のスペースが完全になくなった場合に発生する可能性のある負の結果を防止することはありません。そこで、AIX バージョンのファイル・サーバーは、8% のディスク予約スペースを自動的に作成します。このパーセンテージを変更するには、-m 引き数を使用します。 |
区画にスペースがほとんどなくなってくると、ファイル・サーバーは次のようなメッセージを生成します。
No space left on device
注意
-k と -w 引き数は使用しないでください。これらは、AFS 開発グループのみが使用するようになっています。これらの引き数をデフォルト値から変更すると、ファイル・サーバーの動作は予測できません。どんな場合でも、多くのオペレーティング・システムでは、ファイル・サーバーは、LWP スレッドではなく、固有のスレッドを使用します。したがって、-k 引き数を使用して LWP スレッドの数を設定しても、なんの効果もありません。
-spare 引き数および -pctspare 引き数の両方を指定しないでください。両方とも指定するとファイル・サーバーが終了し、/usr/afs/logs/FileLog ファイルにエラー・メ ッセージが書き込まれます。
-m オプションおよび -lock オプションなど、一部のシステム・タイプにしか使用できないオプションは、関係のあるシステム・タイプでのみ -help オプションが生成する出力に表示されます。
オプション
スレッドの最大の数は、AFS のリリースごとに異なります。現行のリリースについては、AFS リリース情報 を参照してください。
File Server is running at time.
注: | ファイル・サーバーは、none を使用している場合でも、常に 1 つ のアクセス権を system:administrators グループに暗黙で許可しています。 |
注: | この引き数は、AIX オペレーティング・システムが稼働しているマシンでのみ使用できます。したがって、他のシステム・タイプで -help フラグが使用されている場合は、構文ステートメントには表示されません。 |
注: | この引き数は、IRIX オペレーティング・システムが稼働しているマシンでのみ使用できます。したがって、他のシステム・タイプで -help フラグが使用されている場合は、構文ステートメントには表示されません。 |
例
以下の bos create コマンドは、大規模な構成サイズを使用して、割り当て量の 10% を超えるボリュームを許可するファイル・サーバー・マシン fs2.abc.com で fs プロセスを作成します。1 行にコマンドをタイプします。
% bos create -server fs2.abc.com -instance fs -type fs \ -cmd "/usr/afs/bin/fileserver -pctspare 10 \ -L" /usr/afs/bin/volserver /usr/afs/bin/salvager
必要となる特権
シェル・プロンプトでコマンドを発行するためには、発行者はファイルのサーバー・マシン上でローカル・スーパーユーザー root としてログインする必要があります。通常は、bos create コマンドを発行して、プロセスの作成および開始を行います。
関連情報