Работа с агентами на хосте

На хосте доступны следующие операции над агентами:

Запуск агента
Перезапуск агента
Остановка агента
Запрос статуса агента
Запрос версии агента

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

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

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

Linux
Windows
macOS

Для дистрибутивов Astra Linux и РОСА Хром Сервер:
```
sudo systemctl start evo-agent.service
```
Для остальных дистрибутивов:
```
sudo ${EVO_AGENT_HOME}/bin/rpoint-launcher start
```

Используйте командную оболочку PowerShell:

Запуск через cmdlet-команду:
```
Start-Service -Name RvisionAgent
```
Запуск через вызов rpoint-launcher:
- Если переменная RVISION_AGENT_INSTALL_PATH не задана:
  
  & '<install_path>\bin\rpoint-launcher.exe' start
- Если переменная RVISION_AGENT_INSTALL_PATH задана:
  
  & "${RVISION_AGENT_INSTALL_PATH}\bin\rpoint-launcher.exe" start
Здесь:
- <install_path> — полный путь установки агента.

sudo /Library/R-Vision/agent/bin/rpoint-launcher start

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

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

Linux
Windows
macOS

Для всех дистрибутивов, кроме Astra Linux и РОСА Хром Сервер:

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

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

sudo /Library/R-Vision/agent/bin/rpoint-launcher start --gateway-url=nats://<addr>:<port>

Здесь:

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

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

Linux
Windows
macOS

Для дистрибутивов Astra Linux и РОСА Хром Сервер:
```
sudo systemctl restart evo-agent.service
```
Для остальных дистрибутивов:
```
${EVO_AGENT_HOME}/bin/rpoint-launcher restart
```

Используйте командную оболочку PowerShell:

Перезапуск через cmdlet-команду:
```
Restart-Service -Name RvisionAgent
```
Перезапуск через вызов rpoint-launcher:
- Если переменная RVISION_AGENT_INSTALL_PATH не задана:
  
  & '<install_path>\bin\rpoint-launcher.exe' restart
- Если переменная RVISION_AGENT_INSTALL_PATH задана:
  
  & "${RVISION_AGENT_INSTALL_PATH}\bin\rpoint-launcher.exe" restart
Здесь:
- <install_path> — полный путь установки агента.

/Library/R-Vision/agent/bin/rpoint-launcher restart

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

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

Linux
Windows
macOS

Для дистрибутивов Astra Linux и РОСА Хром Сервер:
```
sudo systemctl stop evo-agent.service
```
Для остальных дистрибутивов:
```
${EVO_AGENT_HOME}/bin/rpoint-launcher stop
```

Используйте командную оболочку PowerShell:

Остановка через cmdlet-команду:
```
Stop-Service -Name RvisionAgent
```
Остановка через вызов rpoint-launcher:
- Если переменная RVISION_AGENT_INSTALL_PATH не задана:
  
  & '<install_path>\bin\rpoint-launcher.exe' stop
- Если переменная RVISION_AGENT_INSTALL_PATH задана:
  
  & "${RVISION_AGENT_INSTALL_PATH}\bin\rpoint-launcher.exe" stop
Здесь:
- <install_path> — полный путь установки агента.

/Library/R-Vision/agent/bin/rpoint-launcher stop

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

Помимо полной остановки агента, можно также останавливать его конкретные процессы.

Linux
Windows
macOS

sudo pkill -9 <process_name>

Используйте командную оболочку PowerShell:

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

sudo pkill -9 <process_name>

Здесь:

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

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

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

Linux
Windows
macOS

${EVO_AGENT_HOME}/bin/rpoint-launcher status

Используйте командную оболочку PowerShell:

Если переменная RVISION_AGENT_INSTALL_PATH не задана:
```
& '<install_path>\bin\rpoint-launcher.exe' status
```
Если переменная RVISION_AGENT_INSTALL_PATH задана:
```
& "${RVISION_AGENT_INSTALL_PATH}\bin\rpoint-launcher.exe" status
```

Здесь:

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

/Library/R-Vision/agent/bin/rpoint-launcher status

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

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

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

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

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

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

Запрос версии агента

Linux
Windows
macOS

${EVO_AGENT_HOME}/bin/rpoint-launcher --version

Используйте командную оболочку PowerShell:

Если переменная RVISION_AGENT_INSTALL_PATH не задана:
```
& '<install_path>\bin\rpoint-launcher.exe' --version
```
Если переменная RVISION_AGENT_INSTALL_PATH задана:
```
& "${RVISION_AGENT_INSTALL_PATH}\bin\rpoint-launcher.exe" --version
```

Здесь:

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

/Library/R-Vision/agent/bin/rpoint-launcher --version

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

Была ли полезна эта страница?