JIRA Data Center のインストール

These instructions are applicable for installing JIRA Software Data Center or JIRA Service Desk Data Center on your own hardware. You can also install JIRA Software Data Center or JIRA Service Desk Data Center in Amazon Web Services.

JIRA Data Center のインストール

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

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

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

See JIRA applications installation guides or the JIRA applications upgrade guides.

• If you're installing your instance from scratch, you should generate a non-Data Center evaluation license at the set up stage, and update to your Data Center license when you're adding your cluster properties file at step 3.
• If you're upgrading your instance, update your license at step 3.

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

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

There are multiple ways to do this, but the simplest is to use an NFS share. The mechanics of setting one is unique from installation to installation, and is outside the scope of this document. We recommend using a UNC file path to your storage location.

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

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

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

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

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

1. Stop your instance.

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

   例を展開

   cluster.properties ファイルの例

   
   

   # This ID must be unique across the cluster jira.node.id = node1 # The location of the shared home directory for all JIRA nodes jira.shared.home = /data/jira/sharedhome

   詳細は、Cluster.properties ファイルのパラメーター を参照してください。

   If using the Apache load balancer, set the Apache node name by appending the following setting to the same variable (replacing node1 with the node name used in the load balancer configuration):

   • • -DjvmRoute=node1

3. Start your instance, and install your Data Center license.

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 を繰り返します。

セキュリティ

Ensure that only permitted cluster nodes are allowed to connect to a JIRA Data Center instance's ehcache RMI port, which by default is port port 40001, through the use of a firewall and/or network segregation. Not restricting access to the ehcache RMI port could result in the compromise of a JIRA Data Center instance.

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 ドキュメントを参照してください。