/etc/vx/diag.d/vvrcheck - VVR configuration check utility
-t, --trend Trend mode -c, --healthcheck HealthCheck mode -o, --offline Offline mode --input_dir Input directory for statistics files --output_dir Output directory for the generated files -i, --trend --io Collects only I/O statistics -p, --trend --pools Collects only pool statistics -r, --trend --rlink Collects only RLINK statistics
The utility can be operated in the following modes:1. Snapshot mode1. Snapshot mode
2. Trend mode
3. HealthCheck mode
Snapshot mode gives an overall picture of the status of VVR replication. It also detects and reports anomalies in configuration and current replication status.
Snapshot mode lists:
1. Generated time stamp
2. All RVGs (in all diskgroups)
a. Data volumes
b. SRL
c. RLINKS
3. Tunables (system-wide)
Snapshot mode detects and reports:
a. If LUNs are shared between SRL and data volumes.
b. If the flags in RLINKs status are not among write enabled consistent asynchronous connected attached, it is reported.
To invoke Snapshot mode, enter ./vvrcheck
Snapshot mode has no options.
2. Trend mode
Trend mode processes the online statistics collected by vradmind and generates output files in formats easily used by display tools. For example, most office applications can use the .csv format. Gnuplot can use the .dat format.
The trend mode operates on the following statistics.
a. I/O statistics
I/O statistics are collected in the vxstat_testdg_d_rvg_* files. By default, the statistics are averaged for every 30 minutes and reported. The .csv files display the following fields:
Reads
Writes
Read Response
Write Response
b. RLINK statistics
The RLINK statistics are collected from the files' stats_dgname_nkllinkname_date. The .csv files display the following fields:
Acked Blocks
Sent Blocks
RTT
Timeout
c. Memory pool statistics
The memory pool statistics are collected from the files vxmemstat. The .csv files display the following fields:
In Use
Max Used
Max Size
For every type of statistic (I/O, RLINK, and memory pool), files are generated with .csv, .dat, and .png extensions.
If gnuplot is installed on the system, .dat and .png files are generated.
2.1 Invocation
To invoke Trend mode, enter ./vvrcheck --trend
The default values are:
Statistics Averaged Time (option -b or --break): 30 minutesMode of operation: Online
Input directory for statistics files: /etc/vx/vras/stats
Directory for statistics files
Offline: Current directory.Online: Creates a directory with a time stamp in the current directory.
2.2 Configuration and Options
2.2.1 Configuring via command line
Input directory for statistics files: --input_dirOutput directory for statistics files: --output_dir
Statistics Averaged Time: --break
Mode of operation for offline: --offline
Choosing the type of statistics trended
RLINK statistics: --rlinkPool statistics: --pool
I/O statistics: --io
2.2.2 Configuring via code
The constants are organized into the following files:
constants_trends.pm (all generic constants)You must manually change the Perl constant data structures.constants.pm (I/O statistics constants)
rlink_constants.pm (RLINK stastistics constants)
tunable_constants.rm (memory pool statistics constants)
2.2.2.1 Changing general constants
General constants are stored in the file constants_trends.pm.
To change the default path for statistics files in online mode:
set variable $path_online
To change the default path for statistics files in offline mode:
set variable $path_offline
To change the deafult output directory:
set variable $path_output_dir
2.2.2.2 Changing I/O constants
The I/O constants are stored in the structure %iotstat_csv.
my %iostat_csv = ( "display_fields" ==> ["Reads","Writes","read Response","Write Response"], "display_indices" => [0,1,4,5],#Index of record in online stats "display_units" => ["Operations/ms","Operations/ms","ms"], );2.3 Changing gnuplot behavior
display_fields Indices of the fields in online/offline statistics for I/O. For exameple, vxstat_dgname_rvgname_date. display_indices The name of the fields you want to specify in the .csv file. display_units The name of the units you want to display in the .csv file. 2.2.2.3 Changing offline constants (modify behavior in offline mode) The offline mode constants are stored in the structure %iostats_offline. my %iostats_offline = ( "fileprefix" => "io", "filepath" => "./", "searchpattern" => "vxstat", );fileprefix The name of the file generated on offline mode for I/O statistics. filepath The name of the default path for the statistics directory. searchpattern The pattern used to search for files. 2.3.1 Description
Trend mode also generates files in .dat format. If gnuplot is on the system, it uses these files.
a. I/O statistics
You can plot graphs for all the volumes in the configuration. You can plot against any field in the .csv file.
b. RLINK statistics
You can plot graphs for all the LINKS in the RVG. You can plot against any field in the .csv file.
c. Memory pool statistics
Memory pool statistics are collected for all the memory pools in the system. You can plot against any field in the .csv file.
2.3.2 Changing gnuplot behavior (modify default constants)
The constants for gnuplot behavior are stored in the structure %iostat_gnuplot.
my %iostat_gnuplot = ( "title" => "IO Stastistics", "xlabel" => "Time in Minutes", "ylabel" => "Response Time in milliseconds", "indices" => [5], "output_format" => "x11", "inputfile" => "output.dat", "outputfile" => "output.png", "ylabel_hash" => io_ylabels, );2.3.2.1 Changing fields in gnuplot graphs
indices reflects the index of the field in the .dat files. For example:
Notes:
2 Reads (1st field of CSV) 3 Writes (2nd field of CSV) 4 Read Response (3rd field of CSV) 5 Write Response (4th field of CSV) The indices value is off by 1; that is, it differs from the CSV index by 1.
A .dat file is a form of .csv file formatted without commas. gnuplot uses .dat files.
2.3.2.1 Changing Y-labels on the Y axis
The gnuplot x axis indicates time (in minutes).
You can change gnuplot Y labels in the following hash.
3. HealthCheck mode
HealthCheck mode performs the following checks:
a. Missing Daemons Check - Checks if the VVR daemons vradmin, heartbeat, and vxrsynd are present.
b. Valid License Check - Checks if the Flashsnap and VVR licenses are valid.
c. Network Check - Checks if the remote hosts of all the RLINKS can be reached.
VxVM 7.1 | vvrcheck(1M) |