Scroll to navigation

ROZODIAG(8) User Manuals ROZODIAG(8)

NAME

rozodiag - RozoFS diagnostic tool

SYNOPSIS

rozodiag TARGET... [ OPTIONS ]

DESCRIPTION

rozodiag is the diagnostic interface to the RozoFS processes.

TARGET


Several diagnostic targets can be specified.

TARGET = [ -i <nodes> ] { -p <NPorts> | -T <LPorts> }


Each target names one or several node (-i) and their numeric (-p) or logical (-T) diagnostic ports.
<nodes> can be a hostname or an IP address or a range or a list of hostnames or IP addresses.
When the <nodes> is omitted in a TARGET, it takes the value of the previous TARGET.
When no previous target, local address 127.0.0.1 is used as <nodes>.
At least one -p or -T option must be set.

<nodes> = { <hosts> | <IP@> }
<hosts> = { <hostname> | <hostname>:<N>-<P> | <hostname>:<N>,..,<P> }
<IP@> = { <a>.<b>.<c>.<N> | <a>.<b>.<c>.:<N>-<P> | <a>.<b>.<c>.:<N>,..,<P> }


The numeric port is either one single numeric value or a list of numeric values or a range of numeric values.

<NPorts> = { <port> | <firstPort>,..,<lastPort> | <firstPort>-<lastPort> }


The logical port is a logical naming of the destination process diagnostic port.

<LPorts> = {
| export | export:0 (master exportd)
| export:<slave> (a slave exportd)
| export:<slave1>,..,<slaveN> (a list of slave exportd)
| export:<slave1>-<slaveN> (a range of slave exportd)
| storaged | storio:0 (a storaged)
| storio:<cid> (the storio of cluster <cid>)
| storio:<cid1>,...,<cidN> (storios of a list of cluster)
| storio:<cid1>-<cidN> (storios of a range of cluster)
| mount:<m> | mount:<m>:0 (a rozofsmount instance)
| mount:<m1>,..,<mN> (a list of rozofsmount instances)
| mount:<m1>-<mN> (a range of rozofsmount instances)
| mount:<m>:<s> (instance <s> of storcli of rozofsmount instance <m>)
| mount:<m>:<s1>,...<sN> (a list of instances of storcli of rozofsmount instance <m>)
| mount:<m>:<s1>-<sN> (a range of instances of storcli of rozofsmount instance <m>)
| rebalancer[:<instance>] (rebalancer)
}

OPTIONS

Print help.
cmdline is the optional diagnostic command line. Several -c options can be set in order to run several diagnostic commands in a run. When neither -c nor -f is set in the command, the rozodiag tools connects to the target in interactive mode.
cmdfile is a file containing a diagnostic command per file line that the rozodiag tool will run. When neither -c nor -f is set in the command, the rozodiag tools connects to the target in interactive mode.
seconds gives the periodicity in seconds to run the diagnostic commands given either through the -c or the -f option.

EXAMPLES

Interrogating procedure statistics of export slave 1 on node 192.168.2.1

rozodiag -i 192.168.2.21 -T export:1 -c profiler

Getting disk statuses from the storaged of 4 nodes

rozodiag -i 192.168.2.:21-24 -T storaged -c dstatus

Getting periodicaly storios throughput for the 6 clusters of one node

rozodiag -i 192.168.2.21 -T storio:1-6 -c throughput -period 30

Getting the uptime of rozofsmount instance 2 and its 4 STORCLIs on 2 nodes

rozodiag -i 192.168.2.:21,23 -T mount:2:0-4 -c uptime

REPORTING BUGS

Report bugs to <bugs@fizians.org>.

COPYRIGHT

Copyright (c) 2013 Fizians SAS. <http://www.fizians.com>

RozoFS is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2.

RozoFS is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.

AUTHOR

Fizians <http://www.fizians.org>

SEE ALSO

rozofs(7),

FEBRUARY 2015 RozoFS