WebSphere Application Server での Jython スクリプト・ファイルのデバッグ

Jython スクリプト内のエラーの検出および診断をデバッガーを使用して行うことができます。ブレークポイントの設定、スレッドの一時停止、コードのステップスルー、および変数内容の検査によって、スクリプトの実行を制御できます。Jython スクリプトをデバッグするためには、WebSphere® Application Server 管理スクリプト・ランチャーを使用して、スクリプトを解釈するためのランタイム環境をセットアップし、そのスクリプトがセキュア・サーバーに対して実行される場合にはセキュリティー設定もセットアップします。

始める前に

制約事項: Jython スクリプト・ファイルのデバッグ用にサポートされているランタイム環境は、WebSphere Application Server v6.1 以降のみです。ただし、Jython スクリプト・ファイルを実行する場合は、デバッグの場合とは異なり、サポートされるランタイム環境がほかにいくつかあります。詳しくは、『WebSphere Application Server 上での管理スクリプト・ファイルの実行』を参照してください。
ヒント: Jython スクリプト の実行とデバッグの違いは、Jython スクリプトのデバッグではスクリプト内に ブレークポイントを設定できるのに対して、Jython スクリプトの実行では 割り込みなしでスクリプトを実行するということです。
制約事項: Jython スクリプトを デバッグするには、ワークベンチ内に Jython スクリプトを作成 またはインポートすることによって、Jython スクリプトがワークベンチ内に存在している必要があります。ファイル・システムに配置された Jython スクリプトの実行とは異なり、Jython スクリプトのデバッグはワークベンチ内で行う必要があります。ブレークポイントを設定するブレークポイント・マージンなどのデバッグ・ツールは、 ワークベンチの外部であるファイル・システム上で Jython スクリプトをデバッグするときには使用できません。

このタスクについて

Jython スクリプトをデバッグするには、次の手順に従います。

手順

  1. Jython エディターで Jython スクリプト・ファイルを開きます。
    1. 「ナビゲーター」ビューで、デバッグする Jython スクリプト・ファイルを含んでいる Jython プロジェクトを展開します。
    2. Jython スクリプト・ファイルを右クリックします。
    3. メニューで、「アプリケーションから開く」 > 「Jython エディター」と選択します。
  2. Jython スクリプトにブレークポイントを設定します。 Jython エディターで 1 つ以上のブレークポイントを設定するには、 ブレークポイントとして設定するコード行の横の余白をダブルクリックします。
  3. Jython エディターで、右クリックし、メニューから「デバッグ」 > 「管理スクリプト」と選択します。 WebSphere Application Server 管理スクリプト・ランチャーが開きます。WebSphere Application Server 管理スクリプト・ランチャーを使用して、開発環境内から WebSphere Application Server 上の管理スクリプト・ファイルをデバッグします。
  4. 「スクリプト」ページは、WebSphere Application Server 管理スクリプト・ランチャーのメインページです。
  5. 「管理スクリプト」フィールドには、スクリプト・ファイルへのパスが自動的に事前入力されています。
  6. 「スクリプト・ランタイム環境」リストで、「設定」ページ (「ウィンドウ」 > 「設定」 > 「サーバー」 > 「ランタイム環境」) で定義されている WebSphere Application Server ランタイム環境の名前を選択します。 スクリプト・ファイルを解釈するためには、ローカル・ファイル・システムに あるランタイム環境を指定する必要があります。スクリプト・ファイルを解釈するために使用したい ランタイム環境がリスト内で選択できない場合は、新規 WebSphere Application Server ランタイム環境を定義するため、「新規」をクリックします。「新規サーバー・ランタイム環境」ウィザード が開きます。「新規サーバー・ランタイム環境」ウィザードでは、任意のランタイム環境を作成することができます。ただし、 Jython スクリプトをデバッグするために WebSphere Application Server 管理スクリプト・ランチャーを使用する場合、デバッグ用にサポートされているのは、 WebSphere Application Server v6.1 以降のローカルなランタイム環境のみです。
  7. 「プロファイル名」リストで、先に選択したランタイム環境に属すプロファイルを選択します。 プロファイル は、ランタイム環境を定義するファイルのセットです。 「[未指定]」オプションを選択した場合、 ツールはデフォルトの役割が割り当てられたプロファイルを選択します。
  8. 「wsadmin 引数」フィールドに、wsadmin スクリプト・クライアントの拡張コマンド行呼び出し構文を指定します。 コマンド行呼び出し構文のリファレンスは、 WebSphere Application 資料で提供されています。詳しくは、「Wsadmin ツール」トピックを参照してください。 この WebSphere Application Server 管理スクリプト・ランチャーは、wsadmin スクリプト・クライアントに渡された以下の情報を既に扱っています。
    • スクリプト・ファイルのファイル名とパス
    • スクリプト・ファイルの言語
    • スクリプト・ファイルの実行に使用される WebSphere Application Server プロファイルの名前
    • ターゲットのセキュア・サーバーの認証に使用されるユーザー ID とパスワード
    これらの情報は、「wsadmin 引数」フィールドに再度指定することのないようにしてください。

    管理スクリプトをリモート・サーバーに対して実行する場合は、リモート・メソッド呼び出し (RMI) または SOAP 接続タイプのどちらを使用するかを指定し、ポート値も指定します。リモート・サーバーでセキュリティーが有効にされている場合は、 -user および -password パラメーターを指定します。 「wsadmin 引数」フィールドで、次のコマンド構文のいずれかを使用します。

    • SOAP 接続タイプ:
      -conntype SOAP [-host host_name] [-port port_number] [-user userid] [-password password]

      例 : -conntype SOAP -host mycomputer.mycompany.com -port 8800 -user myUserID -password myPassword

    • RMI 接続タイプ:
      -conntype RMI [-host host_name] [-port port_number] [-user userid] [-password password]

      例 : -conntype RMI -host mycomputer.mycompany.com -port 2809 -user myUserID -password myPassword

    ヒント: Jython スクリプトに引数を渡す場合は、この 「wsadmin 引数」フィールドには指定しないでください。このフィールドは、wsadmin スクリプト・クライアントのターゲットです。 代わりに、「引数」ページを選択し、 「プログラムの引数」テキスト・ボックスにプログラム引数を指定してください。
    注: Jython スクリプトを実行するためにプログラム引数を指定する必要が ある場合、先頭のプログラム・パラメーターは Jython スクリプトのデバッグ時と実行時とでは異なる目的で 使用されることに注意してください。
  9. 「セキュリティー」セクションで、以下のいずれかのオプションを選択して、スクリプトを実行する対象のサーバーがセキュア・サーバーであるかどうかを指定します。
    オプション 説明
    ターゲット・サーバーのセキュリティーなし 保護されていないサーバーに対してスクリプトを実行することを指定します。
    soap.client.props または sas.client.props ファイル内の定義どおり

    保護された WebSphere Application Server に対してスクリプトを実行することを指定します。このセキュア・サーバーと通信するための認証情報は、sas.client.props または soap.client.props ファイルに指定されています。

    sas.client.props ファイルおよび soap.client.props ファイルは、各 WebSphere Application Server プロファイルの properties ディレクトリーにあります (例えば、x:/profilePath/properties)。

    リモート・メソッド呼び出し (RMI) コネクターを使用する場合は、sas.client.props ファイル内の以下のプロパティーに適切な値を設定します。

    com.ibm.CORBA.loginUserid=
    com.ibm.CORBA.loginPassword=
    また、以下のプロパティーも設定します。
    com.ibm.CORBA.loginSource=properties
    このプロパティーのデフォルト値は、sas.client.props ファイル内では prompt です。デフォルト値のままにすると、パスワード・プロンプトのダイアログ・ボックスが表示されます。スクリプトを不在環境で実行していると、停止しているように見えます。
    Simple Object Access Protocol (SOAP) コネクターを使用する場合は、soap.client.props ファイル内の以下のプロパティーに適切な値を設定します。
    com.ibm.SOAP.securityEnabled=true
    com.ibm.SOAP.loginUserid=
    com.ibm.SOAP.loginPassword=
    オプションで、以下のプロパティーも設定します。
    com.ibm.SOAP.loginSource=none
    このプロパティーのデフォルト値は、soap.client.props ファイルにあります。 デフォルト値を受け入れて、loginUserid および loginPassword の値を指定しない場合は、パスワード・プロンプトのダイアログ・ボックスが表示されます。 スクリプトを不在環境で実行していると、停止しているように見えます。
    注: 「指定」セクションおよび sas.client.props ファイル または soap.client.props ファイルにユーザーとパスワードを指定すると、WebSphere Application Server 管理 スクリプト・ランチャーは .props ファイル内の情報をオーバーライドします。
    指定 保護されたサーバーに対してスクリプトを実行することを指定します。

    「ユーザー ID」フィールドと「パスワード」フィールドで、このターゲット・セキュア・サーバーへの認証を行うユーザー ID とパスワードを入力します。

    このセクションおよび sas.client.props ファイルまたは soap.client.props ファイルにユーザー ID とパスワード情報を指定すると、WebSphere Application Server 管理スクリプト・ランチャーは .props ファイル内の情報をオーバーライドします。

    重要: 「パスワード」フィールドを使用した場合、他のユーザーが開始してすべての実行中のプロセスを表示できる ps コマンドなどのシステム状況プログラムに対して、パスワード情報が可視になるため、機密漏れが生じる可能性があります。 機密漏れの恐れがある場合には、このオプションは使用しないでください。代わりに、 「soap.client.props または sas.client props ファイル内の定義どおり」 を選択し、 soap.client.props ファイル (SOAP コネクターの場合) または sas.client.props ファイル (RMI コネクターの場合) に、ユーザー ID とパスワードの情報を指定します。soap.client.props ファイルおよび sas.client.props ファイルは、WebSphere Application Server プロファイルの properties ディレクトリーにあります。
  10. 「適用」をクリックして、構成を保存します。 選択した WebSphere Application Server ランタイム環境に適した VM 引数およびクラスパスが自動的に設定されます。
    ヒント: 「スクリプト・ランタイム環境」リストの選択を変更した場合は、変更ごとに「適用」をクリックして、新しく選択した WebSphere Application Server ランタイム環境用の正しい VM 引数およびクラスパスが自動的に設定されるようにしてください。
  11. Jython エディターで設定した (前のステップで指定した) ブレークポイントがあることを確認します。 ブレークポイントがない場合、デバッグ・セッションは完了まで実行されます。
  12. スクリプトをデバッグするために「デバッグ」をクリックします。 「デバッグ」パースペクティブが開きます。

次のタスク

Jython スクリプト上に設定されたブレークポイントでデバッガーが中断され、「デバッグ」パースペクティブでそのスクリプトの詳細なデバッグを行えます。
トピックのタイプを示すアイコン タスクのトピック
インフォメーション・センターのご利用条件 | フィードバック

タイム・スタンプ・アイコン 最終更新: May 29, 2014 10:20

ファイル名: tjythondebug.html