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

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

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

•«Планирование проектов» – для детального планирования проектных работ и мониторинга их исполнения;

•«Портфели и программы» – для координации проектной деятельности и верхнеуровневого управления.

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

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

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

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

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

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

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

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

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

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

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

do <команда>

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

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

1.Архив с Directum Launcher распакуйте в локальную папку на сервере. В корень папки скопируйте архивы Platform.zip, DirectumRX.zip и другие, включая:

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

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

Подробнее см. в документации 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.Убедитесь, что установлен флажок Планирование проектов.

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

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

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

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

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

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

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

Если нужно установить решения «Agile-доски» и «База знаний», дополнительно скопируйте архивы agile.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.Убедитесь, что установлены флажки Планирование проектов и Прикладная разработка Directum RX.

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

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

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

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

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

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

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

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

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

do components add projectplanning

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

do projectplanning install

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

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

do webclient up

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

do projectplanning import_templates

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

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

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

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

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

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

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

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

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

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

do components add projectplanning

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

do components add agile

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

do components add memo

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

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

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

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

do agile 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.Из архива projectplanning.zip в дистрибутиве решения извлеките пакет разработки ProjectPlanner.dat в любую локальную папку.

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

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

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

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

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

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

do components add projectplanning

В результате в директорию Directum Launcher\etc\_builds добавляются папки projectplanning и pivottable.

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

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

7.Из папки с Directum Launcher последовательно выполните команды:

do projectplanning install --only_client

do webclient up

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

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

•во встроенном редакторе 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\projectplanning\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

СМ. ТАКЖЕ