# 管理の手引き

# サーバー・プロセスの監視および制御

システム管理者として最も重要な役割の 1 つは、ファイル・サーバー・マシンのプロセスが正しく稼働していることを確認することです。各ファイル・サーバー・マシン上で稼働する BOS サーバーは、そのマシン上の他の AFS サーバー・プロセスを絶えず監視することによって、ユーザーを多くの責任から解放します。BOS サーバーは失敗したプロセスを自動的に再始動することができ、相互依存性を考慮に入れた再始動が行なわれるよう指示します。

異なるファイル・サーバー・マシンは異なるプロセスの組み合わせを実行するため、各ファイル・サーバー・マシン上の BOS サーバーが監視するプロセスを定義する必要があります (その方法については、プロセス状況の制御および検査 を参照してください)。

サーバー・プロセス状況を直接制御して、ルーチン・メインテナンスを実行するか、BOS サーバーが訂正できない問題を訂正する必要があるかもしれません (たとえばデータベースの複写または相互認証に関する問題)。その場合、bos コマンドの発行によって、 BOS サーバーを介してプロセス状況を制御します。

## 命令の要約

この章では、指示されたコマンドを使用して次のタスクの実行する方法を説明します。

プロセス状況を検査する | bos status
BosConfig file ファイルの情報を検査する | bos status (-long フラグ付き)
プロセス・インスタンスを作成する | bos create
プロセスを停止する | bos stop
停止したプロセスを開始する | bos start
プロセスを一時的に停止する | bos shutdown
一時的に停止したプロセスを開始する | bos startup
プロセスを停止し、即時に再始動する | bos restart
すべてのプロセスを停止し、即時に再始動する | bos restart (-bosserver フラグ付き)
BOS サーバーの再始動時を検査する | bos getrestart
BOS サーバーの再始動時を設定する | bos setrestart
ログ・ファイルを検査する | bos getlog
コマンドをリモートで実行する | bos exec

## AFS サーバー・プロセスの要旨

このセクションでは、ファイル・サーバー・マシン上で実行することができるさまざまなサーバー・プロセスについて簡単に説明します。複数のファイル・サーバー・マシンがあるセルでは、すべてのプロセスがすべてのマシン上で稼働するわけではありません。

AFS サーバー・プロセスは、コンテキストによっては、3 つのうちのいずれかの方法で参照します。

- bos status コマンドの出力は、bos create コマンドが /usr/afs/local/BosConfig ファイルでそのエントリーを作成するときに割り当てた名前でプロセスを参照します。名前はマシンによって違うこともありますが、すべてのマシンに同じ名前を割り当てるとセルの管理が容易になります。AFS インストールの手引き および bos create コマンドの参照ページには、一般的な名前がリストされています。プロセス名の例として、bosserver、kaserver、および vlserver があります。
- 標準 ps コマンドによって作成されるプロセス・リストは、通常、プロセスのバイナリー・ファイルに一致します。プロセス・バイナリー・ファイルの例として、 /usr/afs/bin/bosserver、/usr/afs/bin/kaserver、および /usr/afs/bin/vlserver があります。
- このドキュメンテーションのほとんどのリファレンスを含むほとんどの文脈で、プロセスは (たとえば) Basic OverSeer (BOS) Server、Authentication Server または Volume Location Server といいます。

次の機能グループは、各プロセスに対する名前、およびプロセスを使用する管理タスクの一部を指定します。サーバーについてのより一般的な説明については、AFS サーバー・プロセスとキャッシュ・マネージャー を参照してください。

### bosserver プロセス: Basic OverSeer サーバー

各 AFS サーバー・マシン上で稼働する bosserver プロセスは、そのマシン上で稼働する他の AFS サーバー・プロセスを監視する役割がある Basic OverSeer (BOS) サーバーです。プロセスに障害が発生すると、BOS サーバーは、それを人間のオペレーターの介入なしに自動的に再始動することができます。複数のコンポーネント・プロセスを持つプロセスを再始動する場合、相互依存を考慮する必要があります (たとえば、プロセスのコレクション: ファイル・サーバー、ボリューム・サーバーおよびサルベージャー で説明されている fs プロセス)。

BOS サーバーは、それ自体を監視および再始動できないため、bos status コマンドの出力には表示されません。`/usr/afs/bin/bosserver`として ps コマンドの出力で表示されます。

システム管理者として、次のタスクを実行するために bos コマンドを発行するときに BOS サーバーと連絡します。

- プロセス状況の制御および検査 で説明してあるように、/usr/afs/local/BosConfig ファイルで項目を作成して BOS サーバーが監視するプロセスの定義。
- この章の後に示す指示に従って、ファイル・サーバー・マシン上のプロセスの停止および開始。
- サーバー CellServDB ファイルの保守で説明してあるように、 /usr/afs/etc/CellServDB ファイルでのセルのデータベース・サーバー・マシンの定義。
- サーバー暗号化鍵の管理に説明してあるように、/usr/afs/etc/KeyFile ファイルでの AFS 暗号化鍵の定義
- UserList ファイルの管理に説明してあるように、ユーザーを /usr/afs/etc/UserList ファイルに追加することによって、BOS サーバー、ボリューム・サーバー、およびバックアップ・サーバーのオペレーションに関してシステム管理者特権の付与
- 認証と許可の要件の管理に説明してあるように、サーバー・マシン上認証チェック要件の設定

### buserver プロセス: バックアップ・サーバー

データベース・サーバー・マシン上で稼働する buserver プロセスは、バックアップ・サーバーです。このプロセスは、バックアップ・システム構成およびバックアップ・データベースのオペレーションについての情報を管理します。

プロセスは、一般的な名前が割り当てられている場合、bos status コマンドの出力で `buserver` のように表示されます。`/usr/afs/bin/buserver` として ps コマンドの出力で表示されます。

システム管理者として、バックアップ・システム構成情報を変更するもの、ボリュームから永久記憶域にデータをダンプするもの、またはデータを AFS に回復するものなどを含む、バックアップ・データベースの情報を操作する backup コマンドを発行するときにバックアップ・サーバーに接触します。 AFS バックアップ・システムの構成 および AFS データのバックアップと復元を参照してください。

### プロセスのコレクション: ファイル・サーバー、ボリューム・サーバーおよびサルベージャー

各ファイル・サーバー・マシン上で稼働する fs プロセスは、 3 つのコンポーネント・プロセス、すなわちファイル・サーバー、ボリューム・サーバー、およびサルベージャーを結合します。 3 つのコンポーネントは、独立した機能を実行しますが、次の理由から単一プロセスとして制御されます。

- これらはすべて同じデータで、すなわち AFS ボリュームに格納されているファイルおよびディレクトリーで動作します。これらを単一プロセスとして結合すると、そのアクションを調整することができますが、同じデータで同時にオペレーションを行わないでください。データが破壊されることもあります。
- BOS サーバーは、要求された順序でプロセスを停止、再始動することができます。ファイル・サーバーが失敗すると、BOS サーバーはボリューム・サーバーを停止し、サルベージャーを稼働して、その障害によって生じた破壊を訂正します。 (サルベージャーは、この特別な状況、または bos salvage コマンドを使用して、ユーザー自身が呼び出した場合にのみ稼働します。 ボリュームのサルベージ を参照してください。) ボリューム・サーバーのみが障害を発生した場合、BOS サーバーは、ファイル・サーバーまたはサルベージャーに影響を与えずに再始動することができます。

ファイル・サーバー・コンポーネントは、ファイルおよびディレクトリーのレベルで AFS データを処理して、アプリケーション・プログラムおよび標準のオペレーティング・システム・コマンドで要求されたときにファイル・システム要素を操作します。主な役割は、クライアント・マシンに要求ファイルを送達し、クライアントが使い終わると、それを再びサーバー・マシンに格納することです。また、各ファイルおよびディレクトリーに関する状況および保護情報も保持します。通常の操作中は、連続的に稼働します。

ボリューム・サーバー・コンポーネントは、ファイルおよびディレクトリーのレベルではなく、ボリューム全体のレベルで AFS データを処理します。vos コマンドへの応答として、他のアクション間で、ボリューム全体を作成、削除、移動、ダンプおよび復元します。通常の操作中は、連続的に稼働します。

サルベージャー・コンポーネントは、他の 2 つのプロセスのうちの 1 つが失敗したあとにのみ稼働します。このコンポーネントは、内部整合性についてファイル・システムを検査して、エラーが見付かった場合にはそれを修理します。

プロセスは、一般的な名前が割り当てられている場合、bos status コマンドの出力で `fs` のように表示されます。補助メッセージは、ファイル・サーバーまたはサルベージャー・コンポーネントの状況をレポートします。BosConfig ファイルのプロセス状況および情報の表示を参照してください。

fs プロセスのコンポーネント・プロセスは、次のように、ps コマンドの出力で個別に表示されます。`fs` プロセスそのものには、項目がありません。

- `/usr/afs/bin/fileserver`
- `/usr/afs/bin/volserver`
- `/usr/afs/bin/salvager`

キャッシュ・マネージャーは、AFS ファイルまたはディレクトリーにあるデータまたはステータス情報をアクセスするとき、または UNIX cp および ls コマンドのようなファイル操作コマンドを発行するときには、ユーザー自身のためにファイル・サーバー・コンポーネントに接触します。次の機能を実行する fs コマンドを発行すると、ファイル・サーバーに直接接触することができます。

- アクセス制御リスト (ACL) の管理で説明してあるように、ファイル・システム内のあるどれかのディレクトリーの ACL を管理する。
- AFS ボリュームを収容するための新規パーティションの導入、この場合には新規パーティションを認識できるようにするため fs プロセスを再起動する必要があります。説明は、ディスクと区分の追加または除去を参照してください。
- ボリュームの取り付けに説明してあるように、AFS ファイル・スペース内でのボリューム・マウントの作成と削除
- ボリューム割り当て量および現行サイズの設定および表示に説明してあるように、ボリューム割り当ての設定およびボリュームまたはパーティションで利用可能なスペースについての情報の表示

作成、除去、複写、移動、名前変更、異なるフォーマットへの変換、およびサルベージのいずれかの方法でボリュームを操作する vos コマンドを発行するときボリューム・サーバー・コンポーネントと接触します。説明については、 ボリュームの管理を参照してください。

通常、サルベージャーは障害があった場合に自動的に稼働します。 ボリュームのサルベージ で説明してあるように、bos salvage コマンドで始動することもできます。

### kaserver プロセス: 認証サーバー

データベース・サーバー・マシン上で稼働する kaserver プロセスは、 AFS セキュリティーのいくつかの局面に対して責任を負う認証サーバーです。このサーバーは、パスワードを要求して AFS ユーザー識別を検証します。認証データベース内のすべての AFS サーバーの暗号化鍵およびユーザー・パスワードを保持します。認証サーバーのチケット付与サービス (TGS) モジュールは、セキュア・コネクションを確立するとき AFS クライアントおよびサーバーが処理する共有シークレットを作成します。

プロセスは、一般的な名前が割り当てられている場合、bos status コマンドの出力で `kaserver` のように表示されます。文字列 ka は、Kerberos 認証 (Kerberos Authentication) を意味し、 AFS 認証プロトコルはマサチューセッツ工科大学のプロジェクト Athena によって開発された Kerberos を基礎としていることを表しています。

`/usr/afs/bin/kaserver` として ps コマンドの出力で表示されます。

システム管理者として、次のタスクを実行するために kas コマンドを発行するときに認証サーバーと接触します。

- ユーザー・パスワードの設定。AFS ユーザー・アカウントの作成 および AFS パスワードの変更 で説明してあるように、通常、ユーザーは自身のパスワードを変更するので、新規のユーザー・アカウントを作成したときにだけこのタスクを実行します。
- TGS がサーバー・チケットの保証に使用する認証データベースでAFS サーバー暗号化鍵の設定。サーバー暗号化鍵の管理を参照してください。
- kas コマンドに対する特権付与: ADMIN フラグに説明してあるように、認証サーバーに関してシステム管理者特権の付与または取り消し。

### ptserver プロセス: 保護サーバー

データベース・サーバー・マシン上で稼働する ptserver プロセスは、保護サーバーです。その主な役割は、ユーザー、マシンおよびグループ項目を含む保護データベースの保持です。保護サーバーは、AFS ID を割り当てて、ID と名前間のマッピングを保持します。ファイル・サーバーは、要求されたアクションをユーザーが実行する権限があるかを検証するときに保護サーバーに相談します。

プロセスは、一般的な名前が割り当てられている場合、bos status コマンドの出力で `ptserver` のように表示されます。`/usr/afs/bin/ptserver`として ps コマンドの出力で表示されます。

システム管理者として、次のタスクを実行するために pts コマンドを発行するときに保護サーバーと接触します。

- 保護データベースの管理に説明してあるように、保護データベースでの新規ユーザー、マシンまたはグループ項目の作成
- 保護データベースの管理に説明してあるように、グループ・メンバーの追加または削除、または保護データベース項目の操作
- system:administrators グループの管理に説明してあるように、system:administrators グループのメンバーシップを変更することによるシステム管理者特権の付与または取り消し

### runntp プロセス

runntp プロセスは、すべてのサーバー・マシン上で稼動するネットワーク・タイム・プロトコル・デーモン (NTPD) の制御プログラムで、サーバー・マシン上にあるハードウェア・クロックを同期させます。NTP または別のタイム同期化プロトコルをサーバー・マシン上でまだ稼動していない場合には、runntpプロセスを実行する必要があります。

データベース・サーバー・マシン上のクロックは、AFS の分散データベース・テクノロジー (Ubik) は、振動の狭い範囲内でクロックが一致するときのみ正しく動作するため、データベース・サーバー・マシン上のクロックは同期する必要があります (Ubik の適切なオペレーションのためのセル構成を参照 )。ファイル・サーバーはファイル上の変更タイム・スタンプを設定するだけではなく、通常の構成では AFS クライアント・マシンのタイム・ソースとなるため、ファイル・サーバー・マシン上のクロックは正確にする必要があります。

プロセスは、一般的な名前が割り当てられている場合、bos status コマンドの出力で `runntp` のように表示されます。それは、`/usr/afs/bin/runntp` として ps コマンドの出力に表示されます。ps コマンドの出力には、`ntpd` という項目も含まれます。その正確な形式は、runntp コマンドに設定する引き数によって違います。

AFS インストールの手引きの指示に従って、システム管理者は、いったんインストールされた NTPD には直接接触することはありません。

### upserver および upclient プロセス: 更新サーバー

アップデート・サーバーには 2 つの分離パーツがあり、各パーツは異なるタイプのファイル・サーバー・マシン上で稼働します。upserver プロセスは、更新サーバーのサーバー部分です。その機能は、ユーザーが使用する AFS の版によって違います。

- 米国版と国際版両方で、ユーザーがサーバー・マシンとして使用する各システム・タイプのバイナリー配布マシンで稼動して、互いの /usr/afs/bin ディレクトリーの内容をそのタイプの他のサーバー・マシンに配布します。これによって、すべてのマシンが AFS バイナリーの同じバージョンを持つことが保証されます。(バイナリーのリストは、/usr/afs/bin ディレクトリーにあるバイナリー を参照してください。)
- AFS の米国版を使用する場合、セルのシステム制御マシン上で稼働して、その /usr/afs/etc ディレクトリーの内容を他のすべてのファイル・サーバー・マシン上に配布してそのディレクトリーに保管されている構成ファイルと同期します。(構成ファイルのリストは、/usr/afs/etc ディレクトリーにある共通構成ファイルを参照してください。)

upclient プロセスは更新サーバーのクライアント部分で、サーバー部分のように、その機能は使用する AFS 版によって違います。

- バイナリー配布マシンではないすべてのサーバー・マシン上で稼動して、そのシステム・タイプのバイナリー配布マシンを /usr/afs/bin ディレクトリーにあるバイナリーへの更新元として参照します。割り当てるための通常のプロセス名は、upclientbin です。
- 米国版の AFS を使用する場合には、プロセスの別のインスタンスは、システム制御マシンを除いてすべてのサーバー・マシン上で稼動します。これは、 /usr/afs/etc ディレクトリー内の共通構成ファイルに対する更新のソースとして、システム制御マシンを参照します。割り当てるための通常のプロセス名は、upclientetc です。

bos status コマンドの出力では、通常の名前が割り当てられている場合、サーバー部分は `upserver` のようになり、クライアント部分は `upclientbin` と `upclientetc` のようになります。ps コマンドからの出力では、サーバー部分は、`/usr/afs/bin/upserver` として表示されますが、クライアント部分は `/usr/afs/bin/upclient` として表示されます。

システム管理者として、いったんインストールされた更新サーバーには、直接接触することはありません。配布するファイルを変更するために bos コマンドを使用するときには、自動的に動作します。

### vlserver プロセス: ボリューム・ロケーション・サーバー

データベース・サーバー・マシン上で稼働する vlserver プロセスは、ファイル・システム内のすべてのボリュームを自動的に追跡するボリューム・ロケーション (VL) サーバーで、そのロケーションをクライアント・アプリケーションに対してトランスペアレントにします。

プロセスは、一般的な名前が割り当てられている場合、bos status コマンドの出力で`vlserver`のように表示されます。`/usr/afs/bin/vlserver` として ps コマンドの出力で表示されます。

システム管理者として、ボリュームの状況を変更する任意の vos コマンドを発行して、VL サーバーと接触します(VLDB 内の状況変化を記録します)。

## プロセス状況の制御および検査

サーバー・マシン上で稼動する AFS サーバー・プロセスを定義するには、bos create コマンドを使用してローカルの /usr/afs/local/BosConfig ファイルで項目を作成します。BOS サーバーは、`Run` ステータス・フラグでマークされているBosConfig ファイルにリストされているプロセスをモニターして、失敗した場合には自動的に再始動しようとします。処理入力を作成すると、プロセスを停止、開始するためまたは必要に応じて状況フラグを変更するために bos 組から他のコマンドを使用します。

bos コマンドを使用しないで BosConfig ファイルを直接編集しないでください。同様に、BosConfig ファイルにリストしないでサーバー・プロセスを実行したり、または UNIX kill コマンドのようなプロセス終了コマンドを使用して停止するのは、良い方法ではありません。

### BosConfig ファイルの情報

BosConfig のプロセス項目には、次の情報が含まれています。

- プロセスの名前。推奨される一般的な名前は AFS インストールの手引き および プロセスの作成および除去で定義されています。単純なプロセスの名前は、通常、そのバイナリー・ファイルの名前に一致します (たとえば、保護サーバーの場合は、ptserver)。
- 以下の 1 つであるそのタイプ:

  simple
    サーバー・マシン上の他のどれとも関係なく動作するプロセス。いくつかの単純プロセスが同時に失敗した場合、BOS サーバーは、どの順序でも再始動することができます。fs プロセス以外のすべての標準 AFS プロセスは、どれもシンプルです。

  fs
    通常名が fs でもあるサーバー・プロセスに予約されたプロセス・タイプ。このプロセスは、3 つのコンポーネント、すなわちファイル・サーバー、ボリューム・サーバー、およびサルベージャーを結合します。

  cron
    連続してではなく定義された時間に稼動するプロセス。このタイプには標準プロセスがありません。
- プロセスに関して次の 2 つのアクションを実行するかどうかを BOS サーバーに通知するその状況フラグ。
  - BOS サーバー初期化中のプロセスの開始
  - (プロセスが) 失敗した場合に、プロセスの再始動
  可能な 2 つの値は、`Run` (アクションを実行するように BOS サーバーに指示する) および `NotRun` (プロセスを無視するように BOS サーバーに指示する) です。BOS サーバーそのものは、プロセスが繰り返し失敗しても、このフラグの設定を変更することはありません。このフラグは内部使用専用です。bos status コマンドの出力には表示されません。
- そのコマンド・パラメーター。このパラメーターは、プロセスを始動するために BOS サーバーが実行するコマンドです。

  - 単純プロセスには 1 つあります。すなわち、そのバイナリー・ファイルへの完全パス名
  - fs プロセスには 3 つあります。すなわち、3 つのコンポーネント・プロセス (/usr/afs/bin/fileserver、/usr/afs/bin/volserver および /usr/afs/bin/salvager) それぞれに完全パス名
  - cron プロセスには 2 つあります。すなわち、1 つはそのバイナリー・ファイルへの完全パス名で、もう 1 つは BOS サーバーが実行する時間

プロセス定義以外に、BosConfig ファイルは、新規バイナリーがあるプロセスに対して、および BOS サーバーを含むすべてのサーバー・プロセスに対して自動再始動時間も記録します。BOS サーバーの再始動時を設定する を参照してください。

### BOS サーバーが BosConfig ファイルの情報を使用する方法

BOS サーバーは、開始または再始動するたびに BosConfig ファイルを読み取って、開始およびモニターするプロセスを確認します。BOS サーバーは、情報をカーネル・メモリーに転送して、次に再始動するまで BosConfig ファイルの再読み取りはしません。 BosConfig ファイルには関係なく、BOS サーバーのメモリー状態を変更できることを意味します。たとえば、プロセスを停止しても BosConfig ファイル内の状況フラグを `Run` のままにしておくこともできますが、BosConfig ファイル内のその状況フラグが `NotRun` であってもプロセスを始動することができます。

### データベース・サーバー・プロセスの開始および停止について

データベース・サーバー・プロセス (認証サーバー、バックアップ・サーバー、またはボリューム・ロケーション・サーバー)を一時的にではなく始動または停止するとき、データベース・サーバー・マシンをインストールまたは除去するためには AFS インストールの手引きの指示に従う必要があります。正しい AFS 機能を維持するために実行する必要のあるタスクの要約を以下に示します。

- そのマシン上の 4 つのデータベース・サーバー・プロセスすべてを開始し、停止する。すべての AFS サーバー・プロセスおよびキャッシュ・マネージャー・プロセスは、4 つのデータベース・サーバー・プロセスすべてが CellServDB ファイルにリストされている各マシンで稼動することを予期しています。マシンがデータベース・サーバー・プロセスの一部しか稼働していないことを示す方法はありません。
- すべてのサーバー・マシン上にある /usr/afs/etc/CellServDB ファイルにあるマシン、およびすべてのクライアント・マシン上にある /usr/vice/etc/CellServDB ファイルでマシンを追加または削除します。
- それぞれに対して新規 Ubik コーディネーターの選択を強制するには、他のデータベース・サーバー・マシン上にあるデータベース・サーバー・プロセスを再始動します。

### 更新サーバーの開始および停止について

通常のセル構成では、各システム・タイプのサーバー・マシンはバイナリー配布マシンとして動作し、更新サーバー (upserver プロセス) のサーバー部分を実行してその /usr/afs/bin ディレクトリーの内容を配布します。そのシステム・タイプの他のサーバー・マシンは、バイナリー配布マシンを参照する更新サーバー・クライアント部分 (通常、upclientbin という) のインスタンスを実行します。

米国版の AFS を稼動する場合には、最初のサーバー・マシンとしては、システム制御マシンとして動作するように設置して、更新サーバー (upserver プロセス) のサーバー部分がその /usr/afs/etc ディレクトリーの内容を配布するように動作させるのが一般的です。他のすべてのサーバー・マシンは、システム制御マシンを参照する更新サーバー・クライアント部分 (通常、upclientetc という) のインスタンスを実行します。

注: | AFS 国際版を使用する場合は、更新サーバーを使用して /usr/afs/etc ディレクトリーの内容を配布しないでください(システム制御マシンを稼動しません)。この章のプロセスへのすべてのリファレンスを無視してください。

現在その役割の 1 つで使用しているマシンを使用停止しないかぎり、バイナリー配布またはシステム制御責任を別のマシンに移動しないでおくのが最も使いやすい方法です。通常、更新サーバーを実行しても、処理負荷はほとんどかかりません。機能を移動する必要がある場合には、次の関連タスクを実行します。

- システム制御マシンを置換する場合には、他のすべてのサーバー・マシン上にある upclientetc プロセスを停止して、新規のシステム制御マシンを参照する新しいものを定義する必要があります。
- バイナリー配布マシンを置換する場合には、そのシステム・タイプの他のすべてのサーバー・マシン上にある upclientbin プロセスを停止して、新規のバイナリー配布マシンを参照する新しいものを定義する必要があります (そのシステム・タイプのサーバー・マシンを今後稼動することがない場合)。

## BosConfig ファイルのプロセス状況および情報の表示

サーバー・マシン上にある AFS サーバー・プロセスの状況を表示するには、bos status コマンドを発行します。 -long フラグを追加すると、そのタイプとコマンド・パラメーターを含めて BosConfig ファイルにある各プロセスの項目の情報のほとんどが表示されます。/usr/afs ディレクトリーにあるファイルとサブディレクトリーのモード・ビットが予期値と一致しない場合には、警告メッセージも表示されます。

### サーバー・プロセスの状況とその BosConfig 項目を表示する方法

1. bos status コマンドを発行します。

          % bos status <machine name>  [<server process name>+]  [-long]

   ここで、

   stat
     status の受け入れ可能な最も短い省略形です。

   machine name
     プロセス状況を表示するファイル・サーバー・マシンを指定します。

   server process name
     その項目が bos create コマンドで定義されたときに割り当てられた名前を使用して、状況を表示する各プロセスに名前を付けます。この引き数を省略すると、すべてのサーバー・プロセスの状況が表示されます。

   -long
     状況の他に、BosConfig ファイル内のプロセスの項目からの情報、すなわち、そのタイプ、状況フラグ、コマンド・パラメーター、関連した通知プログラム、などを表示します。

出力には各プロセスの項目が含まれ、プロセスの状況を示すために次の文字列の 1 つが使用されます。

- `通常、現在稼動中`、プロセスが稼動していて BosConfig ファイル内のその状況フラグが `Run` になっていることを示します。cron 項目では、このメッセージはまだ稼動する予定になっていて、 bos status コマンドが発行されたとき必ずしも稼動していないことを示します。
- `一時的に使用可能`は、プロセスは稼動しているが、BosConfig ファイルのその状況フラグが`NotRun`になっていることを示します。最も一般的な理由は、システム管理者が bos startup コマンドを使用してプロセスを始動したためです。
- `一時的に使用不可`は、BosConfig ファイル内のその状況フラグが `Run` になっていてもプロセスが稼動していないことを示します。最も一般的な理由は、システム管理者が bos shutdown コマンドを使用してプロセスを停止したか、または数多くの試行が失敗した後で BOS サーバーがプロセスを再始動しようとしなかったためです。プロセスを再始動しなかった場合、補足メッセージ: `エラーが多すぎるために停止しました`が表示されます。
- `使用不可`は、プロセスは稼動していないで、BosConfig ファイル内のその状況フラグが `NotRun`になっていることを示します。BOS サーバーは、プロセスを監視しません。フラグをこの方法で設定できるのはシステム管理者だけです。BOS サーバーが行うことはありません。

fs プロセスの出力には、常に`補助状況`とマークされたメッセージが含まれています。これは、以下のいずれかです。

- `ファイル・サーバー稼動中`は、ファイル・サーバー・プロセスのファイル・サーバーとボリューム・サーバー・コンポーネントが正常に稼動していることを示します。
- `ファイル・システムのサルベージ`は、サルベージャーが稼動していることを示し、通常、ファイル・サーバーとボリューム・サーバーが一時的に使用不可になっていることを意味します。それらのサーバーは、サルベージャーが完了すると、BOS サーバーによってすぐに再始動されます。

cron プロセスの出力には、コマンドが次に実行する時期を報告する`補助状況` メッセージが含まれます。次に例を示します。

任意のプロセスの出力は、どこかのポイントでプロセスが失敗して /usr/afs/logs ディレクトリーにコア・ファイルを生成したことを示すため、補助メッセージ「`has core file`」を取り入れることができます。ほとんどの場合、BOS サーバーはプロセスを再始動することができ、稼動しています。

次の例には、backupusersと呼ばれるユーザー定義の cron 項目が含まれています。

       % bos status fs3.example.com
       Instance kaserver, currently running normally.
       Instance ptserver, currently running normally.
       Instance vlserver, has core file, currently running normally.
       Instance buserver, currently running normally.
       Instance fs, currently running normally.
           Auxiliary status is: file server running.
       Instance upserver, currently running normally.
       Instance runntp, currently running normally.
       Instance backupusers, currently running normally.
           Auxiliary status is: run next at Mon Jun 7 02:00:00 1999.

bos status コマンドに -long フラグを組み込むと、出力の各プロセスには BosConfig ファイルの次の追加情報が組み込まれます。

- プロセスのタイプ (`simple`、`fs`、または `cron`)。
- プロセスが最後に開始または再始動した日時。
- `proc starts` の数。BOS サーバーそれ自体が開始してから、プロセスを開始または再始動した回数。
- `Last exit` 時刻。プロセス (または fs プロセス内のコンポーネント・プロセスの 1 つ) が最後に終了した時刻。 BOS サーバーが開始してからプロセスが終了していない場合、この行は表示されません。
- `Last error exit` 時刻。プロセス (または fs プロセス内のコンポーネント・プロセスの 1 つ) がエラーのため最後に失敗した時刻。 `due to shutdown request` (終了の要求による) など、追加の説明が表示される可能性があります。BOS サーバーが開始してからプロセスに失敗がない場合、この行は表示されません。
- プロセスを開始するために BOS サーバーが呼び出す各コマンド。 bos create コマンドに対する -cmd 引き数で指定します。
- プロセスの終了時に BOS サーバーが呼び出す通知プログラムのパス名 (もしあれば)。 bos create コマンドに対する -notifier 引き数で指定します。

さらに、BOS サーバーが /usr/afs の下の特定のファイルおよびディレクトリー上のモード・ビットが、期待から逸脱していることを発見すると、次の警告メッセージを印刷します。

       Bosserver process reports inappropriate access on server directories

/usr/afs ディレクトリー以下のディレクトリーおよびファイルに対して予期される保護は次のとおりです。疑問符は、BOS サーバーがモード・ビットをチェックしないことを示します。これらのファイルおよびディレクトリーへの保護の設定についての詳細は、 AFS インストールの手引き を参照してください。

/usr/afs | `drwxr`?`xr-x`
/usr/afs/backup | `drwx`???`---`
/usr/afs/bin | `drwxr`?`xr-x`
/usr/afs/db | `drwx`???`---`
/usr/afs/etc | `drwxr`?`xr-x`
/usr/afs/etc/KeyFile | `-rw`????`---`
/usr/afs/etc/UserList | `-rw`?????`--`
/usr/afs/local | `drwx`???`---`
/usr/afs/logs | `drwxr`?`xr-x`

以下は、マシン fs3.example.com 上で稼動している fs プロセスの拡張出力を示しています。

       % bos status fs3.example.com fs -long
       Instance fs, (type is fs), currently running normally.
           Auxiliary status is file server running
       Process last started at Mon May 3 8:29:19 1999 (3 proc starts)
       Last exit at Mon May 3 8:29:19 1999
       Last error exit at Mon May 3 8:29:19 1999, due to shutdown request
       Command 1 is '/usr/afs/bin/fileserver'
       Command 2 is '/usr/afs/bin/volserver'
       Command 3 is '/usr/afs/bin/salvager'

## プロセスの作成および除去

サーバー・マシン上で新規の AFS サーバー・プロセスを開始するには、bos create コマンドを発行します。/usr/afs/local/BosConfig ファイルに項目が作成され、ファイルおよび BOS サーバーのメモリー両方でプロセスの状況フラグが `Run` に設定され、直ちに稼動を開始します。そのためには、なるべく /usr/afs/bin ディレクトリーに新規プロセスのバイナリー・ファイルがすでにインストールされている必要があります (新規バイナリーのインストール を参照)。

プロセスを永久的に停止するには、最初に、bos stop コマンドを発行します。プロセスの状況フラグは、BosConfig ファイルと BOS サーバーのメモリー両方で `NotRun` に変化して、 bos status コマンドの出力で `使用不可` としてマークされます。希望する場合、bos delete コマンドを発行してプロセスの項目を BosConfig ファイルから削除します。プロセスは bos status コマンドの出力に表示されなくなります。

注: | この機能グループに説明されている方法でデータベース・サーバー・プロセスを開始または停止する場合、 AFS インストールの手引き のすべての指示に従って、データベース・サーバー・マシンを作成または除去してください。指定のマシンに 1 つのデータベース・サーバー・プロセスを稼働する場合、それらすべてを稼働しなくてはなりません。詳細については、 データベース・サーバー・プロセスの開始および停止について を参照してください。同様に、システム制御マシンまたはバイナリー配布マシン上で upserver プロセスを停止する場合、更新サーバーの開始および停止について に説明してあるように追加タスクを完了する必要があります。

### 新規プロセスを作成および開始する方法

1. /usr/afs/etc/UserList ファイルにリストされているユーザーとして認証されていることを検証します。必要な場合には、bos listusers コマンドを発行します。このコマンドについては、UserList ファイルのユーザーの表示で詳しく説明しています。

          % bos listusers <machine name>

2. (オプション) プロセスのバイナリーがこのマシンの /usr/afs/bin ディレクトリーにインストールされているか検証します。必要に応じて、コンソールにログインするか、または Telnet でマシンに接続し、/usr/afs/bin ディレクトリーの内容をリストします。

   バイナリーが存在しない場合、適切なシステム・タイプのバイナリー配布マシンにインストールして、更新サーバーが、このマシンにコピーするのを待ちます。説明については、新規バイナリーのインストール を参照してください。

          % ls /usr/afs/bin

3. bos create コマンドを発行して、BosConfig ファイルに項目を作成してプロセスを開始します。

          % bos create <machine name> <server process name>   \
                    <server type> <command lines>+ [ -notifier <Notifier program>]

   ここで、

   cr
     create の受け入れ可能な最も短い省略形です。

   machine name
     プロセスを作成するファイル・サーバー・マシンの名前を指定します。

   server process name
     作成して開始するには、プロセスに名前を付けます。単純プロセスでは、一般的な値はプロセスのバイナリー・ファイルの名前です。最も良い方法は、プロセスを稼動するすべてのサーバー・マシンに同じ名前を使用します。以下は、単純プロセスと fs-type プロセス (標準 cron プロセスがない) の一般的な名前のリストです。
     - buserver バックアップ・サーバー用
     - fs ファイル・サーバー、ボリューム・サーバー、およびサルベージャーを結合するプロセス用
     - kaserver 認証サーバー用
     - ptserver 保護サーバー用
     - runntp ネットワーク時間プロトコル・デーモンの制御装置プロセス用
     - upclientbin このマシンのシステムのバイナリー配布マシンを参照する更新サーバーのクライアント部分用
     - upclientetc システム制御マシンを参照する更新サーバーのクライアント部分用
     - vlserver ボリューム・ロケーション (VL) サーバー用

   サーバーのタイプ
     プロセスのタイプを定義します。次のいずれかの値を選択します。
     - cron cron プロセス用
     - fs fs という名前のプロセス用
     - simple server process name 引き数の許容値としてリストされた他のすべてのプロセス用

   command lines
     このプロセスを開始するために BOS サーバーが実行する各コマンドを指定します。コマンドは 6 つまで指定できます (コマンドのオプションが含まれる場合は、文字列全体を二重引用符で囲みます)。7 番目以降のコマンドは無視されます。

     シンプル・プロセスでは、ローカル・ディスク上にあるそのプロセスのバイナリー・ファイルの完全パス名を指定します (たとえば、保護サーバーの場合は /usr/afs/bin/ptserver)。初期設定コマンドの任意のオプションが含まれる場合は、コマンド全体を二重引用符 (" ") で囲みます。 upclient プロセスには、必須の引き数があります。その他のすべてのプロセスのコマンドでは、引き数はオプションです。

     fs プロセスでは、それぞれのコンポーネント・プロセスごとに、ローカル・ディスクのバイナリー・ファイルの完全パス名を指定します。 fileserver、volserver、および salvager の順になります。標準のバイナリー・ディレクトリーは、/usr/afs/bin です。初期設定コマンドの任意のオプションが含まれる場合は、コマンド全体を二重引用符 (" ") で囲みます。

     cron プロセスでは、次の 2 つのパラメーターを指定します。

     - ローカル・ディスクにある、実行可能ファイル、または AFS スイートの 1 つであるコマンドのいずれかの完全パス名 (必要な引き数をすべて完全に指定する)。このパラメーターにスペースが含まれる場合は、パラメーターを二重引用符 (" ") で囲みます。
     - BOS サーバーが、最初のパラメーターで指定されたファイルまたはコマンドの実行をいつ始めるかの指定。許容値は 3 つあります。
       - 文字列 now。 BOS サーバーは、そのファイルまたはコマンドの実行を今すぐ開始し、 1 度しか実行しません。このコマンドは、通常、直接発行するか、 bos exec コマンドを発行する方が簡単です。
       - 時刻。BOS サーバーは、毎日、指定された時刻に、そのファイルまたはコマンドを実行します。時間と分はコロンで区切り (hh:MM)、24 時間形式か、あるいは 1:00 から 12:59 までの値に am または pm を付加して指定することができます。たとえば、 14:30 と "2:30 pm" は、どちらも午後 2:30 を示します。このパラメーターにスペースが含まれる場合は、パラメーターを二重引用符 (" ") で囲みます。
       - 曜日と時刻。曜日と時刻はスペースで区切り、全体を二重引用符 (" ") で囲みます。 BOS サーバーは、毎週、指定された曜日の指定された時刻に、そのファイルまたはコマンドを実行します。曜日は、その曜日の名前全体かまたは最初の 3 文字を、すべて小文字で指定します (sunday または sun、 thursday または thu など)。時刻は、時刻のみを指定する場合と同様の形式で指定します。

   -notifier
     プロセスが終了したときに BOS サーバーが実行するプログラムのパス名を指定します。通知プログラムについての詳細は、 AFS Administration Reference にある bos create コマンドの解説ページを参照してください。

次の例は、マシン db2.example.com の保護サーバーを定義および開始します。

       % bos create db2.example.com ptserver simple /usr/afs/bin/ptserver

次の例は、マシン fs6.example.com の fs プロセスを定義および開始します。

       % bos create fs6.example.com fs fs /usr/afs/bin/fileserver   \
            /usr/afs/bin/volserver /usr/afs/bin/salvager

次の例は、マシン fs3.example.com の backupuser プロセスという cron プロセスを定義および開始して、毎日 3:00 a.m に稼動するようにスケジュールします。

       % bos create fs3.example.com backupuser cron
            "/usr/afs/bin/vos backupsys -prefix user -local" 3:00

### プロセスを停止して BosConfig ファイルから削除する

1. /usr/afs/etc/UserList ファイルにリストされているユーザーとして認証されていることを検証します。必要な場合には、bos listusers コマンドを発行します。このコマンドについては、UserList ファイルのユーザーの表示で詳しく説明しています。

          % bos listusers <machine name>

2. bos stop コマンドを発行して BosConfig ファイルにある各プロセスの状況フラグを、`NotRun` に変更して、停止します。継続的に稼動しない場合でも、BosConfig ファイルから削除したい cron プロセスにもこのコマンドを発行する必要があります。このコマンドについての詳細は、状況を NotRun に変更してプロセスを停止する方法 を参照してください。

          % bos stop <machine name> <server process name>+ [-wait]

3. bos delete コマンドを発行して、各プロセスを BosConfig ファイルから削除します。

          % bos delete <machine name> <server process name>+

   ここで、

   d
     delete の受け入れ可能な最も短い省略形です。

   machine name
     BosConfig ファイルからプロセスを削除するサーバー・マシンを指定します。

   server process name
     BosConfig ファイルから削除する各プロセス項目に名前を付けます。2 のステップで指定したのと同じ名前を指定します。

## プロセスを永続的に停止および開始する

BOS サーバーが監視しないようにするためプロセスを停止するには、bos stop コマンドを発行します。プロセスの状況フラグは、BOS サーバーのメモリーおよび BosConfig ファイル両方で `NotRun` に設定されます。bos start コマンドを発行するまでプロセスは再稼動しません。素の状況フラグは、BOS サーバーのメモリーおよび BosConfig ファイル両方で `Run` に戻されます。(bos startup コマンドを使用すると、BosConfig ファイルの状況フラグを変更しなくてもプロセスを再始動することができます。プロセスを一時的に停止および開始する を参照してください。)

BosConfig ファイルには BOS サーバー用の項目はないので、bos stop および bos start コマンドは BOS サーバーを制御しません。他のすべてのプロセスとともに BOS サーバーを停止して直ちに再始動するには、プロセスの停止および即時の再始動 に説明してあるように、bos restart コマンドに -bosserver フラグを使用します。

注: | この機能グループに説明されている方法でデータベース・サーバー・プロセスを開始または停止する場合、 AFS インストールの手引き のすべての指示に従って、データベース・サーバー・マシンを作成または除去してください。指定のマシンに 1 つのデータベース・サーバー・プロセスを稼働する場合、それらすべてを稼働しなくてはなりません。詳細については、 データベース・サーバー・プロセスの開始および停止について を参照してください。同様に、システム制御マシンまたはバイナリー配布マシン上で upserver プロセスを停止する場合、更新サーバーの開始および停止について に説明してあるように追加タスクを完了する必要があります。

### 状況を NotRun に変更してプロセスを停止する方法

1. /usr/afs/etc/UserList ファイルにリストされているユーザーとして認証されていることを検証します。必要な場合には、bos listusers コマンドを発行します。このコマンドについては、UserList ファイルのユーザーの表示で詳しく説明しています。

          % bos listusers <machine name>

2. bos stop コマンドを発行して各プロセスを停止し、BosConfig ファイルおよび BOS サーバーのメモリーでその状況フラグを `NotRun` に設定します。

          % bos stop <machine name> <server process name>+ [-wait]

   ここで、

   sto
     stop の受け入れ可能な最も短い省略形です。

   machine name
     プロセスを停止するサーバー・マシンを指定します。

   server process name
     その項目が bos create コマンドで定義されたときに割り当てられた名前を使用して、停止する各プロセスに名前を付けます。

   -wait
     すべての指定したプロセスが停止するまで、コマンド・シェル・プロンプトの戻りを遅らせます。このフラグを省略すると、すべてのプロセスがまだ停止していなくても、プロンプトがほぼ即時に戻ります。

### 状況フラグを Run に変更してプロセスを開始する方法

1. ユーザーが、/usr/afs/etc/UserList ファイルにリストされているかどうかを検証する。必要な場合には、bos listusers コマンドを発行します。このコマンドについては、UserList ファイルのユーザーの表示で詳しく説明しています。

          % bos listusers <machine name>

2. bos start コマンドを発行して、 BosConfig ファイルと BOS サーバーのメモリー両方で各プロセスの状況フラグを `Run` に変更して、開始します。

          %  bos start <machine name> <server process name>+

   ここで、

   start
     完全な形式で入力する必要があります。

   machine name
     各プロセスの実行を開始するサーバー・マシンを指定します。

   server process name
     machine name で開始する各プロセスを指定します。作成時にプロセスに割り当てられた名前を使用します。

## プロセスを一時的に停止および開始する

ときには、プロセスを一時的に停止することが必要になります (たとえば、構成をわずかに変更する、または保守を実行するような場合)。この節で説明するコマンドは、BOS サーバーのメモリーのみにあるプロセスの状況を変更します。変更による影響は即時に現れ、メモリー状態を再び変更するまで継続します (または、BOS サーバーが再始動するまで継続し、再始動したときには、BosConfig ファイル内の項目に従ってプロセスが開始します)。

BOS サーバー・メモリーの状況フラグを `NotRun` に変更してプロセスを一時的に停止するには、bos shutdown コマンドを使用します。BOS サーバーのメモリーにある状況フラグを `Run` に変更して、停止したプロセスを再始動するには、bos startup コマンドを使用します。プロセスは、 BosConfig ファイル内の状況フラグに関係なく開始します。以下で説明するように、bos startup コマンドを使用しても、BosConfig ファイル `Run` でマークされたすべてのプロセスを開始することができます。

bos startup コマンドは、BosConfig ファイルの状況フラグを変更しないでプロセスを開始するため、永久的に使用可能にしないでサーバー・プロセスをテストするときには便利です。BosConfig ファイルの状況フラグを変更して、プロセスを停止および開始するには、プロセスを永続的に停止および開始する を参照してください。プロセスを停止および即時に再始動する方法については、プロセスの停止および即時の再始動 を参照してください。

注: | すべてのマシンのデータベース・サーバー・プロセスを同時に一時停止させないでください。そうすることによって、すべてのデータベースが完全に使用不可になります。

### プロセスを一時停止させる方法

1. ユーザーが、/usr/afs/etc/UserList ファイルにリストされているかどうかを検証する。必要な場合には、bos listusers コマンドを発行します。このコマンドについては、UserList ファイルのユーザーの表示で詳しく説明しています。

          % bos listusers <machine name>

2. BOS サーバーのメモリーの状況フラグを `NotRun` に変更して各プロセスを停止するには、bos shutdown コマンドを発行します。

          % bos shutdown <machine name> [<instances>+] [-wait]

   ここで、

   sh
     shutdown の受け入れ可能な最も短い省略形です。

   machine name
     プロセスを一時的に停止するサーバー・マシンを指定します。

   instances
     一時停止させる各プロセスを指定します。作成時にプロセスに割り当てられた名前を使用します。

   -wait
     すべての指定したプロセスが実際に停止するまで、コマンド・シェル・プロンプトの戻りを遅らせます。このフラグを省略すると、すべてのプロセスがまだ停止していなくても、プロンプトがほぼ即時に戻ります。

### BosConfig ファイルの状況フラグが Run になっているすべての停止されたプロセスを開始する方法

1. ユーザーが、/usr/afs/etc/UserList ファイルにリストされているかどうかを検証する。必要な場合には、bos listusers コマンドを発行します。このコマンドについては、UserList ファイルのユーザーの表示で詳しく説明しています。

          % bos listusers <machine name>

2. bos startup コマンドを発行し、BOS サーバーのメモリーの状況フラグを `NotRun` から `Run` に変更して、 BosConfig ファイルで状況フラグ `Run` のあるマシンで各プロセスを開始します。

          % bos startup <machine name>

   ここで、

   startup
     完全な形式で入力する必要があります。

   machine name
     BosConfig ファイルの状況フラグが `Run` になっているすべてのプロセスを開始するサーバー・マシンを指定します。

### 特定のプロセスを開始する方法

1. ユーザーが、/usr/afs/etc/UserList ファイルにリストされているかどうかを検証する。必要な場合には、bos listusers コマンドを発行します。このコマンドについては、UserList ファイルのユーザーの表示で詳しく説明しています。

          % bos listusers <machine name>

2. BosConfig ファイルの状況フラグを変更しないで、BOS サーバーのメモリーにある状況フラグを `Run` に変更し、bos startup コマンドを発行して特定プロセスを開始します。

          % bos startup <machine name> <instances>+

   ここで、

   startup
     完全な形式で入力する必要があります。

   machine name
     プロセスを開始するサーバー・マシンに名前を付けます。

   instances
     開始する各プロセスを指定します。作成時にプロセスに割り当てられた名前を使用します。

## プロセスの停止および即時の再始動

デフォルトでは、BOS サーバーは、新しくインストールされたバイナリー・ファイルを毎日チェックして関連するプロセスを再始動しますが、プロセスを停止して即時に再始動したいときもあります。bos restart コマンドにはこの機能があり、影響のある各プロセスの完全に新しいインスタンスを開始します。

- BOS サーバーを停止して再始動させ、BosConfig ファイルにある `Run` 状況フラグでマークされたすべてのプロセスを再始動するには、-bosserver フラグを組み込みます。
- BosConfig ファイルにある `Run` 状況フラグでマークされたすべてのプロセスを停止して再始動するには、 -all フラグを組み込みます。BOS サーバーは再始動しません。
- BosConfig 内での状況フラグの設定に関係なく、特定のプロセスを停止して再始動するには、再始動する各プロセスの名前を指定します。

プロセスを再始動すると、サービスの障害が起こります。通常は、使用率が低い時間帯に再始動をスケジュールするのが最適です。長時間にわたってプロセスを稼働すると拡大する可能性があるコア・リークの可能性を減らすために、 BOS サーバーは、すべてのプロセスを週に 1 度、自動的に再始動します。 BOS サーバーの再始動時を設定する を参照してください。

### BOS サーバーを含むすべてのプロセスを停止して再始動する方法

1. ユーザーが、/usr/afs/etc/UserList ファイルにリストされているかどうかを検証する。必要な場合には、bos listusers コマンドを発行します。このコマンドについては、UserList ファイルのユーザーの表示で詳しく説明しています。

          % bos listusers <machine name>

2. -bosserver フラグを付けて bos restart コマンドを発行して、BOS サーバーを停止して再始動します。BosConfig ファイル内にある状況フラグ `Run` でマークされたすべてのプロセスが再始動します。

          % bos restart <machine name>  -bosserver

   ここで、

   res
     restart の受け入れ可能な最も短い省略形です。

   machine name
     すべてのプロセスを再始動させるサーバー・マシンを指定します。

   -bosserver
     そのマシン上で稼働している BOS サーバーおよびすべてのプロセスを停止させます。新規の BOS サーバー・インスタンスが開始します。次に、BosConfig ファイルに状況 `Run` がマークされたすべてのプロセスの新規のインスタンスを開始します。

### BOS サーバーを除くすべてのプロセスを停止して即時に再始動する

1. ユーザーが、/usr/afs/etc/UserList ファイルにリストされているかどうかを検証する。必要な場合には、bos listusers コマンドを発行します。このコマンドについては、UserList ファイルのユーザーの表示で詳しく説明しています。

          % bos listusers <machine name>

2. bos restart コマンドに -all フラグを付けて発行し、BosConfig ファイルの状況フラグ `Run` でマークされたすべてのプロセスを停止し、即時に再始動します。 BOS サーバーは再始動しません。

          % bos restart <machine name> -all

   ここで、

   res
     restart の受け入れ可能な最も短い省略形です。

   machine name
     プロセスを停止、再始動するサーバー・マシンを指定します。

   -all
     BosConfig ファイルにある状況フラグ `Run` でマークされたすべてのプロセスを停止して即時に再始動します。

### 特定のプロセスを停止して即時に再始動する方法

1. ユーザーが、/usr/afs/etc/UserList ファイルにリストされているかどうかを検証する。必要な場合には、bos listusers コマンドを発行します。このコマンドについては、UserList ファイルのユーザーの表示で詳しく説明しています。

          % bos listusers <machine name>

2. bos restart コマンドを発行し、 BosConfig ファイルの状況フラグの設定に関係なく、指定した 1 つまたは複数のプロセスを停止し、即時に再始動します。

          % bos restart <machine name> <instances>+

   ここで、

   res
     restart の受け入れ可能な最も短い省略形です。

   machine name
     指定されたプロセスを再始動するサーバー・マシンの名前を指定します。

   instances
     停止して、即時に再始動する各プロセスを指定します。作成時にプロセスに割り当てられた名前を使用します。

## BOS サーバーの再始動時を設定する

デフォルトでは、BOS サーバーは週に 1 回再始動して、新規インスタンスはローカルの /usr/afs/local/BosConfig ファイルにある状況フラグ `Run` でマークされたすべてのプロセスを再始動します (-bosserver フラグを付けて bos restart コマンドを発行するのと同じです)。デフォルトの再始動時間は日曜日の午前 4 時です。週ごとの再始動は、コア・リーク が最も少なくなるように設計されているので、プロセスが仮想メモリーを継続して割り当てるときに拡大しますが、再び開放することはありません。メモリーを完全に使い果たすと、マシンが正しく機能しなくなります。

デフォルトでは、BOS サーバーは新規にインストールされたバイナリー・ファイルを 1 日 1 回検査します。/usr/afs/bin ディレクトリーにあるプロセスのバイナリー・ファイルの変更タイム・スタンプがプロセスを最後に始動した時刻よりも新しいことが分かると、プロセスは、新しいインスタンスが新規バイナリー・ファイルを使い始められるように再始動します。デフォルトのバイナリー検査時刻は、午前 5 時です。

ファイル・システムがアクセス不能なあいだ、再始動によって障害が起こる可能性があるため、再始動のデフォルト時は、使用頻度が最も少ないと思われる早朝です。任意のデータベース・サーバー・マシン上でデータベース・サーバー・プロセスを再始動すると、システム全体が一時的にすべてのユーザーに使用不可になります。その場合、他のタイプのプロセスを再始動すると、そのマシンのプロセスと対話しているユーザーだけが不便を感じることになります。一般的に、最長停止は、ファイル・サーバーがすべてのボリュームを再アタッチする必要があるため、fs プロセスを再始動したことにより発生します。

各ファイル・サーバー・マシンの BosConfig ファイルは、2 度の再始動時を記録します。現在の設定を表示するには、bos getrestart コマンドを発行します。時刻をリセットするには、bos setrestart コマンドを使用します。

### BOS サーバー再始動時を表示する方法

1. bos getrestart コマンドを発行して自動再始動時を表示します。

          % bos getrestart <machine name>

   ここで、

   getr
     getrestart の受け入れ可能な最も短い省略形です。

   machine name
     再始動時を表示するサーバー・マシンを指定します。

### 一般再始動時またはバイナリー再始動時を設定する方法

1. ユーザーが、/usr/afs/etc/UserList ファイルにリストされているかどうかを検証する。必要な場合には、bos listusers コマンドを発行します。このコマンドについては、UserList ファイルのユーザーの表示で詳しく説明しています。

          % bos listusers <machine name>

2. -general フラグを付けて bos setrestart コマンドを発行して、一般的な再始動時を設定するかまたは -newbinary フラグを付けてバイナリー再始動時を設定します。コマンドは、1 回にフラグの 1 つだけを受け入れます。

          % bos setrestart <machine name> "<time to restart server>"
                           [-general]  [-newbinary]

   ここで、

   setr
     setrestart の受け入れ可能な最も短い省略形です。

   machine name
     サーバー・マシンを指定します。

   time to restart server
     BOS サーバーが自ら再始動するときを設定するか ( -general フラグと結合した場合)、または新規バイナリー・ファイルによりどれかのプロセスを設定します (-newbinary フラグと結合した場合)。以下の値のいずれかを指定します。
     - 文字列 never。指示されたタイプの再始動を実行しないように BOS サーバーに指示します。
     - 時刻 (バイナリー開始時の一般的なタイプの値)。時間と分をコロンで分離して (hh:MM)、24 時間形式を使用するか、または am または pm を追加して 1:00 から 12:59 までの範囲の値を使用します。たとえば、14:30 と "2:30 pm" は両方とも午後 2 時半を示します。スペースが含まれる場合には、このパラメーターを二重引用符 (" ") で囲います。
     - 曜日と時刻。スペースで分離して二重引用符 (" ") で囲います。一般的な再始動の値を示すための標準的なタイプです。曜日には、名前全体または最初の 3 文字を使用し、すべてを小文字で表示します (sunday または sun, thursday または thuなど)。時刻では、時刻だけを指定するときと同じ形式を使用します。

     希望する場合、時刻または日と時刻定義の前に、文字列 every または at を使用します。これらのワードを使っても意味は変化しませんが、bos getrestart コマンドの出力が理解しやすくなります。

     注: | 指定した時刻が現在の時刻の 1 時間以内の場合には、BOS サーバーは、次の適切な時刻まで再始動を実行しません (時刻の場合には翌日または日と時刻の場合には翌週)。

   -general
     BOS サーバーが自ら再始動するときの一般的な再始動時を設定します。

   -newbinary
     新規バイナリー・ファイルによるプロセスの再始動時を設定します。

## サーバー・プロセス・ログ・ファイル表示する

各ファイル・サーバー・マシンの /usr/afs/logs ディレクトリーは、いくつかの AFS サーバー・プロセスの通常のオペレーションの際に起こる興味深い事象について説明するログ・ファイルを含みます。ログ・ファイルの自明の情報は、プロセスの障害、およびその他の問題を評価するのに役立ちます。ログ・ファイルをリモートで表示するには、bos getlog コマンドを使用します。サーバー・マシンに接続を確立して、テキスト・エディターまたはその他のファイル表示プログラム (たとえば、cat コマンド) を使用することもできます。

注: | データベース・サーバー・プロセスを定期的に終了して再始動しない場合は、ログ・ファイルが、管理できなくなるほど大きくなる可能性があります (たとえば、一般再始動時を使用不可にする場合)。この場合には、UNIX rm コマンドを定期的に発行して現在のログ・ファイルを削除するようにします。サーバー・プロセスは、必要に応じて新しいものを自動的に作成します。

### サーバー・プロセス・ログ・ファイルを検査する方法

1. ユーザーが、/usr/afs/etc/UserList ファイルにリストされているかどうかを検証する。必要な場合には、bos listusers コマンドを発行します。このコマンドについては、UserList ファイルのユーザーの表示で詳しく説明しています。

          % bos listusers <machine name>

2. bos getlog コマンドを発行してログ・ファイルを表示します。

          % bos getlog  <machine name>  <log file to examine>

   ここで、

   getl
     getlog の受け入れ可能な最も短い省略形です。

   machine name
     ログ・ファイルを表示するサーバー・マシンを指定します。

   log file to examine
     表示するログ・ファイルの名前を指定します。次のファイル名の 1 つを設定して、指示されたログ・ファイルを /usr/afs/logs ディレクトリーから表示します。
     - AuthLog 認証サーバー・ログ・ファイル用
     - BackupLog バックアップ・サーバー・ログ・ファイル
     - BosLog BOS サーバー・ログ・ファイル用
     - FileLog ファイル・サーバー・ログ・ファイル用
     - SalvageLogサルベージャー・ログ・ファイル用
     - VLLog ボリューム・ロケーション (VL) サーバー・ログ・ファイル用
     - VolserLog ボリューム・サーバー・ログ・ファイル用

     完全パス名または相対パス名を指定すると、別のディレクトリーからファイルを表示することができます。相対パス名は、 /usr/afs/logs ディレクトリーの相対パスと解釈されます。

[ ページのトップ | 前ページ | 次ページ | 目次 | 索引 ]

(C) IBM Corporation 2000. All Rights Reserved