UNIX または Linux 上でエージェントのトラブルシューティングを行うには、以下の手順を実行します。
- シェルから bfagent を実行します。正常な応答は、以下のようなメッセージなります。
200 HELLO - Build Forge Agent v7.0.1.122
この例と同じようなメッセージを受け取る場合に、共有ライブラリーに関する問題があるときは、それらの問題に関するメッセージを受け取ります。
パスを正しく設定することで、共有ライブラリーに関する問題の大部分を解決することができます。
- エージェントが listen していることを確認します。以下のコマンドを使用します (ポートがデフォルトの 5555 であることを想定)。
telnet localhost 5555
200 HELLO という応答は、エージェントが listen していることを示します。この応答が返されない場合は、システムのネットワーク構成を確認してください。
inetd 構成が正しいかを検査するか、または Linux あるいは UNIX のシステム管理者に相談してください。
- 認証を確認します。ログイン資格情報を使用して、以下のコマンドを発行します。
telnet localhost 5555
username <user name>
password <password>
cmd ping
go
以下のようなメッセージは、認証が正常に行われていることを示しています。
AUTH: set user account to <user name>
上記のテストが動作してもビルドが失敗し、サーバーのテストによってユーザー認証エラーが表示される場合、プラグ可能認証モジュール (PAM) 構成を確認します。以下のようなメッセージが表示される場合、次の手順に進みます。AUTH: unable to set user account to user name: unknown account (1)
- PAM 構成を確認します。PAM 構成の問題は、AIX® プラットフォームでよくある問題です。使用するオペレーティング・システムによって、PAM は、pam.conf ファイル内の行を使用するか、あるいは pam.d ディレクトリー内のファイルを使用する 2 つの方法のいずれかで構成されています。
ヒント: (Solaris 10 には、以下の手順は適用されません。)
pam_dial_auth のモジュールを指定する行 (例えば
pam_dial_auth.so.1) をすべて削除してください。
このモジュールが含まれていると、エージェント認証が機能しません。
- /etc/pam.conf が存在することを確認します。存在しない場合、このトピックの後の方にある pam.d についての説明に進みます。ファイルが存在する場合、次のステップに進みます。
- ファイル内に bfagent の項目を作成します。
- sshd または login などの別のアプリケーションについての行をコピーし、[application] フィールドを bfagent に置換します。
[application] [when] [mode] [module]
これらのフィールドは、以下のとおりです。
- PAM 項目をセットアップした後、ステップ 3 の説明に従って再びログインします。
- 詳しくは、PAM の資料を参照してください。
- pam.d 内に構成済みの PAM のトラブルシューティングを行うには、以下の手順を実行します。
- /etc/pam.d ディレクトリーを見つけ、それぞれがアプリケーションの名前を持つ複数のファイルが格納されていることを確認します。各ファイル内で、各行は以下のようにフォーマット設定されています。
[when] [mode] [module]
- sshd または login など、別のアプリケーションからファイルをコピーし、bfagent に名前変更します。
- PAM 項目をセットアップした後、ステップ 3 の説明に従って再びログインします。
- 詳しくは、http://www.sun.com/software/solaris/pam/ にある PAM の資料を参照してください。