Skip to main content

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