Миграция JIRA на другой сервер
В этом документе описывается, как переносить / обновлять JIRA 6.4 на другом серверном оборудовании или в другой серверной среде, которая влечет за собой одно или несколько из следующих действий:
- новая операционная система, которая будет запускать JIRA,
- новые местоположения для хранения вашего индекса и / или вложений или
- новую базу данных или систему баз данных, которая будет хранить данные JIRA.
Если вы переходите на новую версию JIRA во время миграции, см. Раздел «Обновление JIRA» для получения информации о необходимых задачах, которые необходимо выполнить перед обновлением.
Если вы меняете свою операционную систему от Windows до Linux или наоборот, помните, что вам нужно будет отменить «косые черты»(слэши), когда это необходимо в ваших путях файлов ('/' к '\' или '\' к '/ ').
- Прежде чем начать
- Проверьте свою лицензию. Убедитесь, что срок действия вашей лицензии действителен.
- Проверьте известные задачи- используйте базу знаний JIRA для поиска любых задач в новой версии, которые будут влиять на вас.
-
Проверьте совместимость:
- Убедитесь, что ваша операционная система, база данных, другие применимые платформы и аппаратные средства по-прежнему соответствуют требованиям для JIRA 6.4. Объявление о завершении поддержки для страницы JIRA также содержит важную информацию о поддержке платформы для будущих версий JIRA.
- Если вы установили надстройки JIRA (т. е. не включеные в JIRA), убедитесь, что они будут совместимы. Вы можете найти информацию о совместимости надстройки на домашней странице надстройки на Atlassian Marketplace. Вы также можете выполнить описанную здесь процедуру: проверка совместимости надстройки с обновлениями приложений, чтобы помочь вам с помощью универсального менеджера надстроек.
Мы настоятельно рекомендуем сначала выполнить миграцию в тестовой среде. Не переносите свой производственный JIRA-сервер, пока не убедитесь, что обновление тестовой среды прошло успешно.
- Если у вас возникли проблемы с тестовой средой, которые вы не можете решить, создайте задачу на нашем сайте поддержки, чтобы мы могли вам помочь.
-
Если у вас возникли проблемы во время миграции вашего производственного JIRA-сервера, не разрешайте пользователям использовать этот сервер. Вместо этого:
- Продолжайте использовать старый сервер JIRA - это поможет вам не потерять производственные данные.
- Также создайте задачу на нашем сайте поддержки, чтобы мы могли помочь вам решить проблемы с вашей миграцией.
Некоторые антивирусные или другие средства безопасности в Интернете могут помешать миграции и предотвратить успешное завершение процесса. Если вы испытываете или ожидаете, что будете испытывать такую задачу с средством защиты от вирусов / обеспечения безопасности Интернета, сначала отключите этот инструмент, прежде чем продолжить миграцию JIRA.
- Резервное копирование
2.1. Запретить пользователям обновлять данные JIRA
Во время процесса обновления вы экспортируете базу данных JIRA из существующей установки JIRA (через резервную копию XML), а затем восстановите эту резервную копию в новой установке JIRA. Чтобы данные в резервной копии XML соответствовали последним данным в системе, вы должны временно ограничить доступ к JIRA, чтобы пользователи не могли обновлять данные. Дополнительную информацию см. В разделе Предотвращение доступа пользователей к странице JIRA во время резервного копирования.
Знайте! Непоследовательные резервные копии XML не могут быть восстановлены!
2.2 Резервное копирование базы данных
Выполните резервное копирование XML существующей внешней базы данных установки JIRA. Для больших установок JIRA для этого процесса может потребоваться несколько часов.
«Встроенная база данных» - это база данных HSQLDB, поставляемая с JIRA только для оценки. Если вы случайно используете базу данных HSQLDB в производственной системе, выполните резервное копирование XML этой базы данных и продолжите эту процедуру.
- Резервное копирование каталога JIRA Home
- Выключите JIRA.
- Найдите каталог JIRA Home. Вы можете найти информацию о расположении каталога, перейдя в файл <jira-application-dir> /WEB-INF/classes/jira-application.properties в каталоге установки JIRA. Кроме того, вы можете открыть JIRA Configuration Tool, чтобы увидеть каталог, который настроен как ваш JIRA Home.
- Перейдите в каталог, указанный в файле конфигурации, и создайте резервную копию в другом каталоге.
- (красный крестик ошибка) Удалите файл <jira-home> /dbconfig.xml из исходной папки сразу после завершения резервного копирования.
2.4 Создайте резервные копии ваших вложений и индексы каталогов, если они находятся за пределами вашего домашнего каталога JIRA
Если вложения и индексы каталогов расположены за пределами вашего домашнего каталога JIRA, вы должны резервировать их отдельно. На этих страницах описывается, как определить, где эти каталоги находятся в вашей реализации:
- Каталог ваших вложений - обратитесь к разделу «Настройка файлов вложений» в документации для вашей версии JIRA.
- Ваш индексный каталог - см. Страницу индексирования поиска в документации для вашей версии JIRA.
Также см. Резервное копирование данных для получения дополнительной информации о резервном копировании вложений в JIRA.
2.5 Создайте резервную копию каталога установки JIRA
«Каталог установки JIRA» - это каталог, в который были загружены файлы и библиотеки приложений JIRA при установке JIRA.
- Настройка новой установки JIRA
3.1 Установите новую версию JIRA
Во-первых, вы должны начать с свежей установкой JIRA, либо текущей версией, либо новейшей. Если вы обновляете JIRA во время этого процесса, см. «Обновление JIRA» для получения информации о необходимых заданиях (tasks), которые необходимо выполнить перед обновлением.
Загрузите и извлеките требуемый дистрибутив JIRA в новый каталог. Не перезаписывайте существующую установку JIRA. Убедитесь, что это было отключено, и установите новую версию JIRA в новое место.
Следуйте инструкциям по установке:
- Установка JIRA (рекомендуется) или
- Установка JIRA WAR
(info) Если вы используете JIRA WAR, не забудьте создать новое веб-приложение JIRA и развернуть его на своем сервере. Для получения конкретных инструкций обратитесь к странице установки JIRA WAR для вашего сервера приложений в разделе «Установка JIRA WAR».
3.2 Укажите свою новую JIRA (копию) существующего каталога JIRA Home
Если ваша новая установка JIRA 6.4 находится на новом сервере, перед продолжением скопируйте резервную копию существующего домашнего каталога JIRA со старого сервера на новый сервер.
Чтобы настроить «рекомендуемое» (не WAR) распределение:
- Откройте JIRA Configuration Tool.
- Перейдите на вкладку JIRA Home.
- Обновите поле Домашний каталог JIRA:
- Если ваша установка JIRA 6.4 находится на новом сервере, обновите поле Home Directory JIRA на пути к скопированному каталогу JIRA Home.
- Если ваша установка JIRA 6.4 находится на том же сервере, обновите поле Home Directory JIRA на пути к существующему каталогу JIRA Home.
Для получения дополнительной информации об этом каталоге см. JIRA Home Directory.
Чтобы настроить распределение WAR:
- Отредактируйте файл jira-application.properties, расположенный в подкаталоге <jira-application-dir> / WEB-INF / classes вашего нового каталога установки JIRA 6.4 Installation Directory JIRA.
- Обновите свойство jira.home в этом файле на пути к новому домашнему каталогу JIRA:
- Если ваша установка JIRA 6.4 находится на новом сервере, обновите свойство jira.home до пути скопированного каталога JIRA Home.
- Если ваша установка JIRA 6.4 находится на том же сервере, обновите свойство jira.home до пути к существующему каталогу JIRA Home.
Для получения дополнительной информации об этом каталоге см. JIRA Home Directory.
- Удалите '#' в начале строки jira.home (чтобы JIRA больше не рассматривала эту строку как комментарий).
- Сохраните обновленный файл jira-application.properties.
(галочка) Вы также можете установить местоположение вашего домашнего каталога JIRA, указав переменную среды JIRA_HOME. Это значение этой переменной имеет приоритет над значением свойства jira.home в файле jira-application.properties в каталоге установки JIRA. Подробнее см. В разделе «Настройка домашнего каталога JIRA».
3.3 Подключите новую версию JIRA к новой пустой базе данных
Создайте новую, пустую базу данных, которую ваша новая установка JIRA будет использовать для хранения своих данных.
Следуйте инструкциям «Подключение JIRA к ...» для вашей базы данных со стадии 2, хотя со стадии 4 этой процедуры обратите внимание на желтую заметку ниже:
- Подключение JIRA к PostgreSQL
- Подключение JIRA к MySQL
- Подключение JIRA к Oracle
- Подключение JIRA к SQL Server 2005
- Подключение JIRA к SQL Server 2008
Вам не нужно создавать новую базу данных, если вы используете встроенную базу данных HSQL.
3.4 Перенесите существующие конфигурации JIRA на новую установку JIRA
Если вы изменили свойства в конфигурационных файлах существующей установки JIRA, внесите те же изменения в новую установку JIRA. Однако, поскольку свойства в файлах конфигурации могут быть изменены между версиями, вы не можете просто скопировать файлы конфигурации из существующей установки и заменить эквивалентные файлы в новой установке.
Для каждого файла, который вы изменили в своей существующей установке JIRA, вам необходимо вручную отредактировать каждый эквивалентный файл в вашей новой установке JIRA и повторно применить ваши изменения. Если файл отсутствует в вашей новой установке JIRA (например, osuser.xml в последних версиях JIRA), просто скопируйте этот файл на новую установку JIRA.
В приведенной ниже таблице перечислены наиболее часто изменяемые файлы и их местоположения в каталоге установки JIRA:
файл |
Расположение в разделе «Рекомендуемые» (ранее «Автономные») распределения JIRA |
Расположение в JIRA WAR |
Описание |
jira-application.properties |
atlassian-jira/WEB-INF/classes |
webapp/WEB-INF/classes |
Расположение исходного каталога JIRA и расширенной конфигурации JIRA в JIRA 4.3.x и более ранних версиях.
Любые значения пользовательских свойств, определенные в файле jira-application.properties существующей установки JIRA 4.3.x (или более ранней), должны быть перенесены в файл jira-application.properties вашей новой установки JIRA 6.4, прежде чем вы начнете новую установку JIRA .
После запуска вашей новой установки JIRA любые значения пользовательских свойств в файле jira-application.properties будут автоматически перенесены в базу данных JIRA или файл jira-config.properties. jira.home является единственным свойством файла jira-application.properties, впоследствии используемого JIRA. |
setenv.bat (Windows) or setenv.sh (Linux) |
bin |
Каталог bin сервера приложений |
Увеличение памяти JIRA |
osuser.xml (не требуется при обновлении с JIRA 4.3.0 или новее) |
atlassian-jira/WEB-INF/classes |
webapp/WEB-INF/classes |
Изменено, если вы интегрировали LDAP с JIRA, интегрировали Crowd с JIRA или используете пользовательскую форму внешнего управления пользователями или аутентификации пользователей. |
seraph-config.xml |
atlassian-jira/WEB-INF/classes |
webapp/WEB-INF/classes |
Изменено, если вы интегрировали Crowd с JIRA. |
server.xml |
conf |
Каталог conf сервера приложений |
Изменено в следующих ситуациях:
· Если вы ранее настроили TCP-порты JIRA по-разному от своих значений по умолчанию. · Если вы использовали SSL. · При подключении JIRA к базе данных в JIRA 4.3.x и ранее. |
Определенные для версии примечания обновления содержат детали относительно свойств, которые, возможно, изменились в этих обычно изменяемых файлах.
Помимо файлов выше, вы также должны рассмотреть и / или выполнить следующие конфигурации как часть процесса обновления:
-
Использование JIRA с Atlassian's Crowd? - Если вы используете Crowd с JIRA, настройте новую JIRA, чтобы поговорить с Crowd, как описано в разделе «Интеграция Crowd с JIRA».
- Не забудьте настроить Crowd для предоставления нового имени хоста / IP-доступа JIRA: Указание адреса приложения или имени хоста
- Выделение дополнительной памяти для JIRA—если вы ранее выделили дополнительную память JIRA, сделайте то же самое для своего нового экземпляра JIRA. Для получения дополнительной информации см. Расширение памяти JIRA.
- Плагины—для любых плагинов, которые вы установили в своей старой JIRA, загрузите версию плагина для своей новой версии JIRA с сайта http://plugins.atlassian.com.
- Кодировка символов—убедитесь, что кодировка символов (например, локаль) одинакова в новых и старых местах. Ваша новая версия JIRA может работать некорректно, если вложения перемещаются между двумя системами с несовместимым кодированием.
- Индивидуальные настройки—если вы внесли какие-либо настройки (код, шаблоны или файлы конфигурации), скопируйте совместимые версии этих изменений в новую JIRA. (Разработчики в вашей организации, которые внесли настройки в вашу старую версию, должны будут создавать и тестировать эквивалентные изменения для новой версии и предоставлять вам файлы для копирования на вашу обновленную установку JIRA.)
- (Необязательно) Запуск JIRA на другом порту—если ваша новая JIRA установлена на том же компьютере, что и ваша старая JIRA, вы можете убедиться, что она работает на другом порту (если вам когда-либо понадобится перезапустить старую JIRA). Подробнее см. Изменение портов TCP JIRA.
3.5 Начните новую версию JIRA
- Убедитесь, что ваша старая установка JIRA закрыта - если этот JIRA-сервер все еще работает, закройте его.
- Если вы установили дистрибутив JIRA WAR в Tomcat, удалите рабочий каталог Tomcat перед перезапуском JIRA. Если вы этого не сделаете, пользователи могут столкнуться с ошибками при попытке отображения страниц JIRA.
- Запустите свою новую версию JIRA. Для:
- «Рекомендуемые» дистрибутивы - следуйте инструкциям «Запуск JIRA».
- Распределения WAR - следуйте инструкциям для запуска JIRA для вашего сервера приложений в разделе «Установка JIRA WAR».
В процессе запуска ваша новая установка JIRA создаст любые необходимые индексы базы данных. Если вы создали пользовательские индексы базы данных, проверьте их позже и удалите все дубликаты индексов, добавленных JIRA.
Не перезагружайте старую установку JIRA ...
Если ваша новая установка JIRA 6.4 находится на том же сервере, что и ваш старая, все равно можно настроить тот же каталог JIRA Home, что и ваша новая установка JIRA. Запуск двух отдельных установок JIRA, которые имеют общий каталог JIRA Home, может привести к серьезному повреждению данных.
Тем не менее мы рекомендуем не удалять какой-либо аспект (или резервный компонент) вашей старой установки JIRA, пока вы не убедитесь, что ваша обновленная установка JIRA функционирует должным образом.
3.6 Импорт данных старой JIRA в новую JIRA
После того, как вы запустили новую установку JIRA, вы должны войти в ваше приложение JIRA и готовы импортировать данные из старого экземпляра в новый экземпляр. Вам понадобится резервный файл данных из старой JIRA, который вы создали ранее в этих инструкциях (см. выше).тобы импортировать старые данные JIRA в новую JIRA:
- Войдите в систему как пользователь с глобальным разрешением «Системные администраторы JIRA».
- Выберите «Администрирование»(Administration)> «Система»(System)> «Импорт и экспорт» (Import & Export)> «Восстановить систему»(Restore System) (вкладка), чтобы открыть страницу «Восстановить данные JIRA с резервной копии».(Restore JIRA data from Backup)
Комбинация клавиш: 'g' + 'g' + тип 'rest'
- В поле «Имя файла» укажите файл резервной копии XML, созданный ранее во время процесса экспорта (см. выше). Этот сжатый архиватором zip файл должен содержать два xml-файла: activeobjects.xml и entities.xml. Оба этих файла должны быть включены в зашифрованный файл для работы процесса импорта.
- Восстановите ранее созданный каталог вложений, в каталог вложений вашей новой JIRA. (См. Восстановление данных.)
Избегайте прохода через прокси при выполнении восстановления XML, особенно если ваш экземпляр JIRA очень велик. Использование прокси-сервера может привести к ошибкам тайм-аута.
- Получите доступ к JIRA через веб-браузер и войдите в систему, используя имя пользователя из вашей предыдущей установки JIRA.
- Осмотрите свой сайт JIRA, чтобы убедиться, что ваши проекты и проблемы присутствуют, и все выглядит нормально. Вы должны увидеть новый номер версии JIRA в нижнем колонтитуле страницы.
- Почтовые проверки миграции и задачи
Настоятельно рекомендуется выполнить следующие проверки и задачи (tasks) после запуска нового экземпляра JIRA:
- Проверьте журналы сервера на наличие сообщений об ошибках, даже если JIRA работает правильно. Если у вас есть какие-либо ошибки, которые вы не можете решить, создайте файл поддержки в https://support.atlassian.com, приложите свой файл журнала, и мы сообщим вам об ошибках.
- Если вы ранее использовали внешнее управление пользователями, включите его в новом экземпляре JIRA.
- Если вы изменили компьютеры при обновлении, измените пути на индексы, вложения и каталоги резервных копий из раздела администрирования JIRA.
- Включите электронную почту, если вы отключили ее во время тестирования.
-
Если вы перенесли какие-либо настройки из своей старой JIRA в новую JIRA, убедитесь, что они протестированы полностью.
- Если вы загрузили плагины для новой версии JIRA, установите загруженные файлы JAR в новую версию JIRA и выполните любую другую необходимую установку для плагина.
- Если плагин имеет файл свойств, примените к нему те же изменения, что и в старом файле свойств (не копируйте только старый файл свойств).
Поздравления! Вы завершили миграцию / обновление JIRA.
Смотрите также
Отключение автоматического экспорта
Восстановление данных
Модернизация JIRA
Переключение серверов приложений на Apache Tomcat
Переключение баз данных
Миграция JIRA на другой сервер
В этом документе описывается, как переносить / обновлять JIRA 6.4 на другом серверном оборудовании или в другой серверной среде, которая влечет за собой одно или несколько из следующих действий:
- новая операционная система, которая будет запускать JIRA,
- новые местоположения для хранения вашего индекса и / или вложений или
- новую базу данных или систему баз данных, которая будет хранить данные JIRA.
Если вы переходите на новую версию JIRA во время миграции, см. Раздел «Обновление JIRA» для получения информации о необходимых задачах, которые необходимо выполнить перед обновлением.
Если вы меняете свою операционную систему от Windows до Linux или наоборот, помните, что вам нужно будет отменить «косые черты»(слэши), когда это необходимо в ваших путях файлов ('/' к '\' или '\' к '/ ').
- Прежде чем начать
- Проверьте свою лицензию. Убедитесь, что срок действия вашей лицензии действителен.
- Проверьте известные задачи- используйте базу знаний JIRA для поиска любых задач в новой версии, которые будут влиять на вас.
-
Проверьте совместимость:
- Убедитесь, что ваша операционная система, база данных, другие применимые платформы и аппаратные средства по-прежнему соответствуют требованиям для JIRA 6.4. Объявление о завершении поддержки для страницы JIRA также содержит важную информацию о поддержке платформы для будущих версий JIRA.
- Если вы установили надстройки JIRA (т. е. не включеные в JIRA), убедитесь, что они будут совместимы. Вы можете найти информацию о совместимости надстройки на домашней странице надстройки на Atlassian Marketplace. Вы также можете выполнить описанную здесь процедуру: проверка совместимости надстройки с обновлениями приложений, чтобы помочь вам с помощью универсального менеджера надстроек.
- Если у вас возникли проблемы с тестовой средой, которые вы не можете решить, создайте задачу на нашем сайте поддержки, чтобы мы могли вам помочь.
-
Если у вас возникли проблемы во время миграции вашего производственного JIRA-сервера, не разрешайте пользователям использовать этот сервер. Вместо этого:
- Продолжайте использовать старый сервер JIRA - это поможет вам не потерять производственные данные.
- Также создайте задачу на нашем сайте поддержки, чтобы мы могли помочь вам решить проблемы с вашей миграцией.
Некоторые антивирусные или другие средства безопасности в Интернете могут помешать миграции и предотвратить успешное завершение процесса. Если вы испытываете или ожидаете, что будете испытывать такую задачу с средством защиты от вирусов / обеспечения безопасности Интернета, сначала отключите этот инструмент, прежде чем продолжить миграцию JIRA.
- Резервное копирование
2.1. Запретить пользователям обновлять данные JIRA
Во время процесса обновления вы экспортируете базу данных JIRA из существующей установки JIRA (через резервную копию XML), а затем восстановите эту резервную копию в новой установке JIRA. Чтобы данные в резервной копии XML соответствовали последним данным в системе, вы должны временно ограничить доступ к JIRA, чтобы пользователи не могли обновлять данные. Дополнительную информацию см. В разделе Предотвращение доступа пользователей к странице JIRA во время резервного копирования.
(предупреждение) Знайте! Непоследовательные резервные копии XML не могут быть восстановлены!
2.2 Резервное копирование базы данных
Выполните резервное копирование XML существующей внешней базы данных установки JIRA. Для больших установок JIRA для этого процесса может потребоваться несколько часов.
«Встроенная база данных» - это база данных HSQLDB, поставляемая с JIRA только для оценки. Если вы случайно используете базу данных HSQLDB в производственной системе, выполните резервное копирование XML этой базы данных и продолжите эту процедуру.
- Резервное копирование каталога JIRA Home
- Выключите JIRA.
- Найдите каталог JIRA Home. Вы можете найти информацию о расположении каталога, перейдя в файл <jira-application-dir> /WEB-INF/classes/jira-application.properties в каталоге установки JIRA. Кроме того, вы можете открыть JIRA Configuration Tool, чтобы увидеть каталог, который настроен как ваш JIRA Home.
- Перейдите в каталог, указанный в файле конфигурации, и создайте резервную копию в другом каталоге.
- (красный крестик ошибка) Удалите файл <jira-home> /dbconfig.xml из исходной папки сразу после завершения резервного копирования.
2.4 Создайте резервные копии ваших вложений и индексы каталогов, если они находятся за пределами вашего домашнего каталога JIRA
Если вложения и индексы каталогов расположены за пределами вашего домашнего каталога JIRA, вы должны резервировать их отдельно. На этих страницах описывается, как определить, где эти каталоги находятся в вашей реализации:
- Каталог ваших вложений - обратитесь к разделу «Настройка файлов вложений» в документации для вашей версии JIRA.
- Ваш индексный каталог - см. Страницу индексирования поиска в документации для вашей версии JIRA.
Также см. Резервное копирование данных для получения дополнительной информации о резервном копировании вложений в JIRA.
2.5 Создайте резервную копию каталога установки JIRA
«Каталог установки JIRA» - это каталог, в который были загружены файлы и библиотеки приложений JIRA при установке JIRA.
- Настройка новой установки JIRA
3.1 Установите новую версию JIRA
Во-первых, вы должны начать с свежей установкой JIRA, либо текущей версией, либо новейшей. Если вы обновляете JIRA во время этого процесса, см. «Обновление JIRA» для получения информации о необходимых заданиях (tasks), которые необходимо выполнить перед обновлением.
Загрузите и извлеките требуемый дистрибутив JIRA в новый каталог. Не перезаписывайте существующую установку JIRA. Убедитесь, что это было отключено, и установите новую версию JIRA в новое место.
Следуйте инструкциям по установке:
- Установка JIRA (рекомендуется) или
- Установка JIRA WAR
(info) Если вы используете JIRA WAR, не забудьте создать новое веб-приложение JIRA и развернуть его на своем сервере. Для получения конкретных инструкций обратитесь к странице установки JIRA WAR для вашего сервера приложений в разделе «Установка JIRA WAR».
3.2 Укажите свою новую JIRA (копию) существующего каталога JIRA Home
Если ваша новая установка JIRA 6.4 находится на новом сервере, перед продолжением скопируйте резервную копию существующего домашнего каталога JIRA со старого сервера на новый сервер.
Чтобы настроить «рекомендуемое» (не WAR) распределение:
- Откройте JIRA Configuration Tool.
- Перейдите на вкладку JIRA Home.
- Обновите поле Домашний каталог JIRA:
- Если ваша установка JIRA 6.4 находится на новом сервере, обновите поле Home Directory JIRA на пути к скопированному каталогу JIRA Home.
- Если ваша установка JIRA 6.4 находится на том же сервере, обновите поле Home Directory JIRA на пути к существующему каталогу JIRA Home.
(info) Для получения дополнительной информации об этом каталоге см. JIRA Home Directory.
Чтобы настроить распределение WAR:
- Отредактируйте файл jira-application.properties, расположенный в подкаталоге <jira-application-dir> / WEB-INF / classes вашего нового каталога установки JIRA 6.4 Installation Directory JIRA.
- Обновите свойство jira.home в этом файле на пути к новому домашнему каталогу JIRA:
- Если ваша установка JIRA 6.4 находится на новом сервере, обновите свойство jira.home до пути скопированного каталога JIRA Home.
- Если ваша установка JIRA 6.4 находится на том же сервере, обновите свойство jira.home до пути к существующему каталогу JIRA Home.
(info) Для получения дополнительной информации об этом каталоге см. JIRA Home Directory.
- Удалите '#' в начале строки jira.home (чтобы JIRA больше не рассматривала эту строку как комментарий).
- Сохраните обновленный файл jira-application.properties.
(галочка) Вы также можете установить местоположение вашего домашнего каталога JIRA, указав переменную среды JIRA_HOME. Это значение этой переменной имеет приоритет над значением свойства jira.home в файле jira-application.properties в каталоге установки JIRA. Подробнее см. В разделе «Настройка домашнего каталога JIRA».
3.3 Подключите новую версию JIRA к новой пустой базе данных
Создайте новую, пустую базу данных, которую ваша новая установка JIRA будет использовать для хранения своих данных.
Следуйте инструкциям «Подключение JIRA к ...» для вашей базы данных со стадии 2, хотя со стадии 4 этой процедуры обратите внимание на желтую заметку ниже:
- Подключение JIRA к PostgreSQL
- Подключение JIRA к MySQL
- Подключение JIRA к Oracle
- Подключение JIRA к SQL Server 2005
- Подключение JIRA к SQL Server 2008
(info) Вам не нужно создавать новую базу данных, если вы используете встроенную базу данных HSQL.
3.4 Перенесите существующие конфигурации JIRA на новую установку JIRA
Если вы изменили свойства в конфигурационных файлах существующей установки JIRA, внесите те же изменения в новую установку JIRA. Однако, поскольку свойства в файлах конфигурации могут быть изменены между версиями, вы не можете просто скопировать файлы конфигурации из существующей установки и заменить эквивалентные файлы в новой установке.
Для каждого файла, который вы изменили в своей существующей установке JIRA, вам необходимо вручную отредактировать каждый эквивалентный файл в вашей новой установке JIRA и повторно применить ваши изменения. Если файл отсутствует в вашей новой установке JIRA (например, osuser.xml в последних версиях JIRA), просто скопируйте этот файл на новую установку JIRA.
В приведенной ниже таблице перечислены наиболее часто изменяемые файлы и их местоположения в каталоге установки JIRA:
файл |
Расположение в разделе «Рекомендуемые» (ранее «Автономные») распределения JIRA |
Расположение в JIRA WAR |
Описание |
jira-application.properties |
atlassian-jira/WEB-INF/classes |
webapp/WEB-INF/classes |
Расположение исходного каталога JIRA и расширенной конфигурации JIRA в JIRA 4.3.x и более ранних версиях.
Любые значения пользовательских свойств, определенные в файле jira-application.properties существующей установки JIRA 4.3.x (или более ранней), должны быть перенесены в файл jira-application.properties вашей новой установки JIRA 6.4, прежде чем вы начнете новую установку JIRA .
После запуска вашей новой установки JIRA любые значения пользовательских свойств в файле jira-application.properties будут автоматически перенесены в базу данных JIRA или файл jira-config.properties. jira.home является единственным свойством файла jira-application.properties, впоследствии используемого JIRA. |
setenv.bat (Windows) or setenv.sh (Linux) |
bin |
Каталог bin сервера приложений |
Увеличение памяти JIRA |
osuser.xml (не требуется при обновлении с JIRA 4.3.0 или новее) |
atlassian-jira/WEB-INF/classes |
webapp/WEB-INF/classes |
Изменено, если вы интегрировали LDAP с JIRA, интегрировали Crowd с JIRA или используете пользовательскую форму внешнего управления пользователями или аутентификации пользователей. |
seraph-config.xml |
atlassian-jira/WEB-INF/classes |
webapp/WEB-INF/classes |
Изменено, если вы интегрировали Crowd с JIRA. |
server.xml |
conf |
Каталог conf сервера приложений |
Изменено в следующих ситуациях:
· Если вы ранее настроили TCP-порты JIRA по-разному от своих значений по умолчанию. · Если вы использовали SSL. · При подключении JIRA к базе данных в JIRA 4.3.x и ранее. |
Определенные для версии примечания обновления содержат детали относительно свойств, которые, возможно, изменились в этих обычно изменяемых файлах.
Помимо файлов выше, вы также должны рассмотреть и / или выполнить следующие конфигурации как часть процесса обновления:
-
Использование JIRA с Atlassian's Crowd? - Если вы используете Crowd с JIRA, настройте новую JIRA, чтобы поговорить с Crowd, как описано в разделе «Интеграция Crowd с JIRA».
- Не забудьте настроить Crowd для предоставления нового имени хоста / IP-доступа JIRA: Указание адреса приложения или имени хоста
- Выделение дополнительной памяти для JIRA—если вы ранее выделили дополнительную память JIRA, сделайте то же самое для своего нового экземпляра JIRA. Для получения дополнительной информации см. Расширение памяти JIRA.
- Плагины—для любых плагинов, которые вы установили в своей старой JIRA, загрузите версию плагина для своей новой версии JIRA с сайта http://plugins.atlassian.com.
- Кодировка символов—убедитесь, что кодировка символов (например, локаль) одинакова в новых и старых местах. Ваша новая версия JIRA может работать некорректно, если вложения перемещаются между двумя системами с несовместимым кодированием.
- Индивидуальные настройки—если вы внесли какие-либо настройки (код, шаблоны или файлы конфигурации), скопируйте совместимые версии этих изменений в новую JIRA. (Разработчики в вашей организации, которые внесли настройки в вашу старую версию, должны будут создавать и тестировать эквивалентные изменения для новой версии и предоставлять вам файлы для копирования на вашу обновленную установку JIRA.)
- (Необязательно) Запуск JIRA на другом порту—если ваша новая JIRA установлена на том же компьютере, что и ваша старая JIRA, вы можете убедиться, что она работает на другом порту (если вам когда-либо понадобится перезапустить старую JIRA). Подробнее см. Изменение портов TCP JIRA.
3.5 Начните новую версию JIRA
- Убедитесь, что ваша старая установка JIRA закрыта - если этот JIRA-сервер все еще работает, закройте его.
- Если вы установили дистрибутив JIRA WAR в Tomcat, удалите рабочий каталог Tomcat перед перезапуском JIRA. Если вы этого не сделаете, пользователи могут столкнуться с ошибками при попытке отображения страниц JIRA.
- Запустите свою новую версию JIRA. Для:
- «Рекомендуемые» дистрибутивы - следуйте инструкциям «Запуск JIRA».
- Распределения WAR - следуйте инструкциям для запуска JIRA для вашего сервера приложений в разделе «Установка JIRA WAR».
В процессе запуска ваша новая установка JIRA создаст любые необходимые индексы базы данных. Если вы создали пользовательские индексы базы данных, проверьте их позже и удалите все дубликаты индексов, добавленных JIRA.
3.6 Импорт данных старой JIRA в новую JIRA
После того, как вы запустили новую установку JIRA, вы должны войти в ваше приложение JIRA и готовы импортировать данные из старого экземпляра в новый экземпляр. Вам понадобится резервный файл данных из старой JIRA, который вы создали ранее в этих инструкциях (см. выше).тобы импортировать старые данные JIRA в новую JIRA:
- Войдите в систему как пользователь с глобальным разрешением «Системные администраторы JIRA».
- Выберите «Администрирование»(Administration)> «Система»(System)> «Импорт и экспорт» (Import & Export)> «Восстановить систему»(Restore System) (вкладка), чтобы открыть страницу «Восстановить данные JIRA с резервной копии».(Restore JIRA data from Backup)
Комбинация клавиш: 'g' + 'g' + тип 'rest'
- В поле «Имя файла» укажите файл резервной копии XML, созданный ранее во время процесса экспорта (см. выше). Этот сжатый архиватором zip файл должен содержать два xml-файла: activeobjects.xml и entities.xml. Оба этих файла должны быть включены в зашифрованный файл для работы процесса импорта.
- Восстановите ранее созданный каталог вложений, в каталог вложений вашей новой JIRA. (См. Восстановление данных.)
Избегайте прохода через прокси при выполнении восстановления XML, особенно если ваш экземпляр JIRA очень велик. Использование прокси-сервера может привести к ошибкам тайм-аута.
- Получите доступ к JIRA через веб-браузер и войдите в систему, используя имя пользователя из вашей предыдущей установки JIRA.
- Осмотрите свой сайт JIRA, чтобы убедиться, что ваши проекты и проблемы присутствуют, и все выглядит нормально. Вы должны увидеть новый номер версии JIRA в нижнем колонтитуле страницы.
- Почтовые проверки миграции и задачи
Настоятельно рекомендуется выполнить следующие проверки и задачи (tasks) после запуска нового экземпляра JIRA:
- Проверьте журналы сервера на наличие сообщений об ошибках, даже если JIRA работает правильно. Если у вас есть какие-либо ошибки, которые вы не можете решить, создайте файл поддержки в https://support.atlassian.com, приложите свой файл журнала, и мы сообщим вам об ошибках.
- Если вы ранее использовали внешнее управление пользователями, включите его в новом экземпляре JIRA.
- Если вы изменили компьютеры при обновлении, измените пути на индексы, вложения и каталоги резервных копий из раздела администрирования JIRA.
- Включите электронную почту, если вы отключили ее во время тестирования.
-
Если вы перенесли какие-либо настройки из своей старой JIRA в новую JIRA, убедитесь, что они протестированы полностью.
- Если вы загрузили плагины для новой версии JIRA, установите загруженные файлы JAR в новую версию JIRA и выполните любую другую необходимую установку для плагина.
- Если плагин имеет файл свойств, примените к нему те же изменения, что и в старом файле свойств (не копируйте только старый файл свойств).
Поздравления! Вы завершили миграцию / обновление JIRA.
Смотрите также
Отключение автоматического экспорта
Восстановление данных
Модернизация JIRA
Переключение серверов приложений на Apache Tomcat
Переключение баз данных