JIRA アプリケーションを IIS と統合する

JIRA アプリケーションを Web サーバーに統合する

このページの内容

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

このページの内容は、JIRA でサポートされていないプラットフォームに関連しています。したがって、アトラシアンは、そのためのサポートの提供を保証できません 。この資料は情報提供のみを目的としているため、お客様自身の責任でご使用ください。

このページでは、ユーザーからのリクエストをマイクロソフトの IIS ウェブサーバーが JIRA に引き渡し、またそれに対する応答を IIS がユーザーに返すように、IIS および JIRA を設定する方法について説明します。この説明は、お客様において既にウェブページ (例えば、http://mycompany.com) を提供する IIS が稼働中であり、かつ JIRA を少しだけ異なる URL (例えば、http://mycompany.com/jira) に統合する場合に有用です。

JIRA は Java で記述されており、その実行には Java アプリケーションサーバー (サーブレットコンテナー) が必要です。IIS はJava アプリケーションサーバーとしての機能を提供していないため、JIRA を IIS に直接デプロイすることはできません。ただし、JIRA がデプロイされているアプリケーションサーバーのプロキシとして JIRA にリクエストを引き渡すように IIS を設定することは可能です。従って、お客様の主ウェブサイトが IIS 上で稼動している場合に JIRA をそのウェブサイトと統合することが可能になるのです。

JIRA をIIS と統合する際には、IIS との統合機能を提供しているJava アプリケーションサーバー (例えば Apache Tomcat) に JIRA をデプロイする必要があります。

JIRA がApache Tomcat 以外のアプリケーションサーバー上で稼動している場合、アプリケーションサーバーの IIS への統合の可否 (ならびにその方法) についてはそのアプリケーションサーバーの説明書を参照してください。

JIRA を IIS に統合する手順は以下の通りです :

  1. JIRA の設定と動作テスト
  2. IIS からのプロキシを介したリクエストを受け入れるための Tomcat の設定
  3. JIRA リクエストを Tomcat に転送するための IIS の設定

1. JIRA の設定

  1. JIRA インストール ガイド」 に従って JIRA をインストール、設定します。なお、JIRA を IIS と同一のマシーンにインストールすることができますが、このことは必須ではありません。
  2. Change the context path of the JIRA web application:
    To allow IIS to proxy requests to JIRA, JIRA web application must be deployed with a context path (e.g. the /jira in http://localhost:8080/jira (http://localhost:8080*/jira*)) in Tomcat. The context path must be set to the path in the URL that IIS will use to proxy requests. For example, if your website is running with address www.example.com in IIS, and you would like to make JIRA available under www.example.com/jira, you will need to set JIRA's context path to "/jira" in Tomcat.
    To do this, edit the conf/server.xml file. Change the path attribute of the Context element to "/jira".

  3. コンテキストパス修正後、JIRA を再起動します。 コンテキストパスを含むように
  4. 「ベース URL」を設定して、コンテキストパスを読み込みます。(JIRA オプションの設定をご参照下さい。)
  5. (プロキシを実現すると、 ‪GZip‬ 圧縮の効力がなくなるため) JIRA の Gzip 圧縮をオフにします。
  6. ウェブブラウザーにおいて Tomcat を直接ポイントし (例えば http://localhost:8080/jira)、JIRA セットアップウィザードを最後まで実行して JIRA が正しく動作することを確認するテストを行います。以前にセットアップウィザードを実行済みの場合は、課題の作成や編集を代わりのテストとします。エラーが全く起こらないことを確認してください。

2. プロキシされたリクエストを受け入れるための Tomcat の設定

HTTP/1.1 Connector

If you are using the HTTP/1.1 Connector, you will need to add the following attributes to the Connector port in Tomcat's server.xml:

proxyName="mycompany.com" proxyPort="80"

参考として Integrating JIRA with Apache をご覧ください。

  1. Enable AJP/1.3 Connector in Tomcat: To allow Tomcat to accept requests for JIRA from IIS, edit the conf/server.xml file and ensure that the AJP/1.3 Connector is enabled (i.e. not commented out). To enable the AJP/1.3 Connector in a JIRA remove the comment symbols around the following section in the conf/server.xml file:

    <Connector port="8009" enableLookups="false" redirectPort="8443" protocol="AJP/1.3" />          

    The above example configures Tomcat to listen for proxied IIS requests on port 8009. If this port is already in use on the machine where JIRA is running, please change to another port.

  2. Tomcat を再起動し、使用したポートに関連するエラーがログにもコンソールの表示にも現れないことを確認してください。
  3. Ensure that the AJP Connector is listening on the specified port (8009 by default). One way to do this is to use the "netstat -na" command in the command window and see if port 8009 is listed in the output:

3. JIRA にリクエストを送るための IIS の設定

IIS がデプロイされているマシーンにおいて、次の手順を実行します :

  1. Apache のサイトから ISAPI Redirect DLL をダウンロードします。ダウンロードの際には、IIS が実行されている Windows のバージョン (Win32 または Win64) を選択し、次に利用可能な jk の中の最新バージョンを選択します

    ダウンロードするファイルの名称は isapi_redirect_X.X.X.dll となっており、ここで 'X.X.X' はバージョン番号です。このバージョン番号は DLL ファイル名から除去する必要があります (即ち、ファイル名を isapi_redirect.dll としなければなりません)。

  2. Place the DLL and the associated properties files in an installation directory. For the purpose of this document, we will assume the directory is C:\tomcat_iis_connector. Place the isapi_redirect.dll in this directory. Then download the isapi_redirect.properties file and place this in the same directory as the isapi_redirect.dll file.
  3. Create a directory called 'conf' in your installation directory (C:\tomcat_iis_connector\conf). Download the files uriworkermap.properties and workers.properties.minimal and place them in the C:\tomcat_iis_connector\conf directory.
  4. Create a directory called 'logs' (C:\tomcat_iis_connector\logs). This is where the logs associated with the isapi_redirect.dll execution will be placed.
  5. In the "C:\tomcat_iis_connector" directory you may need to modify the isapi_redirect.properties file. The isapi_redirect.propertiesfile tells the connector where to find its configuration files and where the DLL can be found in relation to the IIS server. There are 5 properties in this file:
    1. extension_uri — isapi_redirect.dll が保存されている仮想ディレクトリのパスです
    2. log_file — ログファイルに書き込みを行うときのパスです
    3. log_level — ログを生成する際のログレベルです
    4. worker_file — the path to your workers.properties.minimal file in your installation
    5. worker_mount_file — the path to your uriworkermap.propertiesl file in your installation.
      If you are installing the connector in C:\tomcat_iis_connector and you follow the instructions below about setting up the virtual directory for the isapi_redirect.dll, then you should not have to change any properties in the provided file.
  6. In the "C:\tomcat_iis_connector\conf" directory you may need to modify the uriworkermap.properties and the workers.properties.minimalfiles.

    これらのファイルは、ここで説明した設定変更内容を記録しており、このドキュメントに従って最後まで作業した場合はそのままで正しく動作します。このドキュメントとは異なる作業を行った場合、以下の手順でこれらのファイルを書き換える必要が生じます。

    The workers.properties.minimal file tells IIS where (IP address and port) Tomcat is running. The uriworkermap.properties tells IIS what requests to proxy to Tomcat.
    To edit these files:

    1. Edit the uriworkermap.propertiesand ensure that it contains the following mapping for JIRA. You do not need any other mappings.

      /jira/*=worker1             

      The mapping (e.g. /jira/) *must be the same as the context path that JIRA has been deployed with in Tomcat as described in the Configure JIRA section of this document.

    2. Edit the workers.properties.minimal file and modify the worker.ajp13w.host property if necessary. This property should be set to the host name or the IP address of the machine where Tomcat (with JIRA) is running. If Tomcat is running on the same machine as IIS then you can leave the property set to localhost. If you have specified a host name as the value of this property, please ensure that the IIS machine can correctly resolve it to the appropriate IP address.
    3. If you have modified the port for the AJP Connector you will need to modify the worker.ajp13w.portproperty. Here is an example of the file with Tomcat running on the same machine as IIS and using the default port (8009) for AJP:

      worker.list=worker1
      
      #
      # Defining a worker named worker1 and of type ajp13.
      # Note that the name and the type do not have to match.
      #
      worker.worker1.type=ajp13
      worker.worker1.host=localhost
      worker.worker1.port=8009
      
  7. Control Panel、続いて Administrative Tools を開き、さらに Internet Information Services. を開きます。
  8. IIS 7.0 の場合のみ : IIS 7.0 を使用している場合は、次の手順で必要なサービスロールである ISAPI Extensions および ISAPI Filtersをインストールしなければなりません :
    1. Start Menu > All Programs > Administration Tools > Service Manager と移動します。
    2. Server Manager > Roles から 'Web Server (IIS)' を選択します。
    3. 'Add Role Services' をクリックし、以降はウィザードに従って操作します。
  9. 以下の手順で IIS に ISAPI Filter を追加します :
    • IIS 6.0 以前の場合 :
      1. Default Web Site (または JIRA へのリクエストに対してプロキシの役割を持たせるウェブサイト) 上で右クリックし、Properties をクリックします。
      2. ISAPI Filters タブをクリックします。
      3. Check if there is a Filter that points to the isapi_redirect.dll file and that it is in the right location. If not, click Add and create one. Enter tomcat as the Filter Name and enter the location of the isapi_redirect.dll file for the executable.
      4. Apply、続いて OK をクリックします。
    • IIS 7.0 の場合 :
      1. Default Web Site (または JIRA へのリクエストに対してプロキシの役割を持たせるウェブサイト) 上で右クリックし、ISAPI Filters をクリックします。
      2. ISAPI Filters のアイコンをクリックします。
      3. Check if there is a Filter that points to the isapi_redirect.dll file and that it is in the right location. If not, click Add and create one. Enter tomcat as the Filter Name and enter the location of the isapi_redirect.dll file.
      4. OK をクリックします。
  10. IIS における JIRA の仮想ディレクトリを作成します。
    1. Default Web Site (または JIRA へのリクエストに対してプロキシの役割を持たせるウェブサイト) 上で右クリックし、New を選択、続いて Virtual Directory を選択します。
    2. Go through the creation wizard. Set the alias as the value of the Context Path (without slashes) that was set in the Configure JIRA section of this document (see above). In our example this is jira .
    3. この仮想ディレクトリは任意のディレクトリをポイントすることが可能です。
    4. ウィザードを完了します。

      The reason for creating a virtual directory is so that requests without the trailing slash still work. For example, if you are deploying JIRA under http://www.example.com/jira/ without the virtual directory, then requests to http://www.example.com/jira will fail.

  11. 次の手順に従って、IIS 内の isapi_redirect.dll にアクセスするための仮想ディレクトリを作成します :
    • IIS 6.0 以前の場合 :
      1. Default Web Site (または JIRA へのリクエストに対してプロキシの役割を持たせるウェブサイト) 上で右クリックし、New を選択、続いて Virtual Directory を選択します。
      2. Go through the creation wizard. Set the alias to be jakarta .
      3. This must point to the directory in which the isapi_redirect.dll is installed. In our example this is C:\tomcat_iis_connector.
      4. 'Execute' チェックボックスにチェックが入っていて Virtual Directory に対して 'Execute' パーミッションが付与されていることを確認してからウィザードを完了します。
    • IIS 7.0 の場合 :
      1. Default Web Site (または JIRA へのリクエストに対してプロキシの役割を持たせるウェブサイト) 上で右クリックし、Add Virtual Directory を選択します。
      2. Set the alias to be jakarta .
      3. Physical Path must point to the directory in which the isapi_redirect.dll is installed. In our example this is C:\tomcat_iis_connector.
      4. 'jakarta' 仮想ディレクトリをクリックし、'Handler Mappings' をダブルクリックします。
      5. 右側の Action パネルにある 'Edit Feature Permissions' をクリックします。
      6. 'Execute' パーミッションチェックボックスにチェックを入れます。

        This Virtual Directory is needed for the connector to work. The alias that you give the directory needs to be the same as the path set in the isapi_redirect.properties file, extension_uri property. In our example this value is: /jakarta/isapi_redirect.dll.

  12. IIS 6.0 または 7.0 を利用している場合、以下の手順に従って Web Service Extension として DLL を追加する必要があります。
    • IIS 6.0 の場合 :
      1. Web Service Extensions 上で右クリックし、Add a new Web Service Extension... を選択します。
      2. Enter tomcat for the Extension Name and then add the isapi_redirect.dll file to the required files.
      3. 拡張状況を許可に設定チェックボックスを選択して、OK ボタンをクリックします。
    • IIS 7.0 の場合 :
      1. サーバー群の中から該当のサーバーをハイライトします。
      2. 'ISAPI and CGI Restrictions' に移動します。
      3. isapi_redirect.dll 拡張を追加し、有効化します。
  13. ここで IIS Service を再起動する必要があります。これを行うには、Control Panel を開き、Administrative Tools をクリックし、さらに Services をクリックし、IIS Admin Service を探して restart をクリックします。
  14. You are done! To test the configuration, point your web browser at IIS and append JIRA's context path to the URL. For example, if your website is running under the address of http://www.example.com and you have deployed JIRA with the context path of jira, point your browser at http://www.example.com/jira.

トラブルシューティング

  • Whenever I go to JIRA in my browser, a login panel pops up. I enter a valid username and password for JIRA, but the panel pops up again.Make sure that you have Anonymous Access set on the jira virtual directory in IIS. It will be set to that if you have followed the above instructions.To check this:
    1. In 'Internet Information Services', right click the jira virtual directory and choose 'Properties'.
    2. 'Directory Security' タブをクリックします。
    3. 'Anonymous access and authentication control' セクションの 'Edit...' ボタンをクリックします。
    4. 'Anonymous access' のチェックボックスがチェックされていることを確認し、さらに 'Authenticated access' セクションのその他の項目が有効になっていないことを確認します。'Basic authentication'. を選択してはいけません。また、'Integrated Windows authentication' を選択してもいけません。
  • Internet Explorer を使用して JIRA にアクセスするたびにログインパネルが現れます。正しいユーザー名とパスワードを入力するのですが、それでもパネルが必ず現れます。ただし、 Firefox や Safari なと、別のブラウザーを使用するとこの現象は起きません。これらのブラウザーを使用した場合、JIRA に正常にログインすることができます。Internet Explorer の ユーザー認証匿名でログオンするに設定されていることを確認してください。これは次の手順で確認することができます :
    1. Internet Explorer の 「ツール」メニューをクリックし、「インターネットオプション」を選択します。
    2. 「セキュリティ」タブをクリックします。
    3. JIRA サーバーが該当するセキュリティゾーンを選択します。
    4. 「レベルのカスタマイス...」ボタンをクリックします。
    5. 右側のバーをスクロールして一番下の「ユーザー認証」セクションを表示します。
    6. 「匿名でログオンする」を選択します (選択されていない場合)。
    7. この画面と次の画面の 'OK' ボタンをクリックします。
    8. Internet Explorer を再起動します。
  • ブラウザーの http://localhost/jira でJIRA インスタンスのナビゲートを試したところ、 無意味な情報ファイルのダウンロードの指示が出ました。IIS では、JIRA の仮想ディレクトリで「実行」許可を取得しておいて下さい。詳細については、本ドキュメントの「3. IIS を設定して、 JIRA にリクエストを送信する」セクションのステップ11 をご参照下さい
  • Elements like the sidebar, icons, and gadgets aren't loading: This can be caused by URLs that are too long. Currently, the UrlSegmentMaxLength is set to 200 by default in IIS. To fix this, add a registry key to increase the max URL length and then reboot the server:

    [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\HTTP\Parameters] "UrlSegmentMaxLength"=dword:00000400

    This will effectively set the maximum length to 1024.

既知の問題

  • 64 bit IIS:OS が 64 bit の場合は、Tomcat IIS コネクターの 64 bit バージョンを使用してください。
  • Customer submitted solution: If you must use a 32 bit IIS connector, you can do so by clicking Application Pools > Advanced Settings > Allow 32bit applications.
  • お客様からのソリューション情報 : ウェブサイトの ISAPI 拡張を設定する必要があります。

最終更新日: 2017 年 9 月 24 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.