Установка и настройка Pilot-Server на Linux

Pilot-Server для Linux поставляется как автономное приложение .NET 6. Перед установкой ознакомьтесь со страницей Системные требования.

Установка Pilot-Server

В папку /opt/pilot-server скачайте и распакуйте актуальную версию Pilot-Server:

# mkdir /opt/pilot-server

$ cd /opt/pilot-server

# wget --no-check-certificate https://pilot.ascon.ru/release/pilot-server.zip

# unzip pilot-server.zip

# chmod +x Ascon.Pilot.Daemon

Настройка Pilot-Server

Добавьте администратора Pilot-Server. Вместо используемого в примере логина root и пароля whale придумайте ваш логин и пароль:

# ./Ascon.Pilot.Daemon --admin ./settings.xml root whale

По умолчанию в файле settings.xml задан порт HTTP 5545.

Запуск Pilot-Server

Запустите сервер:

# ./Ascon.Pilot.Daemon ./settings.xml

Затем проверьте соединение в браузере по адресу:

http://имя_сервера_или_IP:5545/

Если соединение будет успешно установлено, то браузер покажет версию вашего Pilot-Server.
Например, Pilot-Server_v1.0.48652.29461.

Присоединение демонстрационной базы данных

Демонстрационная база данных скачивается и распаковывается в отдельную папку следующими командами:

# mkdir /opt/pilot-server/bases

$ cd /opt/pilot-server/bases

# wget --no-check-certificate https://pilot.ascon.ru/release/Databases.zip

# unzip Databases.zip

$ chmod -R 755 /opt/pilot-server/bases

База данных присоединяется и запускается командой --attach или -at с записью параметров подключения в файл settings.xml:

# ./Ascon.Pilot.Daemon --attach [DATABASE_NAME] [PATH_TO_DATABASE_FILE] [PATH_TO_FILE_ARCHIVE]

Пример для подключения демонстрационной базы данных pilot-bim_ru:

$ cd /opt/pilot-server
# ./Ascon.Pilot.Daemon --attach pilot-bim_ru ./bases/pilot-bim_ru/base.dbp ./bases/pilot-bim_ru/FileArchive/44191f9c-c8a4-4689-b38b-474f2aba4465.pilotfa

Для того, чтобы внести параметры базы данных в файл settings.xml для последующих подключений, можно воспользоваться командой --add или -ac:

# ./Ascon.Pilot.Daemon --add [PATH_TO_SERVER_SETTINGS_FILE] [DATABASE_NAME] [PATH_TO_DATABASE_FILE] [PATH_TO_FILE_ARCHIVE]

Например:

$ cd /opt/pilot-server
# ./Ascon.Pilot.Daemon --add ./settings.xml pilot-bim_ru ./bases/pilot-bim_ru/base.dbp ./bases/pilot-bim_ru/FileArchive/44191f9c-c8a4-4689-b38b-474f2aba4465.pilotfa

В этом случае база будет подключена при следующем запуске сервера:

# ./Ascon.Pilot.Daemon ./settings.xml

Также можно присоединить базу данных из подключенного к серверу Pilot-myAdmin с компьютера под управлением ОС Windows.

Автозапуск и автообновление

Чтобы при каждом включении и перезагрузке компьютера не надо было запускать Pilot-Server вручную, необходимо настроить автозапуск сервиса. Кроме того, нужно предусмотреть возможность обновления сервера. Эти задачи можно решить разными способами. Например: настройкой служб инициализации systemd или с помощью Supervisor.

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

Создайте учетную запись pilotuser, от которой будет запускаться и работать Pilot-Server:

# adduser pilotuser --no-create-home

Назначьте пользователя pilotuser владельцем каталога и файлов, созданных при распаковке:

# chown pilotuser -Rv /opt/pilot-server

а также владельцем папки с лицензией:

# chown pilotuser -Rv /usr/share/ASCON

Отсоединение базы данных

Для отсоединения базы данных воспользуйтесь командой --detach или -de:

# ./Ascon.Pilot.Daemon --detach [DATABASE_NAME]

Пример отсоединения базы данных pilot-bim_ru:

$ cd /opt/pilot-server
# ./Ascon.Pilot.Daemon --detach pilot-bim_ru