Установка и удаление сервиса Длительное хранение событий🔗

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

Примечание

Данная возможность доступна только для лицензий 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-long-term-database-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-long-term-database-service
```
Создать директорию LongTermDatabasePackages и перенести в неё все скачанные пакеты:
```
mkdir ~/LongTermDatabasePackages/ && cp -R /var/cache/apt/archives/*.deb ~/LongTermDatabasePackages/
```
После этого скопировать всю директорию LongTermDatabasePackages на USB-носитель и перенести данные на сервер. Установить сервис Длительное хранение событий и все зависимости можно при помощи следующей команды:
```
sudo dpkg -i /путь_до_LongTermDatabasePackages/*.deb
```

Зависимости🔗

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

aspnetcore-runtime-6.0 (>= 6.0)
debconf (>= 0.5)
postgresql-12

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

Уточнить наличие установленного пакета и его версию можно с помощью команды:

dpkg -s имя_пакета

Обновление🔗

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

sudo apt-get update

sudo apt-get install macroscop-long-term-database-service

Либо скачать новый пакет из репозитория и установить его вручную с помощью команды:

sudo dpkg -i имя_пакета

Удаление🔗

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

sudo apt-get remove macroscop-long-term-database-service

Ubuntu🔗

Поддерживаемые дистрибутивы:

Ubuntu 20.04
Ubuntu 22.04
Ubuntu 24.04

Онлайн-установка🔗

Добавить репозиторий Macroscop:

wget -O - https://packages.macroscop.com/deb/install/macroscop-deps-ubuntu.sh | bash

Установить сервис.

sudo apt-get install macroscop-long-term-database-service

Офлайн-установка🔗

Предупреждение

Очистить локальный репозиторий:
```
sudo apt-get clean
```

Добавить репозиторий Macroscop:

wget -O - https://packages.macroscop.com/deb/install/macroscop-deps-ubuntu.sh | bash

Скачать все необходимые пакеты (зависимости):
```
sudo apt-get install -d -y macroscop-long-term-database-service
```
Создать директорию LongTermDatabasePackages и перенести в неё все скачанные пакеты:
```
mkdir ~/LongTermDatabasePackages/ && cp -R /var/cache/apt/archives/*.deb ~/LongTermDatabasePackages/
```
После этого скопировать всю директорию LongTermDatabasePackages на USB-носитель и перенести данные на сервер. Установить сервис Длительное хранение событий и все зависимости можно при помощи следующей команды:
```
sudo dpkg -i /путь_до_LongTermDatabasePackages/*.deb
```

Зависимости🔗

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

aspnetcore-runtime-6.0 (>= 6.0)
debconf (>= 0.5)
postgresql-12

Уточнить наличие установленного пакета и его версию можно с помощью команды:

dpkg -s имя_пакета

Обновление🔗

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

sudo apt-get update

sudo apt-get install macroscop-long-term-database-service

Либо скачать новый пакет из репозитория и установить его вручную с помощью команды:

sudo dpkg -i имя_пакета

Удаление🔗

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

sudo apt-get remove macroscop-long-term-database-service

Astra Linux CE🔗

Поддерживаемые дистрибутивы:

Astra Linux CE 2.12

Онлайн-установка🔗

Добавить репозиторий Macroscop:

wget -O - https://packages.macroscop.com/deb/install/macroscop-deps-astra-ce-2.12.sh | bash

Установить сервис.

sudo apt-get install macroscop-long-term-database-service

Офлайн-установка🔗

Предупреждение

Очистить локальный репозиторий:
```
sudo apt-get clean
```

Добавить репозиторий Macroscop:

wget -O - https://packages.macroscop.com/deb/install/macroscop-deps-astra-ce-2.12.sh | bash

Скачать все необходимые пакеты (зависимости):
```
sudo apt-get install -d -y macroscop-long-term-database-service
```
Создать директорию LongTermDatabasePackages и перенести в неё все скачанные пакеты:
```
mkdir ~/LongTermDatabasePackages/ && cp -R /var/cache/apt/archives/*.deb ~/LongTermDatabasePackages/
```
После этого скопировать всю директорию LongTermDatabasePackages на USB-носитель и перенести данные на сервер. Установить сервис Длительное хранение событий и все зависимости можно при помощи следующей команды:
```
sudo dpkg -i /путь_до_LongTermDatabasePackages/*.deb
```

Зависимости🔗

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

aspnetcore-runtime-6.0 (>= 6.0)
debconf (>= 0.5)
postgresql-12

Уточнить наличие установленного пакета и его версию можно с помощью команды:

dpkg -s имя_пакета

Обновление🔗

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

sudo apt-get update

sudo apt-get install macroscop-long-term-database-service

Либо скачать новый пакет из репозитория и установить его вручную с помощью команды:

sudo dpkg -i имя_пакета

Удаление🔗

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

sudo apt-get remove macroscop-long-term-database-service

Astra Linux SE🔗

Поддерживаемые дистрибутивы:

Astra Linux SE 1.7

Онлайн-установка🔗

Добавить репозиторий Macroscop:

wget -O - https://packages.macroscop.com/deb/install/macroscop-deps-astra-se.sh | bash

Установить сервис:

sudo apt-get install macroscop-long-term-database-service

Офлайн-установка🔗

Предупреждение

Для данного способа установки понадобится компьютер с выходом в интернет и с операционной системой, соответствующей той, на которую необходимо установить сервис Длительное хранение событий.

Очистите локальный репозиторий:
```
sudo apt-get clean
```

Добавить репозиторий Macroscop:

wget -O - https://packages.macroscop.com/deb/install/macroscop-deps-astra-se.sh | bash

Скачать все необходимые пакеты (зависимости):
```
sudo apt-get install -d -y macroscop-long-term-database-service
```
Создайте каталог LongTermDatabasePackages и перенесите в него все скачанные пакеты:
```
mkdir ~/LongTermDatabasePackages/ && cp -R /var/cache/apt/archives/*.deb ~/LongTermDatabasePackages/
```
Скопируйте весь каталог LongTermDatabasePackages на USB-носитель и перенесите данные на сервер. Установку сервиса Длительное хранение событий и всех зависимостей можно выполнить с помощью следующей команды:
```
sudo dpkg -i /путь_до_LongTermDatabasePackages/*.deb
```

Зависимости🔗

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

aspnetcore-runtime-6.0 (>= 6.0)
debconf (>= 0.5)
postgresql-11

Уточнить наличие установленного пакета и его версию можно с помощью команды:

dpkg -s имя_пакета

Обновление🔗

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

sudo apt-get update

sudo apt-get install macroscop-long-term-database-service

Либо скачать новый пакет из репозитория и установить его вручную с помощью команды:

sudo dpkg -i имя_пакета

Удаление🔗

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

sudo apt-get remove macroscop-long-term-database-service

РЕД ОС🔗

Поддерживаемые дистрибутивы:

РЕД ОС 7
РЕД ОС 8

Онлайн-установка🔗

Добавить репозиторий Macroscop:

wget -O - https://packages.macroscop.com/rpm/install/macroscop-deps-redos.sh | bash

Установить сервис.

sudo dnf install macroscop-long-term-database-service

Офлайн-установка🔗

Предупреждение

Добавить репозиторий Macroscop:

wget -O - https://packages.macroscop.com/rpm/install/macroscop-deps-redos.sh | bash

Установить дополнения для dnf:
```
sudo dnf install -y dnf-utils
```

Скачать все необходимые пакеты (зависимости):

sudo dnf download --downloadonly --downloaddir=~/LongTermDatabasePackages macroscop-long-term-database-service --resolve

После этого скопировать всю директорию LongTermDatabasePackages на USB-носитель и перенести данные на сервер. Установить сервис Длительное хранение событий и все зависимости можно при помощи следующей команды:
```
sudo rpm -ivh /путь_до_LongTermDatabasePackages/*.rpm
```

Зависимости🔗

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

aspnetcore-runtime-6.0 >= 6.0
policycoreutils-python-utils >= 2.9
postgresql-server >= 12.12

Уточнить наличие установленного пакета и его версию можно с помощью команды:

rpm -qa | grep имя_пакета

Обновление🔗

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

sudo dnf update macroscop-long-term-database-service

Либо скачать новый пакет из репозитория и установить его вручную с помощью команды rpm.

Удаление🔗

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

sudo dnf remove macroscop-long-term-database-service

Сетевые настройки сервиса🔗

Предупреждение

Настройки выполняются на устройстве, где установлен сервис.

Описание🔗

В процессе установки в корневом каталоге сервиса создаётся файл конфигурации appsettings.json, содержащий в себе сетевые настройки.

Путь по умолчанию:

/opt/MacroscopLongTermDatabaseService/appsettings.json

Настройки по умолчанию выглядят следующим образом:

{
    "Application": {
        "Brand": "Macroscop",
        "AppName": "LongTermDatabase"
    },
    "Logging": {
        "LogLevel": {
            "Default": "Information",
            "Microsoft.AspNetCore": "Warning"
        }
    },
    "AllowedHosts": "*",
    "AlwaysRedirectToHttps": false,
    "Network": {
        "Endpoints": {
            "Http": {
                "Url": "http://*:8999"
            }
        }
    },
    "ConnectionStrings": {
        "DefaultConnectionString": "Host=localhost;Port=5432;Database=longtermdatabase;Username=macroscop;Password=masterkey;",
        "ConnectionStringWithDatabasePlaceholder": "Host=localhost;Port=5432;Database={0};Username=macroscop;Password=masterkey;"
    }
}

Смена HTTP порта🔗

Для изменения HTTP-порта необходимо найти в файле конфигурации следующую секцию:

"Network": {
    "Endpoints": {
        "Http": {
            "Url": "http://*:8999"
        }
    }
},

После чего задать в строке Url собственный порт вместо значения 8999, задаваемого по умолчанию.

Включение HTTPS соединения🔗

Для добавления в конфигурацию Сервиса SSL сертификата и включения возможности использовать HTTPS соединение необходимо изменить секцию Network следующим образом:

"Network": {
    "Endpoints": {
        "Http": {
            "Url": "http://*:8999"
        },
        "HttpsInlineCertFile": {
            "Url": "https://*:18999",
            "Certificate": {
                "Path": "Путь",
                "Password": "Пароль"
            }
        }
    }
}

Где:

Путь: Расположение PFX-файла сертификата.
Пароль: Пароль сертификата.

Примечание

Изменение HTTPS-порта осуществляется аналогично протоколу HTTP, но для секции HttpsInlineCertFile.

Принудительное перенаправление на HTTPS🔗

Для включения принудительного перенаправления всех обращений к сервису на защищённое соединение необходимо найти и изменить значение с false на true для следующей строки:

"AlwaysRedirectToHttps": false,

Примечание

Для того чтобы изменения вступили в силу, после сохранения настроек необходимо перезапустить сервис с помощью оснастки Службы.

Примечание

Можно перезапустить службу через терминал, используя следующую команду:

sudo systemctl restart macroscoparchiveepisodes

Предупреждение

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

Связанные ссылки🔗

Описание сервиса

Использование в приложении Macroscop Клиент

Настройка сервиса

Установка сервиса Длительное хранение событий на Windows