Professional Documents
Culture Documents
Version 6.0
755-0148-01 B3
Trademarks
Legal Notices
Certain products and features, including the Rubrik-hosted mode of Polaris for Microsoft 365 Protection,
are subject to additional product-specific terms available at https://www.rubrik.com/en/legal.
By using the Rubrik Polaris Sonar application, you understand and acknowledge that Rubrik Polaris Sonar’s
pre-existing Policies and Analyzers contain general suggestions for data elements and formats based on
common data sets and formats. The suggested data elements and formats in Rubrik Polaris Sonar are not
intended to be a comprehensive or exhaustive list of data elements and formats regulated by the GDPR,
CCPA or any other applicable laws and regulations. We also do not guarantee that your Rubrik Polaris
Sonar search results will include every instance of each data element and format within your data set. We
Support
Use one of the following methods to contact Rubrik Support.
Revision history
The revision history of this guide.
Rev. B2 July 2021 General Availability release of Rubrik CDM version 6.0.
Rev. B3 Aug 2021 Added the cluster upgrade download_and_precheck, cluster
upgrade list_available_versions, cluster upgrade resume,
cluster upgrade rollback, cluster upgrade start, and
cluster upgrade status commands.
Preface 08/17/2021 | iv
Related documentation
Rubrik provides documentation that covers a broad range of related concepts, tasks, and reference
information.
• Rubrik Polaris User Guide
• Rubrik Polaris Radar Quick Start Guide
• Rubrik CDM Release Notes
• Rubrik CDM User Guide
• Rubrik CDM Install and Upgrade Guide
• Rubrik CDM Security Guide
• Rubrik CDM Cloud Cluster Setup Guide
• Rubrik CDM Hardware Guide
• Rubrik CDM CLI Guide
• Rubrik CDM Events Guide
• Rubrik Edge Install and Upgrade Guide
• Rubrik Virtual Cluster Install Guide
• Rubrik Compatibility Matrix
Products
To provide comments and suggestions about our products contact Rubrik Support, as described in Support.
Product documentation
To provide comments and suggestions about the product documentation, please send your message by
email to: techpubs@rubrik.com.
Please include the following information about the product documentation to help us to find the content
that is the subject or your comments:
• Full title
• Part number
• Revision
• Relevant pages
Rubrik Build
Rubrik hosts community-based tools through the Rubrik Build program and associated GitHub repositories
for community-supplied tools.
Rubrik Build is an open source program that provides access to a growing community of enthusiasts and
experts across a number of languages and tools. Rubrik Build is used to create and improve projects that
simplify monitoring, testing, development, and automated workflows for Rubrik product deployments.
Rubrik Build includes the following resources:
• Software Development Kits
Preface 08/17/2021 | v
• Tooling Integrations
• Use Cases
• Community Projects
• Rubrik REST API documentation
Important: USE AT YOUR OWN RISK. Rubrik does not officially support the community tools. Carefully
investigate a community tool before using it. Always test a community tool on non-production data before
using the tool with production data.
Contents
Rubrik Build....................................................................................................................................10
Cloud management........................................................................................................................ 14
cloud network get_flag_public_or_private_ip............................................................................. 14
cloud network use_private_ip................................................................................................... 14
cloud network use_public_ip.....................................................................................................15
Cluster management......................................................................................................................16
cluster add_node..................................................................................................................... 16
cluster bootstrap...................................................................................................................... 17
cluster cluster_name................................................................................................................ 17
cluster cluster_uuid.................................................................................................................. 18
cluster discover........................................................................................................................18
cluster entitle_node..................................................................................................................19
cluster get_failed_jobs..............................................................................................................20
cluster get_node_statuses........................................................................................................ 21
cluster grace............................................................................................................................22
cluster health_monitor get_policies........................................................................................... 23
cluster health_monitor get_status............................................................................................. 24
cluster health_monitor run_policies........................................................................................... 26
cluster hw_health.....................................................................................................................27
cluster node_hostname_change................................................................................................ 29
cluster install........................................................................................................................... 30
cluster job_instances................................................................................................................30
cluster job_logs....................................................................................................................... 33
cluster ledctl............................................................................................................................ 35
cluster manual_discover........................................................................................................... 35
cluster mfg_status................................................................................................................... 36
cluster monitor........................................................................................................................ 37
cluster mount.......................................................................................................................... 38
cluster node_table................................................................................................................... 39
cluster poweroff_cluster........................................................................................................... 40
cluster poweroff_node..............................................................................................................40
cluster provide_encryption_password........................................................................................ 41
cluster reboot.......................................................................................................................... 41
cluster reset_node_status......................................................................................................... 42
cluster revert_hotpatch.............................................................................................................43
cluster rubrik_tool.................................................................................................................... 43
cluster service_status............................................................................................................... 44
cluster setupnetwork................................................................................................................ 45
cluster tpm_upgrade................................................................................................................ 47
commands list................................................................................................................................ 54
Network management................................................................................................................... 55
network arping........................................................................................................................ 55
network bond_mode get.......................................................................................................... 55
network bond_mode set...........................................................................................................55
network broadcast_interface get............................................................................................... 56
network broadcast_interface remove.........................................................................................56
network broadcast_interface setup............................................................................................56
network check_connectivity...................................................................................................... 57
network configure_ip_hosts_mapping........................................................................................57
network dig............................................................................................................................. 58
network esx_subnets................................................................................................................58
network esx_subnets get......................................................................................................... 58
network esx_subnets reset....................................................................................................... 59
network esx_subnets set..........................................................................................................59
network ethtool....................................................................................................................... 59
network floating_ips.................................................................................................................60
network hostname................................................................................................................... 60
network hosts..........................................................................................................................60
network ifconfig....................................................................................................................... 61
network iperf........................................................................................................................... 61
network ipv6 configure.............................................................................................................62
network ipv6 list...................................................................................................................... 62
network move_floating_ip.........................................................................................................63
network mtr............................................................................................................................ 63
network nameservers............................................................................................................... 64
network netstat....................................................................................................................... 64
network nslookup.....................................................................................................................64
network ntp_status.................................................................................................................. 65
network ping........................................................................................................................... 65
network re_ip.......................................................................................................................... 65
network route.......................................................................................................................... 67
network set_default_gateway................................................................................................... 67
network static_route add..........................................................................................................67
network static_route delete...................................................................................................... 68
network tcp_sack..................................................................................................................... 69
network vlan add.....................................................................................................................70
network vlan list...................................................................................................................... 71
network vlan remove............................................................................................................... 71
Support management.................................................................................................................... 76
support cluster_support_bundle................................................................................................ 76
support decommission_status................................................................................................... 77
support find_bad_disk.............................................................................................................. 77
support iops............................................................................................................................ 78
support local_support_bundle................................................................................................... 78
support log_view..................................................................................................................... 79
support teleport regtoken.........................................................................................................81
support toggle_support_data.................................................................................................... 82
support tunnel close................................................................................................................ 83
support tunnel get_port........................................................................................................... 83
support tunnel get_timeout_type.............................................................................................. 84
support tunnel open................................................................................................................ 84
support tunnel service..............................................................................................................85
support tunnel use_absolute_timeout........................................................................................86
support tunnel use_inactivity_timeout....................................................................................... 86
Contents 08/17/2021 | ix
Chapter 1
Rubrik Build
Rubrik Build
Rubrik hosts community-based tools through the Rubrik Build program and associated GitHub repositories
for community-supplied tools.
Rubrik Build is an open source program that provides access to a growing community of enthusiasts and
experts across a number of languages and tools. Rubrik Build is used to create and improve projects that
simplify monitoring, testing, development, and automated workflows for Rubrik product deployments.
Rubrik Build includes the following resources:
• Software Development Kits
• Tooling Integrations
• Use Cases
• Community Projects
• Rubrik REST API documentation
Important: USE AT YOUR OWN RISK. Rubrik does not officially support the community tools. Carefully
investigate a community tool before using it. Always test a community tool on non-production data before
using the tool with production data.
Procedure
1. Open an SSH session by typing the following command:
ssh admin@node_ip
Where node_ip is the IP address of a node.
2. At the password prompt, type the password for the admin account. After a successful login, the Rubrik
CLI prompt appears.
If the admin account was configured with multifactor authentication (MFA), the passcode from
the configured device is also required to login. For example, the passcode from an authenticator
application on a portable device.
Important: The appropriate submenu name must precede the command name.
Cloud management
Syntax
Syntax
Syntax
Cluster management
These commands manage a Rubrik cluster and the individual nodes in it.
Precede these commands with the submenu name 'cluster', as in cluster add_node.
cluster add_node
Add nodes to a Rubrik cluster.
Syntax
cluster add_node
cluster add_node
Node configuration
==================
Number of nodes to add [1]: 1
Node ID: 2
========================
Management Configuration
========================
Management Ip Address: 10.16.54.41
Management Subnet Mask: 255.255.255.252
Management Gateway: 129.144.50.56
Management VLAN (Optional): 2000
==================
IPMI Configuration
==================
IPMI IP Address: 192.168.1.211
IPMI Subnet Mask: 255.244.255.252
IPMI Gateway: 128.25.132.23
IPMI Password:
Confirm IPMI Password:
Passwords matched.
{'2': {'ipmiIpConfig': {'address': '192.168.1.211',
'gateway': '128.25.132.23',
'netmask': '255.244.255.252'},
'managementIpConfig': {'address': '10.16.54.41',
'gateway': '129.144.50.56',
'netmask': '255.255.255.252',
'vlan': 2000}}}
Does this configuration look OK?
Type "yes" to continue, otherwise Abort.: yes
Syntax
cluster bootstrap
Usage
• Run bootstrap in a command line session on a node that is part of a Rubrik cluster.
• The node running bootstrap must have at least 24 GB of available memory.
cluster cluster_name
Displays the human-readable name assigned to the Rubrik cluster.
Syntax
cluster cluster_name
cluster cluster_uuid
Displays the universally unique identifier (UUID) assigned to the Rubrik cluster.
Syntax
cluster cluster_uuid
cluster discover
Discovers nodes that are available to add to the Rubrik cluster.
Syntax
cluster discover
If there are no systems to add to the Rubrik cluster, cluster discover displays an empty output.
cluster entitle_node
Configures entitlement on a node running Rubrik CDM.
Syntax
cluster entitle_node
Entitlement complete...
RDL6420BYTKS13CNWS3009AV00BX03 >>
cluster get_failed_jobs
Lists failed jobs of all types from the Rubrik cluster during a defined time period.
Syntax
Parameter Description
-h Prints the help message and exits.
--limit limit Number of events to retrieve. The default is 25.
--hours-since hours_since Include only events that have occurred in the past
hours_since hours.
--hosts [hosts] Limit retrieved jobs to the given hosts
cluster get_node_statuses
Retrieves the status of each node in the Rubrik cluster.
Syntax
cluster get_node_statuses
Usage
cluster grace
Prints documentation about Rubrik APIs, including descriptions of what individual endpoints do and the
data format each endpoint requires.
Syntax
Parameter Description
-H host Name of the machine on which the command is
run.
-T token API method arguments Describes the token being researched.
-p password API method arguments Rubrik CLI login password.
-h [API] | [API method] | [model] Name of the API being researched.
-I Use an internal API.
Here is an example of using cluster grace to list information for the MssqlApi endpoint.
Version v1 methods:
assign_mssql_sla_properties
Syntax
The following is a truncated sample session for the cluster health_monitor get_policies
command.
Syntax
Parameter Description
[NODE_ID] [NODE_ID ...]] Space-separated list of node IDs.
--all List all policy statuses, including passing policies
The following is a sample session for the cluster health_monitor get_status command with a
failing policy.
The following is a sample session for the cluster health_monitor get_status command listing all
policies on a specific node.
Usage
By default cluster health_monitor get_status prints only failing policies on all nodes.
Include the --all parameter to print all policy results, including passing and skipped policies.
Include the NODE_ID parameters to retrieve health monitor policy statuses for specific nodes.
Syntax
Parameter Description
policy1[,] policy2[,] policy3 List of comma or space separated policy IDs to run.
cluster hw_health
Displays the health of the hardware.
Syntax
cluster hw_health
Usage
The Rubrik cluster reports an error when the cluster hw_health command is run on a virtual machine.
cluster node_hostname_change
Changes the hostname of a Rubrik cluster node.
Syntax
Usage
cluster node_hostname_change changes only the name of the node from which the command is
issued.
The new hostname provided must be RFC1123 compliant. The length must be less than or equal to 64
characters. Valid characters are: numbers, upper and lower case letters, dash, and dot. The hostname
cannot start with a dash or a dot.
cluster install
Performs a cluster install.
Syntax
Parameter Description
-h Prints the help message and exits.
start Start a Rubrik CDM software installation.
status Check the status of an upgrade.
cluster job_instances
Displays job instances for a specified job type or job status.
Syntax
Parameter Description
job_type Type of job for which instances are
being reported. See #unique_31/
unique_31_Connect_42_table_jobsbelow for a list.
Values for job_type must be entered in all capital
letters.
job_status Status of the job. One of:
• QUEUED
• ACQUIRING
• RUNNING
Usage
• When job_type is not specified, cluster job_instances displays a list of possible job types.
• The table contains the following information:
• Job ID
• Instance ID
• Node ID
• Job status
• Job start time stamp
• Job end time stamp
• This table lists the available jobs for job_type.
Job types
ABANDONED_SHARDED_GROUP GC PARALLELIZED_STATS_UPDATER
_PURGE
_AND_INSTANCE
_ORCHESTRATOR_GC
_CHECK_STATUS
_TIME_SERIES
_SCRATCH_BLOBSTORE _DATA_SOURCE
_SOURCE_FREQUENT
_SNAPSHOT
_SNAPSHOT_INTEGRITY _CACHE
_MAINTENANCE
_NODE_SNAPSHOT
_CREDENTIALS _REFRESHER
_AFTER_UPGRADE
cluster job_logs
Uses the system grep command to search the logs of a particular service.
Syntax
Usage
Use the job_instances command to display the instance ID of a given job. The service_name is the
name listed in the output of the log_view command. Use the get_failed_jobs command to display
failed jobs from a given time period.
This example uses the job_instances command to determine the instance_id for a job, then uses that
instance_id as input for the job_logs command.
cluster ledctl
Activates or resets the status LED for a hard disk drive for replacement of a disk on the chassis of the local
node. This command does not support solid-state drives or r528 Rubrik appliances.
Syntax
Parameter Description
locate Locates the LED on the machine.
normal Resets the LED to normal.
ledctl normal=/dev/sdb
cluster manual_discover
Discover nodes to start or add to a cluster.
Syntax
Example:
cluster mfg_status
Displays manufacturing status of a physical node.
Syntax
cluster mfg_status
cluster mfg_status displays the date and time the node was successfully manufactured.
cluster mfg_status displays this message when the manufacture was unsuccessful, the command
was run on a virtual machine, or the node has been upgraded.
cluster mfg_status reports on the status of the node on which it was run, not the cluster.
cluster mfg_status does not produce meaningful information post upgrade.
cluster monitor
Displays cluster status
Syntax
Parameter Description
-h Prints the help message and exits.
list limit Display all monitor checks with descriptions.
status Display all monitor checks and their status.
run Run a monitor check and report status.
Type this command to display a list of the cluster status checks. This display is shortened for display
purposes.
Type this command to display the periodic checks that did not run, that ran successfully, and that failed.
This display is shortened for display purposes.
stdout:
stderr:
Jfl check PASSED
cluster mount
Adds a USB device at the specified path. Used when upgrading Rubrik firmware or exporting support
bundles.
Syntax
Parameter Description
--usb_device [device_path] Specifies the path to the USB device.
Syntax
Usage
[Nodes]
node id: B-1503-lb
status: OK
last updated time: 2020-04-09 23:32:11.054000
management IP address: 10.0.86.152
data IP address: 10.0.86.152
IPMI address: 10.1.81.133
cluster poweroff_cluster
Performs a node status check followed by a graceful shutdown of all nodes in the Rubrik cluster.
Syntax
Parameter Description
--skip_node_status Shuts down the Rubrik cluster without performing a
node status check.
Usage
By default, poweroff_cluster performs a node status check and shuts down the node that hosts the
current session last. This command shuts down the Rubrik cluster only if all nodes are in healthy state.
Note: Nodes that have been down for more than 24 hours and skip the node status check before being
shut down require assistance from Rubrik Support to re-join a Rubrik cluster.
cluster poweroff_node
Performs a node status check followed by a graceful shutdown of the node that hosts the current session.
Syntax
cluster poweroff_node
cluster provide_encryption_password
Checks whether a password is necessary to unlock hard disks on a Rubrik Edge.
Syntax
cluster provide_encryption_password
This is an example of a node reboot during key rotation, and the disks are encrypted by two passwords.
cluster reboot
Gracefully shuts down and restarts either the Rubrik cluster or the node that hosts the current session.
Syntax
Parameter Description
cluster Shuts down and restarts the Rubrik cluster.
node Shuts down and restarts the node that hosts the
current session.
The following example uses cluster reboot cluster to restart a Rubrik cluster.
cluster reset_node_status
Displays the status of a node reset operation.
Syntax
cluster reset_node_status
Usage
If the node is bootstrapped and part of cluster, it prints "Reset node exited or has not run yet".
If the node reset operation has successfully completed, it prints "Reset node successfully completed".
If the node reset operation has failed or still in progress, it prints "Reset node in progress".
Syntax
cluster revert_hotpatch
cluster rubrik_tool
Performs calls to the Rubrik API from the command line.
Syntax
Usage
cluster service_status
Displays the status of Rubrik cluster services such as uptime and process IDs for the node. The status of
services is either up or down.
Syntax
cluster service_status
Usage
Example:
cluster setupnetwork
Configures management, data, and IPMI networks on single or multiple nodes.
Syntax
cluster setupnetwork
Usage
cluster setupnetwork only works on nodes that are not yet bootstrapped.
When run on a bootstrapped node, cluster setupnetwork fails with this message, "Unauthorized".
User configuration
==================
SetupNetwork Progress
=====================
Starting setup network . . . .
Setting up IP Services . . . . . . . . .
System setup completed
Syntax
Parameter Description
start Upgrades the TPM firmware.
status Checks the status of the TPM firmware and displays
a message saying whether the TPM firmware
requires upgrading.
Example:
cluster umount
Removes a device at the specified path. Used when unmounting a USB storage device after uploading
Rubrik software upgrades or after exporting support bundles.
Syntax
Parameter Description
-h Prints the help message and exits.
--usb_device [ device_name] Specifies the USB device to unmount.
Example:
Syntax
Parameter Description
-h | --help Prints the help message and exits.
from_rubrik_release_repository Prompts for Rubrik Support Portal credentials, and
then lists the compatible Rubrik CDM images for the
upgrade.
from_url URL containing the .zip format install image.
from_local Lists the images available for installation from the
images present on the Rubrik cluster node.
watch Provides status information about the upgrade.
cancel Cancels the upgrade operation.
This example retrieves the image from the local node, shares it with other nodes of the Rubrik cluster,
stages it to the secondary partition on all nodes in the cluster, and runs upgrade prechecks for Rubrik CDM
version 6.0-dev-13025.
Following progress of the currently running download and pre-check job. This
method waits
until the job completes. You can return to this view at any time using
"cluster upgrade
download_and_precheck watch". To do a quick check on the current progress
instead, use
"cluster upgrade list_available_versions downloading".
|
##################--------------------------------------------------------------|
22.85%
Usage
cluster upgrade download_and_precheck provides the first step of the upgrade process, using the
prestaging mechanism to download and stage the image. The upgrade prechecks are run while the cluster
is operational.
After successfully running cluster upgrade download_and_precheck, run cluster upgrade
start --mode=normal. This command shuts down the cluster services and then performs the
remaining steps of the upgrade, which install the new Rubrik CDM release software on the Rubrik cluster.
Syntax
Parameter Description
-h | --help Prints the help message and exits.
local List the versions of Rubrik CDM available for
upgrade on the local node.
rubrik_release_repository List the versions of Rubrik CDM available for
upgrade in the Rubrik CDM release directory.
downloading List the versions of Rubrik CDM that are currently
downloading.
This example lists the versions of Rubrik CDM that are available for upgrade on the local node.
Syntax
Usage
Syntax
Usage
Syntax
Parameter Description
-h | --help Prints the help message and exits.
--share filename Path to the install image tarball in the share area
--auto_rollback_on_error {True,False}] Automatic rollback to the current Rubrik cluster
version when an upgrade failure occurs.
--mode {normal | prechecks_only | reset} Indicates the upgrade mode:
• normal – Perform a complete upgrade.
• prechecks_only – Perform only the upgrade
prechecks.
• reset – Resets the upgrade mode. Not available
for disk image upgrade operations.
.
cluster upgrade start starts the installation operation and returns immediately to the command line.
Use the cluster upgrade status command to determine the status of the upgrade operation.
Related reference
cluster upgrade status
Checks the status of a Rubrik CDM upgrade operation.
Syntax
Parameter Description
-h | --help Prints the help message and exits.
watch Display the ongoing status of the upgrade
operation.
cluster uptime
Displays information about the cluster since it was last started.
Syntax
cluster uptime
Usage
cluster uptime output includes the current local time, the length of time since the last restart, the
length of the current session, the node ID, and the load average for each node in the Rubrik cluster.
cluster version
Displays the version of the Rubrik cluster software installed on the node that hosts the current session. All
nodes on the Rubrik cluster run on the same version.
Syntax
cluster version
Example:
commands list
Syntax
commands list
Tab completion is available with this command.
Network management
Use these commands to analyze network performance in the Rubrik cluster and to manage VLANs and IP
addresses.
Precede these network commands with the submenu name 'network', as in network ifconfig. Tab
completion is available with these commands.
network arping
Sends a ping to MAC addresses for troubleshooting network and cluster installation issues.
Syntax
network arping
Syntax
Usage
If the CLI session is running on an node that is not bootstrapped, network bond_mode get displays the
bond mode of the local node.
When run on a bootstrapped node, network bond_mode get displays a message stating the node is
bootstrapped.
Syntax
Usage
Syntax
Usage
Syntax
Syntax
Use network broadcast_interface setup only if native VLAN is disabled on the network switch.
network check_connectivity
Connects to a specified target host on a specified port and returns the result of the connection attempt.
Syntax
network configure_ip_hosts_mapping
Configures custom entries in /etc/hosts.
Syntax
network configure_ip_hosts_mapping
Usage
Displays, creates, and deletes custom host file entries for the entire Rubrik cluster.
network configure_ip_hosts_mapping displays, creates, and deletes custom host file entries for
the entire Rubrik cluster.
Running this command from any node creates updated host files for all nodes in the cluster.
Use network configure_ip_hosts_mapping only when nodes are in a status of
OK
.
Syntax
Parameter Description
server Name of the DNS server.
name Name of the resource record.
type Type of query.
network esx_subnets
Use the network esx_subnets command to configure esx_subnets for the Rubrik cluster.
For VMware, esx_subnets filter the multiple ESXi host IP addresses and provide guidance for these
situations.
• For Export of vSphere virtual machine snapshots, the configured esx_subnets are used to filter the IP
addresses of ESXi hosts. For each IP address within the esx_subnets, an IP address to ESXi host FQDN
mapping entry is added to /etc/hosts file. These host file entries take priority over DNS lookup and
point VMware exports to the specified IP address of an ESXi host.
• For Live Mount or Instant Recovery operations of vSphere virtual machine snapshots, the esx_subnets
are used to filter multiple IP addresses of an ESXi host. Those IP addresses falling within the
esx_subnets are used to point IP address matching or optimization efforts to select the best local IP
address and export as a data store for mount operations.
Syntax
Usage
Use network esx_subnets get only when the Rubrik cluster nodes are in a status of OK.
Syntax
Usage
Use network esx_subnets reset only when the Rubrik cluster nodes are in a status of OK.
Syntax
Parameter Description
IP_address A comma-separated list of subnets using CIDR
notation.
Usage
Enter subnet information carefully. Incorrect subnet settings can cause failures during backup, Live Mount,
and Instant Recovery of vSphere virtual machine snapshots.
Use network esx_subnets set only when the Rubrik cluster nodes are in a status of OK.
network ethtool
Sets and displays the speed, auto-negotiation, and duplexing settings for specified network interfaces. The
information can be used for diagnostic purposes.
Syntax
Here is an example that uses network ethtool to list the current network interface settings.
network ethtool
Usage
Settings defined by the latest call overwrite persistent settings. The updated settings are persistent. When
no interfaces are defined, eth2 and eth3 are used by default.
network floating_ips
Displays the nodes in the Rubrik cluster and lists their associated floating IP addresses.
Syntax
network floating_ips
The following example uses network floating_ips to list the nodes in the Rubrik cluster and their
floating IP addresses.
network hostname
Displays the hostname of the node that hosts the current session.
Syntax
network hostname
network hosts
Displays the contents of the /etc/hosts file for the node that hosts the current session.
Syntax
network hosts
network ifconfig
Displays the status and IP address configuration of interfaces active on the node or configures an interface
on the node that hosts the current session.
Syntax
network ifconfig
Usage
The command can display a single virtual or physical interface configuration and statistics.
Issue this command to view available arguments.
network ifconfig -h
network iperf
Measures network throughput between two nodes in the Rubrik cluster, or between a node and another
host on the network.
Syntax
Parameter Description
-h | help Prints the help message and exits.
-s limit Runs the command in server mode on a node.
-c Runs the command in client mode on a node.
-3 Run iperf3 instead of iperf2
Usage
Use the network iperf command to determine possible network component problems between two
points.
network iperf accepts arguments available to the system iperf command. Issue this command to
view available arguments:
network iperf -h
Syntax
Usage
Rubrik CDM only uses IPv6 addresses for backups, Live Mounts, and restores of vSphere virtual machine
snapshots. All communications between nodes in the Rubrik cluster continue to use IPv4 addresses.
network requires the IPv6 address in CIDR form for each node.
A null value removes the IPv6 address.
Before using this command, verify the node status at the Rubrik CDM web UI.
Syntax
Usage
This command returns a JSON object that lists the node names and associated IPv6 addresses.
Syntax
Parameter Description
-h Prints the help message and exits.
--floating_ip floating_ip Floating IP being moved.
--node_id node_id ID of node to which the floating IP is moving.
--cluster_id cluster_id Cluster ID from node table
Example:
Here is an example of using network move_floating_ip to move the floating IP 10.10.10.10 to node
B-1234-lb.
Related reference
cluster node_table
Displays the contents of the node table for each node in the Rubrik cluster.
cluster rubrik_tool
Performs calls to the Rubrik API from the command line.
network mtr
Combines the functions of traceroute and ping to list the network connections with a specified host.
Syntax
Parameter Description
-h Prints the help message and exits.
hostname Name of the host. network connection information
between node hosting the current session and the
host.
network mtr accepts arguments available to the system mtr command. Run network mtr -h to view
available arguments.
network nameservers
Displays the DNS name servers listed in the /etc/resolv.conf file for the node that hosts the current session.
Syntax
network nameservers
Usage
Use the Rubrik CDM web UI to change DNS servers used by the Rubrik cluster.
network netstat
Provides statistics and information for network troubleshooting.
Syntax
network netstat
Usage
The network netstat command displays active and open network connections for the node that hosts
the current session.
network netstat accepts arguments available to the system netstat command. Run network
iperf -h to view available arguments.
network nslookup
Displays the IP address for a hostname.
Syntax
Here is an example of using network nslookup to list the IP address of the current host.
Name: b-1229-lb.rubrik-lab.com
Address: 10.0.115.142
network nslookup performs DNS queries against DNS servers, or against a specified DNS server, used
by the Rubrik cluster.
network ntp_status
Displays the status of the NTP server and any peers used by the Rubrik cluster.
Syntax
Parameter Description
hostname Name of the NTP server.
Usage
network ntp_status calls the system ntpq -p command. The expected output shows two nodes in
contact with Network Time Protocol, and the remaining Rubrik cluster nodes getting peer updates from
those nodes. The output also includes the date and time.
network ping
Measures connectivity and latency from the node that hosts the current session to another host.
Syntax
network ping
Usage
network ping measures connectivity and latency by sending ICMP ECHO_REQUEST datagrams.
network ping accepts arguments available to the system ping command. Run network ping -h to
view available arguments:
Related reference
network mtr
Combines the functions of traceroute and ping to list the network connections with a specified host.
network re_ip
Changes the IP addresses assigned to the nodes of a bootstrapped Rubrik cluster.
Syntax
network re_ip
Usage
Syntax
network route
Usage
network route accepts arguments available to the system route command. Run network route -h
to view available arguments:
Related reference
network static_route add
Requests static route configuration information, then adds a new static route to the Rubrik cluster.
network static_route delete
Lists the Cassandra route configurations. Specify a route number to delete a route configuration.
network set_default_gateway
Sets the default gateway, moving the default gateway from the bond0 network interface to the bond1
network interface.
Syntax
network set_default_gateway
Usage
Run this command only at the request of Rubrik Support, and only when the status of every node is
OK
.
Related reference
cluster get_node_statuses
Retrieves the status of each node in the Rubrik cluster.
cluster node_table
Displays the contents of the node table for each node in the Rubrik cluster.
Syntax
Usage
All requested input is required and will be validated. The following table lists the required information.
Syntax
Usage
All requested input is required and will be validated. The following table lists the required information.
Usage
OK
.
Running this command from any node creates updated host files for all nodes in the cluster.
Related reference
cluster get_node_statuses
Retrieves the status of each node in the Rubrik cluster.
cluster node_table
Displays the contents of the node table for each node in the Rubrik cluster.
network tcp_sack
Enables or disables the selective ack or tcp_sack commands for each node in the Rubrik cluster and lists
the current tcp_sack settings.
Syntax
Usage
The changed settings apply clusterwide for all interfaces on the Rubrik cluster and modify and reload the /
etc/sysctl.d/net.conf file.
Use this command only when nodes are in a status of OK.
The setting persists after a reboot, except after an upgrade, when the setting for each node changes to
the default value of the new version. In this case, the value must be updated to retain the previously set
value.
Changing SACK settings can severely slow network performance.
Syntax
Usage
Input Description
VLAN ID ID of the VLAN
VLAN Subnet mask Subnet mask of the VLAN
IPv4 address range Address range or the individual IPv4 address of
each node
Run network vlan add once from a single cluster node for each VLAN interface to be added to the
cluster.
Use this command only when nodes are in a status of OK.
Review and accept the generated JSON configuration to add the VLAN information to the Rubrik cluster.
The following example uses network vlan add to add a VLAN interface with an ID of 3.
Related reference
cluster get_node_statuses
Retrieves the status of each node in the Rubrik cluster.
cluster node_table
Syntax
Syntax
Usage
If a VLAN ID is not included with the command, the Rubrik cluster prompts for one.
Use this command only when nodes are in a status of OK.
Related reference
cluster get_node_statuses
Retrieves the status of each node in the Rubrik cluster.
cluster node_table
Displays the contents of the node table for each node in the Rubrik cluster.
Use resource management commands to examine and modify computing resources in the Rubrik cluster.
Precede these commands with the submenu name 'resource', as in resource df. Tab completion is
available with these commands.
resource df
Lists information about the filesystems mounted on the node that hosts the current session.
Syntax
resource df
Usage
This command is a diagnostic tool used on the Rubrik cluster. The diagnostic information it lists applies
only to the capacity and mount points of the file systems mounted on the node that hosts the current
session.
Issue resource df for standard output. Issue resource df -h for improved readability.
resource df output can include:
• Number of 1 K blocks
• Space used
• Space available
• Percentage of space used
• Mount point
resource df accepts arguments available to the system df command. Run resource df -h to view
available arguments.
resource storage_statistics
Lists the total storage used on a Rubrik cluster and the storage used by snapshots and Live Mounts.
Syntax
resource storage_statistics
The following example uses resource storage_statistics to list storage on the Rubrik cluster.
resource storage_statistics
Total Storage: 22.5 TB
Available: 22.5 TB
Usage
Use this command to retrieve the current total storage used, storage used for snapshots, and storage used
for Live Mounts.
resource system_stats
Lists statistics for CPU activity, memory usage, and status of the nodes.
Syntax
Parameter Description
-all Displays information about the nodes in this Rubrik
cluster.
Usage
The storage information is derived from the resource df and cluster uptime commands for the
node from which the command was run.
The space represented is not related to snapshot storage usage.
resource top
Displays a dynamic, real-time view of the processes running on the node that hosts the current session.
Syntax
resource top
Usage
The processes include CPU, memory, and file usage of node resources.
Type q to quit top and return to the CLI prompt.
The command is used for diagnostic purposes.
Run this command only at the request of Rubrik Support.
resource top accepts arguments available to the system top command. Run resource top -h to
view available arguments:
resource top -h
User commands
User commands enable viewing and managing user account configurations through the Rubrik CLI.
Precede these commands with the submenu name 'users', as in users ldap. Tab completion is available
with these commands.
users ldap
Manages the Rubrik cluster LDAP integration.
Syntax
Parameter Description
show logs Lists available logs.
configuration list Lists the current settings for the configuration.
configuration get configuration Displays the value of the specified configuration.
configuration set configuration=value Changes the configuration to the provided value.
Changes take effect within an hour unless a service
restart is required.
Parameter Description
ldapsTlsProtocol Name of the encryption algorithm to use for secure
LDAP communication, either TLS or StartTLS.
Choosing a weaker algorithm may violate your
company's security requirements.
Usage
The logs can be searched for basic terms, similar to viewing a file using the less command.
Support management
support cluster_support_bundle
Generates a cluster-wide support bundle for Rubrik Support debugging purposes.
Syntax
Parameter Description
-h Prints the help message and exits.
logs Include all logs, including services, jobs, syslog,
accesslog, and so on.
stats Include information about the influxDB backups
during the last 24 hours and any influx debug
information.
metainfo Include cluster metadata and configuration
information. The config file contains the complete
list.
sysinfo Include all point in time system information.
full | everything Include all information in the output.
support decommission_status
Displays the status of the currently running decommission job.
Syntax
support decommission_status
Example:
support find_bad_disk
Locates a failed disk drive.
Syntax
Parameter Description
-h Prints the help message and exits.
-OFF Include all logs, including services, jobs, syslog,
accesslog.
Usage
Rubrik clusters running on virtual machines do not support the support find_bad_disk command.
support find_bad_disk runs a subset of disk-drive-specific commands displayed by cluster
hw_health, and works in conjunction with cluster ledctl to illuminate LED lights for failed disks.
Syntax
support iops
Usage
Running support iops is a resource-intense operation, creating a significant load on the system. Run
support iops only prior to bootstrapping, or on clusters that require attention. Do not run support
iops on a healthy cluster.
support local_support_bundle
Generates a support log bundle with logs from all of the nodes in the cluster. The logs are configured for
use by Rubrik Support.
Syntax
Parameter Description
-h Prints the help message and exits.
logs Include all logs, including services, jobs, syslogs,
and accesslogs.
stats Include information about the influxDB backups
during the last 24 hours and any influx debug
information.
Parameter Description
Destination disk Specifies the location to save the support bundle.
Indicate a local directory or a USB drive.
support log_view
View the log for Rubrik cluster services.
Syntax
Parameter Description
service_name Name of the service.
Example:
This example displays the log for the SDFS server created with a timestamp of 2020-10-11
07:31:59.186621.
>> support log_view
1: agent-server
2: backup-agent
3: cassandra
4: cdp-log-receiver
5: cdp-metadata-service
6: cloud-storage-service
7: cluster-config
8: cockroachdb
9: diamond
10: job-fetcher
11: key-wrapper
12: lambda
13: lambda-content-analyzer
14: lambda-parser-service
15: node-monitor
16: pyvmware
17: remote-cluster
18: replication
19: samba
20: sdfs
21: search
22: snapshot
23: spray-server
24: upgrade-service
25: vmware
26: firewall
27: kern
28: syslog
Usage
Run support log_view without a parameter for a list of currently supported services.
Syntax
support toggle_support_data
Enables and disables the movement of data like system statistics, errorlogs, traces, or uploads from the
Rubrik cluster.
Syntax
Parameter Description
-h | --help Prints the help message and exits.
--show Display the status of the specified data.
--opt_in Enable data upload for the specified data.
--opt_out Disable data upload for the specified data.
--systemstats Include live statistics.
--errorlogs Include error logs for services and jobs.
--traces Include traces for the services and jobs..
--uploads Include support bundle, report bundle, and
metadata uploads.
--all Manage configurations for all data types, --
systemstats, --errorlogs, --traces, and --uploads.
Usage
Syntax
Syntax
Syntax
This example reports that the support tunnel is closed due to inactivity
Example:
This example reports that the support tunnel is closed after a fixed interval of time.
Syntax
Example:
Syntax
Warning: Journal has been rotated since unit was started. Log output is
incomplete or unavailable.
Syntax
This example configures the support tunnel to timeout after a period of inactivity.
Syntax
This example configures the support tunnel to timeout after a period of inactivity.
Usage
Determine the inactivity timeouts with the support tunnel open command.
Related reference
support tunnel open
Open a support tunnel for the node.