Установка и удаление сервиса Архив эпизодов🔗
Архив эпизодов обеспечивает хранение отдельных частей архива неограниченное время. Используя Архив эпизодов, можно не опасаться, что части архива будут удалены при циклической записи или повреждении основного архива.
Примечание
Данная возможность доступна только для лицензий Enterprise и ULTRA.
Сервис можно установить на любой компьютер. При этом устанавливать на этот компьютер сервер Macroscop не обязательно.
На всю систему настраивается один сервис.
Установка сервиса возможна в двух вариантах:
Онлайн, при наличии на устройстве доступа в интернет.
Офлайн, при отсутствии на устройстве доступа в интернет.
Debian🔗
Поддерживаемые дистрибутивы:
Debian 11
Debian 12
Онлайн-установка🔗
Добавить репозиторий Macroscop:
wget -O - https://packages.macroscop.com/deb/install/macroscop-deps-debian.sh | bash
Установить сервис.
sudo apt-get install macroscop-archive-episodes-service
Офлайн-установка🔗
Предупреждение
Для данного способа установки понадобится компьютер с выходом в Интернет и с операционной системой, соответствующей той, на которую необходимо установить сервис Архив эпизодов.
Очистить локальный репозиторий:
sudo apt-get clean
Добавить репозиторий Macroscop:
wget -O - https://packages.macroscop.com/deb/install/macroscop-deps-debian.sh | bash
Скачать все необходимые пакеты (зависимости):
sudo apt-get install -d -y macroscop-archive-episodes-service
Создать директорию ArchiveEpisodesPackages и перенести в неё все скачанные пакеты:
mkdir ~/ArchiveEpisodesPackages/ && cp -R /var/cache/apt/archives/*.deb ~/ArchiveEpisodesPackages/
После этого скопировать всю директорию ArchiveEpisodesPackages на USB-носитель и перенести данные на сервер. Установить сервис Архив эпизодов и все зависимости можно при помощи следующей команды:
sudo dpkg -i /путь_до_ArchiveEpisodesPackages/*.deb
Зависимости🔗
Для работы сервиса в операционной системе должны быть установлены следующие пакеты зависимостей:
aspnetcore-runtime-6.0 (>= 6.0)
debconf (>= 0.5)
postgresql-12
В процессе онлайн-установки пакеты зависимостей устанавливаются автоматически, в то время как при офлайн-установке может потребоваться их ручная установка.
Уточнить наличие установленного пакета и его версию можно с помощью команды dpkg -s %имя_пакета%.
Обновление🔗
Для обновления сервиса необходимо выполнить следующие команды:
sudo apt-get update
sudo apt-get install macroscop-archive-episodes-service
Либо скачать новый пакет из репозитория и установить его вручную с помощью команды dpkg.
Удаление🔗
Для удаления сервиса необходимо выполнить следующую команду:
sudo apt-get remove macroscop-archive-episodes-service
Сетевые настройки сервиса🔗
Предупреждение
Настройки выполняются на устройстве, где установлен сервис.
Описание🔗
В процессе установки в корневом каталоге сервиса создаётся файл конфигурации appsettings.json, содержащий в себе сетевые настройки.
Путь по умолчанию:
/opt/MacroscopArchiveEpisodesService/appsettings.json
Настройки по умолчанию выглядят следующим образом:
{
"ConnectionStrings": {
"DatabaseConnectionTemplateWithoutDbName": "Host=localhost; Port=5432;Database={0};Username=macroscop;Password=masterkey"
},
"Serilog": {
"MinimumLevel": {
"Default": "Debug",
"Override": {
"Default": "Information",
"Microsoft": "Warning",
"Microsoft.Hosting.Lifetime": "Information"
}
},
"WriteTo": [
{
"Name": "Logger",
"Args": {
"configureLogger": {
"Filter": [
{
"Name": "ByIncludingOnly",
"Args": {
"expression": "(@Level = 'Error' or @Level = 'Fatal' or @Level = 'Warning')"
}
}
],
"WriteTo": [
{
"Name": "File",
"Args": {
"path": "%LogsDir%/service.log",
"rollOnFileSizeLimit": true,
"fileSizeLimitBytes": "52428800",
"retainedFileCountLimit": 10
}
}
]
}
}
},
{
"Name": "Console",
"Args": {
"outputTemplate": "===> {Timestamp:HH:mm:ss.fff zzz} [{Level}] {Message}{NewLine}{Exception}"
}
}
],
"Enrich": [
"FromLogContext",
"WithMachineName",
"WithThreadId"
],
"Properties": {
"Application": "LongTerArchiveService"
}
},
"AllowedHosts": "*",
"EpisodesDbRelativePath": "ArchiveServiceData/episodes-database",
"AlwaysRedirectToHttps": "false",
"Network": {
"Endpoints": {
"Http": {
"Url": "http://*:8899"
}
}
}
}
Смена HTTP порта🔗
Для изменения HTTP порта необходимо найти в файле конфигурации следующую секцию:
"Network": {
"Endpoints": {
"Http": {
"Url": "http://0.0.0.0:8899"
}
}
},
После чего задать в строке Url собственный порт вместо значения 8899, задаваемого по умолчанию.
Включение HTTPS соединения🔗
Для добавления в конфигурацию сервиса SSL сертификата и включения возможности использовать HTTPS соединение необходимо изменить секцию Network одним из следующих способов:
"Network": {
"Endpoints": {
"Http": {
"Url": "http://0.0.0.0:8899"
},
"Https": {
"Url": "https://0.0.0.0:18899",
"Certificate": {
"Path": "Файл .pfx",
"Password": "Пароль"
}
}
}
}
Где:
Файл.pfx: Расположение PFX файла сертификата.
Пароль: Пароль сертификата.
"Network": {
"Endpoints": {
"Http": {
"Url": "http://0.0.0.0:8899"
},
"HttpsInlineCertAndKeyFile": {
"Url": "https://0.0.0.0:18899",
"Certificate": {
"Path": "Файл .pem/.crt",
"KeyPath": "Файл .key",
"Password": "Пароль"
}
}
}
}
Где:
Файл .pem/.crt: Расположение .pem/.crt файла сертификата.
Файл .key: Расположение .key файла сертификата.
Пароль: Пароль сертификата.
"Network": {
"Endpoints": {
"Http": {
"Url": "http://0.0.0.0:8899"
},
"Https": {
"Url": "https://0.0.0.0:18899",
"Certificate": {
"Subject": "Subject",
"Store": "Store",
"Location": "Location",
"AllowInvalid": "true/false"
}
}
}
}
Где:
Subject: Имя субъекта сертификата.
Store: Имя хранилища сертификата.
Location: Расположение хранилища сертификата. По умолчанию, CurrentUser.
AllowInvalid: Состояние политики использования недопустимых (например, самоподписанных) сертификатов. По умолчанию false.
Примечание
Изменение HTTPS-порта осуществляется аналогично протоколу HTTP, но для соответствующей секции.
Принудительное перенаправление на HTTPS🔗
Для включения принудительного перенаправления всех обращений к сервису на защищённое соединение необходимо найти и изменить значение с false на true для следующей строки:
"AlwaysRedirectToHttps": false,
Примечание
Для того чтобы изменения вступили в силу, после сохранения настроек необходимо перезапустить сервис с помощью оснастки Службы.
Примечание
Можно перезапустить службу через терминал, используя следующую команду:
sudo systemctl restart macroscoparchiveepisodes
Предупреждение
Не рекомендуется изменять настройки, не описанные в документации, поскольку это может привести к ошибкам в работе сервиса или его отказу.