SnapProtect Backup - SnapTest Tool for Windows and UNIX File Systems

Table of Contents

Overview

The SnapTest tool is used to test basic snap engine operations and as a diagnostic tool to verify host and array connections. The SnapTest tool is capable of working with multiple mount points for each operation and supports interactive and command line modes.

Prerequisites

Ensure that the MediaAgent is installed on the computer that will be diagnosed by the SnapTest tool.

If no CommServe is installed, the SnapTool can still run in decoupled mode.

Usage

Use the SnapTest tool to:

  • derive the HBA/iSCSI, the vendor, product, and version details for an array
  • create, mount, unmount, delete, revert snapshots for an array
  • test proxy computers by mounting snapshots

If SnapProtect installation is decoupled, the SnapTest tool will be started in decoupled mode.

If SnapProtect is in normal mode, use the command line if you want to start the SnapTest in decoupled mode:

SnapTest -local

When multiple instances are installed on the system, the default instance will be selected. To select a specific instance, use the command:

SnapTest -vm <InstanceName> -local

If SnapProtect is in normal mode, use the command line if you want to start the SnapTest in normal mode:

SnapTest

When multiple instances are installed on the system, the default instance will be selected. To select a specific instance, use the command:

SnapTest -vm <InstanceName>

Adding an Array

If SnapProtect installation is in normal mode, you might add the array using the Snaptest commands below or add the array in the Array Management using SnapProtect console.

Add the array once, for each new array. Adding the array is mandatory in decoupled mode and you need to do it before any snap operation.

  1. In the Introductory dialog box, press Enter.
  2. In the Main Menu dialog box, type the number for FileSystem-MainMenu and press Enter.
  3. In the FileSystem-MainMenu dialog box, type the number Array Configuration and press Enter.
  4. In the Configure Arrays dialog box, press Enter to add a new array.
  5. In the Add Array dialog box, specify the number corresponding to the snap engine vendor to add and press Enter.
  6. Specify the following information for the detected array:
    • Array ID
    • Control host name/ip
    • User name
    • Password
    • Reenter password
    • Device group
    • Use only devices belonging to the above device group [y/n]

Testing Automatic Snap Operations on Mount Paths

To test the snap operations create, mount, unmount, delete, and revert snapshots for an array:

  1. In the Introductory dialog box, press Enter.
  2. In the Main Menu dialog box, type the number for FileSystem-MainMenu and press Enter.
  3. In the FileSystem-MainMenu dialog box, type the number for Automatic Snap Tests and press Enter. If you want to include the revert operation in the automatic test, press Y.
  4. Enter the source mount paths to snap and press Enter.
  5. If more than one snap engine is associated to the mount path, then choose the engine you would like to exercise and press Enter.

Performing Individual Snap Operations

To create, mount, unmount, delete, or revert snapshots for an array:

  1. In the Introductory dialog box, press Enter.
  2. In the Main Menu dialog box, type the number for FileSystem-MainMenu and press Enter.
  3. In the FileSystem-MainMenu dialog box, type the number for FileSystem-MainMenu and press Enter.
  4. In the FileSystem-MainMenu dialog box, press Enter to Perform individual Snap Operations.
  5. In the Snap Engine Test dialog box, specify the number corresponding to the snap engine and press Enter.
  6. Type the number corresponding to the snap operation and press Enter.

Detecting Snap Engine Type

To detect the type of engine in your environment:

  1. In the Introductory dialog box, press Enter.
  2. In the Main Menu dialog box, type the number FileSystem-MainMenu and press Enter.
  3. In the FileSystem-MainMenu dialog box, type the number for Advanced Operations and press Enter.
  4. In the Advanced Operations dialog box, type the number for Miscellaneous Tasks and press Enter.
  5. In the Miscellaneous Tasks dialog box, press Enter to Detect Snap Engine Type. This will prompt you to specify the source mount path.
  6. In the Snap Engine Detection, specify the source mount path or the device path and press Enter.

    The mount path should be specified as follows, <drive>:\\

    For example:

    f:\\

    The snap engine type configured for the mount or device path is displayed, press Enter to continue

Showing HBA or iSCSI Address

To derive the HBA or the iSCSI information for an array:

  1. In the Introductory dialog box, press Enter.
  2. In the Main Menu dialog box, type the number for FileSystem-MainMenu and press Enter.
  3. In the FileSystem-MainMenu dialog box, type the number for Advanced Operations and press Enter.
  4. In the Advanced Operations dialog box, type the number for Miscellaneous Tasks and press Enter.
  5. In the Miscellaneous Tasks dialog box, type the number and to Show HBA/iSCSI address and press Enter .
  6. In the List Adapters dialog box, press Y to List Adapters for an engine. This will prompt you to enter the name of the snap engine or press N to List all adapters.
The HBA or iSCSI information, including the WWPN number for the fibre card, is displayed. 

Sending SCSI Inquiry to Mount Point

To derive the vendor information for an array, by sending SCSI inquiry to the mount point:

  1. In the Introductory dialog box, press Enter.
  2. In the Main Menu dialog box, type the number for FileSystem-MainMenu and press Enter.
  3. In the FileSystem-MainMenu dialog box, type the number for Advanced Operations and press Enter.
  4. In the Advanced Operations dialog box, type the number for Miscellaneous Tasks and press Enter.
  5. In the Miscellaneous Tasks dialog box, type the number to Send SCSI inquiry to mount point and press Enter. This will prompt you to enter the name of the snap engine.
  6. In the Send SCSI Inquiry dialog box, type the drive letter of mount directory and press Enter.
The vendor information, source path, and the mount path details are displayed. 

Mounting Snapshot on Proxy

To create a snapshot on your source computer and mount it to a proxy computer:

  1. In the Introductory dialog box, press Enter.
  2. In the Main Menu dialog box, type the number for FileSystem-MainMenu and press Enter.
  3. In the FileSystem-MainMenu dialog box, type the number for Advanced Operations and press Enter.
  4. In the Advanced Operations dialog box, press Enter to Perform Individual Snap Operations.
  5. In the Snap Engine Test dialog box, specify the number corresponding to the snap engine and press Enter. This will prompt you to specify the Mount points to snap.
  6. In the SnapTest Create Snap,  specify the drive letter of mount directory and press Enter, for example:

    Enter all the mount points that you want to test separated by commas, if more than one.

    E:\

  7. In the SnapTest Create Snap dialog box, a message will appear to indicate the creation of the snapshot, press Enter to continue.
  8. Type 0 and press Enter until you exit the tool.
  9. Navigate to <installed_directory>\Base and copy the SnapTestSnapInfo.xml file to a temporary location on the proxy computer. 
  10. Connect to the proxy computer and do the following:
    • Rename the current SnapTestSnapInfo file to SnapTestSnapInfo_old.
    • Copy the new SnapTestSnapInfo.xml file to the <installed_directory>\Base folder.
    • Double-click SnapTest.exe to start the tool.
  11. In the Introductory dialog box, press Enter.
  12. In the Main Menu dialog box, type the number for FileSystem-MainMenu and press Enter.
  13. In the FileSystem-MainMenu dialog box, type the number for Advanced Operations and press Enter.
  14. In the Advanced Operations dialog box, press Enter to Perform individual Snap Operations.
  15. In the Snap Engine Test dialog box, specify the number corresponding to the snap engine and press Enter.
  16. In the Snap Engine Test dialog box, type the number to Mount Snap and press Enter.
  17. Type the number corresponding to the snapshot you want to mount and press Enter. This will prompt you to type the Snap numbers to mount.

    Type the numbers separated by commas, if more than one, and press Enter.

  18. The snapshot is successfully mounted on the proxy computer.
  19. To remove the snapshot after perform the test:
    • Type 0 and press Enter until you exit the tool.
    • Navigate to <installed_directory>\Base and remove the SnapTestSnapInfo.xml file you copied.
    • Rename the SnapTestSnapInfo_old file to SnapTestSnapInfo.