サーバー制御パブリッシングのトラブルシューティング
worker スクリプトに関する問題をトラブルシューティングするには、まず以下のことを確認する必要があります。
• アダプタまたは Worker が正しくインストールされ、設定されている。
• Worker が Visualization サーバーの Worker Agent と通信するように設定されている。
• Worker Agent がリモートで Worker を正しく起動するように設定されている。
• Worker が変換を正しく実行するように設定されている。
以下の手順を順序どおりに実行します。
1. Worker Agent 設定でアダプタを実行するように設定されたユーザーとして Worker マシンにログオンします。新しいコマンドシェルを開始し、ディレクトリを <setup_directory> に変更し、以下のコマンドを実行します。
<batch_script> -vl worker_test.log -I
|
|
上記のコマンドを実行する前に、特別な起動スクリプトを実行しないでください。Worker スクリプトの実行前に Worker Agent が起動スクリプトを実行することはありません。batch スクリプトを作成しなかった場合は config ツールを使用してこのスクリプトを生成します。
|
このコマンドは、アダプタを実行してバージョン情報を新しい worker_test.log ファイルに印刷しようとします。このファイルが作成されたこと、およびこのファイルに約 15 のライブラリバージョンのリストが含まれていることを確認します。以下の問題が発生する可能性があります。
◦ ユーザーファイルのアクセス許可に関する問題により、アダプタがログファイルを作成し直すことができないことがあります。
◦ ディスクの空き容量が非常に不足している場合は、ログファイルを作成できません。
◦ インストールが壊れている場合、スクリプトで必要なソフトウェアコンポーネントを検索したり、それらを実行するためのアクセス許可を持つことができない場合があります。
通常、これらの問題はコマンドラインですぐに報告され、ログファイルは作成されません。問題を防ぐには、以下の条件が満たされていることを確認する必要があります。
◦ ディスクの空き容量が十分にある。
◦ すべてのコンポーネントとディレクトリに適切なアクセス許可が存在する。
◦ インストールが壊れていない。必要に応じてアダプタを再インストールしてください。
詳細については、この章の「コマンドラインパブリッシングのトラブルシューティング」セクションを参照してください。
2. ステップ 1 の項目が正常に行われた後、Worker が Worker Agent と通信できることを確認します。そのためには、同じコマンドシェルで以下のコマンドを実行します。
<worker_script>
このコマンドは、Worker Agent への接続を試み、指示を待ちます。以下の問題が発生する可能性があります。
◦ 設定が Worker Agent を正しくポイントしない場合があります。
◦ Worker Agent が Worker を認識しない場合があります。
v8.0 以降の Visualization サーバーの場合:
設定に関する問題がある場合は、monitor_#.log ログファイルでエラーが報告されます。このログファイルには、通常以下のメッセージのいずれかが含まれます。
Connecting to server "<server_name>" on port <server_port>
Failed to establish connection to client. <further details>.
このメッセージは、worker に間違ったサーバー情報が含まれていることが原因である可能性があります。Worker Agent のマシン名とポートを確認し config ツールを使用してエラーを修正してください。
Connecting to server "<server_name>" on port <server_port>
Connection established
Got version 8 INIT FAILURE (with no description) from WVS.
このメッセージは、Worker Agent が正しく設定されておらず、Worker との通信を拒否していることを意味します。この問題を修正する方法の詳細については、
Visualization サーバーの定義を参照してください。
Connecting to server "<server_name>" on port <server_port>
Connection established
Got INIT SUCCESS reply
このメッセージは、接続に成功したこと、および Worker と Worker Agent の両方の設定が正しいことを意味します。
すべてが正しく機能しているときは、worker スクリプトの実行が継続され、それが停止するまではコマンドシェルへの出力はありません。
|
|
config ツールにはテストサーバー機能があり、サーバー設定の確認に使用できます。
|
v8.0 以前の Visualization サーバーの場合:
設定に関する問題がある場合は、helper_#.log ログファイルでエラーが報告されます。このログファイルには、通常以下のメッセージのいずれかが含まれます。
Invalid hostname "-CS<server_name>".
または
Connecting to server "<server_name>" on port <server_port>
Could not connect to server at port <server_port> on host "<server_name>". <further details>.
このメッセージは、worker のサーバー情報が間違っていることが原因である可能性があります。Worker Agent のマシン名とポートを確認し config ツールを使用してエラーを修正してください。
Connecting to server "<server_name>" on port <server_port>
Connection established
Started worker
Worker has connected.
Helper: Connection to server has been rejected. Shutting down...
このメッセージは、Worker Agent が正しく設定されておらず、Worker との通信を拒否していることを意味します。この問題を修正する方法の詳細については、
Visualization サーバーの定義を参照してください。
Connecting to server "<server_name>" on port <server_port>
Connection established
Started worker
Worker has connected.
このメッセージは前述のメッセージと同じですが、エラーメッセージは含まれていません。Visualization サーバーが接続を拒否しなかったことを意味します。Worker が受け入れられたことを確認するには、Worker Agent の Worker ページで Worker に開始済みのフラグが付いていることを確認します。フラグが付いていない場合は、Worker Agent は正しく設定されていません。
すべてが正しく機能しているときは、worker スクリプトの実行が継続され、それが停止するまではコマンドシェルへの出力はありません。
3. Worker と Worker Agent 間の通信が起動していることを確認した後、リモート実行での問題をチェックできます。問題の原因となる可能性のある項目は次のとおりです。
◦ Windows マシンで Worker デーモンがサービスとしてインストールされていないか、実行されていない。
◦ UNIX マシンで、telnet サービスが有効になっていない。
◦ Worker Agent の設定が間違っている。
◦ アダプタにより表示へのアクセスが要求されているが、許可されていない。
◦ Windows マシンで、インストールの一部がサービスがアクセスできないネットワークドライブ上にある。
Windows マシン上で、Worker インストールがネットワークドライブにないことを確認します。Worker がサーバーとは異なる Windows マシンで実行されている場合は、Worker デーモンが正しくインストールされており、実行されていること、および接続に使用しているポートがわかっていることを確認します。これは、セットアッププログラムページの「Worker デーモンオプションを選択」(Select Worker Daemon Options) を使用して行います。Worker デーモンが開始されたかどうかが不明な場合は、コンピュータのコンピュータ管理ツールでサービスを確認します。
UNIX マシンでは、Visualization サーバー上でコマンドシェルから telnet を実行することにより、Worker マシンに telnet 接続します。ログオンするために正しいユーザー名とパスワードがあることを確認します。
この接続が確立された後、Worker マシンはリモート実行コマンドを受け入れたり、Worker Agent の設定を調べ、ホスト、ポート、ユーザー名、パスワードが正しいことを確認したりできます。すべての詳細が正しく設定された場合は、Visualization サーバーからリモートで worker を開始できます。
Worker が正しく開始されると、<setup_directory> に以下のログファイルが表示されます。
◦ helper_#.log - workerhelper プログラムで作成されたログファイル。
◦ worker_#.log - アダプタで作成されたログファイル。
Worker が開始されない場合は、これらのログファイルを調べてエラーメッセージを確認し、報告されたエラーを修正してから、再試行します。診断が難しい一般的な問題の 1 つは、表示にアクセスすることをアダプタが要求することです。これに対処するには、以下のいずれかを選択します。
◦ UNIX では、worker スクリプトの冒頭に以下の行を追加します。
setenv DISPLAY :0.0
◦ Windows では、Worker デーモンに対して LogOn 設定の「デスクトップとの対話をサービスに許可」(Allow service to interact with the desktop) を有効にします。
4. Worker を開始できるようになったら、単純なファイルをパブリッシングして Worker が正しく動作していることを確認します。Worker でファイルのパブリッシングに失敗した場合は、データを Worker マシンにコピーし、batch スクリプトを使用してコマンドラインでデータを変換します。通常、変換の失敗は、batch スクリプトを使用して再現できます。これで問題を再現できた場合は、「コマンドラインパブリッシングのトラブルシューティング」セクションを参照して、この問題を修正してください。Windchill の場合は、Worker が動作を開始したら、Worker Agent テストを使用して、Worker にテストファイルを送信する必要があります。これが正常に行われた後、Windchill にあるデータをパブリッシングします。
まだ問題がある場合は、テクニカルサポートにお問い合わせください。
