Загрузка...

Установка

Documenos ®

Documenos® совместим с архитектурами x86 и ARM.

Процессор вашего сервера может быть на базе x86 или ARM. Documenos® совместим с обоими вариантами. Установочные файлы для каждой серверной архитектуры можно загрузить на этой странице: Скачать

Есть два способа установки: с помощью Docker все компоненты запускаются одной командой — это рекомендуемый способ. Установка на Windows IIS предпочтительна, если вы хотите запускать приложение в существующей серверной инфраструктуре Windows.

ARM / x86

Установка с помощью Docker

Единый пакет устанавливает приложение, базу данных PostgreSQL, службу цифровой подписи, поисковую систему Elasticsearch и службу перевода LibreTranslate.

  1. Подготовьте необходимые компоненты. На сервере должны быть установлены Docker Engine (20.10+) и плагин Docker Compose (2.0+). Для контейнера приложения должно быть доступно не менее 8 GB RAM, а серверу требуется доступ в интернет для загрузки образов контейнеров. Работает в Linux, Windows и macOS.
  2. Загрузите пакет. Загрузите пакет Docker Compose (ZIP) на странице Скачать. Пакет состоит из файлов docker-compose.yml с определениями служб, .env со значениями конфигурации и readme.md с примечаниями по установке. Скопируйте папку на сервер без изменений.
  3. Задайте пароли. Откройте файл .env и перед запуском контейнеров обязательно замените эти два значения собственными надёжными и уникальными: DB_PASSWORD (пароль пользователя базы данных PostgreSQL) и DEFAULT_PWD (начальный пароль, назначаемый новым пользователям; пользователи должны сменить его после первого входа). Никогда не используйте примерные пароли или пароли по умолчанию в производственной среде.
  4. Проверьте сетевые настройки и настройки портов. Проверьте значения *_BIND_IP и *_PORT. По умолчанию службы базы данных, подписи, поиска и перевода привязаны только к адресу 127.0.0.1 и недоступны извне; единственный открытый наружу порт — порт приложения (APP_PORT, по умолчанию 8080). Если приложение работает за балансировщиком нагрузки или обратным прокси-сервером, укажите значение CLIENT_IP_HEADER (например, X-Forwarded-For).
  5. Запустите службы. В папке, где находится файл docker-compose.yml, выполните команду: docker compose up -d
  6. Дождитесь завершения первого запуска. При первом запуске служба перевода загружает языковые модели, заданные параметром TRANSLATE_LOAD_ONLY; при обычном подключении это занимает 5–10 минут и выполняется только один раз. Следить за ходом можно с помощью команд docker compose ps и docker compose logs -f documenos_translate. Во время загрузки служба имеет статус starting, а по готовности — healthy. Если подключение медленное, увеличьте значение TRANSLATE_START_PERIOD.
  7. Откройте приложение. Откройте в браузере http://адрес-вашего-сервера:8080 (или заданное вами значение APP_PORT), следуя инструкциям первого запуска, создайте учётную запись администратора и зарегистрируйте лицензию.

Обновление: Загрузите последний пакет, перенесите текущие значения конфигурации в новый файл .env и выполните docker compose pull, а затем docker compose up -d. Ваши данные хранятся в именованных томах Docker (volume) и не затрагиваются обновлениями и перезапусками.

Установка на Windows IIS

Documenos® — это приложение ASP.NET Core, которое работает на IIS через модуль ASP.NET Core.

  1. Подготовьте необходимые компоненты. Включите роль IIS в Windows Server и установите пакет ASP.NET Core Hosting Bundle. Hosting Bundle необходимо устанавливать после IIS, иначе модуль ASP.NET Core не будет зарегистрирован в IIS. После установки перезапустите IIS командой iisreset.
  2. Подготовьте сервер базы данных. Установите PostgreSQL (v15 или новее) или обеспечьте доступ к существующему серверу PostgreSQL. Documenos® использует отдельные базы данных для ядра (DOCUMENOS_CORE), отчётности (DOCUMENOS_REPORT) и распознавания лиц (DOCUMENOS_FACE).
  3. Подготовьте вспомогательные службы. Для полнотекстового поиска требуется Elasticsearch, для электронной подписи — служба цифровой подписи, а для автоматического перевода на собственном сервере — LibreTranslate. Запустите эти службы на отдельном сервере с помощью определений из пакета Docker и запишите адреса, по которым приложение сможет к ним обращаться.
  4. Загрузите ZIP-пакет. Загрузите пакет, введя ключ загрузки в разделе ZIP-файл для Windows IIS на странице Скачать.
  5. Распакуйте файлы на сервер. Распакуйте содержимое ZIP-архива в папку, выделенную для веб-сайта, например C:\inetpub\documenos.
  6. Настройте параметры подключения. В файле appsettings.json в папке приложения укажите параметры подключения к PostgreSQL (CnStrServer, CnStr, CnStrBI, CnStrFA) в разделе ConnectionStrings. В этом же файле задайте адреса служб подписи и перевода (SignatureServiceUrl, TranslateServiceUrl). Подключение к поисковому серверу Elasticsearch настраивается в панели администрирования после установки.
  7. Создайте пул приложений. В диспетчере IIS добавьте новый пул приложений (Application Pool) и для параметра Версия среды CLR .NET выберите Без управляемого кода (No Managed Code).
  8. Добавьте веб-сайт. В диспетчере IIS создайте новый сайт через Сайты → Добавить веб-сайт; в качестве физического пути укажите папку, в которую распаковали файлы, а в качестве пула приложений — только что созданный пул. Задайте привязки (порт, имя узла) и в производственной среде назначьте SSL-сертификат для HTTPS.
  9. Предоставьте разрешения на папку. Предоставьте удостоверению IIS AppPool\<имя пула> права на чтение и запись для папки приложения. Под этим удостоверением приложение записывает журналы, временные файлы и ключи защиты данных.
  10. Запустите и откройте сайт. Запустите сайт и откройте в браузере заданный адрес. Структура базы данных применяется автоматически при запуске приложения. Следуя инструкциям первого запуска, создайте учётную запись администратора и зарегистрируйте лицензию.

Обновление: Шаги обновления версии для установки на IIS описаны на странице Обслуживание и обновления. Сведения о регистрации лицензии и пробном режиме см. на странице Лицензирование.