Jira Service Management サポート

Jira Service Management Data Center 4.15 以降をご利用の場合はアセットがすでに組み込まれているため、何もダウンロードする必要はありません。その場合、Jira 上部のナビゲーションで [アセット] を選択するとアクセスできます。

Jira Service Management Data Center 4.14 以前をご利用の場合は、Atlassian Marketplace からアセットアプリを無料でインストールできます。

アセットは Jira Software Data Center ユーザーも利用できますが、ご利用の Jira バージョンによってはいくつかの制限があります。詳細は FAQ をご参照ください。

アプリのインストール

アセットアプリを Atlassian Marketplace からインストールする手順は次のとおりです。

管理者として Jira にログインします。
[管理] > [アプリを管理] の順に選択します。
[新しいアプリを検索] を選択して [アセット] を検索します。
結果に適切なアプリのバージョンが表示されます。
画面の指示に従ってアプリをインストールします。Data Center をご利用の場合、このバージョンにライセンスは不要です。
MyAtlassian へのログインを促すメッセージが表示されて、アセットのダウンロードが開始されます。
ダウンロードすると、Jira 上部のナビゲーションに [アセット] が表示されます。

システム要件

アトラシアンでは Data Center インスタンスで問題は出ないと考えていますが、念のためにいくつかのシステム要件を示します。

システム要件

アセットにインポートする予定のデータ量を Jira が処理できるように設定されていることをご確認ください。大量のスケジュールタスクによって大量のデータをインポートする予定がある場合は、次のテーブルに従うことをお勧めします。

膨大なデータセットに対するテスト環境では、必ずメモリ消費量をテストしてください。これは、オブジェクトの数だけでなくオブジェクト属性のコンテンツも関係しているためです。

アセット内のオブジェクト	JVM メモリ (最小)	JVM メモリ (推奨)
~ 1,000,000	16 GB	20 GB
~ 2,000,000	20 GB	25 GB
~ 5,000,000	40 GB	50 GB
~ 6,000,000 + 700,000 件の課題が接続を持つ状態	50 GB	60 GB
~ 8,000,000 + 800,000 件の課題が接続を持つ状態	70 GB	90 GB

パフォーマンスのチューニング

アセットの大規模なインストールでは、パフォーマンスを向上させるために微調整できるオプションがいくつかあります。

ガベージコレクション

休止時間を短縮するには、GC (ガベージコレクション) のアルゴリズムを既定値から G1 に切り替えることをお勧めします。これを設定するには、次の JVM 引数を Jira の setenv スクリプトに追加します。

-XX:+UseG1GC

アセットの並列処理

環境によっては、G1 を調整する他のオプションが必要になる場合があります。Oracle からの情報 (http://www.oracle.com/technetwork/tutorials/tutorials-1876574.html) をご確認のうえ、要件に応じて JVM を調整してください。

アセットでは、タスク (インデックスの再作成やインポートなど) を並列で実行します。大規模なインスタンスではタスクを実行するスレッドの数を増やせます。詳細については「Jira のグローバル設定を構成する」をご参照ください。初期設定では、JVM で利用可能なコア数と同じになるように並列処理が設定されます。

データベースプール

スレッド数を増やした場合は (アセットの並列処理)、データベース接続プールモニターをご確認のうえ、接続プールを増やす必要があるかを判断することをお勧めします。

Jira のシャットダウン

Jira のシャットダウン時に、アセットはインデックスをディスク上に永続化して起動を高速化します。大規模なインスタンスでは、強制シャットダウンコマンドが送信される際にインデックスファイルをディスクに保存できません。このために、アセットは起動のたびにデータベースのインデックスを再作成します。この変更を防ぐには、stop-jira スクリプトで強制シャットダウンのタイムアウトを変更する必要があります。

値 20 (秒単位) を、インストール内のデータ量に応じてより妥当な値に変更します。Jira 標準の stop-jira.sh のスニペットを次に示します。値 20 を 2 か所で変更する必要があります。

if [ -z "$JIRA_USER" ] || [ $(id -un) == "$JIRA_USER" ]; then
    echo executing as current user
  
    exec $PRGDIR/shutdown.sh 20 -force $@
  
elif [ $UID -ne 0 ]; then
  
    echo JIRA has been installed to run as $JIRA_USER so please sudo run this to enable switching to that user
    exit 1
  
else
  
    echo executing using dedicated user
    if [ -x "/sbin/runuser" ]; then
        sucmd="/sbin/runuser"
    else
        sucmd="su"
    fi
    $sucmd -m $JIRA_USER -c "$PRGDIR/shutdown.sh 20 -force $@"
  
fi

Tomcat の考慮事項

setenv で CATALINA_OPTS によってヒープを設定した場合は、JVM 設定 (JVM_MAXIMUM_MEMORY) が CATALINA_OPTS で設定された最大ヒープと同じ値でないことをご確認ください。

大量のオブジェクトをインポートする

アセットによって何百万ものオブジェクトに対応してインポーターを多用する予定がある場合 (Asset Discovery 製品など) は、まだ Data Center バージョンを使用していないのであれば移行をお勧めします。これによって、インポーターを 1 つのインポートノードのみに分離して、他のノードをユーザーノードにできます。インポートノードが 1 つであれば、インポートプロセスによるユーザー操作への影響が小さくなります。また、インポートの失敗やメモリの過剰消費はインポートノードにのみ影響してユーザーノードには影響しないため、より堅牢になります。

オブジェクトに保存されているデータやインポートの頻度に関係するため、オブジェクトやインポートに特定の推奨サイズを設定することは困難です。ただし、一般にオブジェクトの数が数百万個に達したり、メモリ使用量が 32 GB を超えたりする場合や、ユーザーインタラクションに絶対に影響を与えたくない場合は、Data Center バージョンのアセットの利用をご検討ください。

インポート中に Data Center でインデックスを再作成する場合は、インデックスを更新するために他のノードにメッセージを送信する必要があります。これは、提供されているアトラシアンの機能によって行われます。clustermessage テーブルは、すべてのノードがプッシュ/プルする DB テーブルです。これまでに確認された問題は、このテーブルのアトラシアンでの保持期間が 30 日であることです。これは少し長すぎると考えられるため、独自の保持スクリプトによって 24 時間以上古いアセット関連のデータ行をすべて削除することをお勧めします。

次のステップ

「アセットの管理」にお進みください。

Jira Service Management サポート

製品

Jira Software