Перейти к основному содержимому

Установка

Статья описывает установку сервера ТехноДок в Linux, Windows и Docker, первый вход в приложение и удаление сервера. После установки ТехноДок хранит данные в базе SQLite, которая входит в дистрибутив. Подключение PostgreSQL или MariaDB описано в статье «База данных».

Системные требования​

  • Процессор: 64-разрядный архитектуры x86-64 с тактовой частотой 1 ГГц или выше.
  • Оперативная память: не менее 2 ГБ.
  • Свободное место на диске: не менее 1 ГБ.
  • Операционная система Linux: Debian 12 и выше, Ubuntu 20.04 и выше, Fedora 39 и выше, Astra Linux 1.7 и выше или производный от них дистрибутив.
  • Операционная система Windows: Windows 10 и выше или Windows Server 2012 с расширенными обновлениями безопасности и выше.
  • Браузер пользователя: браузер на основе Chromium последней версии, например Google Chrome, Microsoft Edge или Яндекс Браузер, либо Mozilla Firefox последней версии.

Установка и запуск в Linux​

Чтобы установить и запустить сервер, выполните команды в терминале от имени пользователя, которому разрешена команда sudo:

  1. Установите пакет unzip.
    В Debian, Ubuntu и Astra Linux: 
    sudo apt install unzip
    В Fedora: 
    sudo dnf install unzip
  2. Создайте каталог установки, распакуйте в него архив и назначьте владельцем каталога текущего пользователя: 
    sudo mkdir -p /opt/SMS-Automation/TechnoDoc \
    && sudo unzip "[Путь до архива ТехноДок]" -d "/opt/SMS-Automation/TechnoDoc" \
    && sudo chown -R $USER: /opt/SMS-Automation/TechnoDoc
  3. Создайте службу technodoc и запустите её: 
    cd /opt/SMS-Automation/TechnoDoc/scripts/service \
    && sh create.sh \
    && sudo sh start.sh
    Служба работает от имени пользователя, который выполнил команду. Она запускает сервер при загрузке операционной системы и перезапускает его после сбоя.
  4. Войдите в приложение, как описано в разделе «Вход в приложение».

Чтобы остановить службу и отключить её запуск при загрузке, выполните скрипт stop.sh из каталога scripts/service:

cd /opt/SMS-Automation/TechnoDoc/scripts/service && sudo sh stop.sh

Чтобы запустить сервер без службы, например для проверки, выполните вместо шага 3 скрипт run.sh из каталога scripts:

cd /opt/SMS-Automation/TechnoDoc/scripts && sh run.sh

Сервер работает, пока открыт терминал.

Установка и запуск в Windows​

Чтобы установить и запустить сервер, выполните команды в командной строке или PowerShell, запущенных от имени администратора:

  1. Создайте каталог установки и распакуйте в него архив: 
    mkdir "C:\Program Files\SMS-Automation\TechnoDoc"
    tar -xf "[Путь до архива ТехноДок]" -C "C:\Program Files\SMS-Automation\TechnoDoc"
    Программа tar входит в Windows 10 версии 1803 и выше и в Windows Server 2019 и выше. В более ранних версиях создайте каталог и распакуйте в него архив в Проводнике.
  2. Создайте службу technodoc и запустите её: 
    cd "C:\Program Files\SMS-Automation\TechnoDoc\scripts\service"
    .\create.bat
    .\start.bat
    Служба запускает сервер при загрузке операционной системы.
  3. Войдите в приложение, как описано в разделе «Вход в приложение».

Чтобы остановить службу, выполните скрипт stop.bat из каталога scripts\service:

cd "C:\Program Files\SMS-Automation\TechnoDoc\scripts\service"
.\stop.bat

Чтобы запустить сервер без службы, например для проверки, выполните вместо шага 2 скрипт run.bat из каталога scripts:

cd "C:\Program Files\SMS-Automation\TechnoDoc\scripts"
.\run.bat

Сервер работает, пока открыт терминал.

Установка и запуск в Docker​

Образ ТехноДок smsru/technodoc для Linux на процессорах архитектуры x86-64 опубликован в Docker Hub.

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

  1. Запустите контейнер: 
    docker run --name technodoc --restart unless-stopped -p 8003:8003 -d -v technodoc-data:/technodoc/data smsru/technodoc
    Команда загружает образ последней версии и запускает сервер на порту 8003. Базу данных сервер хранит в томе technodoc-data. После перезагрузки сервера Docker запускает контейнер снова, если контейнер не остановлен вручную.
  2. Войдите в приложение, как описано в разделе «Вход в приложение».

Вход в приложение​

  1. Откройте в браузере адрес сервера ТехноДок с портом 8003, например http://127.0.0.1:8003.
  2. В окне «Активация лицензии.» введите ключ активации и нажмите «Активировать». Если ключа нет, нажмите «Запросить демо-лицензию». Срок действия и состав демо-лицензии описаны в разделе «Демо-лицензия» статьи «Лицензирование».
  3. Введите логин admin и пароль admin и нажмите «Войти».

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

Удаление​

  1. Остановите сервер ТехноДок.
  2. Если создана служба, удалите её скриптом delete из каталога scripts/service.
  3. Удалите каталог установки.
  4. Если ТехноДок подключён к PostgreSQL или MariaDB, удалите базу данных ТехноДок средствами СУБД.