JIRA Data Center のインストール

These instructions are applicable for installing JIRA Software Data Center or JIRA Service Desk Data Center on your own hardware.

If you're looking to host JIRA Data Center externally, see:

アトラシアンの Web サイトで、Jira Software Data Center および Jira Service Desk Data Center の詳細をご確認ください。

始める前に

JIRA Data Center をインストールする前に、以下の前提条件に関する情報をお読みください。

  • Understand how Jira Data Center works.
  • 次のノード要件を理解します。
    • 各 JIRA ノードは、それ自身の (物理的または仮想の) マシン上で実行される必要があり、これとは別に共有サービスのための独立したマシンが必要です。この共有サービス用のマシンには、各ノードがアクセスできなければなりません。
    • 標準の JIRA サポート対象プラットフォームおよび要件を各ノードに適用します。
    • 各ノードはまったく同じである必要はありませんが、一貫性のあるパフォーマンスのために、可能な限り同質になるようにします。
    • ノードはまったく同じ JIRA バージョンを実行し、同一のデータセンターに配置される必要があります。
    • ノードは、同じタイムゾーンに設定され、現在時刻の同期を維持する必要があります。これを行うには、ntpd や類似のサービスを利用すると便利です。
    • Nodes must be configured to have unrestricted port access to each other.
  • 選択したロードバランサのインストールと設定を行います。
    • ロードバランサは、"クッキー ベースのセッション アフィニティ"("スティッキー セッション" としても知られる) をサポートする必要があります。
  • You need a JIRA Data Center license. You'll need this to allow JIRA to use the clustering capabilities. To get one you should either:

オプションで、ロードバランサ、データベース、および共有ファイルシステムをクラスター化できます。

JIRA データセンターのインストールまたはご使用の環境への新しいノードの追加後に、ヘルス チェックツールを使用して、インスタンスが正しく設定され、正常に動作しているかどうか検査します。

JIRA Data Center のインストール

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

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

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
    • caches


$ 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 設定を提供しましたが、固有の情報については、ご利用のプロキシベンダーに確認してください。

mod_balancer を使用したサンプル 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>

JIRA をロードバランサに追加したら、 JIRA インスタンスの再起動後、基本機能が動作していることを確認します。これを行うには、インスタンスに移動してログインし、壊れたリンクや正常に動作しない JIRA 機能がないか調べます。

ベースサーバーの URL が (ロードバランサのパブリック URL に対して) 正しく設定されていることを必ず確認してください。

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

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

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

新しいノードがクラスター内にあり、リクエストを受信することを検証します。これを行うには、各ノードでログを調べ、いずれもトラフィックを受信していることを確認し、さらに、一方のノードで実行された更新をもう一方のノードで表示できるかどうかも調べます。

各ノードで、手順 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:

パラメータ 必須 説明/値
jira.node.id はい This unique ID must match the username and the BalancerMember entry in the Apache config.
jira.shared.home はい すべての Jira ノードの共有ホーム ディレクトリの場所。
ehcache.peer.discovery いいえ

ノードがお互いを見つける方法を示します。

default - JIRA will automatically discover nodes. This means when a JIRA instance starts up, it will check the clusternode table in the database to discover if there are other nodes already in the cluster. This is the recommended setting.
automatic - Will use EhCache's multicast discovery. This is the historical default method used by ehCache, but can be problematic for customers to configure and is no longer recommended by Atlassian for use with JIRA clustering.

ehcache.listener.hostName いいえ キャッシュ通信のための現行ノードのホスト名。JIRA データセンターは、パラメーターが設定されていない場合、内部的にこれを解決します。
ネットワークのホスト名の解決に問題がある場合、このパラメータを設定できます。
ehcache.listener.port いいえ

ノードがリッスンすることになるポート ( デフォルト = 40001)


複数のノードが同じホスト上にあるか、このポートが利用できない場合、手動でこれを設定することが必要な場合もあります。

ehcache.object.port いいえ

レジストリでバインドされているリモート オブジェクトが呼び出しを受信するポート。このポートはファイアウォールでも開放する必要があります。

このパラメーターを指定することをお勧めします。指定しない場合、空きポートがランダムに使用されます。

ehcache.listener.socketTimeoutMillis いいえ デフォルトでは、これは Ehcache デフォルトに設定されます。

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

最終更新日 2019 年 3 月 28 日

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

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