Generating Disk Performance Statistics for HyperScale X Nodes

Disk performance statistics for Commvault HyperScale X nodes in a storage pool can be obtained using the cv_disk_perf.py script.

The tool performs I/O operations directly on physical disks by using mount points designated for data and metadata on the storage nodes. The script uses either 10GB or 40% of the available free disk space, whichever is lower.

If the free space available on a disk is less than 5% of the total physical disk size, the tool does not run on that disk. The tool performs random read and write I/O operations.

The script must be executed from one of the nodes in the storage pool. It automatically identifies the other nodes in the storage pool and runs the tool on all applicable nodes and disks simultaneously.

Before You Begin

To obtain accurate results, run the disk performance tool when there are no backup jobs running against the storage pool.

Procedure

  1. Log on to any one of the nodes in the storage pool and navigate to the following directory:

    # cd /opt/commvault/MediaAgent
    
  2. Run the following command:

    python3 cv_disk_perf.py option

    <option> can be one of the following:

    • CVDiskPerf

      Runs the command using the Commvault disk performance tool.

      Example:

      python3 cv_disk_perf.py CVDiskPerf
      
    • fio

      Runs the tool using the Linux native fio command.

      Example:

      python3 cv_disk_perf.py fio
      

    Caution

    Do not run the CVDiskPerf or fio commands independently on the nodes while the script is running.

Result

Note

The run time may vary from a few minutes to several hours, depending on the write size, workload, and available resources on the nodes.

  • Log location

    The output is logged in the following directory:

    /var/log/commvault/Log_Files/CVFSPerfMon/

  • Log file format

    The output is saved using the following naming format:

    disk_performance_<timestamp>.log

    For example:

    /var/log/commvault/Log_Files/CVFSPerfMon/disk_performance_20221007081957.log

  • Summary information

    The SUMMARY section of the log provides a brief overview of throughput for each disk. The remainder of the log includes detailed run parameters and debug traces.

×

Loading...