Работа с установленными агентами :: Руководство по эксплуатации R-Vision SIEM

Запуск агента

Для запуска агента необходимо обладать правами администратора или root-пользователя.

Способ запуска агента зависит от используемой ОС:

В ОС Linux:

sudo ${EVO_AGENT_HOME}/bin/rpoint-launcher start

В ОС Windows:

Первый способ запуска агента:
```
Start-Service -Name RvisionAgent
```

Второй способ запуска агента:

& '<install_path>\bin\rpoint-launcher.exe' start

Здесь:

<install_path> — полный путь установки агента.

Если перед установкой агента была задана переменная RVISION_AGENT_INSTALL_PATH, то вместо указания полного пути установки можно обратиться к этой переменной:

& '${RVISION_AGENT_INSTALL_PATH}\bin\rpoint-launcher.exe' start

В macOS:

sudo ${EVO_AGENT_HOME}/bin/rpoint-launcher start

При запуске агента осуществляется подключение к внешнему NATS-серверу, указанному в конфигурационном файле rpoint.conf, а также выполняется сбор его инвентарной информации.

При необходимости вы можете указать адрес подключения к внешнему NATS-серверу явно через параметр --gateway-url. Например:

В ОС Linux:

sudo ${EVO_AGENT_HOME}/bin/rpoint-launcher start --gateway-url=nats://<addr>:<port>

В ОС Windows:

& '<install_path>\bin\rpoint-launcher.exe' start --gateway-url=nats://<addr>:<port>

В macOS:

sudo ${EVO_AGENT_HOME}/bin/rpoint-launcher start --gateway-url=nats://<addr>:<port>

Здесь:

<addr> — адрес подключения к шлюзу.
<port> — порт подключения к шлюзу.

Перезапуск агента

Способ перезапуска агента зависит от используемой ОС:

В ОС Linux:

${EVO_AGENT_HOME}/bin/rpoint-launcher restart

В ОС Windows:

Первый способ перезапуска агента:
```
Restart-Service -Name RvisionAgent
```

Второй способ перезапуска агента:

& '<install_path>\bin\rpoint-launcher.exe' restart

Здесь:

<install_path> — полный путь установки агента.

Если перед установкой агента была задана переменная RVISION_AGENT_INSTALL_PATH, то вместо указания полного пути установки можно обратиться к этой переменной:

& '${RVISION_AGENT_INSTALL_PATH}\bin\rpoint-launcher.exe' restart

В macOS:

${EVO_AGENT_HOME}/bin/rpoint-launcher restart

При перезапуске агента выполняется сбор его инвентарной информации.

Остановка агента

Способ остановки агента зависит от используемой ОС:

В ОС Linux:

${EVO_AGENT_HOME}/bin/rpoint-launcher stop

В ОС Windows:

Первый способ остановки агента:
```
Stop-Service -Name RvisionAgent
```

Второй способ остановки агента:

& '<install_path>\bin\rpoint-launcher.exe' stop

Здесь:

<install_path> — полный путь установки агента.

Если перед установкой агента была задана переменная RVISION_AGENT_INSTALL_PATH, то вместо указания полного пути установки можно обратиться к этой переменной:

& '${RVISION_AGENT_INSTALL_PATH}\bin\rpoint-launcher.exe' stop

В macOS:

${EVO_AGENT_HOME}/bin/rpoint-launcher stop

Остановка процессов агента

Помимо полной остановки агента, можно также останавливать его конкретные процессы. Способ остановки процессов зависит от используемой ОС:

В ОС Linux и macOS:
```
sudo pkill -9 <process_name>
```

В ОС Windows:

Stop-Process -Name "<process_name>" -Force -ErrorAction SilentlyContinue

Здесь:

<process_name> — имя процесса, который необходимо остановить.

Если попытаться остановить любой процесс, кроме rpoint-launcher, то этот процесс будет автоматически перезапущен.
Если попытаться остановить процесс rpoint-launcher, то дальнейшее поведение процессов будет зависеть от сервиса WatchDog:
- Если сервис WatchDog активен, то процесс rpoint-launcher будет автоматически перезапущен.
- Если сервис WatchDog неактивен, то процесс rpoint-laucnher не будет перезапущен. В этом случае остальные процессы агента могут быть также успешно остановлены.

Запрос статуса агента

Способ получения информации о текущем статусе агента зависит от используемой ОС:

В ОС Linux:

${EVO_AGENT_HOME}/bin/rpoint-launcher status

В ОС Windows:

Первый способ запроса статуса агента:
```
Get-Service -Name RvisionAgent
```

Второй способ запроса статуса агента:

& '<install_path>\bin\rpoint-launcher.exe' status

Здесь:

<install_path> — полный путь установки агента.

Если перед установкой агента была задана переменная RVISION_AGENT_INSTALL_PATH, то вместо указания полного пути установки можно обратиться к этой переменной:

& '${RVISION_AGENT_INSTALL_PATH}\bin\rpoint-launcher.exe' status

В macOS:

${EVO_AGENT_HOME}/bin/rpoint-launcher status

В результате выполнения команды будет выведена информация о текущем статусе агента.

Пример 1. Пример информации о статусе агента

[{"name":"nats-server","status":"running"},{"name":"configuration-server","status":"running"},{"name":"vm","reason":"Disabled by config","status":"not running"}]

Если в ОС Windows статус запрашивается с помощью команды Get-Service, то результат вывода информации отличается.

Пример 2. Пример информации о статусе агента для команды Get-Service

Status   Name               DisplayName
-------  --------           -----------
Running  RvisionAgent       EVO Agent Service

После установки и запуска агента модули nats-server и configuration-server должны иметь статус running, например:

[{"name":"nats-server","status":"running"},{"name":"configuration-server","status":"not running"},...]

Если статус хотя бы одного из модулей отличается от running, необходимо переустановить агент.