# 管理解説書

## bos status

目的

サーバー・プロセスの状況を表示します。

構文

    bos status -server <machine name>  [-instance <server process name>+]
               [-long]  [-cell <cell name>]  [-noauth]  [-localauth]  [-help]

    bos stat -s <machine name>  [-i <server process name>+]
             [-lon]  [-c <cell name>]  [-n]  [-loc]  [-h]

構文

bos status コマンドは、-server 引き数で指定されたサーバー・マシン上の次のいずれかのプロセスの状況を表示します。

- /usr/afs/local/BosConfig ファイルにリストされるすべての AFS サーバー・プロセス。
- -instance 引き数に指定されたプロセス

オプション

-server
  サーバー・プロセス状況を表示するサーバー・マシンを指定します。 IP アドレスまたはホスト名 (完全修飾名または省略形) によってマシンを識別します。詳細については、bos コマンド・セットの概要の解説ページを参照してください。

-instance
  状況を表示するプロセス名を指定します。 bos コマンドの -instance 引き数に割り当てたプロセス名を使用してください。bos status コマンドの出力には、この名前がリストされます。

-long
  詳しい状況情報を表示します。

-cell
  コマンドを実行するセルを指定します。この引き数は、 -localauth フラグと一緒に使用してはなりません。詳細については、bos の解説ページを参照してください。

-noauth
  コマンドの発行側に非特権 ID anonymous を割り当てます。このフラグは -localauth フラグと一緒に使用してはなりません。詳細については、bos の解説ページを参照してください。

-localauth
  ローカルの /usr/afs/etc/KeyFile ファイルのキーを使用して、サーバー・チケットを構成します。 bos コマンド・インタープリターは、相互認証中に、このチケットを BOS サーバーに渡します。このフラグは、-cell 引き数または -noauth フラグと一緒に使用してはなりません。詳細については、bos の解説ページを参照してください。

-help
  このコマンドのオンライン・ヘルプを出力します。これ以外の有効なオプションはすべて無視されます。

出力

プロセスの出力には、プロセスの現状として次のように少なくとも 1 行の情報が表示されます。

- 「`現在、正常に実行しています (currently running normally)`」。BosConfigファイルのプロセス状況は、`Run` です。cron 項目の場合、このメッセージは、コマンドが実行予定であり、bos status コマンドの発行時に実行されたとは限らないことを意味しています。
- 「`使用不可 (disabled)`」。プロセスを実行していませんが、BosConfig 状況フラグは `NotRun` です。
- 「`一時的に使用不可 (temporarily disabled)`」。BosConfig ファイルの状況フラグが `Run` であるにもかかわらず、このプロセスが実行されていません。管理者が bos shutdown コマンドを使用して停止したか、
- あるいは、BOS サーバー が何度も失敗して、再起動を中止しています。 2 番目の場合、「`エラーが多過ぎて停止しました (stopped for too many errors)`」 という補助メッセージが表示されます。
- 「`一時的に使用可能 (temporarily enabled)`」。BosConfig ファイルの状況フラグが `NotRun` であるにもかかわらず、このプロセスが実行されています。管理者が、bos startup コマンドを使用して開始しています。

次のいずれかの環境が適用される場合、該当する項目がメッセージに表示されます。

- 「`コア・ファイルを作成しました (has core file)`」。プロセスが失敗して、/usr/afs/logs ディレクトリーにコア・ファイルが作成されています。 BOS サーバー が失敗後にプロセスを再起動できた場合、基本状況は、「`現在、正常に実行しています (currently running normally)`」 となります。
- 「`エラーが多過ぎて停止しました (stopped for too many errors)`」。「`一時的に使用不可 (temporarily disabled)`」 という基本状況が表示される理由は、 BOS サーバーが失敗したすべてのプロセスを再起動しようしたからです。

fs プロセスの項目には、プロセスの `補助状況` を報告する 2 番目の行が含まれます。この行は次の 1 つになります。

- 「`ファイル・サーバーが実行しています (file server running)`」。ファイル・サーバー・プロセスのファイル・サーバーおよびボリューム・サーバー・コンポーネントが正常に実行されています。
- 「`ファイル・システムをサルベージしています (salvaging file system)`」。サルベージャーが実行されているため、ファイル・サーバーおよびボリューム・サーバーは一時的に使用できません。BOS サーバーは、サルベージャーが終了するとすぐに再起動します。

cron プロセスの項目には、 `補助状況` があり、コマンドが次に実行される時刻が示されます。

-long フラグが指定されている場合、次の追加情報が各項目に示されます。

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

-long フラグが指定され、 BOS サーバーがローカルの /usr/afs ディレクトリーのファイルおよびサブディレクトリーのモード・ビットが予想値とは異なることを認識すると、次の警告メッセージを出力します。

    「BOS サーバーがサーバー・ディレクトリー上の不適切なアクセスをレポートします
     (Bosserver reports inappropriate access on server directories)」

以下の図表は、予想されるモード・ビットの設定を要約です。疑問符 (?) は、BOS サーバーが検査しないビットであることを示しています。

/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 のプロセス状況を表示しています。

       % bos status fs3.example.com
       Instance buserver, currently running normally.
       Instance kaserver, currently running normally.
       Instance ptserver, currently running normally.
       Instance vlserver, currently running normally.
       Instance fs, has core file, currently running normally.
           Auxiliary status is: file server running.
       Instance upserver, currently running normally.
       Instance runntp, currently running normally.

次のコマンドは、マシン fs1.example.com の fs および ptserver プロセスの詳しい状況を表示しています。

       % bos status -server fs1.example.com -instance fs ptserver -long
       Instance fs, (type is fs), currently running normally.
          Auxiliary status is: file server running.
          Process last started at Wed Jan 7 5:34:49 1998 (3 proc starts)
          Last exit at Wed Jan 7 5:34:49 1998
          Last error exit at Wed Jan 7 5:34:49 1998, 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'
       Instance ptserver, (type is simple) currently running normally.
          Process last started at Tue Jan 6 8:29:19 1998 (1 proc starts)
          Command 1 is '/usr/afs/bin/ptserver'

必要となる特権

なし。

関連情報

BosConfig

KeyFile

bos

bos create

bos shutdown

bos startup

bos status

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

(C) IBM Corporation 2000. All Rights Reserved