Advanced JIRA Configuration
JIRA では、複数の詳細設定オプションを利用出来ます。各オプションは個別プロパティ (もしくは値に対応するキー) として定義されています。これらのキー値の組み合わせは、JIRA が使用する3つの領域の内の1つに格納されます。
The JIRA Database
The values of a small number of most commonly edited advanced configuration options are stored in the JIRA database. These values can be edited from the Advanced Settings page of JIRA's administration area. To access the values for editing:
- 「JIRA 管理者」グローバル権限を持つユーザーとしてログインします。
- Choose to open the Administration page. See > System. Select General Configuration Configuring Advanced Settings for details.
これらのプロパティの値は、変更されるとすぐに有効になります。
The jira-config.properties
file
Custom values for JIRA's remaining advanced configuration options (i.e. not stored in the JIRA database) are stored as individual key-value pairs in a file called jira-config.properties
(located in the JIRA Home Directory). Typically, these options are of little interest to most JIRA system administrators. While these key-value pairs can be edited, JIRA must be restarted for any changed values to take effect.
jira.projectkey.warning = testwarning
jira.projectkey.description = testdescription
In new JIRA installations, this file may not initially exist and if so, needs to be created manually. For more information about editing the
jira-config.properties
file see here: Edit the jira-config.properties file in Jira server
The jpm.xml
file
Default values for all* of JIRA's available advanced configuration options are stored in a file called jpm.xml
(located in the <jira-application-dir>/WEB-INF/classes
subdirectory of the JIRA Installation Directory). These default values are only used by JIRA if a property's value has not already been customized in either the JIRA database (via JIRA's 'Advanced Settings' page) or the jira-config.properties
file.
The
jpm.xml
file should not be edited because any values that you customize in it will not be migrated automatically during subsequent JIRA upgrades. To change the value of a property for an advanced configuration option in JIRA, override the value of this property by redefining it in either:
- JIRA データベース(JIRA の「詳細設定」ページより).
または jira-config.properties
ファイル。
* JIRA recognises a small number of properties, which can be set in your jira-config.properties
file but have no definition in the jpm.xml
file. These properties:
jira-config.properties
ファイルに定義されていない場合、一般に詳細設定オプションが無効化されていることを表します。- when not specified in your
jira-config.properties
file, typically affect JIRA's behavior differently to when they are specified in yourjira-config.properties
file with no value.
Making changes to the jira-config.properties
file
To make changes to the jira-config.properties
file:
- Shut down JIRA (for example, by executing either the
/bin/stop-jira.sh
or\bin\stop-jira.bat
file in your JIRA Installation Directory, or by stopping the JIRA service). - Open the
jira-config.properties
file (located at the root of your JIRA Home Directory) in a text editor.
This file may not exist if you are using a new JIRA installation or an upgraded JIRA installation where your previous JIRA version(s) had never been customized. If this file does not exist, create it using a text editor.
- Edit the appropriate properties in this file.
Editing tips:
- To determine the default value of a property whose value you wish to redefine, search for that property in the
<jira-application-dir>/WEB-INF/classes/jpm.xml
file (of your JIRA Installation Directory). The default value is defined in the<default-value/>
sibling element of the relevant property's<key/>
element. - To override a property's default value in
jpm.xml
(which is not already defined in yourjira-config.properties
file or available on the 'Advanced Settings' page):- Copy the value of the relevant property's
<key/>
element from thejpm.xml
file to thejira-config.properties
file. - In the
jira-config.properties
file, add an '=
' after that property's key, followed by your custom value.
- Copy the value of the relevant property's
- To disable a custom property's value in the
jira-config.properties
file, either 'comment out' the property with a preceding '#' symbol or remove the property from the file.
- To determine the default value of a property whose value you wish to redefine, search for that property in the
- Save your modifications to the
jira-config.properties
file. - Jira を再起動します。
参考資料
Setting Properties and Options on Startup — for changes like setting available memory, disabling email, enabling Jelly, etc.