About the AGILITY CLI tool
The agility command-line interface (CLI) tool is for managing and performing various operations related to the AGILITY platform. The CLI tool has several commands, subcommands, and options that can be used to interact with different components of the AGILITY system.
These commands are used during installation and configuration. Go to the AGILITY Onboarding page for step-by-step guidance.
Note: Inside the VM run this tool as root user.
sudo su -
[root@ip-172-31-48-37 ~]# agility --help
Usage: agility [OPTIONS] COMMAND [ARGS]...
Options:
--help Show this message and exit.
Commands:
backup Manage backups (VM Only).
diagnostics Diagnose and troubleshoot your AGILITY instance.
ingress Manage ingress settings.
license Manage AGILITY license.
monitoring Manage AGILITY Monitoring Stack.
proxy Manage proxy configuration.
telemetry Manage telemetry settings.
upgrade Upgrade AGILITY components.
cv Manage AGILITY ContinuousValidation instance.
[root@ip-172-31-48-37 ~]#In case of errors or other problems, please check the Installation troubleshooting document.
The options available in the CLI tool:
Command: backup
Manage backups (VM Only).
Sub Command: local
Manage local (internal) backups.
| | | |
|---|
create | Create a new backup. | [--namespace] TEXT: Namespace in which agility is installed. Default is 'agility'.
[--full] Perform a full backup. Default behavior if neither --full nor --diff is specified.
[--diff] Perform a differential (delta) backup.
| agility backup s3 create
|
restore | Restore DB In-Place from a local backup. | [--namespace] TEXT: Namespace in which AGILITY is installed. Default is 'agility'.
[--time] TEXT: Point-in-Time Recovery (PITR) to restore the database to. Format: 'YYYY-MM-DD HH:mm:ss-TZ'.
[--auto-accept] Automatically accept the restore operation without prompting.
| agility backup local restore
|
status | Show the available backups status. | [--namespace] TEXT: Namespace in which agility is installed. Default is 'agility'.
[--debug] Shows more details.
| agility backup local status
|
Sub Command: s3
Manage S3 bucket backups.
| | | |
|---|
clone | Clone the DB from another S3 backup. | [--namespace] TEXT: Namespace in which agility is installed. Default is 'agility'.
[--bucket-name] TEXT: Specify the S3 bucket name.
[--endpoint] TEXT: Specify the S3 endpoint.
[--path] TEXT: Specify the S3 path.
[--region] TEXT: Specify the S3 region.
[--access-key-id] TEXT: Specify the S3 Access Key ID.
[--secret-access-key] TEXT: Specify the S3 Secret Access Key.
[--timeout] Restore job timeout. Default 600 (seg).
[--auto-accept] Automatically accept the clone operation without prompting.
| Recommended:
agility backup s3 clone Complete:
agility backup s3 clone --bucket-name=my-bucket --endpoint=s3.us-east-1.amazonaws.com --path=/backups-old --access-key-id=XXXX --secret-access-key=YYYYY --region=us-east-1 |
create | Create a new backup. | [--namespace] TEXT: Namespace in which agility is installed. Default is 'agility'.
[--full] Perform a full backup. Default behavior if neither --full nor --diff is specified.
[--diff] Perform a differential (delta) backup.
| agility backup s3 create
|
restore | Restore DB from a S3 bucket backup. | [--namespace] TEXT: Namespace in which AGILITY is installed. Default is 'agility'.
[--time] TEXT: Point-in-Time Recovery (PITR) to restore the database to. Format: 'YYYY-MM-DD HH:mm:ss-TZ'.
[--auto-accept] Automatically accept the restore operation without prompting.
| agility backup s3 restore
|
status | Show the available backups status. | [--namespace] TEXT: Namespace in which agility is installed. Default is 'agility'.
[--debug] Reveals sensitive information.
| agility backup s3 status
|
settings | Configure S3 bucket backup settings. | | |
Sub Command: settings
Configure S3 bucket backup settings.
| | | |
|---|
apply | Apply S3 bucket backups settings. | [--namespace] TEXT: Namespace in which agility is installed. Default is 'agility'.
[--bucket-name] TEXT: Specify the S3 bucket name.
[--endpoint] TEXT: Specify the S3 endpoint.
[--path] TEXT: Specify the S3 path.
[--region] TEXT: Specify the S3 region.
[--retention-count] INTEGER: Specify the full backups retention count.
[--full-schedule] TEXT: Specify the full backup schedule.
[--differential-schedule] TEXT: Specify the differential backup schedule.
[--access-key-id] TEXT: Specify the S3 Access Key ID.
[--secret-access-key] TEXT: Specify the S3 Secret Access Key.
[--auto-accept] Automatically accept the restore operation without prompting.
| Recommended:
agility backup s3 settings apply Complete:
agility backup s3 settings apply --bucket-name=my-bucket --retention-count=10 --full-schedule="0 0 * * *" --differential-schedule="0 2-22/12 * * *" --endpoint=s3.us-east-1.amazonaws.com --path=/backups --access-key-id=XXXX --secret-access-key=YYYYY --region=us-east-1 |
delete | Delete the existing backup settings. | [--namespace] TEXT: Namespace in which agility is installed. Default is 'agility'.
[--auto-accept] Automatically accept the delete operation without prompting.
| agility backup s3 settings delete
|
list | List S3 bucket backup settings. | [--namespace] TEXT: Namespace in which agility is installed. Default is 'agility'.
[--sensitive] Reveals sensitive information.
| agility backup s3 settings list
|
Command: diagnostics
Diagnose and troubleshoot your AGILITY instance.
| | | |
|---|
collect | Generate a diagnostics report and optionally upload it to B-Yond storage. | [--local]: Generate the report locally without uploading.
[--namespace] TEXT: Namespace in which AGILITY is installed. Default is 'agility'.
| agility diagnostics collect
|
run | Execute diagnostics checks. | [--namespace] TEXT: Namespace in which AGILITY is installed. Default is 'agility'.
| agility diagnostics run
|
Command: cv
Manage AGILITY Continuous Validation instance.
Sub Command: settings
Manage AGILITY Continuous Validation settings.
| | | |
|---|
description | Show AGILITY setting descriptions. | [--namespace] TEXT: Namespace in which agility is installed. Default is 'agility'.
[--cv] TEXT: ContinuousValidation AGILITY definition. Default is 'agility'.
[--auto-accept] Auto accept all the questions (y).
[--help] Show this message and exit.
| agility cv settings description
|
set | Set value to AGILITY settings. | [--namespace] TEXT: Namespace in which agility is installed. Default is 'agility'.
[--cv] TEXT: ContinuousValidation AGILITY definition. Default is 'agility'.
[--auto-accept] Auto accept all the questions (y).
[--help] Show this message and exit.
| agility cv settings set continuousClassification true
|
status | Show current AGILITY setting values. | [--namespace] TEXT: Namespace in which agility is installed. Default is 'agility'.
[--cv] TEXT: ContinuousValidation AGILITY definition. Default is 'agility'.
[--auto-accept] Auto accept all the questions (y).
[--help] Show this message and exit.
| agility cv settings status
|
Command: license
Manage AGILITY license.
| | | |
|---|
upload | Upload AGILITY license. | --file TEXT: AGILITY license file path.
--text TEXT: AGILITY license content as text.
[--namespace] TEXT: Namespace in which AGILITY is installed. Default is 'agility'.
| agility license upload --file agility.lic
|
status | Get AGILITY license status. | [--namespace] TEXT: Namespace in which AGILITY is installed. Default is 'agility'.
| agility license status
|
Command: ingress
Manage ingress settings.
Sub Command: tls
Manage TLS configuration.
| | | |
|---|
set | Set Ingress TLS for the specified host | --host TEXT: Specify the host for TLS configuration (required).
--cert TEXT: Specify the certificate filename (required).
--key TEXT: Specify the key filename (required).
[--agility-namespace] TEXT: Namespace in which agility is installed. Default 'agility'.
[--monitoring-namespace] TEXT: Namespace in which monitoring is installed. Default is 'monitoring'.
| agility ingress tls set --host example.com --cert tls.crt --key tls.key
|
reset | Reset ingress configuration | | agility ingress tls reset
|
Command: monitoring
Manage AGILITY Monitoring Stack.
| | | |
|---|
install | Install or upgrade AGILITY Monitoring Stack. | [--version]: Specify the version to install/upgrade. Default 1.0.8.
[--namespace] TEXT: Namespace in which monitoring is installed. Default is 'monitoring'.
| agility monitoring install
|
reset | Reset alert manager configuration. | | agility monitoring reset
|
set | Configure Alert manager notifications. | | agility monitoring install
|
show | Show current alert manager configuration. | | agility monitoring show
|
uninstall | Uninstall AGILITY Monitoring Stack. | [--namespace] TEXT: Namespace in which monitoring is installed. Default is 'monitoring'.
[--auto-accept]: Auto accept all the questions (y). (default: False)
| agility monitoring uninstall
|
Sub Command set
Anonymous usage data collection to B-Yond.
| | | |
|---|
both | Configure email and pagerduty notifications for Alert manager. | [--email-from] TEXT: Specify the adddress from email will come.
[--email-to]: Specify the adddress where email will be sent to.
[--smarthost]: Specify the smarthost for email service.
[--auth-password]: Specify the auth password for smarthost service.
[--auth-username]: Specify the user for smarthost service.
[--require-tls]: Enable TLS if required.
[--send-resolved]: Send resolved alerts notifications.
[--namespace] TEXT: Namespace in which monitoring is installed. Default is 'monitoring'
| agility monitoring both --pager-duty-service-key=pagerduty-key --pager-duty-url=http://pagerduty-url email --email-from=origin@domain.com --email-to=destiny@domain.com
|
email | Configure email notifications for Alert manager. | [--email-from] TEXT: Specify the adddress from email will come.
[--email-to]: Specify the adddress where email will be sent to.
[--smarthost]: Specify the smarthost for email service.
[--auth-password]: Specify the auth password for smarthost service.
[--auth-username]: Specify the user for smarthost service.
[--require-tls]: Enable TLS if required.
[--send-resolved]: Send resolved alerts notifications.
[--namespace] TEXT: Namespace in which monitoring is installed. Default is 'monitoring'
| agility monitoring set email --email-from=origin@domain.com --email-to=destiny@domain.com
|
pagerduty | Configure pager duty notifications for Alert manager. | [--pager-duty-service-key] TEXT: Specify Pager duty service key.
[--pager-duty-url] TEXT: Specify the pager duty url.
[--namespace] TEXT: Namespace in which monitoring is installed. Default is 'monitoring'
| agility monitoring set pagerduty --pager-duty-service-key=pagerduty-key --pager-duty-url=http://pagerduty-url
|
For the non cli (manual Helm) installation details please refer to AGILITY Monitoring
Command: proxy
Manage proxy configuration.
| | | |
|---|
set | Set the proxy configuration. | --http-proxy: Specify the HTTP proxy (required).
--https-proxy: Specify the HTTPS proxy (required).
[--no-proxy]: Specify the hosts to exclude from the proxy.
[--namespace] TEXT: Namespace in which AGILITY is installed. Default is 'agility'.
[--cv] TEXT: ContinuosValidation (default: agility)
| agility proxy set --http-proxy http://proxy.example.com --https-proxy https://proxy.example.com --no-proxy localhost,127.0.0.1
|
reset | Remove the proxy configuration. | [--namespace] TEXT: Namespace in which AGILITY is installed. Default is 'agility'.
[--cv] TEXT: ContinuosValidation (default: agility)
| agility proxy reset
|
Command: telemetry
Manage telemetry settings.
Sub Command local
Local monitoring (agility-monitoring) stack telemetry data.
| | | |
|---|
enable | Enable local usage data collection. | [--agility-namespace] TEXT: Namespace in which AGILITY is installed (default: agility).
[--cv] TEXT: ContinuosValidation (default: agility)
[--monitoring-namespace] TEXT: Namespace in which monitoring is installed (default: monitoring).
[--auto-accept]: Auto accept all the questions (y). (default: False)
| agility telemetry local enable --auto-accept
|
disable | Disable local usage data collection. | [--agility-namespace] TEXT: Namespace in which AGILITY is installed (default: agility).
[--cv] TEXT: ContinuosValidation (default: agility)
[--monitoring-namespace] TEXT: Namespace in which monitoring is installed (default: monitoring).
[--auto-accept]: Auto accept all the questions (y). (default: False)
| agility telemetry local disable --auto-accept
|
status | Show local usage data collection details. | [--agility-namespace] TEXT: Namespace in which AGILITY is installed (default: agility).
[--cv] TEXT: ContinuosValidation (default: agility)
[--monitoring-namespace] TEXT: Namespace in which monitoring is installed (default: monitoring).
[--auto-accept]: Auto accept all the questions (y). (default: False)
| agility telemetry local status
|
Sub Command remote
Anonymous usage data collection to B-Yond.
| | | |
|---|
enable | Enable anonymous usage data collection. | [--namespace] TEXT: Namespace in which AGILITY is installed (default: agility).
[--cv] TEXT: ContinuosValidation (default: agility)
[--auto-accept]: Auto accept all the questions (y). (default: False).
| agility telemetry remote enable --auto-accept
|
disable | Disable anonymous usage data collection. | [--namespace] TEXT: Namespace in which AGILITY is installed (default: agility).
[--cv] TEXT: ContinuosValidation (default: agility)
[--auto-accept]: Auto accept all the questions (y). (default: False)
| agility telemetry remote disable --auto-accept
|
status | Show anonymous usage data collection details. | [--namespace] TEXT: Namespace in which AGILITY is installed (default: agility).
[--cv] TEXT: ContinuosValidation (default: agility)
[--auto-accept]: Auto accept all the questions (y). (default: False)
| agility telemetry remote status
|
Sub Command customer
Enables a customer to route Agility data to a compliant Open Telemetry collector.
| | | |
|---|
enable | Enable data collection to customer open telemetry collector. | [--namespace] TEXT: Namespace in which AGILITY is installed (default: agility)
[--cv] TEXT: ContinuosValidation (default: agility)
--endpoint TEXT Endpoint of the OpenTelemetry Collector.
--port TEXT Port of the OpenTelemetry Collector.
| |
disable | Disable data collection to customer open telemetry collector. | [--namespace] TEXT: Namespace in which AGILITY is installed (default: agility).
[--cv] TEXT: ContinuosValidation (default: agility)
| agility telemetry customer disable --auto-accept
|
status | Show status of data collection to customer open telemetry collector. | [--namespace] TEXT: Namespace in which AGILITY is installed (default: agility).
[--cv] TEXT: ContinuosValidation (default: agility)
| agility telemetry customer status
|
Sub Command remote
Anonymous usage data collection to B-Yond.
| | | |
|---|
enable | Enable anonymous usage data collection. | [--namespace] TEXT: Namespace in which AGILITY is installed (default: agility).
[--cv] TEXT: ContinuosValidation (default: agility)
[--auto-accept]: Auto accept all the questions (y). (default: False).
| agility telemetry remote enable --auto-accept
|
disable | Disable anonymous usage data collection. | [--namespace] TEXT: Namespace in which AGILITY is installed (default: agility).
[--cv] TEXT: ContinuosValidation (default: agility)
[--auto-accept]: Auto accept all the questions (y). (default: False)
| agility telemetry remote disable --auto-accept
|
status | Show anonymous usage data collection details. | [--namespace] TEXT: Namespace in which AGILITY is installed (default: agility).
[--cv] TEXT: ContinuosValidation (default: agility)
[--auto-accept]: Auto accept all the questions (y). (default: False)
| agility telemetry remote status
|
Sub Command customer
Enables a customer to route Agility data to a compliant Open Telemetry collector.
| | | |
|---|
enable | Enable data collection to customer open telemetry collector. | [--namespace] TEXT: Namespace in which AGILITY is installed (default: agility)
[--cv] TEXT: ContinuosValidation (default: agility)
--endpoint TEXT: Endpoint of the OpenTelemetry Collector.
--port TEXT Port of the OpenTelemetry Collector.
--no_tls Do not setup TLS.
--tls_key TEXT: TLS key path.
--tls_cert TEXT: TLS cert path.
--tls_ca TEXT: TLS ca path (optional).
| |
disable | Disable data collection to customer open telemetry collector. | [--namespace] TEXT: Namespace in which AGILITY is installed (default: agility).
[--cv] TEXT: ContinuosValidation (default: agility)
--auto-accept Auto accept all the questions (y).
| agility telemetry customer disable --auto-accept
|
status | Show status of data collection to customer open telemetry collector. | [--namespace] TEXT: Namespace in which AGILITY is installed (default: agility).
[--cv] TEXT: ContinuosValidation (default: agility)
| agility telemetry customer status
|
Sub Command syslog
Enables a syslog exporter to to route Agility logs to a compliant Syslog receiver.
| | | |
|---|
enable | Enable log collection to an external syslog receiver. | [--namespace] TEXT: Namespace in which AGILITY is installed (default: agility)
[--cv] TEXT: ContinuosValidation (default: agility)
--endpoint TEXT Endpoint of the Syslog receiver.
--port TEXT Port of the Syslog receiver.
--protocol TEXT Protocol (rfc5424 or rfc3164) of the syslog endpoint. Default 'rfc5424'
| agility telemetry syslog enable --endpoint loclahost --port 514 --protocol rfc5424
|
disable | Disable log collection to an external syslog receiver. | [--namespace] TEXT: Namespace in which AGILITY is installed (default: agility).
[--cv] TEXT: ContinuosValidation (default: agility)
| agility telemetry syslog disable
|
status | Show status log collection to an external syslog receiver. | [--namespace] TEXT: Namespace in which AGILITY is installed (default: agility).
[--cv] TEXT: ContinuosValidation (default: agility)
| agility telemetry syslog status
|
Command: upgrade
Upgrade AGILITY components.
| | | |
|---|
agility | Upgrade the AGILITY component. | --version TEXT: Specify the version for upgrade (required).
[--namespace] TEXT: Namespace in which AGILITY is installed. Default is 'agility'. .
| agility upgrade agility --version 3.86.3
|
agility-services | Upgrade the AGILITY Services component. | --version TEXT: Specify the version for upgrade (required).
[--namespace] TEXT: Namespace in which AGILITY is installed. Default is 'agility'. .
| agility upgrade agility-services --version 3.86.3
|
agility-system | Upgrade the AGILITY System component. | --version TEXT: Specify the version for upgrade (required).
[--namespace] TEXT: Namespace for AGILITY System (default: kube-system) (default: kube-system).
| agility upgrade agility-system --version 3.86.3
|
cli | Upgrade AGILITY CLI. | --version TEXT: Specify the version for upgrade (required).
| agility upgrade cli --version 3.86.3
|
all | Upgrade all AGILITY components with the same version (except the database). | --all-version TEXT: Specify the version for upgrade. All components with the same version (required).
[--namespace] TEXT: Namespace for AGILITY and AGILITY Services (default: agility)
--sys-namespace TEXT: Namespace for AGILITY System (default: kube-system).
| agility upgrade all --all-version 3.86.3 --namespace agility --sys-namespace kube-system
|
database | Upgrade PostgreSQL version. | --version TEXT: Specify the PostgreSQL major version to upgrade (required).
[--namespace] TEXT: Namespace for AGILITY (default: agility)
[--auto-accept]: Auto accept all the questions (y). (default: False)
[--force]: Force upgrade, ignoring some restrictions. (default: False)
| agility upgrade database --version 16
|