Using Command Prompt to Manage Optimized Scan Services

The DcClient command is a command line tool used to administer Optimized Scan volumes on a UNIX client. This command allows you to do the following, among other tasks:

  • change the Optimized Scan additional setting values regarding volumes

  • administer the Optimized Scan database

  • stop and start individual volumes and stop and start all volumes simultaneously.

To use this tool, open the command prompt and navigate to the Optimized Scan installation directory.

For Example: /opt/Commvault/Base

The following table describes these options in detail.

Task

Command Line Usage

Get Information on Volumes States and Additional Setting Values

The following command displays information on the current state of the volumes and additional settings:

DcClient -getinfo

Start Monitoring a Volume

The following command starts monitoring an Optimized Scan volume:

DcClient -start mount path

The Optimized Scan services will start monitoring the volume unless the services are restarted or the corresponding stop command is run.

Stop Monitoring a Volume

The following command stops monitoring an Optimized Scan volume:

DcClient -stop mount path

The Optimized Scan services will stop monitoring the volume.

Defragment a Volume

The following command defragments (optimizes) an Optimized Scan database.

DcClient -defrag mount path

Defragmentation is especially helpful for reorganizing highly-active databases.

Relocate a Database Volume

The following command moves a database to another directory. In essence, the command relocates the database from the current path to the specified new path.

DcClient -relocate volume new path to the database

For better performance of Optimized Scan, it is recommended that the Optimized Scan database is located at a centralized location.

Add a Volume to be Monitored

The following command adds an Optimized Scan volume for monitoring.

DcClient -monitor mount path

You can add either existing volumes or new volumes for monitoring.

Remove a Volume from being Monitored

The following command removes an Optimized Scan volume from being monitored:

DcClient -donot-monitor mount path

Change Additional Setting Values

You can use the DcClient command with various additional setting values to set or implement the following:

  • Centralized Location of Optimized Scan Database

  • Refresh Time Interval for All Monitored Volumes

  • Volume Picking and Scanning

  • Volume Scan Priority

    Create a centralized directory for all Optimized Scan databases

    DcClient -edit DB_FOLDER path to a directory

    The Optimized Scan database is created on each volume. You can use the DB_FOLDER additional setting to create a centralized database directory to accommodate all these databases. The centralized database directory will be created for all the volumes, added into Optimized Scan monitoring, after you create the additional setting. For all the existing volumes in the Optimized Scan monitoring, relocate the database to a centralized location.

    For better performance of Optimized Scan, it is recommended that the Optimized Scan database is located at a centralized location.

    If you want Optimized Scan to create databases under the root of each volume, run the following command:

    DcClient -edit DB_FOLDER NULL

    Change the Refresh Time Interval for All Monitored Volumes

    DcClient -edit REFRESH_PERIOD time

    The REFRESH_PERIOD additional setting indicates the period of time after which the Optimized Scan services will refresh all the monitored volumes. If any changes occur on the monitored volumes, the Optimized Scan services will attempt an incremental scan of the data after the refresh period. You can use this additional setting to change the refresh interval. Depending on the time specified, if you add any new volumes, the services will "pick up" the volumes and start to monitor those volumes after the refresh period.

    Set the number of volumes that Optimized Scan will scan at once

    DcClient -edit THROTTLE number of volumes

    The default is 1.

    Set the Volume Scan Priority

    DcClient -edit PRIORITY priority number

    The value for the PRIORITY additional setting depends on the operating system-level scan priority.

×

Loading...