Fujitsu ETERNUS DSP Series Instruction Manual

FUJITSU Storage
ETERNUS DSP series
CLI Reference Guide
P3AG-4252-01ENZ0

ETERNUS DSP CLI Reference Guide2
Table of Contents
1. CLI Overview .............................................................................4
Using the CLI ................................................................................................................................ 4
Accessing the CLI for the First Time .......................................................................................................................4
Accessing the CLI ................................................................................................................................................... 4
Configuring DSP Node Physical Interfaces .............................................................................................................5
Displaying DSP Node Physical Interfaces ...............................................................................................................6
Displaying CLI Help ...............................................................................................................................................6
Logging out of the CLI ........................................................................................................................................... 6
Command Syntax and Conventions ....................................................................................................................... 7
2. CLI Commands...........................................................................8
check_cluster_config .................................................................................................................... 8
cluster_logcollect ......................................................................................................................... 8
cluster_join .................................................................................................................................. 9
datera-net ................................................................................................................................... 9
dig ............................................................................................................................................. 10
disks .......................................................................................................................................... 12
ethtool ....................................................................................................................................... 12
inventory ................................................................................................................................... 16
iperf3 ......................................................................................................................................... 16
json ............................................................................................................................................ 17
logcollect ................................................................................................................................... 18
net ............................................................................................................................................. 18
ntpstat ....................................................................................................................................... 18
ntptime ...................................................................................................................................... 19
ping ........................................................................................................................................... 19
ps ............................................................................................................................................... 21
reboot ........................................................................................................................................ 22
services ...................................................................................................................................... 22
shell ........................................................................................................................................... 23
tcpdump .................................................................................................................................... 23

Table of Contents
ETERNUS DSP CLI Reference Guide3
traceroute .................................................................................................................................. 27

ETERNUS DSP CLI Reference Guide4
1. CLI Overview
The Command Line Interface (CLI) is used to manage nodes in the ETERNUS DSP. The CLI manages the local node
on which you are accessing the CLI and displays some global information about the other nodes in the ETERNUS
DSP System. The CLI is used to configure new nodes before they join a ETERNUS DSP System, set networking
parameters, reboot, and display information about the node. All storage provisioning operations are managed
through the GUI or the REST API.
Using the CLI
You can access the CLI with System Administrator user credentials. If you have not created users with the GUI or
REST API before logging in to the CLI, you must use the default username and password. Access the CLI through
an SSH connection or through a keyboard and monitor directly connected to the node. ETERNUS DSP provides
VGA, USB, and DB-9 serial ports for direct connectivity.
Accessing the CLI for the First Time
If you are accessing a new or recommended DSP node, you must log into the node with the default administrator
user credentials. You must configure at least one physical network interface before you can use a remote connec-
tion to manage the node.
To access the CLI on a new or recommended node:
1Connect a keyboard and monitor to the node.
2Enter the default username and password at the prompt. The default login name is admin, the
default login password is password. After a successful login, you should see the local prompt:
Local >>.
•To configure the network interfaces, see "Configuring DSP Node Physical Interfaces" (page 5).
•When you create a ETERNUS DSP system or add a DSP node to an existing ETERNUS DSP system, the login
name and password for the node are reset.
Accessing the CLI
You can access the CLI with a monitor and keyboard directly connected to the node, or through one of the net-
work interfaces. You must have System Administrator credentials to access the CLI. At least one physical network
interface must be configured before you can use a remote connection to manage the node.
If you are using a keyboard and monitor directly connected to a DSP node, ignore the instructions for connecting
through the network interfaces. You are prompted to login to the CLI when you connect a keyboard and monitor
to the node.
To log into the CLI:
1Open a terminal window and use SSH to connect to a node using one of the following IP
addresses:
•One of the Management Network VIP addresses.
•The IP address of one of the DSP node physical interfaces: ipmi, mgt1, mgt2, netA1, netA2,
netB1, or netB2.

1. CLI Overview
Using the CLI
ETERNUS DSP CLI Reference Guide5
2Enter a System Administrator username and password at the prompt. After a successful login,
you should see the local prompt: Local >>.
•If you are accessing the CLI on a new or recommended node, see "Accessing the CLI for the First Time" (page
4).
•To configure physical network interfaces so you can use a remote connection to manage the node, see "Con-
figuring DSP Node Physical Interfaces" (page 5).
Configuring DSP Node Physical Interfaces
Use the datera-net command to configure any of the DSP node physical network interfaces.
To configure a physical interface on the DSP node:
1Access the CLI.
2Enter the System Administrator username and password at the prompt. After a successful
login, you should see the local prompt: Local >>.
3To configure any of the DSP node physical interfaces, issue the datera-net interface
config command:
Options:
•addr - DHCP or the IP address and netmask in CIDR notation. For example, 192.168.1.1/24.
•gateway - IP address of the gateway.
•mtu - MTU number of the interface, the default is 0.
•vlan - VLAN ID number of the interface, if no VLAN the setting is 0.
4Verify the interface configuration and status by issuing the datera-net interface list
command. You can ping the interface from any reachable node on your network to verify con-
nectivity. To display the IP addresses of the physical interfaces, issue the datera-net inter-
face list --iface=all command.
•The minimum MTU is 1,500 and the maximum MTU is 9,198. We recommend 4,096 MTU for the Access and
Internal Network. Consult your switch vendor documentation to verify the MTU limits of your switches.
•When a node is operating in L3 mode, DHCP is not supported on the netA1, netA2, netB1, or netB2
interfaces. When a node is operating in L3 mode, DHCP is supported on the mgt1 and mgt2 interfaces.
datera-net interface config --iface=ipmi|mgt1|mgt2|netA1|netA2|netB1|netB2
[--addr=dhcp|address] [--gateway=gateway] [--mtu=mtu] [--vlan=vlan]

1. CLI Overview
Using the CLI
ETERNUS DSP CLI Reference Guide6
Displaying DSP Node Physical Interfaces
1To display the IP addresses of all physical interfaces on the DSP node, issue the following com-
mand:
2To display the IP address of a specific physical interface on the DSP node, issue the following
command:
Displaying CLI Help
1To display a list and short description of all CLI commands, issue the help command.
2To display the detailed Help for a specific CLI command, use the --help or -h command. For
example:
3Some commands include additional Help for specific subcommands. For example:
Logging out of the CLI
To log out of the CLI, enter the exit or the quit command:
The Ctrl-D command also exits the CLI.
datera-net interface list --iface=all
datera-net interface list --iface=ipmi|mgt1|mgt2|netA1|netA2|netB1|netB2
Local >> help
Local >> datera-net --help
Local >> datera-net interface -h
Local >> exit | quit

1. CLI Overview
Using the CLI
ETERNUS DSP CLI Reference Guide7
Command Syntax and Conventions
The CLI and CLI Reference Guide follow the syntax and style conventions described in this section.
•Commands use the following syntax:
•Most options with modifiers are entered in the -option value format. For example, -p port_name indi-
cates you need to enter the option -p and the value port_name.
•Some options with modifiers are entered in key-value pair (KVP) format, +keyword=[value] . For exam-
ple, +time=5.
•Strings are a non quoted set of characters. Do not use quotation marks around the string or the string will
include the quotation marks.
•The brackets, pipe symbols, ellipses and other indicators are used for documentation clarification and must be
excluded from the command.
•The characters KMG|kmg are used for options that support a K/M/G suffix to indicate kilo-, mega-, or giga-.
•The Ctrl+C command clears the current line and stops interactive commands but does not exit the CLI.
•The Ctrl+D command exits the CLI.
Table 1 CLI Conventions
command subcommand required_arguments [optional_arguments]
Convention Description
[ ] Square brackets indicate an optional argument.
Italics or < >
Information in italics or angle brackets indicates variables. For example: file names , IP
addresses , user names , and other values. Nonprinting characters, such as passwords, are also
displayed in angle brackets.
{ x | y | z } Lists in curly braces indicate alternative keyword groups. The items may be separated by verti-
cal bars or commas.
[ x , y , z ] Lists in square brackets indicate optional alternative keyword groups. The items may be sepa-
rated by vertical bars or commas.
|The vertical bar or pipe symbol indicates an exclusive list of options separated by vertical bars.
Use one of the options separated by vertical bars.
,Commas indicate an inclusive list separated by commas. Use any number of the options sepa-
rated by commas.
... An ellipse indicates input or output continues, but the sample input or output does not dis-
play all of the information.
^The caret symbol indicates the key labeled Control. For example, the key combination ^D in a
screen display means hold down the Control key while you press the D key.
Boldface Indicates commands and key words.
Courier The Courier font indicates terminal input and output. This includes file names, commands,
subcommands, options, parameters, IP addresses and other system values.

ETERNUS DSP CLI Reference Guide8
2. CLI Commands
check_cluster_config
■COMMAND NAME
check_cluster_config
■SYNOPSIS
■DESCRIPTION
Check the cluster configuration.
■OPTIONS
all All the tests, except the performance tests.
perf The performance tests (just iperf ).
interfaces Check the network interfaces.
bgp Check BGP health.
dns Verify dns server is reachable.
ntp Verify ntp server is reachable.
callhome Verify callhome server is reachable.
syslog Verify the syslog server is reachable.
mtu Use ping to test that the mtu is set correctly.
iperf Run a bandwidth test using iperf.
cluster_logcollect
■COMMAND NAME
cluster_logcollect
■SYNOPSIS
■DESCRIPTION
Collects logs on all nodes in the ETERNUS DSP System. If call home features are enabled, the logs are uploaded to
Insights support.
check_cluster_config [options]
cluster_logcollect

2. CLI Commands
cluster_join
ETERNUS DSP CLI Reference Guide9
cluster_join
■COMMAND NAME
cluster_join
■SYNOPSIS
■DESCRIPTION
Join a cluster.
datera-net
■COMMAND NAME
datera-net
■SYNOPSIS
■DESCRIPTION
Set, modify, and display the DSP node network configuration.
•interface Display and configure ETERNUS DSP network interfaces.
•l3 Display and configure L3 settings.
•system Display and configure system-wide host settings.
■OPTIONS
interface
•list List interface status and basic configuration.
•list --iface=all List detailed interface information including IP address.
•dump Dump interface status in JSON format.
•start --iface=[mgt1 | mgt2 | netA1 | netA2 | netB1 | netB2 | ipmi] Start interface.
•stop --iface=[mgt1 | mgt2 | netA1 | netA2 | netB1 | netB2 | ipmi] Stop interface.
•restart --iface=[mgt1 | mgt2 | netA1 | netA2 | netB1 | netB2 | ipmi] Restart interface.
•clear --iface=[mgt1 | mgt2 | netA1 | netA2 | netB1 | netB2 | ipmi] Clear interface.
•config --iface=[mgt1 | mgt2 | netA1 | netA2 | netB1 | netB2 | ipmi] Configuration for an interface.
---addr=dhcp | address DHCP or the IP address and netmask in CIDR notation. For example,
192.168.1.1/24.
---gateway=gateway IP address of the gateway.
cluster_join
datera-net interface|l3|system [options]

2. CLI Commands
dig
ETERNUS DSP CLI Reference Guide10
---mtu=mtu MTU number of the interface, the default is 0.
---vlan =vlan VLAN ID number of the interface, if no VLAN the setting is 0.
•l3 [list | status | health | debug | config | peer | dump | dump_status] Configuration for an interface.
-list List system L3 config.
-status Show peering status.
-health L3 health check.
-debug Show L3 debugging info.
-config Configure L3 system settings.
-peer Add or modify a BGP peer.
-dump Dump system L3 config in JSON format.
-dump_status Show peering status in JSON format.
•system [list | config | dump] Configuration for an interface.
-list List system config.
-config Configure DNS settings.
-dump Dump system config in JSON format.
•For more information about configuring the DSP node interfaces, see "Configuring DSP Node Physical Interfaces"
(page 5).
•When a node is operating in L3 mode, DHCP is not supported on the netA1, netA2, netB1, or netB2
interfaces. When a node is operating in L3 mode, DHCP is supported on the mgt1 and mgt2 interfaces.
dig
■COMMAND NAME
dig
■SYNOPSIS
■DESCRIPTION
DNS lookup utility. DIG (domain information groper) is a flexible tool for interrogating DNS name servers. It per-
forms DNS lookups and displays the answers that are returned from the name server(s) that were queried. Most
DNS administrators use dig to troubleshoot DNS problems because of its flexibility, ease of use and clarity of out-
put. Other lookup tools tend to have less functionality than dig. Although dig is normally used with command-
line arguments, it also has a batch mode of operation for reading lookup requests from a file.
A brief summary of its command-line arguments and options is printed when the -h option is given. Unlike earlier
versions, the BIND 9 implementation of dig allows multiple lookups to be issued from the command line. Unless
it is told to query a specific name server, dig will try each of the servers listed in /etc/resolv.conf. When no com-
mand line arguments or options are given, dig will perform an NS query for "." (the root). It is possible to set per-
user defaults for dig via ${HOME}/.digrc. This file is read and any options in it are applied before the command
line arguments. The IN and CH class names overlap with the IN and CH top level domains names.
dig [@global-server] [domain] [q-type] [q-class] {q-opt}
{global-d-opt} host [@local-server] {local-d-opt}
[ host [@local-server] {local-d-opt} [...]]

2. CLI Commands
dig
ETERNUS DSP CLI Reference Guide11
Either use the -t and -c options to specify the type and class, use the -q the specify the domain name, or use "IN."
and "CH." when looking up these top level domains.
Global d-opts and servers (before host name) affect all queries.
Local d-opts and servers (after host name) affect only that lookup.
■OPTIONS
server Tis the name or IP address of the name server to query. This can be an IPv4 address in dotted-decimal
notation or an IPv6 address in colon-delimited notation. When the supplied server argument is a hostname,
dig resolves that name before querying that name server. If no server argument is provided, dig consults /etc/
resolv.conf and queries the name servers listed there. The reply from the name server that responds is displayed.
domain The Domain Name System.
q-class One of (in,hs,ch,...) [default: in].
q-type One of (a,any,mx,ns,soa,hinfo,axfr,txt,...) [default:a] (Use ixfr=version for type ixfr) .
q-opt One of:
•-x dot-notation Shortcut for reverse lookups.
•-i Use IP6.INT for IPv6 reverse lookups.
•-f filename Batch mode.
•-b address[#port] Bind to source address/port.
•-p port Specify port number.
•-q name Specify query name.
•-t type Specify query type.
•-c class Specify query class.
•-k keyfile Specify tsig key file.
•-y [hmac:]name:key Specify named base64 tsig key.
•-4 Use IPv4 query transport only.
•-6 Use IPv6 query transport only.
•-m Enable memory usage debugging.
d-opt is of the form +keyword[=value], where keyword is:
•+[no]vc TCP mode.
•+[no]tcp TCP mode, alternate syntax.
•+time=### Set query timeout.
•+tries=### Set number of UDP attempts.
•+retry=### Set number of UDP retries.
•+domain=### Set default domainname.
•+bufsize=### Set EDNS0 Max UDP packet size.
•+ndots=### Set NDOTS value.
•+[no]edns[=###] Set NDOTS value.
•+[no]search Set whether to use searchlist.
•+[no]showsearch Search with intermediate results.
•+[no]defname Ditto.
•+[no]recurse Recursive mode.
•+[no]ignore Don't revert to TCP for TC responses.
•+[no]fail Don't try next server on SERVFAIL.
•+[no]besteffort Try to parse even illegal messages.
•+[no]aaonly Set AA flag in query (+[no]aaflag).
•+[no]adflag Set AD flag in query.
•+[no]cdflag Set CD flag in query.

2. CLI Commands
disks
ETERNUS DSP CLI Reference Guide12
•+[no]cl Control display of class in records.
•+[no]cmd Control display of command line.
•+[no]comments Control display of comment lines.
•+[no]rrcomments Control display of per-record comments.
•+[no]question Control display of question.
•+[no]answer Control display of answer.
•+[no]authority Control display of authority.
•+[no]additional Control display of additional.
•+[no]stats Control display of statistics.
•+[no]short Disable everything except short form of answer.
•+[no]ttlid Control display of ttls in records.
•+[no]all Set or clear all display flags.
•+[no]qr Print question before sending.
•+[no]nssearch Search all authoritative nameservers.
•+[no]identify ID responders in short answers.
•+[no]trace Trace delegation down from root [+dnssec].
•+[no]dnssec Request DNSSEC records.
•+[no]nsid Request Name Server ID.
•+[no]sigchase Chase DNSSEC signatures.
•+trusted-key=#### Trusted Key when chasing DNSSEC sigs.
•+[no]topdown Do DNSSEC validation top down mode.
•+[no]split=## Split hex/base64 fields into chunks.
•+[no]multiline Print records in an expanded format.
•+[no]onesoa AXFR prints only one soa record.
disks
■COMMAND NAME
disks
■SYNOPSIS
■DESCRIPTION
Display disk information for the node.
ethtool
■COMMAND NAME
ethtool
disks

2. CLI Commands
ethtool
ETERNUS DSP CLI Reference Guide13
■SYNOPSIS
■DESCRIPTION
Display standard information about a device.
■OPTIONS
DEVNAME Device name.
-s|--change Set or change generic options.
•[ speed %d ]
•[ duplex half|full ]
•[ port tp|aui|bnc|mii|fibre ]
•[ mdix auto|on|off ]
•[ autoneg on|off ]
•[ advertise %x ]
•[ phyad %d ]
•[ xcvr internal|external ]
•[ wol p|u|m|b|a|g|s|d... ]
•[ sopass %x:%x:%x:%x:%x:%x ]
•[ msglvl %d | msglvl type on|off ... ]
-a|--show-pause Show pause options.
-A|--show-pause Set pause options.
•[ autoneg on|off ]
•[ rx on|off ]
•[ tx on|off ]
-c|--show-coalesce Show coalesce options.
ethtool -C|--coalesce Set coalesce options.
•[adaptive-rx on|off]
•[adaptive-tx on|off]
•[rx-usecs N]
•[rx-frames N]
•[rx-usecs-irq N]
•[rx-frames-irq N]
•[tx-usecs N]
•[tx-frames N]
•[tx-usecs-irq N]
•[tx-frames-irq N]
•[stats-block-usecs N]
•[pkt-rate-low N]
•[rx-usecs-low N]
•[rx-frames-low N]
•[tx-usecs-low N]
•[tx-frames-low N]
•[pkt-rate-high N]
ethtool [options] <DEVNAME>

2. CLI Commands
ethtool
ETERNUS DSP CLI Reference Guide14
•[rx-usecs-high N]
•[rx-frames-high N]
•[tx-usecs-high N]
•[tx-frames-high N]
•[sample-interval N]
-g|--show-ring Query RX/TX ring parameters.
G|--set-ring Set RX/TX ring parameters.
•[ rx N ]
•[ rx-mini N ]
•[ rx-jumbo N ]
•[ tx N ]
-k|--show-features|--show-offload Get state of protocol offload and other features.
K|--features|--offload Set protocol offload and other features FEATURE on|off ... .
-i|--driver Show driver information.
-d|--register-dump Do a register dump.
•[ raw on|off ]
•[ file FILENAME ]
-e|--eeprom-dump Change bytes in device EEPROM.
•[ raw on|off ]
•[ offset N ]
•[ length N ]
-E|--change-eeprom Do a register dump.
•[ magic N ]
•[ offset N ]
•[ length N ]
•[ value N ]
-r|--negotiate Restart N-WAY negotiation.
-p|--identify Show visible port identification (e.g. blinking).
•[ TIME-IN-SECONDS ]
-t|--test Execute adapter self test.
•[ online | offline | external_lb ]
-S|--statistics Show adapter statistics.
-n|-u|--show-nfc|--show-ntuple Show Rx network flow classification options or rules.
•[ rx-flow-hash tcp4|udp4|ah4|esp4|sctp4|tcp6|udp6|ah6|esp6|sctp6 |rule %d ]
-N|-U|--config-nfc|--config-ntuple Configure Rx network flow classification options or rules.
•rx-flow-hash tcp4|udp4|ah4|esp4|sctp4|tcp6|udp6|ah6|esp6|sctp6 m|v|t|s|d|f|n|r... | flow-type
ether|ip4| tcp4|udp4|sctp4|ah4|esp4
•[ src %x:%x:%x:%x:%x:%x [m %x:%x:%x:%x:%x:%x] ]
•[ dst %x:%x:%x:%x:%x:%x [m %x:%x:%x:%x:%x:%x] ]
•[ proto %d [m %x] ]
•[ src-ip %d.%d.%d.%d [m %d.%d.%d.%d] ]
•[ dst-ip %d.%d.%d.%d [m %d.%d.%d.%d] ]

2. CLI Commands
ethtool
ETERNUS DSP CLI Reference Guide15
•[ tos %d [m %x] ]
•[ l4proto %d [m %x] ]
•[ src-port %d [m %x] ]
•[ dst-port %d [m %x] ]
•[ spi %d [m %x] ]
•[ vlan-etype %x [m %x] ]
•[ vlan %x [m %x]
•[ user-def %x [m %x] ]
•[ dst-mac %x:%x:%x:%x:%x:%x [m %x:%x:%x:%x:%x:%x] ]
•[ action %d ]
-T Show time stamping capabilities.
-x Show Rx flow hash indirection and/or hash key.
-X|--set-rxfh-indir|--rxfh
•[ equal N | weight W0 W1 ... ]
•[ hkey %x:%x:%x:%x:%x:]
-f Flash firmware image from the specified file to a region on the device.
-P Show permanent hardware address.
-w|--get-dump Get dump flag, data.
•[ data FILENAME ]
-W|--set-dump Set dump flag of the device.
-l|--show-channels Query Channels.
-L|--set-channels Set Channels.
•[ rx N ]
•[ tx N ]
•[ other N ]
•[ combined N ]
--show-priv-flags Query private flags.
--set-priv-flags on|off . . . . Set private flags.
-m|--dump-module-eeprom|--module-info
•[ raw on|off ]
•[ hex on|off ]
•[ offset N ]
•[ length N ]
--show-eee Show EEE settings.
--set-eee Set EEE settings.
•[ eee on|off ]
•[ advertise %x ]
•[ tx-lpi on|off ]
•[ tx-timer %d ]
--version Show version number.

2. CLI Commands
inventory
ETERNUS DSP CLI Reference Guide16
inventory
■COMMAND NAME
inventory
■SYNOPSIS
■DESCRIPTION
Display a JSON formatted inventory of the node.
iperf3
■COMMAND NAME
iperf3
■SYNOPSIS
■DESCRIPTION
Perform network throughput tests. It can test either TCP or UDP throughput. To perform an iperf3 test the user
must establish both a server and a client.
■OPTIONS
-s Run in server mode.
-c host Run in client mode, connecting to the host.
Server or Client
-p port Server port to listen on/connect to.
-f [kmKM] Format to report: Kbits, Mbits, KBytes, MBytes.
-i interval Seconds between periodic bandwidth reports.
-F file_name On the client-side: read from the file and write to the network, instead of using random data.
On the server-side: read from the network and write to the file, instead of throwing the data away.
-A affinity n/n,m Set CPU affinity.
-B bind host Allow pinging a broadcast address.
-V Verbose, more detailed output.
-j Output in JSON format.
-d Emit debugging output.
-v show version information and quit.
Server Specific
-D Run the server as a daemon.
-1 Handle one client connection then exit.
Client Specific
-u Use UDP rather than TCP.
inventory
iperf3 [-s|-c host] [options]

2. CLI Commands
json
ETERNUS DSP CLI Reference Guide17
-b bandwidth Bandwidth #[KMG][/#] target bandwidth in bits/sec: (0 for unlimited) (default 1 Mbit/sec for
UDP, unlimited for TCP) (optional slash and packet count for burst mode) .
-t time Time in seconds to transmit for (default 10 secs).
-n bytes #[KMG] number of bytes to transmit (instead of -t).
-k blockcount #[KMG] number of blocks (packets) to transmit (instead of -t or -n).
-l len #[KMG] length of buffer to read or write (default 128 KB for TCP, 8 KB for UDP) .
-P parallel Number of parallel client streams to run.
-R Run in reverse mode (server sends, client receives).
-w window #[KMG] set window size / socket buffer size.
-C linux-congestion algo
-M set-mss Set TCP maximum segment size (MTU - 40 bytes).
-N Set TCP no delay, disabling Nagle's Algorithm.
-4 Use IPv4.
-6 Use IPv6.
-S tos Set the IP 'type of service'.
-L flowlabel Set the IPv6 flow label (only supported on Linux).
-Z Use a 'zero copy' method of sending data.
-O n Omit the first n seconds.
-T title str Prefix every output line with this string.
-get-server-output Get results from server.
json
■COMMAND NAME
json
■SYNOPSIS
■DESCRIPTION
Enter ON to enable JSON mode, or OFF to disable JSON mode. When JSON mode is enabled, commands and sub-
commands that support JSON will display the information returned by the command in JSON format. JSON mode
only affects the output of the command, not the input format.
A single command can also be run in JSON mode by adding the --json flag. If a command does not support
JSON mode, the command will return an error.
The following commands or their subcommands support JSON:
•check_cluster_config Fully supported.
•inventory Fully supported.
•datera-net Supports list subcommands only.
•logcollect Fully supported.
•cluster_logcollect Fully supported.
json

2. CLI Commands
logcollect
ETERNUS DSP CLI Reference Guide18
logcollect
■COMMAND NAME
logcollect
■SYNOPSIS
■DESCRIPTION
Collects logs of all services on this node and provides a URL to the archive.
net
■COMMAND NAME
net
■SYNOPSIS
■DESCRIPTION
Display network information about the node.
ntpstat
■COMMAND NAME
ntpstat
■SYNOPSIS
■DESCRIPTION
Show network time synchronisation status. The ntpstat command will report the synchronisation state of the NTP
daemon running on the local machine. If the local system is found to be synchronised to a reference time source,
ntpstat will report the approximate time accuracy. The ntpstat command returns 0 if clock is synchronised. ntp-
stat returns 1 if clock is not synchro- nised. ntpstat returns 2 if clock state is indeterminant, for example if ntpd is
not contactable.
logcollect
net
ntpstat

2. CLI Commands
ntptime
ETERNUS DSP CLI Reference Guide19
ntptime
■COMMAND NAME
ntptime
■SYNOPSIS
■DESCRIPTION
Mange the Network Time Protocol (NTP) daemon.
■OPTIONS
-M Switch to microsecond mode.
-N Switch to nanosecond mode.
-T tai_offset set TAI offset.
-c Display the time taken to call ntp_gettime (us).
-e esterror Estimate of the error (us).
-f frequency Frequency error (-500 .. 500) (ppm).
-m maxerror Max possible error (us).
-o offset Current offset (ms).
-r Print the unix and NTP time raw.
-s status Set the status bits.
-t timeconstant log2 of PLL time constant (0 .. 6).
ping
■COMMAND NAME
ping
■SYNOPSIS
■DESCRIPTION
Send ICMP ECHO_REQUEST to network hosts. Ping uses the ICMP protocol's mandatory ECHO_REQUEST datagram
to elicit an ICMP ECHO_RESPONSE from a host or gateway. ECHO_REQUEST datagrams (''pings'') have an IP and
ICMP header, followed by a struct timeval and then an arbitrary number of ''pad'' bytes used to fill out the packet.
ntptime [options]
ping [-aAbBdDfhLnOqrRUvV] [-c count] [-i interval] [-I interface] [- m mark]
[-M pmtudisc_option] [-l preload] [-p pattern] [-Q tos] [-s packetsize] [-S
sndbuf] [-t ttl] [-T timestamp_option] [-w deadline] [-W timeout] [hop1 ...
destination]

2. CLI Commands
ping
ETERNUS DSP CLI Reference Guide20
■OPTIONS
-a Audible ping.
-A Adaptive ping. Interpacket interval adapts to round-trip time, so that effectively not more than one (or more,
if preload is set) unanswered probes present in the network. Minimal interval is 200msec for not super-user. On
networks with low rtt this mode is essentially equivalent to flood mode.
-b Allow pinging a broadcast address.
-B Do not allow ping to change source address of probes. The address is bound to one selected when ping starts.
-m mark Use mark to tag the packets going out. This is useful for variety of reasons within the kernel such as
using policy routing to select specific outbound processing.
-c count Stop after sending count ECHO_REQUEST packets. With deadline option, ping waits for count
ECHO_REPLY packets, until the timeout expires.
-d Set the SO_DEBUG option on the socket being used. Essentially, this socket option is not used by Linux kernel.
-F flow label Allocate and set 20 bit flow label on echo request packets. (Only ping6). If value is zero, kernel
allocates random flow label.
-f Flood ping. For every ECHO_REQUEST sent a period ``.'' is printed, while for ever ECHO_REPLY received a back-
space is printed. This provides a rapid display of how many packets are being dropped. If interval is not given, it
sets interval to zero and outputs packets as fast as they come back or one hundred times per second, whichever is
more. Only the super-user may use this option with zero interval.
-i interval Wait interval seconds between sending each packet. The default is to wait for one second
between each packet normally, or not to wait in flood mode. Only super-user may set interval to values less 0.2
seconds.
-I interface address Set source address to specified interface address. Argument may be numeric IP
address or name of device. When pinging IPv6 link-local address this option is required.
-l preload If preload is specified, ping sends that many packets not waiting for reply. Only the super-user may
select preload more than 3.
-L Suppress loopback of multicast packets. This flag only applies if the ping desti- nation is a multicast address.
-M hint Select Path MTU Discovery strategy. hint may be either do (prohibit fragmentation, even local one),
want (do PMTU discovery, fragment locally when packet size is large), or dont (do not set DF flag).
-N nioption Send ICMPv6 Node Information Queries (RFC4620), instead of Echo Request.
•name Queries for Node Names.
•ipv6 ies for IPv6 Addresses. There are several IPv6 specific flags.
-ipv6-global Request IPv6 global-scope addresses.
-ipv6-sitelocal Request IPv6 site-local addresses.
-ipv6-linklocal Request IPv6 link-local addresses.
-ipv6-all Request IPv6 addresses on other interfaces.
•ipv4 Queries for IPv4 Addresses. There is one IPv4 specific flag.
-ipv4-all Request IPv4 addresses on other interfaces.
•subject-ipv6=ipv6addr IPv6 subject address.
•subject-ipv4=ipv4addr IPv4 subject address.
•subject-name=nodename Subject name. If it contains more than one dot, fully-qualified domain name is
assumed.
•subject-fqdn=nodename Subject name. Fully-qualified domain name is always assumed.
-n Numeric output only. No attempt will be made to lookup symbolic names for host addresses.
-p pattern You may specify up to 16 ``pad'' bytes to fill out the packet you send. This is useful for diagnosing
data-dependent problems in a network. For example, -p ff will cause the sent packet to be filled with all ones.
-D Print timestamp (unix time + microseconds as in gettimeofday) before each line.
-Q tos Set Quality of Service -related bits in ICMP datagrams. tos can be either decimal or hex number. Tradition-
ally (RFC1349), these have been interpreted as: 0 for reserved (currently being redefined as congestion control),
1-4 for Type of Service and 5-7 for Precedence. Possible settings for Type of Service are: minimal cost: 0x02, reli-
ability: 0x04, throughput: 0x08, low delay: 0x10. Multiple TOS bits should not be set simultaneously. Possible set-
tings for special Precedence range from priority (0x20) to net control (0xe0). You must be root (CAP_NET_ADMIN
capa- bility) to use Critical or higher precedence value. You cannot set bit 0x01 (reserved) unless ECN has been