VA
Learn about the CLI commands you can use to interact with VAs in this guide.
A virtual appliance (VA) is a Linux-based virtual machine that connects to your sources and applications in ISC by using APIs, connectors, and other integrations SailPoint has made available.
For more information about VAs, refer to the Virtual Appliance Reference Guide.
Commands
To use the CLI to interact with VAs connected to your tenant, run these commands:
Collect
To collect all files from a VA, run this command:
sail va collect {VA IP address} {flags}
This command gets all files from the VA and saves them to the current working directory (the directory you're in), unless you specify flags.
Flags
You can add these flags to the the collect
command:
-o, --output
: Set the path to save the files to. If the directory doesn't exist, the CLI creates it. The default directory is the current working directory.-c, --config
: Only get config files.-h, --help
: View the command's help with examples within the CLI.-l, --logs
: Only get log files.
Example
Here is an example command and response:
sail va collect 10.10.10.25 10.10.10.26 -p S@ilp0int -p S@ilp0int
2023/10/05 22:19:19 INFO Starting File Collection VA=10.10.10.26
2023/10/05 22:19:19 INFO Starting File Collection VA=10.10.10.25
2023/10/05 22:19:19 WARN Skipping file file=/home/sailpoint/proxy.yaml VA=10.10.10.25
2023/10/05 22:19:19 WARN Skipping file file=/home/sailpoint/log/ccg.log VA=10.10.10.25
2023/10/05 22:19:19 WARN Skipping file file=/home/sailpoint/proxy.yaml VA=10.10.10.26
2023/10/05 22:19:19 WARN Skipping file file=/home/sailpoint/log/ccg.log VA=10.10.10.26
10.10.10.26 - static.network : 87.00 b Complete
10.10.10.26 - resolv.conf : 785.00 b Complete
10.10.10.25 - resolv.conf : 785.00 b Complete
10.10.10.25 - static.network : 87.00 b Complete
10.10.10.25 - charon.log : 36.12 MB Complete
10.10.10.26 - charon.log : 36.06 MB Complete
Parse
This command converts log files into a human-readable format. It's helpful when you want to troubleshoot VA issues.
To parse log files, run this command:
sail va parse {log file} {flags}
By default, this command parses all errors in the log files, not all log traffic - you can use flags to parse all log traffic.
Flags
You can add these flags to the parse
command:
--type
:canal
Specify that the provided files are Canal log files.ccg
Specify that the provided files are CCG log files.
-e, --everything
: Parse all log traffic, not just errors.-h, --help
: View the command's help with examples within the CLI.
Example
Here is an example command:
sail va parse --type ccg ./path/to/ccg.log ./path/to/ccg.log --all
or
sail va parse --type canal ./path/to/canal.log ./path/to/canal.log
Update
To update a VA, run this command:
sail va update {VA IP address} {flags}
Flags
You can add these flags to the update
command:
-h, --help
: View the command's help with examples within the CLI.
Example
Here is an example command:
sail va update 10.10.10.25
or
sail va update 10.10.10.25 -p S@ilp0int