<< Click to Display Table of Contents >> Администрирование (Windows) > Локальная установка системы > Установка системы (Directum Launcher) Серверная часть Directum RX |
1.Архив с Directum Launcher распакуйте в локальную папку на сервере.
ВАЖНО. Для корректной установки не перемещайте и не переименовывайте папку после распаковки архива. Общий путь к файлам должен быть не более 256 символов. Также он не должен содержать пробелы, символы кириллицы, запятые и спецсимволы. Поэтому используйте, например, папку D:\DirectumLauncher.
2.В корень папки скопируйте архивы:
•Platform.zip – платформа, включающая веб-сервер и сервисы Directum RX;
•DirectumRX.zip – набор стандартных шаблонов документов, утилиты RxCmd и DrxUtil, а также стандартная прикладная разработка Directum RX.
Примечание. Для систем с заказной разработкой в архиве содержится утилита RxCmd, которая позволяет импортировать свои шаблоны документов, запускать и настраивать под себя интеллектуальную обработку документов. Также в архиве есть утилита DrxUtil для настройки интеграции с 1С. Поэтому при установке системы указываются оба пакета разработки: с заказной и со стандартной;
•WebHelp.zip – справка и слайдер;
•Redist.zip – дополнительные компоненты, необходимые для установки серверной части и среды разработки;
•DeploymentTool.zip – утилита DeploymentTool, если планируете ее использовать для публикации решений. Утилита является устаревшей, оставлена для совместимости. Для новых публикаций используйте утилиту DeploymentToolCore, которая устанавливается вместе с платформой
Некоторые компоненты зависят друг от друга. Например, без актуальной платформы нельзя добавить прикладную разработку. Версии зависимых компонентов должны быть совместимы. Если зависимый компонент нужной версии не найден в папке с Directum Launcher, то при запуске инструмента установки возникнет ошибка. Проверьте, что все нужные архивы есть в папке.
В таблице приведены примеры компонентов, у которых есть зависимости:
Компонент |
От какого компонента зависит |
---|---|
DirectumRX |
Platform |
WebHelp |
Platform |
3.От имени администратора запустите файл DirectumLauncher.exe. Откроется командная строка, в ней запустится сервис развертывания, в браузере откроется страница с параметрами установки и обновления. До окончания установки не закрывайте окно командной строки.
Страницу можно открыть вручную по ссылке http://127.0.0.1:5000/, например, если случайно закрыли браузер или он не настроен по умолчанию.
ПРИМЕЧАНИЕ. С помощью ключей запуска можно подключиться к Directum Launcher с другого компьютера, настроить аутентификацию для входа и использовать защищенный протокол HTTPS. Также можно сменить локализацию на английскую. Подробнее см. раздел «Дополнительные параметры запуска Directum Launcher».
4.На странице Развертывание убедитесь, что установлен переключатель Установка и укажите настройки веб-сервера:
Platform. Установите флажок. Если флажок не установлен, то поля с настройками веб-сервера и сервисов Directum RX недоступны.
Адрес сайта, по которому доступна система. По умолчанию заполняется полным доменным именем текущего компьютера. Для работы через Интернет необходимо указать внешнее зарегистрированное DNS-имя сайта, например rx.company.ru. Указанный адрес используется для задания привязок сайта в веб-сервере IIS.
ВАЖНО. После установки системы изменять адрес сайта не рекомендуется.
Протокол, который будет использоваться для работы с системой. Возможные значения: https, http. Значение по умолчанию https. Для работы с системой рекомендуется использовать защищенный протокол HTTPS.
Протокол HTTP не рекомендуется использовать для удаленного доступа к системе Directum RX. Допускается только при работе в локальной сети компании для тестирования системы. В этом случае данные от клиентского приложения к веб-серверу передаются по сети в открытом виде.
HTTP-порт. Порт для работы с системой по протоколу HTTP.
HTTPS-порт. Порт для работы с системой по протоколу HTTPS. Поле активно, если в поле Протокол указано значение https.
Отпечаток сертификата для работы по протоколу HTTPS. Чтобы получить отпечаток, двойным щелчком мыши откройте свойства сертификата, перейдите на вкладку «Состав» и скопируйте значение поля Отпечаток. Сертификат и его закрытый ключ должны быть установлены в личное хранилище текущего компьютера. Сертификат должен подходить для указанного имени сайта. Подробнее см. разделы «Создание SSL-сертификата» и «Установка SSL-сертификата». Поле активно, если в поле Протокол указано значение https.
5.Укажите настройки базы данных и сервисов:
Тип СУБД, которая используется для хранения данных системы Directum RX. Возможные значения: PostgreSQL – PostgreSQL/Postgres Pro/Jatoba, Microsoft SQL – Microsoft SQL Server. При установке системы в Microsoft Windows рекомендуется использовать Microsoft SQL Server.
Выберите вариант развертывания базы данных:
•если БД была создана ранее, снимите флажок Создать новую базу. По умолчанию флажок установлен;
•если нужно создать новую БД, оставьте флажок Создать новую базу установленным.
В поле Сервер БД укажите параметры подключения к новой базе данных Microsoft SQL Server:
•Сервер. Имя компьютера, на котором установлена СУБД (SQL Instance Name). Если при установке Microsoft SQL Server имя компьютера по умолчанию было изменено, укажите имя сервера в формате <Имя компьютера>\<Имя экземпляра>;
•База данных системы Directum RX;
•Пользователь сервера БД. Используется для взаимодействия системы с базой данных. Пользователю достаточно входить в роль public. В этом случае пользователю, от которого система взаимодействует с базой данных, недоступны другие базы сервера БД;
•Пароль пользователя сервера БД. Использование пустого пароля не допускается;
•Администратор. Пользователь сервера БД с правами администратора. Используется только при создании базы данных во время установки системы. Права администратора есть у пользователей, которые на сервере БД включены в роль sysadmin. Для повышения информационной безопасности не рекомендуется указывать стандартного пользователя sa.
Параметр Администратор необязательный. Если в параметре Администратор значение не указано, то в параметре Пользователь нужно указать пользователя с правами администратора сервера БД.
СОВЕТ. Чтобы обезопасить данные, рекомендуется указывать обоих пользователей. Если система Directum RX будет скомпрометирована, то злоумышленник не получит доступ к другим базам на сервере.
•Пароль администратора сервера БД. Заполните параметр, если указано значение в параметре Администратор.
ПРИМЕЧАНИЕ. Параметры подключения к базе данных PostgreSQL см. в инструкции по установке системы в Linux.
Сервер RabbitMQ. Заполните параметры подключения:
•Сервер. IP-адрес сервера, на котором установлен RabbitMQ;
ВАЖНО. Если RabbitMQ установлен на текущем сервере, в качестве адреса нельзя использовать значение 127.0.01. Вместо этого укажите внешний IP-адрес сервера.
•Порт, по которому RabbitMQ взаимодействует с веб-сервером, например 5672;
•Виртуальный хост RabbitMQ, например rxhost. Создается на этапе установки RabbitMQ. По умолчанию /. Чтобы ввести новое имя виртуального хоста, очистите символ /, а затем укажите новое значение;
•Пользователь, Пароль. Имя и пароль пользователя для подключения к RabbitMQ. Пользователь создается на этапе установки RabbitMQ;
•Точка обмена, к которой привязываются очереди сообщений веб-сервера. Также используется для наименования очередей сообщений. Укажите произвольное имя для новой точки обмена, например RxExchange. Она создастся во время установки системы.
ВАЖНО. Необходимо задать новую точку обмена. Если указать точку обмена, которая по умолчанию уже есть в RabbitMQ, при установке системы может возникнуть ошибка.
Сервер MongoDB. В строке подключения задаются:
•Сервер. IP-адрес сервера, на котором установлена СУБД MongoDB.
•Порт, по которому MongoDB взаимодействует с сервисами Directum RX. Значение по умолчанию 27017;
•Пользователь, Пароль. Имя и пароль пользователя для подключения к MongoDB. Пользователь создается на этапе установки MongoDB.
ВАЖНО. Для значений параметров MongoDB учитывается регистр символов.
При заполнении полей Сервер БД, Сервер RabbitMQ и Сервер MongoDB по кнопке можно переключиться на настройку параметров в виде строки подключения. Подробнее см. в руководстве администратора, раздел «Минимальные настройки».
Папка с данными. Укажите путь к локальной папке. Папка создастся автоматически во время установки системы. В ней будут созданы подпапки для хранения содержимого документов, файлов предпросмотра, лог-файлов системы и других данных. Если часть данных нужно хранить в отдельных папках, после установки измените путь в соответствующей настройке конфигурационного файла.
ВАЖНО. Для корректной установки общий путь к файлам должен быть не более 256 символов и не содержать пробелы. Кроме того, данные не должны храниться в папке с Directum Launcher, поэтому задайте отдельную папку, например, D:\RxData.
Пароль, который будет задан для служебных пользователей: Administrator, Service User, Integration Service и Adviser. В поле ниже повторите пароль.
СОВЕТ. Рекомендуется использовать пароль, который состоит из 8 и более символов, содержит строчные и прописные буквы, а также цифры. Это повышает стойкость пароля ко взлому. Если пароль не соответствует рекомендациям, появляется значок предупреждения. При наведении курсора на него отображается подсказка:
С помощью значка можно показать пароль.
6.Укажите дополнительные настройки:
Код системы, который используется в работе сервисов Directum RX и в штрихкодах документов, чтобы различать штрихкоды разных систем. Параметр должен быть уникальным для каждой установленной системы Directum RX. Для продуктивной системы код передается в письме при поставке.
Язык системы. Возможные значения: Русский (ru-ru), Английский (en-us). На выбранном языке будут отображаться наименования шаблонов и видов документов, тексты задач и заданий по умолчанию, а также другие автоматически создаваемые данные.
При этом язык интерфейса веб-клиента Directum RX по умолчанию будет таким же, как в операционной системе. Пользователи могут изменить язык интерфейса в проводнике Directum RX.
Данные в системе отображаются на том языке, на котором их занесли в систему. Их можно заносить на любом языке и любыми символами, независимо от основного языка системы. Все данные хранятся в кодировке Unicode.
ВАЖНО. Язык системы можно задать только во время установки Directum RX, в дальнейшем его изменять нельзя.
7.Убедитесь, что установлен флажок DeploymentToolUI, если планируется использовать утилиту DeploymentTool. Файлы утилиты распакуются в папку DirectumLauncher\etc\_builds\DeploymentToolUI, на рабочем столе создастся ярлык. Флажок доступен, если в корне локальной папки с Directum Launcher есть архив DeploymentTool.zip.
8.Если планируется использовать мобильные приложения Directum Solo и Directum Jazz, убедитесь, что установлен флажок NOMAD. Выполните шаги по установке сервиса NOMAD. Снимите флажок, если мобильные решения не используются.
9.При первой установке системы убедитесь, что установлен флажок DirectumRX для публикации прикладной разработки и заполнено поле Путь до пакета. Флажок и поле отображаются, если в корне локальной папки с Directum Launcher есть архив DirectumRX.zip. При этом флажок недоступен для изменения, если стоит флажок DevelopmentStudio для установки среды разработки.
Если разработка состоит из нескольких пакетов или нужно опубликовать пакет другого решения, то нажмите на кнопку и в появившемся поле укажите путь до пакета:
Таким же образом добавьте все необходимые пакеты. Они должны включать в себя исходные коды. Если нужно удалить поле с пакетом, нажмите на кнопку .
Примечание. Если в строке подключения указана существующая база данных Directum RX с прикладной разработкой, то снимите флажок DirectumRX.
10.Для установки справки убедитесь, что стоит флажок WebHelp. Флажок доступен, если в корне локальной папки с Directum Launcher есть архив WebHelp.zip. Снимите флажок, если система устанавливается для тестирования и нужно сэкономить место на диске.
11.Ознакомьтесь с текстом лицензионного соглашения и установите флажок Я принимаю условия лицензионного соглашения.
12.Нажмите на кнопку Установить. При этом сгенерируется конфигурационный файл config.yml, выполнится проверка подключения к СУБД, RabbitMQ и MongoDB. Неверно заполненные поля подсветятся красным цветом.
Примечание. Если установка запускается на компьютере с Microsoft Windows 2012R2 и службы IIS на нем не были развернуты ранее, на этапе «Настройка IIS» может потребоваться перезагрузка операционной системы. При выполнении этапа запустите оснастку Диспетчер серверов и откройте вкладку «IIS». Если отображается сообщение «В сети: ожидается перезагрузка», то перезагрузите операционную систему и затем с помощью Directum Launcher повторно запустите установку.
13.Дождитесь окончания установки. На странице выводятся этапы установки. В раскрывающейся области с названием этапа отображаются сообщения из лог-файла установки. Во время установки могут появляться дополнительные окна. Чтобы корректно завершить процесс, не закрывайте их.
Если при выполнении этапа возникает ошибка, с помощью сообщения из лог-файла проанализируйте и устраните ее, затем нажмите на кнопку Повторить.
ПРИМЕЧАНИЕ. Если база данных создалась и ошибка возникает на следующих этапах, то перед повторной установкой снимите флажок Создать новую базу.
Если нужно изменить ранее заданные настройки, нажмите на кнопку Вернуться к настройкам. В результате откроется страница установки. Укажите новые значения параметров и по кнопке Установить повторите установку.
Когда установка завершится, на странице появится ссылка для входа в веб-клиент.
Справочная информация
Во время установки в папке DirectumLauncher\etc автоматически создается конфигурационный файл config.yml с заполненными параметрами. Соответствие полей в Directum Launcher и параметров конфигурационного файла:
Параметр установки |
Секция config.yml |
Параметр config.yml |
---|---|---|
Адрес сайта |
variables |
host_fqdn |
Протокол |
variables |
protocol |
HTTP-порт |
variables |
http_port |
HTTPS-порт |
variables |
https_port |
Папка с данными |
variables |
home_path |
Тип СУБД |
common_config |
DATABASE_ENGINE |
Сервер БД |
common_config |
CONNECTION_STRING |
Сервер RabbitMQ |
common_config |
QUEUE_CONNECTION_STRING |
Сервер MongoDB |
common_config |
MONGODB_CONNECTION_STRING |
Пароль администратора |
common_config |
AUTHENTICATION_PASSWORD |
Код системы |
common_config |
PRIMARY_TENANT |
Язык системы |
common_config |
LANGUAGE |
Отпечаток сертификата |
IIS |
ssl_cert_thumbprint |
© Компания Directum, 2024 |