Skip to main content
Device groups are typically HA pairs ā€” an active device and a standby. crcli devicegroups commands target the active device by default unless you specify --standby or --all. All commands accept a device group name or UUID.

ā€‹
devicegroups list

List all device groups for your tenant. 
crcli devicegroups list

ā€‹
devicegroups get

Show details for a single device group. 
crcli devicegroups get <group>

ā€‹
devicegroups devices

List member devices of a device group. 
crcli devicegroups devices <group>

ā€‹
devicegroups ssh

Open an SSH session to a device groupā€™s active device. 
# Connect to active device
crcli devicegroups ssh <group>

# Connect to standby device
crcli devicegroups ssh <group> --standby

# Connect to both active and standby simultaneously
crcli devicegroups ssh <group> --all

# Run a command on the active device
crcli devicegroups ssh <group> -c "tmsh show sys version"

# Run a command on the standby device
crcli devicegroups ssh <group> -c "tmsh show sys version" --standby

# Run a script across multiple groups simultaneously
crcli devicegroups ssh <group1> <group2> <group3> -S ./check.sh

# Group output per device (no interleaving)
crcli devicegroups ssh <group1> <group2> -S ./check.sh --group

# Save each device's output to a file
crcli devicegroups ssh <group> -S ./audit.sh --output-dir ./results/
Flags:
FlagShortDescription
--standby-sConnect to the standby device instead of active
--all-aConnect to both active and standby simultaneously
--command-cRun a command string
--script-SExecute a local script file
--interpreter-iInterpreter for script execution (default: bash)
--group-gBuffer output per device instead of interleaving
--output-dirSave each deviceā€™s output to a file in this directory

ā€‹
devicegroups web

Open the BIG-IP TMUI web console in your browser for the active device. 
crcli devicegroups web <group>

# Standby device
crcli devicegroups web <group> --standby

# Print URL instead of opening browser
crcli devicegroups web <group> -n

ā€‹
devicegroups push

Upload files to every device in a group simultaneously. 
crcli devicegroups push <group> ./bigip.conf

# Push to multiple groups at once
crcli devicegroups push <group1> <group2> ./bigip.conf

# Specify remote destination
crcli devicegroups push <group> ./bigip.conf:/config/bigip.conf

ā€‹
devicegroups pull

Download a file from every device in a group. Files are saved as <hostname>_<filename> so they donā€™t overwrite each other. 
crcli devicegroups pull <group> /config/bigip.conf

# Save to a specific directory
crcli devicegroups pull <group> /config/bigip.conf -o ./configs/

# Pull multiple files
crcli devicegroups pull <group> /config/bigip.conf /config/bigip_base.conf -o ./configs/
Flags:
FlagShortDescription
--output-oDirectory to save downloaded files (default: .)

ā€‹
Global Flags

FlagShortDescription
--env-eEnvironment: prod (default), staging
--output-OOutput format: table, json, yaml
--debug-dPrint HTTP request/response details
--no-telemetryDisable usage analytics