Описание команд локального консольного интерфейса

В настоящем разделе представлено описание команд локального консольного интерфейса (ЛКИ).

Обновление ARMA MC

Обновление ARMA MC возможно осуществить через:

Для обновления через ЛКИ необходимо выполнить следующие действия:

  1. Перейти в директорию «/opt» и создать пустой каталог, например «amc»:

cd opt
mkdir amc
  1. Распаковать архив командой «tar -xzf [название архива] -C [название каталога]», например:

tar -xzf InfoWatch-ARMA-Центр-Управления_1.8.0.tar.gz -C amc
  1. Перейти в каталог «amcansible», например:

cd ./amc/amcansible
  1. Сравнить версию установленной ARMA MC, указанной в левом нижнем углу веб-интерфейса, с версией обновления. Для проверки версии обновления ввести команду:

sudo ./setup.sh -v

Версия обновления будет указана в строке «This package can be used as update for versions».

  1. Если версия установленной ARMA MC больше или равна версии, указанной в строке «This package can be used as update for versions», выполнить команду:

sudo ./setup.sh -u

В консоли появится надпись «Installation completed» и ARMA MC перезагрузится.

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

Примечание

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

Автоматическое резервное копирование

После запуска команды «sudo ./setup.sh -u» (см. п.6 Обновление ARMA MC) запускается механизм создания резервной копии ARMA MC.

Резервная копия создаётся в папке «backup», которая располагается на одном уровне с файлом «setup.sh». В случае обновления ARMA MC через веб-интерфейс (см. Обновление ARMA MC), резервная копия сохранится в директории «/opt/amcbackup».

Возможные проблемы и их решения

В случае отсутствия ответа ARMA MC рекомендуется:

  1. Выполнить установку текущей версии (см. Установка).

  2. Скопировать папку «backup» в директорию с файлом «setup.sh» и ввести команду восстановления:

sudo ./setup.sh -r

Примечание

В случае возникновения любых ошибок при обновлении рекомендуется скопировать папку «backup» на отдельный диск, а также отправить файл «/var/log/armaconsole/setup.log» в INFOWATCH ARMA.

Резервное копирование и восстановление ARMA MC

Резервную копию возможно использовать для восстановления конфигурации при её повреждении, отката изменений конфигурации или переноса конфигурации на новое устройство.

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

  1. Перейти в директорию «/opt/armaupdate/amcansible/», которая содержит файл «setup.sh».

  2. Ввести команду:

sudo ./setup.sh -b

В результате выполнения данной команды на одном уровне с файлом «setup.sh» будет создана директория «backup» с резервной копией.

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

sudo ./setup.sh -r

Примечание

Механизм восстановления может быть применён только для той версии ARMA MC, для которой была сделана резервная копия.

В текущей реализации производится резервное копирование и восстановление баз данных «PostgreSQL» и «Elasticsearch».

Сервисы ARMA MC

ARMA MC включает в себя следующие сервисы:

Таблица «Сервисы ARMA MC»

Название сервиса

Полное наименование сервиса

Путь к журналу сервиса

amccelery

amccelery.service

/var/log/armaconsole/celeryd.log

amccelerybeat

amccelerybeat.service

/var/log/armaconsole/celerybeat.log

amcchecker

amcchecker.service

Журнал отсутствует

amcclient

amcclient.service

/var/log/armaconsole/license.log

amccore

amccore.service

var/log/armaconsole/console.log

amccorrelator

amccorrelator.service

/var/log/armaconsole/correlator.log

elasticsearch

elasticsearch.service

/var/log/elasticsearch

nginx

nginx.service

/var/log/nginx

postgresql@13-main

postgresql@13-main.service

/var/log/postgresql/postgresql-13-main.log

postgresql

postgresql.service

/var/log/postgresql

rabbitmq-server

rabbitmq-server.service

/var/log/rabbitmq/rabbit@amcdebian.log

redis-server

redis-server.service

/var/log/redis/redis-server.log

amc-storage-event-listener

amc-storage-event-listener.service

/var/log/syslog

amc-gateway.service

amc-gateway.service.service

/var/log/syslog

amc-device

amc-device.service

/var/log/syslog

amc-event

amc-event.service

/var/log/syslog

amc-license

amc-license.service

/var/log/syslog

amc-notification

amc-notification.service

/var/log/syslog

Перезагрузка сервисов

Для перезагрузки сервиса необходимо ввести команду «systemctl restart [servicename]», где:

[servicename] – это название сервиса (см. Сервисы ARMA MC).

Например, для перезагрузки сервиса «amccelery», необходимо ввести команду «systemctl restart amccelery» и нажать клавишу «ENTER».

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

  • в случае успешного перезапуска сервиса в командной строке сообщений не будет;

  • в случае безуспешного перезапуска сервиса будет выведено сообщение об ошибке, которая возникла при попытке перезапуска.

Просмотр журналов сервисов

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

  1. Ввести команду:

  • vim [path_to_log_file] – для редактора «Vim»;

  • nano [path_to_log_file] – для редактора «Nano»;

  • cat [path_to_log_file] – для утилиты «Cat», где:

    [path_to_log_file] – это название сервиса (см. Сервисы ARMA MC).

    Например, для просмотра журнала сервиса «amcclient», необходимо ввести команду «vim /var/log/armaconsole/license.log».

  1. Нажать клавишу «ENTER».

Работа с SSH

В ARMA MC протокол SSH по умолчанию включён.

Чтобы произвести удалённое подключение и управление сервером ARMA MC необходимо сконфигурировать nftables.