Resource Pack - Overview

Table of Contents

Overview

The Resource Pack is a collection of stand-alone utilities that can be used to help resolve environment specific issues. Each utility is accompanied with a Readme file that contains information on the utility's purpose and its usage and if there are any minimum system requirements. Utilities are used to make modifications within a specified CommCell. They can also be used for advanced troubleshooting.

Do not use any utility contained in the Resource Pack without contacting your Software Provider or the Customer Support Hotline. The utilities distributed in the Resource Pack may make modifications to the installed CommCell. A utility should not be run without a full understanding of how to use it and what issue it may address. Many utilities make registry and CommServe Database changes, which will have an immediate impact on the installed CommCell.

The Resource Pack can be installed from the installation package that was created using the Download Manager. All tools are installed in the Base folder under the installation directory. See Download Manager - Getting Started for instructions on creating an installation package.

Disclaimer of Warranties:

Commvault Systems, Inc. provides software tools and utilities on an "as is" basis, as a courtesy and convenience to its users, and they may be changed from time to time without notice. These tools and utilities are provided without express, implied, or statutory warranties of any kind. You assume full risk and responsibility for the selection, possession, performance and proper installation and use of the software tools and utilities, and for verifying the results obtained therefrom. Your use of Commvault Systems, Inc. software tools and utilities indicates your unconditional acceptance of the above disclaimer.

Windows Resource Pack

The following table provides a list of tools and utilities, along with a brief description and support information. For more details on how to use the tool/utility, click on the respective utility to view the readme that is provided with the tool/utility.

Utility/Tool Name Description
CleanSPDA.exe This tool cleans up two columns (that is, Archived and CommVault Stub) that are created in Document and Picture Libraries during archive operations using SharePoint Archiver.

When SharePoint Archiver is uninstalled, these columns are not removed automatically. Use the CleanSPDA tool to remove these columns.

CreateCSSQLAccount.exe This tool creates a SQL account for connection to the CommServe database. The tool can also set the account user name and password in the registry so that the system can start using it.
CreatePostPack.exe This utility allows you to create a Post Pack from a list of updates.

First, collect all required updates in a folder. This tool then accepts the location of the folder and the OS. It generates the Post Pack in the specified destination folder and copies InstallUpdates.exe from the most recent update.

CVDiskPerf.exe This tool is used to test the performance of the read and write operations on a disk of a file system volume. When you run this tool, you can specify the following settings:
  • Read and write modes such as sequential or random access.
  • Parameters such as block size for a file system, block count, file count, or thread count.
CVGACUtil.exe This utility is used to register the DM2FastWebquery.dll when you uninstall one of the CommServes from any of the nodes in a cluster. Make sure that you register the DM2FastWebquery.dll only on the node where the CommServe was uninstalled.

For more information, see Uninstalling CommServe on Cluster Nodes.

CVIPInfo.exe This is a diagnostic tool used to obtain information about the IP configuration in a computer. It can be used to verify the configuration of multiple network cards used by the software.
CvServicesCheck.exe This utility checks services for responsiveness by sending a request to the service and waiting an hour for a response. If a response is not received, the utility restarts the service.
CvSpf.exe This utility can be used to display the system protected files in Windows.
DiskReadWrite.exe This utility can be used to validate backup speeds by measuring the following:
  • Performance of hard disk reads.
  • Measure the network read and write performance.
DRListMedia.exe This utility generates a report with media required for restore for the cycle located at that date/time for all the storage policy copies in the input file.
DumpGalaxyRegistry.exe This utility displays the following registry tree in the console:

HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems

EnableDisableComputers.exe This utility can be used to disable or enable the following:
  • Data Protection and Recovery operation for the given clients.
  • Disable or enable the given MediaAgents in a CommCell.
ExMBDMPredictor.exe This utility can be used to predict the amount of data that will be archived from an Exchange Server based on the specified archiving rules.
ExToolDialog.exe This tool queries information from the Exchange Server and is useful in diagnosing Exchange environment to isolate issues.

The settings in Exchange Server are not changed and all actions performed by the tool are logged in c:\extool.log.

FindMailbox.exe This utility outputs Exchange Server, BackupSet, subclient and the browse time to use for the cycle based on the input mailbox.
GXHSMPredictor.exe This tool is deprecated. The GXHSMPredictor tool has been deprecated in this release. You must use the System Discovery and Archive Analyzer for File Systems.

For more information, see System Discovery and Archive Analyzer for File Systems.

GxSCMCmd.exe This utility checks the running status of Windows Services. This is needed during configuration of HP Scalable NAS/PolyServe Clusters.
Instsvc.exe This utility can be used to uninstall, start, and stop windows services on a local computer.
LNDMPredictorTool.exe This utility can be used to predict the amount of data that will be archived from an IBM Domino based on the specified archiving rules.
MarkActiveMediaFull.exe The tool will mark all active media full for the given Storage Policy and all streams of the Storage Policy copy.
MoveAfterReboot.exe This utility can be used to mark files to move/delete after the next reboot.
PendingRenameKey.exe This utility displays the list of files which are marked for Deletion/Rename after reboot based on the existence of the following registry key:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\PendingFileRenameOperations

Predict.exe This utility can be used to track the size of the data that has been added or modified on a specified volume.
QProfile.exe This tool can be used to show the drive utilization or attempts failures per the given interval.
ScrubLogFiles.exe This utility is intended to replace words in the log files with custom-defined words. The words to be replaced and their substitutes are defined in a simple text file called a dictionary file. The utility takes this dictionary file as input along with the input file specification and the output folder in which it is to place the modified files. For each file in the input file specification, it replaces the words defined in the dictionary file.
SetAllDrives.exe This utility can be used to disable or enable all the drives for the MediaAgent.
SetCopyFlags.exe This utility provides the ability to set copy flags [copy to same library] at storage policy copy level.
SetLibraryAttributes.exe This utility provides an interface to the user to set or unset library attributes without any communication with the CommServe subsystem.
SetMediaLocation.exe This utility provides the ability to set the location and container for a given media.
SetRetentionTime.exe Provides a command line method to adjust the basic retention rules for one or more or all storage policy copies.
SetSpareMediaErasable.exe The tool will set all spare media erasable for the given scratch pool of the given library.
ShadowExplorer.exe This tool helps with the management and testing of VSS writers, hardware providers, and volumes created by VSS and VDS shadow copy.

(Applicable for Windows 32-bit computers).

ShowEnv.exe This tool displays the environment variables for the current user.
showMediaErrors.exe This tool displays all media with number of software and hardware errors on them. Useful to identify bad tapes.
showMountSince.exe This tool displays the mount history since a given day for all or specified drive/media/library/MediaAgent.
TapeTool.exe This tool is used to troubleshoot the media in the library and run performance testing on the mounted media.
TestPort.exe This utility is a server-client TCP/IP utility to perform TCP/IP connectivity tests and to measure line throughput.
TestSendMail.exe This utility is used to test the mail connection as used by the CommServe to send an alert mail. By default, the mail server and sender used are retrieved from the CommServe database.

UNIX Resource Pack

The following table provides a list of tools and utilities, along with a brief description and support information. For more details on how to use the tool/utility, click on the respective utility to view the readme that is provided with the tool/utility. Use CVGxRP as the package to install them.

Utility/Tool Name Description
CVIPInfo.exe This is a diagnostic tool used to obtain information about the IP configuration in a computer. It can be used to verify the configuration of multiple network cards used by the software.
DiskReadWrite.exe This utility can be used to validate backup speeds by measuring the following:
  • Performance of hard disk reads.
  • Measure the network read and write performance.
drivedumptool.exe This utility is designed to be called directly from Simpana services when a tape drive dump is to be created. Although designed to be called from Simpana, this tool may be invoked directly to obtain a drive dump on user discretion.
dumpGalaxyRegistry.exe This utility displays the following registry tree in the console:

HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems

GXHSMPredict.exe This utility allows you to enter migration parameters for a specified volume or folder to predict how many files would be migrated, and their combined total size.
GxInstallMove.exe By moving the Simpana configuration information (e.g., registry, software install folder, services, etc.) to a selected destination, this utility provides the ability to switch between two or more CommServe computers.
TestPort.exe This utility is a server-client TCP/IP utility to perform TCP/IP connectivity tests and to measure line throughput.

UNIX Predictor for Continuous Data Replicator (CDR)

For more details on how to use the tool/utility, click on the utility below to view the readme that is provided with the tool/utility. Use CVGxCDRP as the package to install it.

Utility/Tool Name Description
cdrp.exe This utility can be used to track the size of the data that has been added or modified on a specified volume.