Работа с установленными агентами

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

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

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

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

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

В ОС Linux:

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

В ОС Windows — используйте командную оболочку 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> — полный путь установки агента.

В macOS:

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

Здесь:

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

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

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

В ОС Linux:

${EVO_AGENT_HOME}/bin/rpoint-launcher restart

В ОС Windows — используйте командную оболочку 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> — полный путь установки агента.

В macOS:

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

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

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

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

В ОС Linux:

${EVO_AGENT_HOME}/bin/rpoint-launcher stop

В ОС Windows — используйте командную оболочку 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> — полный путь установки агента.

В macOS:

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

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

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

В ОС Linux и macOS:
```
sudo pkill -9 <process_name>
```
В ОС Windows — используйте командную оболочку PowerShell:
```
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 — используйте командную оболочку PowerShell:
- Запрос статуса через cmdlet-команду:
  Get-Service -Name RvisionAgent
- Запрос статуса через вызов rpoint-launcher:
  Если переменная 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> — полный путь установки агента.

В macOS:

/Library/R-Vision/agent/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, необходимо переустановить агент.

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

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

В ОС Linux:

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

В ОС Windows — используйте командную оболочку 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> — полный путь установки агента.

В macOS:

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

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