Jira アプリケーションを Windows サービスとして実行する

長期的な利用においては、オペレーティング システムを再起動した際に Jira も自動的に再起動するように構成する必要があります。Windows のサーバーの場合、これを実現するには、Jira を Windows サービスとして実行します。

Jira を Windows サービスとして実行することには、他にも利点があります。手動で起動する場合はコンソール ウィンドウが開くため、ほかのユーザーがこのウィンドウを誤って閉じ、Jira をシャットダウンしてしまう可能性があります。また、Jira ログが Windows サービスによって適正に管理されます (お使いの Jira インストール ディレクトリ内の logs\stdout*.log に作成され、日々切り替えられます)。

Jira をサービスとしてインストールするには、インストーラー経由および手動の 2 とおりの方法があります。

このページの内容:

インストーラーを使用して、サービスとしてインストール

Jira を Windows サービスとしてインストーラーする最も簡単な方法は、Windows インストーラーの実行中に [Jira をサービスとしてインストールする] チェックボックスを選択する方法です。

このインストレーションプロセスを成功させるには、お使いの Windows オペレーティングシステムにおける完全な管理者権限が必要となります。

Jira をサービスとして実行するよう、手動で設定する

以下のいずれかの状況が該当する場合、Jira をサービスとして実行するように設定できます。

  • Windows インストーラーを利用しなかった。
  • Windows インストーラーを利用したが、最初に Jira をサービスとしてインストールしなかった。

(info) 注意:

  • ユーザーアカウント制御 (UAC) が搭載されたWindows Vista、 Windows 7 等のウィンドウズ OSでは、UAC を無効化するか、管理者(例:「cmd.exe」の右クリック、または「管理者として実行」を選択します)として「cmd.exe」を実行して、以下の手順のスクリプトを実行します。 ウィンドウズで UAC が有効化されている状態では、管理者アカウントのログイン以外にも複雑な作業が要求されます。

Jira をサービスとして実行するためのセットアップ方法

  1. コマンドプロンプトを開きます。
  2. ディレクトリを変更 (cd) して Jira アプリケーションのインストール ディレクトリに移動し、このディレクトリの "bin" サブディレクトリに移動します。
    (warning)パスのディレクトリに空白文字がある場合 (例: "C:\Program Files\..")、対応する 8 文字の形式に変換します (例: "C:\Progra~1\..")。
  3. JAVA_HOME 変数がお使いの Java プラットフォームのインストール ディレクトリのルートに設定されていることを確認します。
    (info)JAVA_HOME 変数の現在の値を調べるには、コマンド プロンプトに「echo %JAVA_HOME%」と入力します。
  4. 次のコマンドを実行します:

    service.bat install Jira

    以下が、本プロセスのスクリーンショットです:

    これで、Jira をサービスとしてセットアップできるようになりました。

  5. さらに、オペレーティング システムが起動した際に Jira サービスを自動的に起動させるには、以下を実行します。

    tomcat8 //US//JIRA --Startup auto

    オペレーティング システムが次回リブートされた際に、Jira サービスも自動的に起動されます。Jira サービスを手動で起動するには "net start JIRA"、停止するには "net stop JIRA" コマンドを使用します。

    Jira Core サービスが起動する際のパラメータを確認するには、[スタート] > [実行] に移動し、「regedt32.exe」を実行してから、次の操作を行います。
    * Windows 32 bit エディションの場合は、HKEY_LOCAL_MACHINE > SOFTWARE > Apache Software Foundation > Procrun 2.0 > Jira<タイムスタンプ> に移動します。
    * Windows 64bit エディションの場合は、HKEY_LOCAL_MACHINE > SOFTWARE > Wow6432ノード > Apache Software Foundation > Procrun 2.0 > Jira<タイムスタンプ> に移動します。

  6. Jira  の追加のセットアップ オプション (オプション):

    • Jira が利用できる最大メモリ サイズ (デフォルトは 256 MB) を増やすには、次を実行します:

      tomcat8 //US//service_name --JvmMx 512

      service_name には Jira サービスが入ります。例: JIRA123487934298

    • Jira と Confluence を同じ JVM で動かしている場合は MaxPermSize を 128 MB に増やします:

      tomcat8 //US//service_name ++JvmOptions="-XX:MaxPermSize=128m"

      service_name には Jira サービスが入ります。例: JIRA123487934298

    • Jira のガベージ コレクション情報の確認が役立つ場合があります。これは特に、メモリの問題を調査する際に有用です。Verbose GC (ガベージ コレクション) ロギングをオンにするには、コマンド プロンプトで以下のコマンドを実行します:

      tomcat8 //US//service_name ++JvmOptions="-Xloggc:path\to\logs\atlassian-gc.log"

      service_name には Jira サービスが入ります。例: JIRA123487934298
      パス (\path\to の部分) は、Jira がインストールされているディレクトリを指定します。例:

      tomcat8 //US//service_name ++JvmOptions="-Xloggc:c:\jira\logs\atlassian-gc.log"

      service_name には Jira サービスが入ります。例: JIRA123487934298

詳しいサービスオプションに関しては、Tomcat ドキュメンテーション を参照して下さい。

Jira サービスの削除

Windows インストーラーで Jira をインストールした場合、Windows の [コントロール パネル] で [プログラムの追加と削除] をクリックして、Jira を削除します。これによってサービスも削除されます。

手動でサービスをインストールした場合(上記参照)、以下の手順でアンインストール可能です:

service.bat remove JIRA

上記が動作しない場合、tomcat8 //DS//JIRA を使用します。

Jira サービスが利用する Windows ユーザの変更

Jira のバックアップ ディレクトリ、attachments ディレクトリ、インデックス ディレクトリ、あるいは %CATALINA_HOME%\‌* ディレクトリとしてマッピングされたネットワーク ドライブを利用している場合、Jira がこれらのドライブへの書き込みを行えることを必ず確認しておきます。これらのディレクトリはすべて、Jira サービスを実行しているユーザによって書き込み可能である必要があります。つまり、Jira サーバーが利用している Windows ユーザを変更する必要があります。

(info) また、これらのネットワークドライブを文字のマッピングではなく、UNC によって指定する必要があります。即ち z:\jira ではなく、 \\backupserver\jira です。

Jira サービスで使用している Windows ユーザーを変更するには、[コントロール パネル] -> [管理ツール] -> [サービス] で Windows サービスを検索します。"Atlassian Jira" サービスを見つけ、右クリックして "プリファレンス" を表示します。

'ログオン' タブに行き、希望のユーザに変更します。

複数サービスのスタートアップ順序を指定する

相互依存的なサービスを有する場合は、それらを正しい順序で起動する事が重要です。以下は、一般的な例です:以下は、一般的な例です:

  • Jira と Crowd の双方を実行中の場合、ユーザーが Jira へのログインを試みる前に Crowd を起動しておく必要があります。
  • Jira が接続するデータベースが Jira と同一のサーバー上でホストされており、Windows サービスを介して起動される場合、データベース サービスが先に起動されている場合にのみ、Jira サービスは適切に起動します。

起動時に使用する依存関係のルールをセットアップするには、コマンド プロンプトを開いて以下のコマンドを入力します:
C:\Documents and Settings\Developer>sc config [JIRA service] depend=[database service]
'depend=' の後にスペースが必要であることにご注意ください。

  • [JIRA service] は、実行中の Jira サービスの名称です。例: JIRA051007111904
  • [database service]は、あなたが実行中のデータベースサービスの名前です。例 MSSQLSERVER。

システムレジストリを編集することでも依存規則を設定することができます。詳しくは http://support.microsoft/kb/193888 を参照してください。

サービスの名前を見つける

Jira サービス、データベース サービスの正式名称がわからない場合、以下の手順で現在の名称を検索できます。

  1. 'コントロールパネル' > '管理ツール' > 'サービス'へと操作します。
  2. 'サービス' ウィンドウが開きます:
  3. 名前を知りたいサービス上で右クリックし、ポップアップ メニューから [プロパティ] を選択します:
  4. '一般' タブに 'サービス名' が現れます:

トラブルシューティング

  • Java 6 は Jira 6.0 以降ではサポートされません。JDK 1.6 で Jira を Windows サービスとして実行するように設定した場合、問題が発生する可能性があります。問題の原因は、”MSVCR71.DLL" が見つからないことです。このファイルは %JAVA_HOME%/bin にあります。この問題を解決する方法は 2 つあります。
    • PATH に %JAVA_HOME/bin を追加し、Jira サーバーを再起動します。
    • MSVCR71.DLL を、C:\WINDOWS\SYSTEM32 または C:\WINNT\SYSTEM32 のシステムパスにコピーします
  • サービスを実行しているユーザー名を確認し、インストール ディレクトリの /temp および /work ディレクトリを変更して、このユーザーに読み取りおよび書き込み許可を与えます。
  • 64 ビット版の OS で 1.5 GB 以上のメモリを割り当てる必要がある場合、32 ビットの JDK メモリ制限と 64 ビットの JDK / Tomcat サービス問題のため、Jira をサービスとして実行することはできません。
最終更新日 2018 年 7 月 5 日

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

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