Установка программного обеспечения в ОС Linux

1 Введение

Настоящее руководство описывает процесс установки программного обеспечения ПАК ИСБ «Приток-А» версии 3.8.1 и 3.8.2 (далее - ПО) на отдельно взятом компьютере под управлением операционной системы на базе Linux (далее - ОС).

Список поддерживаемых операционных систем:

  • Astra Linux версии 1.7;

  • «Альт СП» версии 10.х (вариант исполнения «Рабочая станция» и «Сервер»).

В руководстве приводится порядок установки нативных [1] серверных [2] и клиентских [3] приложений из состава ПО.

Установка ПО может быть выполнена при помощи мастера установки с графическим интерфейсом (.tar.gz) либо через пакет установки (.deb). Наименование дистрибутива отличается в зависимости от типа установки и аппаратной платформы компьютера, на котором производится установка.

Тип установки Серверные приложения

Наименование дистрибутива

Операционная система

Аппаратная платформа

pritoka-3.8.1.х.x64.tar.gz

Astra Linux

64 бит (AMD, Intel)

pritoka-3.8.2.х.x64.tar.gz

Astra Linux, «Альт СП»

64 бит (AMD, Intel)

Тип установки Клиентские приложения

Наименование дистрибутива

Операционная система

Аппаратная платформа

pritoka-arm-3.8.1.х.x64.tar.gz

Astra Linux

64 бит (AMD, Intel, ARMv8)

pritoka-arm-3.8.2.х.x64.tar.gz

Astra Linux, «Альт СП»

64 бит (AMD, Intel, ARMv8)

pritoka-arm-3.8.1.х.amd64.deb

Astra Linux

64 бит (AMD, Intel)

pritoka-arm-3.8.2.х.amd64.deb

Astra Linux, «Альт СП»

64 бит (AMD, Intel)

pritoka-arm-3.8.1.х.arm64.deb

Astra Linux

64 бит (ARMv8)

pritoka-arm-3.8.2.х.arm64.deb

Astra Linux, «Альт СП»

64 бит (ARMv8)

2 Описание процесса установки

Во время работы мастер установки выполнит несколько действий:

  1. Сообщит версию устанавливаемого ПО, ознакомит с лицензионным соглашением и списком изменений конкретной сборки.

  2. Запросит указать, какие приложения системы будут установлены;

  3. Скопирует файлы ПО;

  4. Запросит указать список дополнительных компонентов системы для установки (СУБД Firebird, файл чистой рабочей БД и т. д.) и установит их.

  5. Создаст необходимые скрипты для управления службами «Приток-А» (см. Служебные скрипты).

  6. По возможности создаст иконки приложений для быстрого доступа из главного меню рабочего стола ОС;

  7. Выполнит обновление рабочей базы данных, если это требуется, и сохранит её копию.

  8. Предложит перезагрузить компьютер.

Для работы ПО «Приток-А» в ОС Astra Linux с уровнем защищенности «Смоленск» в режиме замкнутой программной среды (ЗПС) требуется установка публичного ключа разработчика. При запуске мастер установки проверит на компьютере наличие ключа ООО ОБ «Сократ» и предложит установить его. После установки ключа потребуется перезагрузить компьютер.

3 Подготовка к установке

Перед началом установки убедитесь в том, что компьютер соответствует характеристикам, описанным в документе Требования к техническим характеристикам персональных компьютеров.

Используйте нужный файл дистрибутива в зависимости от типа установки (см. Дистрибутивы).

При установке ПО для ОС Astra Linux может потребоваться наличие установочного диска с репозиторием ОС.

Рекомендуется предварительная установка пакета «dialog» (не обязательно).

sudo apt-get install dialog

4 Установка

4.1 Серверные приложения

  1. Создайте пользователя, который будет администратором системы «Приток-А».

sudo useradd -m -G sudo -U -c “<comment>” -s /bin/bash <имя_пользователя>

sudo passwd <имя_пользователя>

Мастер установки наложит ограничение (при раздаче прав доступа на установленные файлы) на модификацию файлов только самим пользователем, от имени которого был запущен, и разрешит запуск только для этого пользователя и его группы.

  1. Переключитесь на созданного пользователя.

su <имя_пользователя>

  1. Распакуйте архив дистрибутива.

tar xzf pritoka-3.8.X.X.x64.tar.gz

  1. Перейдите в распакованный каталог дистрибутива.

cd pritoka-3.8.X.X.x64

  1. Запустите мастер установки через скрипт и следуйте инструкциям на экране:

./install.sh

Примечание

Примечание: Картинки (копии экрана) в руководстве предназначены для демонстрации различных шагов работы мастера установки при первоначальной установке ПО. Содержание шагов, компонентов, действий и пояснений может отличаться в зависимости от типа и версии мастера установки.

../_images/01.png
../_images/02.png
../_images/03.png

Ознакомьтесь со списком изменений в ПО.

../_images/04.png

Подтвердите лицензионное соглашение.

../_images/05.png

Укажите, какие компоненты ПО должны быть установлены. Символ * означает, что компонент будет установлен.

../_images/06.png

Дождитесь окончания копирования и установки фалов.

../_images/07.png

Выберите дополнительные компоненты, установив * напротив нужного:

  1. Выберите компонент firebird для установки СУБД.

  2. Выберите компонент python, если в работе используется приложение «Сервер сценариев» (обработка событий от Contact ID-совместимых приборов и выполнение пользовательских сценариев).

  3. Выберите компонент prtx_db, если предполагается запуск «Приток-А» на чистой базе данных.

  4. Выберите компонент dbmanager.

Нажмите «Далее».

../_images/08.png

Выполните действия, запрашиваемые мастером установки:

  • подтвердите установку СУБД Firebird, по требованию вставьте установочный диск ОС Astra Linux;

  • введите пароль `masterkey` для пользователя БД;

  • укажите путь для файла базы данных (рекомендуется оставить по умолчанию);

  • подтвердите установку требуемых пакетов и дождитесь завершения их установки.

../_images/09.png

Подтвердите перезагрузку ОС после установки.

../_images/11.png

4.2 Клиентские приложения

  1. Перед началом установки распакуйте архив дистрибутива.

tar xzf pritoka-arm-3.8.X.X.x64.tar.gz

  1. Перейдите в распакованный каталог дистрибутива.

cd pritoka-arm-3.8.X.X.x64

  1. Запустите мастер установки клиентских приложений через скрипт и следуйте инструкциям на экране:

./install.sh

Мастер установки наложит ограничение на модификацию файлов только самим пользователем, от имени которого был запущен (при раздаче прав доступа на установленные файлы).

Примечание

Примечание: Картинки (копии экрана) в руководстве предназначены для демонстрации различных шагов работы мастера установки при первоначальной установке ПО. Содержание шагов, компонентов, действий и пояснений может отличаться в зависимости от типа и версии мастера установки.

../_images/012.png
../_images/022.png

Ознакомьтесь со списком изменений в ПО.

../_images/032.png

Подтвердите лицензионное соглашение.

../_images/041.png

Укажите, какие компоненты ПО должны быть установлены (символ * означает, что компонент будет установлен).

../_images/051.png

Дождитесь окончания копирования и установки фалов.

../_images/061.png
../_images/071.png

Завершите установку.

../_images/081.png

5 После установки

5.1 После установки серверных приложений

После установки северных приложений выполните на сервере следующие действия:

  1. Запустите приложение «Контрольная панель системы» (cntrl) либо откройте на редактирование конфигурационный файл системы pritoka.conf. Внесите настройки, необходимые для корректной работы приложений.

  2. Установите (зарегистрируйте) службы, которые будут работать на этом компьютере при помощи служебных скриптов (см. Служебные скрипты).

    • Чтобы зарегистрировать все установленные службы используйте скрипт sc_install.sh.

    • Чтобы зарегистрировать службы по одной — используйте скрипт service.sh c нужными параметрами.

  3. Запустите необходимые службы при помощи скриптов.

    • Чтобы запустить все установленные службы используйте скрипт sc_start.sh.

    • Чтобы запустить службы по одной — используйте скрипт service.sh c нужными параметрами.

  4. Проконтролируйте работу служб через соответствующие протоколы работы.

5.2 После установки клиентских приложений

После установки системы в меню «Пуск» будет создана папка «Приток-А» с ярлыками для запуска приложений.

Для ярлыка «Веб-интерфейс инженера» измените URL на http://x.x.x.x:8000, где х.х.х.х - IP-адрес компьютера, на котором запущен и работает «Менеджер БД», а 8000 - порт для веб-интерфейса (см. подробнее в справке по веб-интерфейсу инженера).

6 Обновление

Примечание

Ранее установленные дополнительные компоненты, файлы настроек, журналы работы приложений и рабочие директории сохраняются и не удаляются в ходе обновления.

6.1 Обновление при помощи мастера установки

Запустите мастер установки от имени пользователя с соответствующими правами и следуйте инструкциям на экране.

Мастер установки выполнит удаление старых и произведёт установку новых файлов ПО.

Мастер установки серверных приложений в ходе своей работы самостоятельно выполняет обновление рабочей базы данных, если это требуется, и сохраняет при этом её копию. Обновление рабочей базы данных выполняется только после того, как как все необходимые компоненты новой версии были успешно установлены.

Примечание

При обновлении ПО версии 3.8.2 перезагружать компьютер после завершения работы мастера установки не обязательно.

6.2 Обновление через пакет установки

  1. Откройте терминал.

  2. Перейдите в директорию с пакетом установки.

  3. Выполните команду

sudo dpkg -i <имя_пакета_установки>.deb

или

sudo apt-get install ./<имя_пакета_установки>.deb

и следуйте инструкциям на экране.

Пример:

sudo dpkg -i pritoka-arm-3.8.1.14.amd64.deb

../_images/deb_upd.png

7 Удаление

7.1 Удаление при помощи служебного скрипта

Чтобы удалить ПО с компьютера выполните служебный скрипт uninstall.sh.

8 Дополнительные сведения

8.1 Файлы и директории

Во время работы мастер установки установит права доступа к создаваемым файлам ПО и директориям, из расчета работы приложений от имени администратора системы (см. Установка).

8.1.1 Директория установки

  • Серверные приложения: /opt/sokrat/pritoka

  • Клиентские приложения: /opt/sokrat/pritoka-arm

8.1.2 Настройки системы

Серверные приложения: /etc/sokrat/pritoka/

  • pritoka.conf – общий конфигурационный файл системы «Приток-А»;

  • xdevsvc.cfg либо xdevsvc.json – конфигурационный файл программы «Сервер подключений».

Клиентские приложения: /etc/sokrat/pritoka-arm/

  • rarm.conf – конфигурационный файл АРМ «ДО/ДПУ».

8.1.3 Протоколы работы программ

  • Серверные приложения: /var/log/sokrat/pritoka/

  • Клиентские приложения: /var/log/sokrat/pritoka-arm/

8.1.4 Необходимые для работы дополнительные файлы (в том числе временные)

  • Серверные приложения: /var/opt/sokrat/pritoka/

  • Клиентские приложения: /var/opt/sokrat/pritoka-arm/

8.1.5 Документация

  • Серверные приложения: /opt/sokrat/pritoka/docs

  • Клиентские приложения: /opt/sokrat/pritoka-arm/docs

8.2 Служебные файлы

8.2.1 Протокол работы менеджера служб

Серверные приложения: /var/log/sokrat/pritoka/service.log

8.2.2 Файлы контроля работы

Серверные приложения: <имя_приложения>_<2:день><2:месяц><2:год><2:час><2:минута><2:секунда>_<pid>.alive

8.2.3 Файлы критических ошибок

Серверные приложения: !fatal<приложение><pid>_<4:год><2:месяц><2:день>_<2:час><2:минута><2:секунда><3:миллисекунда>

8.2.4 PID-файлы

Серверные приложения: /var/run/sokrat/pritoka

8.3 Наименования исполняемых файлов приложений

Наименование приложения

Имя исполняемого файла / Имя службы

Менеджер БД

prt_dbmanager

Репликатор

prt_replicator

Сервер подключений

prt_xerver

Сервер сценариев

prt_ss

Сервер архивов и отчётов

prt_pars

Ядро

prt_kernel

АРМ «ДО/ДПУ»

rarm

Контрольная панель системы

cntrl

8.4 Служебные скрипты

После установки в указанной директории будут созданы служебные shell-скрипты, предназначенные для установки и удаления системы и работы со службами.

Используйте служебные скрипты для более удобной работы со службами системы.

8.4.1 Скрипт менеджера серверных служб

Скрипт service.sh представляет собой Менеджер служб, предназначенный для установки, удаления, запуска и остановки служб.

service.sh <исполняемый файл приложения> <параметр>

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

Параметр

Значение

install

установить (зарегистрировать) службу

start

запустить установленную службу

stop

остановить установленную службу

remove

удалить службу

status

узнать состояние службы

saynam

показать имя службы.

Пример:

Запустить «Ядро» - ./service.sh prt_kernel start

Остановить «Ядро» - ./service.sh prt_kernel stop

8.4.2 Скрипты управления серверными службами

Скрипт

Назначение

sc_install.sh

устанавливает (регистрирует) все службы «Приток-А» в ОС

sc_remove.sh

удаляет все службы «Приток-А» из ОС

sc_start.sh

запускает все установленные службы «Приток-А»

sc_stop.sh

останавливает запущенные службы «Приток-А»

status.sh

выводит в консоль список запущенных процессов системы.

8.4.3 Скрипт удаления (деинсталляции)

uninstall.sh - cкрипт для удаления (деинсталляции) приложений системы.

8.5 Параметры запуска серверных приложений

Параметры командной строки (ключи):

Ключ

Порядок в командной строке

Назначение

-startd

1

запуск приложения в качестве демона (если приложение поддерживает такой режим работы);

-stopd

1

остановка ранее запущенного демона (не останавливает фоновые процессы)

-service[=<путь>]

1

создание systemd юнита службы (если путь не указан, генерируется в /lib/systemd/system/ со служебным именем; если путь заканчивается символом «/», то генерируется в директорию, иначе в файл)

-alias

1

вывод служебного псевдонима приложения (имя службы/демона)

-version

1

вывод версии приложения

-info

1

вывод информации о приложении

-SILENT

>1

подавление вывода