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

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

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

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

Для выполнения операций над агентами необходимо обладать правами администратора или суперпользователя (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> — порт подключения к шлюзу.
При необходимости вы можете указать явно, может ли агент переключаться между шлюзами. Подробные сведения о данном механизме приведены в описании параметра gateway_discovery_enabled файла конфигурации rpoint.conf.

Чтобы включить или отключить данный механизм, используйте один из следующих параметров:
- --gateway-discovery-disable — отключает механизм переключения между шлюзами и меняет значение параметра gateway_discovery_enabled на false.
- --gateway-discovery-enable — включает механизм переключения между шлюзами и меняет значение параметра gateway_discovery_enabled на true.
Ниже приведены примеры запуска агента без переключения между шлюзами:
Linux

Windows

macOS

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

sudo ${EVO_AGENT_HOME}/bin/rpoint-launcher start --gateway-discovery-disable

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

sudo /Library/R-Vision/agent/bin/rpoint-launcher start --gateway-discovery-disable
Здесь:
- <install_path> — путь установки агента.
При необходимости вы можете указать явно, может ли агент использовать значения по умолчанию для параметров deny_imports и deny_exports. Подробные сведения об этих параметрах приведены в описании следующих параметров файла конфигурации rpoint.conf:
- default_deny_exports_enabled;
- default_deny_imports_enabled.
Чтобы указать логику использования значений по умолчанию, используйте следующие параметры:
- --default-deny-exports-enable — указывает агенту использовать значения deny_exports по умолчанию и меняет значение параметра default_deny_exports_enabled на true.
- --default-deny-exports-disable — указывает агенту не использовать значения deny_exports по умолчанию и меняет значение параметра default_deny_exports_enabled на false.
- --default-deny-imports-enable — указывает агенту использовать значения deny_imports по умолчанию и меняет значение параметра default_deny_imports_enabled на true.
- --default-deny-imports-disable — указывает агенту не использовать значения deny_imports по умолчанию и меняет значение параметра default_deny_imports_enabled на false.
Ниже приведены примеры запуска агента с отключением использования deny_exports:
Linux

Windows

macOS

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

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

sudo /opt/rvision/agent/bin/rpoint-launcher start --default-deny-exports-disable

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

sudo -E ${EVO_AGENT_HOME}/bin/rpoint-launcher start --default-deny-exports-disable

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

& 'C:\Program Files (x86)\RVision\Agent\bin\rpoint-launcher.exe' start --default-deny-exports-disable

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

& "${RVISION_AGENT_INSTALL_PATH}\bin\rpoint-launcher.exe" start --default-deny-exports-disable

sudo /Library/R-Vision/agent/bin/rpoint-launcher start --default-deny-exports-disable

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

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

Например, перезапуск агента может потребоваться, если нужно применить актуальную конфигурацию после изменения файла rpoint.conf.

Linux
Windows
macOS

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

sudo /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 задана:
  
  sudo ${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

sudo /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 задана:
```
sudo ${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
```

sudo /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 задана:
```
sudo ${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
```

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

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

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