JIRA Data Center のインストール

JIRA Data Center のインストール

以下の図は、JIRA のクラスター化インスタンス の一般的なインストール方法を示しています。

このインストールガイドは、既に JIRA インスタンスとロードバランサが存在し、ネットワークファイル共有システムをセットアップできることを前提としています。

1. JIRA インスタンスを 6.3 以降にアップグレードする

See JIRA Installation and Upgrade Guide.

2. JIRA ファイルストレージの場所を共有ストレージに設定する

この手順では、JIRA インスタンスと今後追加されるノードが書き込むことのできる共有ホーム ディレクトリを設定する必要があります。

これを行うには複数の方法がありますが、もっとも簡単な方法は、NFS 共有を使用することです。設定の方法はインストールごとに固有であり、このドキュメントの扱う範囲を超えています。

この共有ストレージの場所の最終的なマウントポイントは、/data/jira/sharedhome を想定しています。

• ディレクトリは、他の潜在的なノードによる読み取りと書き込みができるようにします。
• 次のディレクトリを /data/jira/sharedhome にコピーします (一部のディレクトリは空の場合もあります)。
  • data
  • plugins
  • logos
  • インポート
  • export

$ cp -R /path/to/jira-local-home/{data,plugins,logos,import,export} /data/jira/sharedhome

3. 既存の JIRA インスタンスをクラスター内で機能するように設定する

既存の JIRA インスタンスに以下のものを設定します。

1. Put a cluster.properties file in the local JIRA home directory, with contents as follows:

4. 最初のノードをロードバランサに追加する

JIRA データセンターは、ロードバランサによってノード間のトラフィックのバランスを取っています。多くの JIRA をインストールする大規模環境では、既にリバースプロキシを設定しており、多くのリバースプロキシには、ロードバランシングも同様に実行する能力があります。例として役立つように、サンプルの Apache httpd 設定を提供しましたが、固有の情報については、ご利用のプロキシベンダーに確認してください。

<VirtualHost *:80>
        ProxyRequests off
 
        ServerName MyCompanyServer
 
        <Proxy balancer://jiracluster>
                # JIRA node 1
                BalancerMember http://jira1.internal.atlassian.com:8080 route=node1
                # JIRA node 2  Commented pending node installation
                # BalancerMember http://jira2.internal.atlassian.com:8080 route=node2
 
                # Security "we aren't blocking anyone but this the place to make those changes
                Order Deny,Allow
                Deny from none
                Allow from all
 
                # Load Balancer Settings
                # We are not really balancing anything in this setup, but need to configure this
                ProxySet lbmethod=byrequests
                ProxySet stickysession=JSESSIONID
        </Proxy>
 
        # Here's how to enable the load balancer's management UI if desired
        <Location /balancer-manager>
                SetHandler balancer-manager
 
                # You SHOULD CHANGE THIS to only allow trusted ips to use the manager
                Order deny,allow
                Allow from all
        </Location>
 
        # Don't reverse-proxy requests to the management UI
        ProxyPass /balancer-manager !
        # Reverse proxy all other requests to the JIRA cluster
        ProxyPass / balancer://jiracluster/
        ProxyPreserveHost on
</VirtualHost>

5. 新しい JIRA ノードをクラスターに追加する

1. JIRA インストレーションディレクトリを新しいホストにコピーします。ドキュメンテーションとデプロイメントの負担を軽くするために、設定は、可能な限り最初のインストールから逸脱しないようにすることをお勧めします (インストールパス、ユーザー、ファイル権限など)。
2. 新しいホストが共有ホーム ディレクトリにアクセスできることを確認します (たとえば、共有 JIRA ディレクトリのコンテンツの読み取りが可能なことや、共有 JIRA ディレクトリへの書き込みアクセス権限があることを確認します)。
3. 最初のノードからこの新しいノードに、ローカルのホーム ディレクトリをコピーします。
4. cluster.properties ファイルが新しいノード ID を参照するように変更します。すべてのノード ID は、ノード間で一意でなければなりません。
5. 新しいノードを起動し、スタートアップの問題がないか監視します。
6. 課題の作成、検索、添付ファイル、およびカスタマイズが期待どおりに動作するか確認します。

6. この新しいノードをロードバランサに接続する

Verify that the new node is in the cluster and receiving requests by checking the logs on each node to ensure both are receiving traffic and also check that updates done on one node are visible on the other.

各ノードで、手順 5 と 6 を繰り返します。

Cluster.properties ファイルのパラメーター

You can set the following parameters in the cluster.properties file:

If you set ehcache.peer.discovery = automatic then you need to set the following parameters:

• ehcache.multicast.address

• ehcache.multicast.port

• ehcache.multicast.timeToLive

• ehcache.multicast.hostName

これらのパラメーターについての詳細は、Ehcache ドキュメントを参照してください。