test veritas logo


vvrcheck(1M)

NAME

/etc/vx/diag.d/vvrcheck - VVR configuration check utility

SYNOPSIS

-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

DESCRIPTION

The utility can be operated in the following modes:

1. Snapshot mode

2. Trend mode

3. HealthCheck mode

1. Snapshot 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 RLINK’s 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 minutes

Mode 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_dir

Output directory for statistics files: --output_dir

Statistics Averaged Time: --break

Mode of operation for offline: --offline

Choosing the type of statistics trended

RLINK statistics: --rlink

Pool 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)

constants.pm (I/O statistics constants)

rlink_constants.pm (RLINK stastistics constants)

tunable_constants.rm (memory pool statistics constants)

You must manually change the Perl constant data structures.

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"],
);

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 Changing gnuplot behavior

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:
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)
Notes:

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.3.1 vvrcheck(1M)