IBM Support

Troubleshooting/Testing VSS using DiskShadow on Windows 8/2008 (R2)/2012 (R2)

Question & Answer


Question

During troubleshooting of problems with SystemState backup or Open File Support/Online Image using VSS, it is sometimes useful to test the VSS portion by itself.

Cause

With Windows 8, 2008, 2008 R2, 2012, and 2012 R2, Microsoft included a tool called DiskShadow.exe that can be used to take snapshots of the system and much more.

Answer

For the purpose of this technote, we will be limited to performing tests similar to what happens when Tivoli Storage Manager (TSM) performs a SystemState backup, Open File Support backup or an Online Image backup.

Obtain Writer Information:

When troubleshooting a problem, sometimes it is useful to obtain information about the writers, their status and the metadata.

You can start diskshadow and logging all outputs to a file by starting a Command Prompt and launching this command:
diskshadow /l c:\diskshadow.out

From the diskshadow prompt, issue the following commands:

reset
list writers
list writers status
list writers metadata
list writers detailed
list providers
exit

The output of all the above commands will be found in c:\diskshadow.out. The output can use useful to see the list of files which are reported by the VSS writers to be included and excluded by the backup.

Test a snapshot of SystemState

When dealing with SystemState backup failures, sometimes the problem is with Tivoli Storage Manager, sometimes on Windows either with VSS itself or with one of its writers. Testing outside Tivoli Storage Manager helps determine if the problem is within Tivoli Storage Manager or some other area.

You can start diskshadow and logging all outputs to a file by starting a Command Prompt and launching this command:
diskshadow /l c:\diskshadowsys.out

From the diskshadow prompt, issue the following commands:

reset
set verbose on
set option differential
set context volatile
add volume c:
add volume d: (if the system is on more than one disk, add them one by one)
create
exit

The output of all the above commands will be found in c:\diskshadowsys.out. Review this file for errors. Any failure during the create phase indicate a problem either with VSS or one of the writers which should be pursued with Microsoft.

Test a snapshot of a disk for Open File Support or Online Image with snapshot provider to VSS

When dealing with a problem doing an open file support backup or online image backup when VSS is used as the snapshot provider, it is sometimes useful to isolate if the problem is within or external to the Tivoli Storage Manager client. This will perform a snapshot of the disk.

You can start diskshadow and logging all outputs to a file by starting a Command Prompt and launching this command:
diskshadow /l c:\diskshadowsnap.out

From the diskshadow prompt, issue the following commands:

reset
set verbose on
set option differential
set context volatile nowriters
add volume c: (replace c: with the drive letter the snapshot is having problems.)
create
exit

The output of all the above commands will be found in c:\diskshadowsnap.out. Review this file for errors. Any failure during the create phase indicate a problem either with VSS or possibly the disk.

Related Information

[{"Product":{"code":"SSGSG7","label":"Tivoli Storage Manager"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":"Client","Platform":[{"code":"PF033","label":"Windows"}],"Version":"Version Independent","Edition":"","Line of Business":{"code":"LOB26","label":"Storage"}}]

Product Synonym

TSM

Document Information

Modified date:
17 June 2018

UID

swg21699984