Прикладные модули > Agile-доски > Локальная установка решения

Для установки решения «Agile-доски» используется инструмент Directum Launcher. Подробнее см. в документации Directum RX в руководстве администратора, раздел «Установка системы (Directum Launcher)» (Windows, Linux).

Чтобы установить решение:

1.Ознакомьтесь с типовыми требованиями и убедитесь, что ваше аппаратное и программное обеспечение подходит для установки решения.

2.Выберите вариант установки:

•вместе с серверной частью Directum RX;

•дополнительно к Directum RX, если система была развернута ранее. Также возможна установка с помощью командной строки, в том числе совместно с решениями «Планирование проектов» и «База знаний»;

• на сервер со средой разработки, если планируется модификация решения.

3.После установки настройте интеграцию с Directum RX.

ВАЖНО. Компонент agile зависит от компонента DirectumRX. Их версии должны быть совместимы. Если зависимый компонент нужной версии не найден в папке с Directum Launcher, то при запуске инструмента установки возникнет ошибка. Проверьте, что все нужные архивы есть в папке.

Порядок установки решения «Agile-доски» в операционных системах Microsoft Windows и Linux совпадает. При этом расширение архивов и синтаксис команд отличается в зависимости от операционной системы.

Пример команды:

./do.sh <команда>

do <команда>

Далее в разделе приведен порядок установки на Windows.

Установка вместе с Directum RX

1.Архив с Directum Launcher распакуйте в локальную папку на сервере. В корень папки скопируйте архивы Platform.zip, DirectumRX.zip и другие, включая agile.zip. Подробнее см. в документации Directum RX в руководстве администратора, раздел «Серверная часть Directum RX» (Windows, Linux).

ВАЖНО. Для корректной установки общий путь к файлам должен быть не более 256 символов. Также он не должен содержать пробелы, символы кириллицы, запятые и спецсимволы. Поэтому используйте, например, папку D:\DirectumLauncher.

2.От имени администратора запустите файл DirectumLauncher.exe. Откроется командная строка, в ней запустится сервис развертывания, в браузере откроется страница с параметрами установки и обновления. До окончания установки не закрывайте окно командной строки.

Страницу можно открыть вручную по ссылке http://127.0.0.1:5000/, например, если случайно закрыли браузер или он не настроен по умолчанию.

Подробнее см. в документации Directum RX в руководстве администратора, раздел «Серверная часть Directum RX» (Windows, Linux).

3.На странице Развертывание убедитесь, что установлен переключатель Установка.

4.Укажите настройки сервисов Directum RX и остальных компонентов. Подробнее см. в документации Directum RX в руководстве администратора, раздел «Серверная часть Directum RX» (Windows, Linux).

5.Убедитесь, что установлен флажок Agile-доски.

6.Ознакомьтесь с текстом лицензионного соглашения и установите флажок Я принимаю условия лицензионного соглашения.

7.Нажмите на кнопку Установить и дождитесь окончания установки.

8.Настройте интеграцию с Directum RX.

9.Чтобы использовать возможности решения, запросите и активируйте ключи лицензии.

Установка дополнительно к Directum RX

1.Из дистрибутива Directum RX в корень папки Directum Launcher скопируйте архив agile.zip.

Если нужно установить решения «Планирование проектов» и «База знаний», дополнительно скопируйте архивы projectplanning.zip, pivottable.zip и memo.zip.

2.Убедитесь, что в папке с Directum Launcher есть компоненты Platform.zip и DirectumRX.zip. Подробнее см. в документации Directum RX в руководстве администратора, раздел «Серверная часть Directum RX» (Windows, Linux).

3.От имени администратора запустите файл DirectumLauncher.exe. Откроется командная строка, в ней запустится сервис развертывания, в браузере откроется страница с параметрами установки и обновления. До окончания установки не закрывайте окно командной строки.

Подробнее см. в документации Directum RX в руководстве администратора, раздел «Серверная часть Directum RX» (Windows, Linux).

4.На странице Развертывание убедитесь, что установлен переключатель Установка.

5.Убедитесь, что установлены флажки Agile-доски и Прикладная разработка Directum RX.

6.Для установки решений «Планирование проектов» и «База знаний» установите флажки Планирование проектов и База знаний.

7.Ознакомьтесь с текстом лицензионного соглашения и установите флажок Я принимаю условия лицензионного соглашения.

8.Нажмите на кнопку Обновить и дождитесь окончания установки.

9.Настройте интеграцию с Directum RX.

10.Чтобы использовать возможности решения, запросите и активируйте ключи лицензии.

Установка с помощью командной строки

1.Из комплекта поставки в корень папки с Directum Launcher скопируйте архив с решением agile.zip.

3.Добавьте компонент решения. Для этого выполните команду:

do components add agile

4.Установите решение. Для этого выполните команду:

do agile install

Примечание. С версии Directum RX 4.12 можно использовать ключи package и package-from-component. Подробнее см. в документации Directum RX в руководстве администратора, раздел «Команды скриптов развертывания» (Windows, Linux).

5.Дождитесь окончания установки и перезапустите веб-клиент. Для этого выполните команду:

do webclient up

6.Настройте интеграцию с Directum RX.

7.Чтобы использовать возможности решения, запросите и активируйте ключи лицензии.

Совместная установка решений с помощью командной строки

Если в компании планируется использовать решения «Agile-доски», «Планирование проектов» и «База знаний», рекомендуется установить их вместе. Для этого:

1.Из комплекта поставки в корень папки с Directum Launcher скопируйте архивы с решениями:

•agile.zip – решение «Agile-доски»;

•projectplanning.zip – решение «Планирование проектов»;

•pivottable.zip – компонент для работы со сводными таблицами;

•memo.zip – решение «База знаний».

3.Добавьте компонент решения «Agile-доски». Для этого выполните команду:

do components add agile

4.Добавьте компонент решения «Планирование проектов». Для этого выполните команду:

do components add projectplanning

5.Добавьте компонент решения «База знаний». Для этого выполните команду:

do components add memo

6.Установите решение «Agile-доски». Для этого выполните команду:

do agile install --package-from-component=“projectplanning;memo;directumrx”

Примечание. Установка может занимать длительное время, дождитесь ее окончания.

7.Установите компонент решения «Планирование проектов». Для этого выполните команду:

do projectplanning install --only client

8.Установите компонент решения «База знаний». Для этого выполните команду:

do memo install --only client

9.Перезапустите веб-клиент. Для этого выполните команду:

do webclient up

10.Импортируйте шаблоны планов проектов. Для этого выполните команду:

do projectplanning import_templates

11.Импортируйте шаблоны документов решения «База знаний». Для этого выполните команду:

do memo import_templates

12.Настройте интеграцию с Directum RX.

13.Чтобы использовать возможности решения, запросите и активируйте ключи лицензии.

Установка на сервер со средой разработки

Чтобы адаптировать решение под потребности компании, можно внести изменения в его прикладную разработку, добавив в этапы плана проекта новые свойства. Для этого необходимо установить решение на компьютер, где установлена среда разработки Directum RX Development Studio.

ВАЖНО. Перед началом установки убедитесь, что все изменения в других решениях отправлены на Git-сервер.

Порядок установки:

1.Запросите в службе поддержки дистрибутив решения с пакетами разработки:

•AgileBoardsSolution_Base.dat – при импорте на базовый слой разработки;

•AgileBoardsSolution_Work.dat – при импорте на рабочий слой разработки.

2.Импортируйте нужный пакет в среду разработки. Подробнее см. в руководстве разработчика Directum RX, раздел «Импорт разработки».

3.В среде разработке опубликуйте решение, затем запустите его инициализацию. Подробнее см. в руководстве разработчика Directum RX, раздел «Публикация с помощью среды разработки».

4.Из дистрибутива решения в корень папки Directum Launcher скопируйте архив agile.zip.

6.Настройте интеграцию с Directum RX.

ВАЖНО. Отладочный веб-сервер работает только по протоколу HTTP. Поэтому при настройке интеграции добавьте параметр RD_WEB_CUSTOM_SCHEME со значением http.

При запуске Directum Launcher автоматически добавляется компонент решения. В результате в директорию Directum Launcher\etc\_builds добавляется папка agile.

7.Установите веб-интерфейс решения и перезапустите веб-клиент. Для этого из папки с Directum Launcher последовательно выполните команды:

do agile install --only_client

do webclient up

Настройка интеграции с Directum RX

При установке решения «Agile-доски» задаются минимально необходимые настройки. Их можно изменить:

•во встроенном редакторе YAML (рекомендуется). Подробнее см. в документации Directum RX в руководстве администратора, раздел «Встроенный редактор YAML» (Windows, Linux);

•в конфигурационном файле config.yml.

Убедитесь, что для сервисов Directum RX заданы настройки интеграции. Для этого:

1.Запустите Directum Launcher. Подробнее см. в документации Directum RX в руководстве администратора, раздел «Настройка через Directum Launcher» (Windows, Linux).

2.Убедитесь, что на открывшейся странице установлен переключатель Настройка.

3.Измените положение переключателя Визуальный режим конфигурирования. В результате во встроенном редакторе YAML отображается содержимое файла config.yml.

4.Если система Directum RX работает по протоколу HTTP, в секции common_config добавьте параметр RD_WEB_CUSTOM_SCHEME и укажите для него значение http. При работе по протоколу HTTPS добавлять параметр необязательно.

5.Сравните адрес обработчика гиперссылок, который указан в параметре HYPERLINK_SERVER, с адресом веб-клиента Directum RX. Если они совпадают, перейдите к следующему пункту настройки. Иначе в секции common_config добавьте параметры:

•RD_WEB_CUSTOM_HOST, если в адресах отличаются хосты. В параметре укажите хост системы Directum RX. Например, если адрес веб-клиента https://rx.company.ru/ClientWeb, укажите значение rx.company.ru.

•RD_WEB_CUSTOM_PORT, если в адресах отличаются хосты и для работы с системой используется нестандартный порт. В параметре укажите значение этого порта. По умолчанию для работы по протоколу HTTPS используется стандартный порт 443, по протоколу HTTP – 80.

Примеры настройки

Пример 1:

•адрес веб-клиента – https://rx.company.ru/ClientWeb;

•адрес обработчика гиперссылок – http://rx.company.ru:4332/.

Для работы с системой используется протокол HTTPS, а адрес хоста системы совпадает с адресом хоста обработчика гиперссылок. Поэтому добавлять параметры не нужно.

Пример 2:

•адрес веб-клиента – http://rx.company.ru/ClientWeb;

•адрес обработчика гиперссылок – https://hyperlinks.rx.company.ru:4332/.

В этом случае в секцию common_config добавьте параметры:

RD_WEB_CUSTOM_SCHEME: 'http'
RD_WEB_CUSTOM_HOST: 'rx.company.ru'

Пример 3:

•адрес веб-клиента – https://rx.company.ru:4332/ClientWeb;

•адрес обработчика гиперссылок – https://hyperlinks.rx.company.ru/.

В этом случае в секцию common_config добавьте параметры:

RD_WEB_CUSTOM_HOST: 'rx.company.ru'
RD_WEB_CUSTOM_PORT: '4332'

Подробнее см. в документации Directum RX в руководстве администратора, раздел «Общие настройки» (Windows, Linux).

6.Убедитесь, что в секции сервиса интеграции IntegrationService для параметра AUTH_COOKIE_SCHEME_ENABLED установлено значение true. Подробнее см. в документации Directum RX в руководстве администратора, раздел «Сервис интеграции» (Windows, Linux).

7.В секции сервиса интеграции IntegrationService в параметре INTEGRATION_SERVICE_RELATIVE_PATH проверьте, что верно указан адрес сервиса интеграции. Если параметр не задан, то используется значение по умолчанию Integration.

Укажите этот же адрес в конфигурационном файле решения DirectumLauncher\etc\_builds\agile\client\config.js в параметре INTEGRATION_SERVICE_PATH. Значение параметра указывается в формате /<Адрес сервиса интеграции>/odata. Сохраните изменения, а затем очистите кэш и файлы cookie браузера.

8.Чтобы применить изменения, перезапустите сервис интеграции Directum RX с помощью команды:

do integrationservice up

9.Убедитесь, что в секции services_config заданы настройки для сервиса Public API, который используется для взаимодействия решений с веб-сервером Directum RX:

SungeroPublicApi:

<<: *logs

PUBLIC_API_HOST_HTTP_PORT: # auto

WEB_API_HOST_URI: '{{ protocol }}://{{ host_fqdn }}/Client/api'

PUBLIC_API_HOST_URI: '{{ protocol }}://{{ host_fqdn }}/Client/api/public'

где:

•protocol. Протокол для работы с системой;

•host_fqdn. Адрес сайта, по которому доступна система.

Оба параметра задаются в секции Переменные (variables) при настройке Directum RX. Подробнее см. в документации Directum RX в руководстве администратора, раздел «Минимальные настройки» (Linux, Windows).

Если настройки не заданы, добавьте строки с параметрами вручную, и выполните команду:

./do.sh all up

do all up

СМ. ТАКЖЕ