Расширенная настройка JIRA

JIRA имеет ряд дополнительных опций конфигурации, каждая из которых определяется как индивидуальное свойство (или «ключ» (key), связанный со значением). Эти пары «ключ-значение» (key-value) хранятся в одной из трех областей для использования JIRA:

База данных JIRA

Значения небольшого числа наиболее часто отредактированных расширенных опций конфигурации хранятся в базе данных JIRA. Эти значения можно отредактировать на странице «Дополнительные параметры» ( Advanced Settings) в области администрирования JIRA.

Чтобы получить доступ к значениям для редактирования, выполните следующие шаги:

Войдите в систему как пользователь с глобальным разрешением администраторов JIRA.
Выберите > «Система» (System). Выберите «Общая конфигурация» (General Configuration), чтобы открыть страницу «Администрирование» (Administration). Подробнее см. в разделе «Настройка дополнительных параметров».

После изменения значений любого из этих свойств они сразу становятся эффективными.

Файл jira-config.properties

Пользовательские значения оставшихся расширенных опций конфигурации JIRA (т. е. не хранящихся в базе данных JIRA) сохраняются как отдельные пары ключ-значение в файле с именем jira-config.properties (расположенном в домашнем каталоге JIRA). Как правило, эти параметры мало интересуют большинство системных администраторов JIRA. Хотя эти пары ключ-значение могут быть отредактированы, JIRA необходимо перезапустить, чтобы все измененные значения вступили в силу.

ПРИМЕР СОДЕРЖАНИЯ ДЕМОНСТРАЦИОННОГО ФОРМАТА


jira.projectkey.warning = testwarning
jira.projectkey.description = testdescription

В новых установках JIRA этот файл может не существовать первоначально, и если это необходимо, его необходимо создать вручную. Дополнительные сведения об изменении файла jira-config.properties см. здесь: Как отредактировать файл jira-config.properties

Файл jpm.xml

Значения по умолчанию для всех доступных расширенных опций конфигурации JIRA хранятся в файле jpm.xml (расположенном в подкаталоге <jira-application-dir> / WEB-INF / classes каталога установки JIRA). Эти значения по умолчанию используются только JIRA, если значение свойства еще не было настроено ни в базе данных JIRA (через страницу «Расширенные настройки» JIRA), либо в файле jira-config.properties.

Файл jpm.xml не должен редактироваться, потому что любые значения, которые вы настроили в нем, не будут автоматически перенесены во время последующих обновлений JIRA. Чтобы изменить значение свойства для расширенной опции конфигурации в JIRA, переопределите значение этого свойства, переопределив его в:

База данных JIRA (через страницу расширенных настроек JIRA).

ИЛИ

Файл jira-config.properties.

* JIRA распознает небольшое количество свойств, которые могут быть установлены в файле jira-config.properties, но не имеют определения в файле jpm.xml. Эти свойства:

обычно представляют собой расширенные опции конфигурации, которые отключены, если они не определены в файле jira-config.properties и
если они не указаны в файле jira-config.properties, как правило, влияющие на поведение JIRA по-разному, если они указаны в файле jira-config.properties без значения.

Внесение изменений в файл jira-config.properties

Чтобы внести изменения в файл jira-config.properties:

Завершите работу JIRA (например, выполнив файл /bin/stop-jira.sh или \ bin \ stop-jira.bat в каталоге установки JIRA или остановив службу JIRA).
Откройте файл jira-config.properties (расположенный в корневом каталоге вашего домашнего каталога JIRA) в текстовом редакторе.

Этот файл может не существовать, если вы используете новую установку JIRA или обновленную установку JIRA, в которой предыдущие версии JIRA никогда не были настроены. Если этот файл не существует, создайте его с помощью текстового редактора.

Измените соответствующие свойства в этом файле.

Советы по редактированию:

Чтобы определить значение по умолчанию для свойства, значение которого вы хотите переопределить, выполните поиск этого свойства в файле <jira-application-dir> /WEB-INF/classes/jpm.xml (вашего каталога установки JIRA). Значение по умолчанию определяется в родственном элементе <default-value /> элемента <key /> соответствующего свойства.
Чтобы переопределить значение свойства по умолчанию в jpm.xml (которое еще не определено в файле jira-config.properties или доступно на странице «Дополнительные параметры»):
- Скопируйте значение элемента <key /> соответствующего свойства из файла jpm.xml в файл jira-config.properties.
- В файле jira-config.properties добавьте '=' после ключа этого свойства, а затем ваше пользовательское значение.
Чтобы отключить значение пользовательского свойства в файле jira-config.properties, либо «закомментируйте» свойство с предыдущим символом «#», либо удалите свойство из файла.

Сохраните изменения в файле jira-config.properties.
Перезапустите JIRA.

Смотрите также

Настройка свойств и опций при запуске для таких изменений, как установка доступной памяти, отключение электронной почты, включение Jelly и т. д.

По материалам Atlassian JIRA Administrator's Guide: Advanced JIRA Configuration