JIRA をサービスとして実行
長期的な利用においては、オペレーティングシステムを再起動した際には JIRA も自動的に再起動するように構成する必要があります。Windows サーバーの場合は、JIRA が Windows サービスとして実行するように構成する事を意味します。
If you are running JIRA on Linux and want to start it automatically, please refer to Starting JIRA Automatically on Linux instead.
Running JIRA as a Windows service has other advantages. When started manually a console window opens and there is a risk of someone accidentally shutting down JIRA by closing this window. Also, the JIRA logs are properly managed by the Windows service (found in logs\stdout*.log
in your JIRA Home Directory, and rotated daily).
JIRA をサービスとしてインストールするには、インストーラー経由および手動の二通りの方法があります。
インストーラーを使用して、サービスとしてインストール
The easiest way to get JIRA installed as a Windows service is by clicking the 'Install JIRA as Service' check box when running the Windows Installer:
このインストレーションプロセスを成功させるには、お使いの Windows オペレーティングシステムにおける完全な管理者権限が必要となります。
JIRA をサービスとして実行するよう、手動で設定する
以下のいずれ下の状況が該当する場合、JIRA がサービスとして実行するよう設定できます:
- Windows インストーラーを利用しなかった。
- Windows インストーラーを利用したが、最初に JIRA をサービスとしてインストールしなかった。
注意:
- These instructions do not apply to installations of the JIRA WAR distribution. To run a JIRA WAR installation as a service, refer to the relevant JIRA WAR installation instructions for Apache Tomcat 6.0 or 7.0.
- 以下の手順を Windows Vista または Windows 7 等のユーザアカウントコントロール(UAC)を備えた一切の Windows オペレーティングシステム上で実行するには、UAC を無効化するか、または管理者として 'cmd.exe' を実行しなくてはいけません(例、'cmd.exe' 上で右クリック、「管理者として実行」を選択)。UAC が有効化となっている場合、単に管理者アカウントで Windows にログインするだけでは十分ではありません。
JIRA をサービスとして実行するためのセットアップ:
- コマンドプロンプトを開きます。
- Change directory ('cd') to the JIRA installation directory and then into this directory's '
bin
' subdirectory.If a directory in the path has spaces (e.g. '
C:\Program Files\..
'), please convert it to its eight-character equivalent (e.g. 'C:\Progra~1\..
'). - JAVA_HOME 変数がお使いの Java プラットフォームのインストール ディレクトリのルートに設定されていることを確認します。
JAVA_HOME 変数の現在の値を調べるには、コマンド プロンプトに「
echo %JAVA_HOME%
」と入力します。 次のコマンドを実行します。
service.bat install JIRA
Here is a screenshot of the process:
JIRA should now be set up to run as a service.更に、オペレーティングシステムが起動した際に、JIRA サービスを自動的に起動させるには、以下を実行します:
tomcat7 //US//JIRA --Startup auto
次回オペレーティングシステムがリブートした際は、JIRA サービスも自動的に起動します。JIRA サービスを手動で起動させるには 'net start JIRA'、停止させるには 'net stop JIRA' コマンドを使用します。
To see what parameters the JIRA service is starting with, go to Start -> Run and run '
regedt32.exe
' and then:
* For Windows 32 bit edition navigate to HKEY_LOCAL_MACHINE -> SOFTWARE -> Apache Software Foundation -> Procrun 2.0 -> JIRA<time stamp>
* For Windows 64 bit edition navigate to HKEY_LOCAL_MACHINE -> SOFTWARE -> Wow6432Node -> Apache Software Foundation -> Procrun 2.0 -> JIRA<time stamp>追加の JIRA セットアップオプション(任意):
JIRA 5.2 以降においては、これらのtomcat7 コマンドを実行しますが、JIRA 5.1 以前においては、代わりにtomcat6 コマンドを実行します
JIRA が利用可能な最大メモリを増やすには(デフォルトの時点で既に 256MB)、次を実行します:
tomcat7 //US//service_name --JvmMx 512
service_name が、お使いの JIRA サービスの名前、即ち JIRA123487934298。
パラメータを通して JIRA の Jelly サポートを有効化する等、JVM パラメータを加えるには、次を実行します:
tomcat7 //US//service_name ++JvmOptions="-Djira.jelly.on=true"
service_name が、お使いの JIRA サービスの名前、即ち JIRA123487934298。
同じ JVM 内で JIRA と Confluence を実行中の場合、MaxPermSize サイズを 128 MB まで増加します:
tomcat7 //US//service_name ++JvmOptions="-XX:MaxPermSize=128m"
service_name が、お使いの JIRA サービスの名前、即ち JIRA123487934298。
時折、JIRA のガーベジコレクション情報を閲覧すると便利かもしれません。これは、メモリの問題を捜査する際に、特に当てはまります。Verbose GC (ガーベジコレクション) ロギングをオンにするには、コマンドプロンプトで以下のコマンドを実行します:
tomcat7 //US//service_name ++JvmOptions="-Xloggc:path\to\logs\atlassian-gc.log"
service_name は、お使いの JIRA サービスの名前を使用してください。(例えば
パス (\path\to の部分) は、JIRA が現在インストールされているディレクトリを意味します。例:tomcat7 //US//service_name ++JvmOptions="-Xloggc:c:\jira\logs\atlassian-gc.log"
service_name が、お使いの JIRA サービスの名前、即ち JIRA123487934298。
詳しいサービスオプションに関しては、Tomcat ドキュメンテーション を参照して下さい。
JIRA サービスを削除する
JIRA が Windows インストーラーを通じてインストールされた場合、Windows の'コントロールパネル' から、'プログラムの追加または削除' をクリックして、JIRA を削除します。これによって、サービスも削除されます。
手動でサービスをインストールした場合(上記参照)、以下の手順でアンインストール可能です:
service.bat remove JIRA
上記が動作しない場合、tomcat7 //DS//JIRA
を使用します。
JIRA サービスが利用する Windows ユーザを変更する
JIRA のバックアップディレクトリ、アタッチメント、インデックスディレクトリ、あるいは %CATALINA_HOME%\* ディレクトリとしてマップネットワークドライブを利用している場合、JIRA が必ずこれらのドライブに書込める事を確認しておきます。要するに、これらのディレクトリは全て、JIRA サービスが実行しているユーザによって書込み可能となっている必要があるのです。即ち、JIRA サーバーが利用している Windows ユーザを変更する必要があります。
また、これらのネットワークドライブを文字のマッピングではなく、UNC によって指定する必要があります。即ち z:\jira ではなく、 \\backupserver\jira です。
To change the Windows user that the JIRA service uses, navigate to the service in Windows, i.e. 'Control Panel' -> 'Administrative Tools' -> 'Services'. Locate the 'Atlassian JIRA' service, right-click and view the 'Preferences'.
'ログオン' タブに行き、希望のユーザに変更します。
複数サービスのスタートアップ順序を指定する
相互依存的なサービスを有する場合は、それらを正しい順序で起動する事が重要です。以下は、一般的な例です:以下は、一般的な例です:
- If you are running both JIRA and Crowd, it is important to start Crowd first, so that Crowd is running before people try to login to JIRA.
- 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 サービスあるいはデータベースサービスの正確な名前が分からない場合、以下の手順に従う事でそれらを見つけられます:
- 'コントロールパネル' > '管理ツール' > 'サービス'へと操作します。
- 'サービス' ウィンドウが開きます:
- 名前を知りたいサービス上で右クリックし、ポップアップ メニューから [プロパティ] を選択します:
- '一般' タブに 'サービス名' が現れます:
トラブルシューティング
- Java 6 is not supported by JIRA 6.0 and later. Problems may occur when trying to setup JIRA to run as a Windows service with JDK 1.6. The problem is due to failure to locate "MSVCR71.DLL", which can be found in
%JAVA_HOME%/bin
. There are two options to resolve this problem:- PATH に %JAVA_HOME/bin を追加し、JIRA サーバーを再起動します。
- MSVCR71.DLL を、C:\WINDOWS\SYSTEM32 または C:\WINNT\SYSTEM32 のシステムパスにコピーします
- サービスを実行しているユーザー名を確認し、インストール ディレクトリの
/temp
および/work
ディレクトリを変更して、このユーザーに読み取りおよび書き込み許可を与えます。 - 32bit JDK メモリ制限および 64bit JDK/Tomcat サービス問題があるため、1.5 GB 以上のメモリ割り当てを必要とする場合は、JIRA を 64bit オペレーティングシステム上でサービスとして実行できません