Agent

Introduction

Many subcommands need to specify on which agent to execute, if not there will be a default agent, which is set in the ~/.orxray/config configuration file. You can edit the configuration file to change the default agent.

The agent subcommand lists all the agents and shows which one is the current default agent.

Usage

Usage: orxray agent ACTION [OPTIONS]

ACTIONS:
    list
    get-default

GLOBAL OPTIONS:
    --help
    --config                           specify config file, default is ~/.orxray/config.

List agents

This subcommand list all the agents.

Usage

Usage: orxray agent list [OPTIONS]

OPTIONS:
    -s, --page-size integer            page size, 20(default).

GLOBAL OPTIONS:
    --help
    --config                           specify config file, default is ~/.orxray/config.

-s, --page-size integer

Specify the maximum number of data to be displayed, the default is 20

Example

1. list agents

$ orxray agent list
ID      HOSTNAME                        IP              SYSTEM          VERSION
1       centos7                         13.17.28.191    centos-7        816
4       amzn2-xray-agent                13.17.28.193    amazon-2        816
5       suse15-aa                       13.17.29.132    opensuse-15     802
7       ubuntu18-xray-agent             13.17.28.195    ubuntu-bionic   816
9       deploy-server                   18.12.20.58     centos-7        796
10      centos7                         13.17.231.163   centos-7        797

2. specify list number, default is 10

$ orxray agent list -s 3
ID      HOSTNAME                        IP              SYSTEM          VERSION
1       centos7                         13.17.28.191    centos-7        816
4       amzn2-xray-agent                13.17.28.192    amazon-2        816
5       suse15-aa                       13.17.29.132    opensuse-15     802

Get default agent info

The default agent info is saved in ~/.orxray/config. This subcommand show the information about the default agent.

Usage

Usage: orxray agent get-default

GLOBAL OPTIONS:
    --help
    --config                           specify config file, default is ~/.orxray/config.

Example

$ orxray agent get-default
ID      HOSTNAME                IP              SYSTEM          VERSION
29      centos7-xxx-1           83.37.218.191   centos-7        816