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

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

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

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

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

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

Linux
Windows
macOS

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

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

Запуск через cmdlet-команду:
```
Start-Service -Name RvisionAgent
```
Запуск через вызов rpoint-launcher:
- Если переменная RVISION_AGENT_INSTALL_PATH не задана:
  
  & 'C:\Program Files (x86)\RVision\Agent\bin\rpoint-launcher.exe' start
- Если переменная RVISION_AGENT_INSTALL_PATH задана:
  
  & "${RVISION_AGENT_INSTALL_PATH}\bin\rpoint-launcher.exe" start

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

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

Запуск агента с дополнительными параметрами

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

Linux
Windows
macOS

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

Если переменная окружения EVO_AGENT_HOME не задана:

sudo /opt/rvision/agent/bin/rpoint-launcher start --gateway-url=nats://<addr>:<port>

Если переменная окружения EVO_AGENT_HOME задана:

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

Если переменная RVISION_AGENT_INSTALL_PATH не задана:

& 'C:\Program Files (x86)\RVision\Agent\bin\rpoint-launcher.exe' start --gateway-url=nats://<addr>:<port>

Если переменная RVISION_AGENT_INSTALL_PATH задана:

& "${RVISION_AGENT_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>

Здесь:

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

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

Linux
Windows
macOS

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

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

Перезапуск через cmdlet-команду:
```
Restart-Service -Name RvisionAgent
```
Перезапуск через вызов rpoint-launcher:
- Если переменная RVISION_AGENT_INSTALL_PATH не задана:
  
  & 'C:\Program Files (x86)\RVision\Agent\bin\rpoint-launcher.exe' restart
- Если переменная RVISION_AGENT_INSTALL_PATH задана:
  
  & "${RVISION_AGENT_INSTALL_PATH}\bin\rpoint-launcher.exe" restart

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

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

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

Linux
Windows
macOS

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

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

Остановка через cmdlet-команду:
```
Stop-Service -Name RvisionAgent
```
Остановка через вызов rpoint-launcher:
- Если переменная RVISION_AGENT_INSTALL_PATH не задана:
  
  & 'C:\Program Files (x86)\RVision\Agent\bin\rpoint-launcher.exe' stop
- Если переменная RVISION_AGENT_INSTALL_PATH задана:
  
  & "${RVISION_AGENT_INSTALL_PATH}\bin\rpoint-launcher.exe" stop

/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 не задана:
```
/opt/rvision/agent/bin/rpoint-launcher status
```
Если переменная окружения EVO_AGENT_HOME задана:
```
${EVO_AGENT_HOME}/bin/rpoint-launcher status
```

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

Если переменная RVISION_AGENT_INSTALL_PATH не задана:
```
& 'C:\Program Files (x86)\RVision\Agent\bin\rpoint-launcher.exe' status
```
Если переменная RVISION_AGENT_INSTALL_PATH задана:
```
& "${RVISION_AGENT_INSTALL_PATH}\bin\rpoint-launcher.exe" status
```

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

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

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

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

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

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

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

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

Linux
Windows
macOS

Если переменная окружения EVO_AGENT_HOME не задана:
```
/opt/rvision/agent/bin/rpoint-launcher --version
```
Если переменная окружения EVO_AGENT_HOME задана:
```
${EVO_AGENT_HOME}/bin/rpoint-launcher --version
```

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

Если переменная RVISION_AGENT_INSTALL_PATH не задана:
```
& 'C:\Program Files (x86)\RVision\Agent\bin\rpoint-launcher.exe' version
```
Если переменная RVISION_AGENT_INSTALL_PATH задана:
```
& "${RVISION_AGENT_INSTALL_PATH}\bin\rpoint-launcher.exe" version
```

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

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

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