Установка и обновление через мастер установки (.tar.gz)

1 Введение

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

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

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

[1]

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

[2]

Приложения предназначенные для работы на сервере, как правило, без графического интерфейса (такие как «Ядро», «Менеджер БД», «Репликатор» и т.д.).

[3]

Приложения предназначенные для работы на рабочем месте имеющие графический интерфейс для взаимодействия с пользователем (такие как «АРМ ДО/ДПУ», «Контрольная панель системы» и т.д.).

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

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

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

• Astra Linux версии 1.7;

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

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

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

Наименование дистрибутива	Операционная система	Аппаратная платформа
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)

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

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

sudo apt-get install dialog

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

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

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

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

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

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

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

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

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

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

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

4 Установка

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

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

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

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

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

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

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

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

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

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

cd pritoka-3.8.X.X.x64

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

./install.sh

Примечание

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

./install.sh

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

Примечание

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

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

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

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

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

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

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 Обновление

Примечание

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

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

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

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

Примечание

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

7 Удаление

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

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

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