SnapProtect Backup - Snaptest Tool

Table of Content

Overview

Usage

Setup Array Configuration

Exercise Vendor Snap Engine

Detect Snap Engine Type

Show HBA/iSCSI Address

Send SCSI inquiry to mount point

Mount Snapshot on Proxy

Overview

The SnapTest tool is used to test the basic snap engine operations like creating, deleting, mounting snapshots etc. It can also be used as a diagnostic tool to verify the host and array connections. The SnapTest tool is capable of working with multiple mount points for each operation and supports an interactive and command line mode.

Usage

You can use the SnapTest tool to derive the HBA/iSCSI, the vendor, product, and version details for an array. You can also use the Snaptest tool to:

SeTup Array Configuration

Follow the steps given below to setup array information:

1. Navigate to <installed_directory>\Base and double-click SnapTest.exe.  
2. Press Enter. This tool helps to perform operations such as...

-> Automatic Snap Tests

-> Individual Snap Tests

-> Hardware Snapshot Engine Detection

-> SCSI Inquiry

-> Scan HBA/IQN Adapters

NOTE: Please make sure that the mount points used for this test are not being used by any other application. If they are in use, it may cause data corruption or data loss. Please refer to our online documentation for list of supported Operating systems, Hardware Snapshot engines and File systems.

Press <ENTER> to continue...

3. Type 2 press Enter. SnapTest Version      Main Menu

--------------------------------------

Perform automatic snap tests or launch Advanced Operations such as Array Configuration, Snapshot Engine Detection etc. Automatic snap tests take one or more source mounts to snap and performs series of Snap related operations on them. In order to perform these snap opertions, array configuration such as array id, control host and user credentials is required. If no array configuration is found, Automatic Snaptests takes you to Array Configuration screen.

1. Automatic Snap Tests

2. Advanced Operations

0. Exit

Choose your option [1]:

4. Type 2 and press Enter. SnapTest Version      Advanced Operations

----------------------------------------------

From this screen you can launch Array Configuration screen or Miscellaneous
tasks screen.

1. Perform Individual Snap Operations

2. Array Configuration

3. Miscellaneous Tasks

0. Exit

Choose your option [1]:

5. Press Enter to add a new array. SnapTest Version      Configure Arrays

------------------------------------------------------------------------------

All snap operations require array information such as Array ID, User Name and Password etc... Without this information, Snap operations will fail. Configuration changes performed in this screen can be saved to disk so that it is available when the tool is restarted. Password will be encrypted before writiing to disk.

1. Add New Array

2. Delete Array

3. Show Existing Arrays

4. Save configuration (If not saved, changes will be lost.)

0. Exit

Choose your option [1]:

6. Specify the number corresponding to the snap engine vendor that you wish to add and press Enter. SnapTest Version      Add Array

------------------------------------------------------------------------------

Choose the vendor of your array

1. CommVault

2. Dell Equallogic

3. EMC CLARiiON

4. EMC Celerra

5. EMC Symmetrix

6. HDS

7. HP EVA

8. IBM XIV

9. LSI

10. Native

11. NetApp

0. Exit

Enter Vendor Number [1]:

7. 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]
SnapTest             Add  Array

-----------------------------------

Vendor : XXX

Enter array ID :

Enter control host name/ip :

Enter user name :

Enter password :

Enter password again :

Enter device group :

Exercise vendor snap engine

Use the following steps to create, mount, unmount, delete, revert snapshots for an array.

1. Navigate to <installed_directory>\Base and double-click SnapTest.exe.  
2. Press Enter. This tool helps to perform operations such as...

-> Automatic Snap Tests

-> Individual Snap Tests

-> Hardware Snapshot Engine Detection

-> SCSI Inquiry

-> Scan HBA/IQN Adapters

NOTE: Please make sure that the mount points used for this test are not being used by any other application. If they are in use, it may cause data corruption or data loss. Please refer to our online documentation for list of supported Operating systems, Hardware Snapshot engines and File systems.

Press <ENTER> to continue...

3. Type 2 and press Enter. SnapTest Version      Main Menu

--------------------------------------

Perform automatic snap tests or launch Advanced Operations such as Array Configuration, Snapshot Engine Detection etc. Automatic snap tests take one or more source mounts to snap and performs series of Snap related operations on them. In order to perform these snap opertions, array configuration such as array id, control host and user credentials is required. If no array configuration is found, Automatic Snaptests takes you to Array Configuration screen.

1. Automatic Snap Tests

2. Advanced Operations

0. Exit

Choose your option [1]:2

4. Press Enter. SnapTest Version      Advanced Operations

----------------------------------------------

From this screen you can launch Array Configuration screen or Miscellaneous
tasks screen.

1. Perform Individual Snap Operations

2. Array Configuration

3. Miscellaneous Tasks

0. Exit

Choose your option [1]:

5. Specify the number corresponding to the snap engine that you wish to select and press Enter. SnapTest Version      Snap Engine Test

------------------------------------------------------------------------------

Choose the snap engine you would like to exercise. All the snap tests will use this engine till you choose a different one. If you do not know what engine to choose, choose 'Detect Engine' to find out what engine to choose.

1. Native

2. HDS Shadow Image

3. NetApp

4. EMC TimeFinder BCV

5. EMC TimeFinder Snap

6. EMC CLARiiON Snapview Snap

7. EMC CLARiiON Snapview Clone

8. HDS Copy on Write Snapshot

9. Dell Equallogic Snap

10. Data Replicator

11. Data Replicator

12. HP EVA Snapshot

13. HP EVA Clone

14. IBM XIV SNAP

15. Data Replicator

16. LSI Snapshot

17. LSI Volume Copy

18. Dell Equallogic Clone

19. EMC Celerra

20. IBMSVC Space-efficient FlashCopy

21. IBMSVC FlashCopy

22. 3PAR SNAP

23. 3PAR CLONE

24. LSI IBM Snap

25. LSI IBM Clone

26. LSI Dell Snap

27. LSI Dell Clone

28. LSI SGI Snap

29. LSI SGI Clone

30. LSI Sun Snap

31. LSI Sun Clone

32. Detect Engine

0. Exit

Enter Engine Number [32]:

6. Specify the operation that you wish to perform. For e.g., specify 1 if you wish to create a snapshot and press Enter. SnapTest Version      Snap Engine Test

-------------------------------------------

From this screen, you can launch individual snap operations to exercise the snap engine selected in the previous screen. Exit from this screen to choose a different engine.

1. Create Snap

2. Delete Snap

3. Mount Snap

4. Unmount Snap

5. Revert to Snap

6. Save Snaps List

7. Load Snaps List

0. Exit

Choose your option [1]:

Detect Snap Engine Type

Use the following procedure to detect the type of storage array in your environment:

1. Navigate to <installed_directory>\Base and double-click SnapTest.exe.  
2. Press Enter. This tool helps to perform operations such as...

-> Automatic Snap Tests

-> Individual Snap Tests

-> Hardware Snapshot Engine Detection

-> SCSI Inquiry

-> Scan HBA/IQN Adapters

NOTE: Please make sure that the mount points used for this test are not being used by any other application. If they are in use, it may cause data corruption or data loss. Please refer to our online documentation for list of supported Operating systems, Hardware Snapshot engines and File systems.

Press <ENTER> to continue...

3. Type 2 and press Enter. SnapTest Version      Main Menu

--------------------------------------

Perform automatic snap tests or launch Advanced Operations such as Array Configuration, Snapshot Engine Detection etc. Automatic snap tests take one or more source mounts to snap and performs series of Snap related operations on them. In order to perform these snap opertions, array configuration such as array id, control host and user credentials is required. If no array configuration is found, Automatic Snaptests takes you to Array Configuration screen.

1. Automatic Snap Tests

2. Advanced Operations

0. Exit

Choose your option [1]:2

4. Type 3 and press Enter. SnapTest Version      Advanced Operations

----------------------------------------------

From this screen you can launch Array Configuration screen or Miscellaneous
tasks screen.

1. Perform Individual Snap Operations

2. Array Configuration

3. Miscellaneous Tasks

0. Exit

Choose your option [1]:

5. Press Enter. SnapTest Version      Miscellaneous Tasks

----------------------------------------------

From this screen you can launch various miscellaneous tasks that you might need to do while setting up snap feature. For example, you might need to find out HBA adapter address. Or you might need to scan for new devices upon zoning your client with your array. Such tasks can be performed from here.

1. Detect Snap Engine Type

2. Show HBA/iSCSI address

3. Send SCSI inquiry to mount point

4. Rescan Adapters

5. Delete Devices

0. Exit

Choose your option [1]:

6. Specify the source mount path or the device path and press Enter.

The mount path should be specified as <drive>:\\. For example, f:\\.

SnapTest Version      Snap Engine Detection

--------------------------------------------------------------------------

Enter source mount path or device path :

7. The snap engine type configured for the mount or device path is displayed. SnapTest Version      Snap Engine Detection

----------------------------------------------------

Mount Path : f:\\

Underlying Devices : \\.\PhysicalDrive1

Snap Engine for \\.\PhysicalDrive1 : HP EVA Snapshot

Press <ENTER> to continue...

Show HBA/iSCSI Address

Follow the steps gives below to derive the HBA/iSCSI information for an array:

1. Navigate to <installed_directory>\Base and double-click SnapTest.exe.  
2. Press Enter. This tool helps to perform operations such as...

-> Automatic Snap Tests

-> Individual Snap Tests

-> Hardware Snapshot Engine Detection

-> SCSI Inquiry

-> Scan HBA/IQN Adapters

NOTE: Please make sure that the mount points used for this test are not being used by any other application. If they are in use, it may cause data corruption or data loss. Please refer to our online documentation for list of supported Operating systems, Hardware Snapshot engines and File systems.

Press <ENTER> to continue...

3. Type 2 and press Enter. SnapTest Version      Main Menu

--------------------------------------

Perform automatic snap tests or launch Advanced Operations such as Array Configuration, Snapshot Engine Detection etc. Automatic snap tests take one or more source mounts to snap and performs series of Snap related operations on them. In order to perform these snap opertions, array configuration such as array id, control host and user credentials is required. If no array configuration is found, Automatic Snaptests takes you to Array Configuration screen.

1. Automatic Snap Tests

2. Advanced Operations

0. Exit

Choose your option [1]:2

4. Type 3 and press Enter. SnapTest Version      Advanced Operations

----------------------------------------------

From this screen you can launch Array Configuration screen or Miscellaneous
tasks screen.

1. Perform Individual Snap Operations

2. Array Configuration

3. Miscellaneous Tasks

0. Exit

Choose your option [1]:

5. Type 2 and press Enter. SnapTest Version      Miscellaneous Tasks

----------------------------------------------

From this screen you can launch various miscellaneous tasks that you might need to do while setting up snap feature. For example, you might need to find out HBA adapter address. Or you might need to scan for new devices upon zoning your client with your array. Such tasks can be performed from here.

1. Detect Snap Engine Type

2. Show HBA/iSCSI address

3. Send SCSI inquiry to mount point

4. Rescan Adapters

5. Delete Devices

0. Exit

Choose your option [1]:

6. Press Enter to list adapters for a specific array. SnapTest Version      List Adapters

----------------------------------------------

Do you need adapters specific to an Array? [Y/N]

[Y] :

7. Enter the name of the snap engine. SnapTest Version      List Adapters

----------------------------------------------

Do you need adapters specific to an Array? [Y/N]

[Y] : y

Enter Array name :

8. The HBA/iSCSI information including the WWPN number for the fiber card is displayed.  

Send SCSI inquiry to mount point

Follow the steps given below to derive the vendor information for an array:

1. Navigate to <installed_directory>\Base and double-click SnapTest.exe.  
2. Press Enter. This tool helps to perform operations such as...

-> Automatic Snap Tests

-> Individual Snap Tests

-> Hardware Snapshot Engine Detection

-> SCSI Inquiry

-> Scan HBA/IQN Adapters

NOTE: Please make sure that the mount points used for this test are not being used by any other application. If they are in use, it may cause data corruption or data loss. Please refer to our online documentation for list of supported Operating systems, Hardware Snapshot engines and File systems.

Press <ENTER> to continue...

3. Type 2 and press Enter. SnapTest Version      Main Menu

--------------------------------------

Perform automatic snap tests or launch Advanced Operations such as Array Configuration, Snapshot Engine Detection etc. Automatic snap tests take one or more source mounts to snap and performs series of Snap related operations on them. In order to perform these snap opertions, array configuration such as array id, control host and user credentials is required. If no array configuration is found, Automatic Snaptests takes you to Array Configuration screen.

1. Automatic Snap Tests

2. Advanced Operations

0. Exit

Choose your option [1]:2

4. Type 3 and press Enter. SnapTest Version      Advanced Operations

----------------------------------------------

From this screen you can launch Array Configuration screen or Miscellaneous
tasks screen.

1. Perform Individual Snap Operations

2. Array Configuration

3. Miscellaneous Tasks

0. Exit

Choose your option [1]:

5. Type 3 and press Enter. SnapTest Version      Miscellaneous Tasks

----------------------------------------------

From this screen you can launch various miscellaneous tasks that you might need to do while setting up snap feature. For example, you might need to find out HBA adapter address. Or you might need to scan for new devices upon zoning your client with your array. Such tasks can be performed from here.

1. Detect Snap Engine Type

2. Show HBA/iSCSI address

3. Send SCSI inquiry to mount point

4. Rescan Adapters

5. Delete Devices

0. Exit

Choose your option [1]:

6. Specify the drive letter of mount directory and press Enter. SnapTest Version      Send SCSI Inquiry

----------------------------------------------

Enter Mount Point to send SCSI Inquiry :

7. The vendor information, source path, and the mount path details are displayed.  

Mount Snapshot on Proxy

Follow the steps below to create a snapshot on your source computer and mount it to a proxy computer:

1. On your source computer, navigate to <installed_directory>\Base and double-click SnapTest.exe.  
2. Press Enter. This tool helps to perform operations such as...

-> Automatic Snap Tests

-> Individual Snap Tests

-> Hardware Snapshot Engine Detection

-> SCSI Inquiry

-> Scan HBA/IQN Adapters

NOTE: Please make sure that the mount points used for this test are not being used by any other application. If they are in use, it may cause data corruption or data loss. Please refer to our online documentation for list of supported Operating systems, Hardware Snapshot engines and File systems.

Press <ENTER> to continue...

3. Type 2 and press Enter. SnapTest Version      Main Menu

--------------------------------------

Perform automatic snap tests or launch Advanced Operations such as Array Configuration, Snapshot Engine Detection etc. Automatic snap tests take one or more source mounts to snap and performs series of Snap related operations on them. In order to perform these snap opertions, array configuration such as array id, control host and user credentials is required. If no array configuration is found, Automatic Snaptests takes you to Array Configuration screen.

1. Automatic Snap Tests

2. Advanced Operations

0. Exit

Choose your option [1]: 2

4. Press Enter. SnapTest             Main Operations

-----------------------------------------------------

From this screen you can perform individual snap operations or miscellaneous tasks.

1. Perform Individual Snap Operations

2. Miscellaneous Tasks

0. Exit

Choose your option [1]:

5. Specify the number corresponding to the storage that you wish to select and press Enter. SnapTest      Snap Engine Test

------------------------------------------------------------------------------

Choose the snap engine you would like to exercise. All the snap tests will use this engine till you choose a different one. If you do not know what engine to choose, choose 'Detect Engine' to find out what engine to choose.

1. Native

2. HDS Shadow Image

3. NetApp

4. EMC TimeFinder BCV

5. EMC TimeFinder Snap

6. EMC CLARiiON Snapview Snap

7. EMC CLARiiON Snapview Clone

8. HDS Copy on Write Snapshot

9. Dell Equallogic Snap

10. Data Replicator

11. Data Replicator

12. HP EVA Snapshot

13. HP EVA Clone

14. IBM XIV SNAP

15. Data Replicator

16. LSI Snapshot

17. LSI Volume Copy

18. Dell Equallogic Clone

19. EMC Celerra

20. IBMSVC Space-efficient FlashCopy

21. IBMSVC FlashCopy

22. Dell Compellent Snap

23. 3PAR SNAP

24. 3PAR CLONE

25. LSI IBM Snap

26. LSI IBM Clone

27. LSI Dell Snap

28. LSI Dell Clone

29. LSI SGI Snap

30. LSI SGI Clone

31. LSI Sun Snap

32. LSI Sun Clone

33. Detect Engine

0. Exit

Enter Engine Number [33]:

6. Specify the drive letter of mount directory and press Enter.
  Enter all the mount points that you want to test. Ensure to specify two "\" after the drive letter e.g., E:\\.
Mount points to snap (separate by commas, if more than one): E:\\
7. Press Enter. SnapTest                 Create Snap

-----------------------------------------------------------

Mount points to snap (separate by commas, if more than one): E:\\

Creating snapshot... SUCCESS

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. Press Enter. This tool helps to perform operations such as...

-> Automatic Snap Tests

-> Individual Snap Tests

-> Hardware Snapshot Engine Detection

-> SCSI Inquiry

-> Scan HBA/IQN Adapters

NOTE: Please make sure that the mount points used for this test are not being used by any other application. If they are in use, it may cause data corruption or data loss. Please refer to our online documentation for list of supported Operating systems, Hardware Snapshot engines and File systems.

Press <ENTER> to continue...

12. Type 2 and press Enter. SnapTest Version      Main Menu

--------------------------------------

Perform automatic snap tests or launch Advanced Operations such as Array Configuration, Snapshot Engine Detection etc. Automatic snap tests take one or more source mounts to snap and performs series of Snap related operations on them. In order to perform these snap opertions, array configuration such as array id, control host and user credentials is required. If no array configuration is found, Automatic Snaptests takes you to Array Configuration screen.

1. Automatic Snap Tests

2. Advanced Operations

0. Exit

Choose your option [1]: 2

13. Press Enter. SnapTest             Main Operations

-----------------------------------------------------

From this screen you can perform individual snap operations or miscellaneous tasks.

1. Perform Individual Snap Operations

2. Miscellaneous Tasks

0. Exit

Choose your option [1]:

14. Specify the number corresponding to the storage that you wish to select and press Enter. SnapTest      Snap Engine Test

------------------------------------------------------------------------------

Choose the snap engine you would like to exercise. All the snap tests will use this engine till you choose a different one. If you do not know what engine to choose, choose 'Detect Engine' to find out what engine to choose.

1. Native

2. HDS Shadow Image

3. NetApp

4. EMC TimeFinder BCV

5. EMC TimeFinder Snap

6. EMC CLARiiON Snapview Snap

7. EMC CLARiiON Snapview Clone

8. HDS Copy on Write Snapshot

9. Dell Equallogic Snap

10. Data Replicator

11. Data Replicator

12. HP EVA Snapshot

13. HP EVA Clone

14. IBM XIV SNAP

15. Data Replicator

16. LSI Snapshot

17. LSI Volume Copy

18. Dell Equallogic Clone

19. EMC Celerra

20. IBMSVC Space-efficient FlashCopy

21. IBMSVC FlashCopy

22. Dell Compellent Snap

23. 3PAR SNAP

24. 3PAR CLONE

25. LSI IBM Snap

26. LSI IBM Clone

27. LSI Dell Snap

28. LSI Dell Clone

29. LSI SGI Snap

30. LSI SGI Clone

31. LSI Sun Snap

32. LSI Sun Clone

33. Detect Engine

0. Exit

Enter Engine Number [33]:

15. Type 3 and press Enter. SnapTest             Snap Engine Test

-----------------------------------------------------

From this screen, you can launch individual snap operations to exercise the snap engine selected in the previous screen. Exit from this screen to choose a different engine.

1. Create Snap

2. Delete Snap

3. Mount Snap

4. Unmount Snap

5. Revert to Snap

6. Save Snaps List

7. Load Snaps List

0. Exit

Choose your option [1]: 3

16. Type the number corresponding to the snapshot you want to mount and press Enter. Snap numbers to mount (Separate by commas, if more than one): 1
17. Specify the destination path for the snapshot to be mounted and press Enter. Enter Mount point for snapshot 1: c:\mylocation
18. Press Enter.

The snapshot is successfully mounted on the proxy computer.

SnapTest                 Mount Snap

-----------------------------------------------------------

Snap numbers to mount (Separate by commas, if more than one): 1

Enter Mount point for snapshot 1: c:\mylocation

Mounting snapshot... SUCCESS

Press <ENTER> to continue...

19. Do the following 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.
 

 

Back to Top