Remote Storage Services Tools

ID: Q234692


The information in this article applies to:
  • Microsoft Windows 2000 Server
  • Microsoft Windows 2000 Advanced Server
  • Microsoft Windows 2000 Datacenter Server


SUMMARY

Remote Storage Services (RSS) includes three tools that you can use to ensure data integrity:

  • The Remote Storage Diagnostic tool (Rsdiag.exe)


  • The File Information tool (Rsdir.exe)


  • The Database Dump tool (Rsdumpdb.exe)


These tools are not copied to the system when you install the Microsoft Windows 2000 Resource Kit. You must install them separately from the Support\Reskit\Stormgmt\Rstool folder on the Windows 2000 CD-ROM.


MORE INFORMATION

The Remote Storage Diagnostic Tool

You can use Rsdiag.exe to examine remote storage databases and display diagnostic information. Rsdiag.exe can output the contents of remote storage databases and property files to text files. You can use Rsdiag.exe and Rsdir.exe together to diagnose problems in the databases and to recover lost data.

To install the Remote Storage Diagnostic tool:
  1. Copy the Rsdiag.exe file and the Rstools.dll files from the Support\Reskit\Stormgmt\Rstool folder to the %SystemRoot%\System32 folder.


  2. Register the Rstools.dll file by typing regsvr32 rstools.dll at a command prompt.


You can also use Rsdiag.exe on a system that does not have RSS installed (for example, to validate RSS databases). In this case, perform the following steps:
  1. Copy the Rsdiag.exe, Rstester.dll, and Ntlog.dll files to the %SystemRoot%\System32 folder.


  2. Register the Rstester.dll file by typing regsvr32 rstester.dll at a command prompt.


  3. Copy the Rscommon.dll and Rsconn.dll files from the Windows 2000 CD-ROM to the %SystemRoot%\System32 folder.


  4. Register the Rscommon.dll file by typing regsvr32 rscommon.dll at a command prompt, and then register the Rsconn.dll file by typing regsvr32 rsconn.dll at a command prompt.


You can use Rsdiag.exe at a command prompt with the following syntax:
rsdiag [job [jobname]] [cancel jobname] [volume [volumename] [/manageables]] [version] [reloadtrace] [media] [decode errorcode] [dump {-e|-f|-a|-n|-s} dumpfile]
You can use the following options with Rsdiag.exe:

NOTE: Use only one set at a time (for example, rsdiag job jobname).
  • Job jobname shows job information for a specified job. If jobname is not specified, all information on all jobs is displayed.


  • Cancel jobname cancels the job specified.


  • Volume volumename /manageables. If you use the volume command by itself, volume information is displayed. If you use volumename, extended information about the specific volume is displayed. If you use the /manageables switch, the volumes that are eligible to be managed are displayed.


  • Version shows version information for the files.


  • Reloadtrace reloads the trace information.


  • Media shows physical storage media information.


  • Decode errorcode shows error information for a particular error code. To specify hex error codes, type 0x in front of errorcode.


  • Dump {-e|-f|-a|-a|-s} dumpfile sends the diagnostic information to a text file. Dumpfile is the path where you want the text file placed. The following dump switches specify source file format that is to be put to a text file:


  • -e Engine database file
    -f File System Agent (FSA) database file
    -a FSA property file
    -n Engine property file
    -s Subsystem property file

The File Information Tool

You can use Rsdir.exe to examine reparse points and display information for managed files.

To install the File Information tool:
  1. Copy the Rsdir.exe file and the Rstools.dll file from the Support\Reskit\Stormgmt\Rstool folder to the %SystemRoot%\System32 folder.


  2. Register the Rstools.dll file by typing regsvr32 rstools.dll at a command prompt.


  3. NOTE: If you already registered the Rstools.dll file using the Remote Storage Diagnostic tool (Rsdiag.exe), you do not have to re-register the file.
You can use Rsdir.exe at a command prompt with the following syntax:
rsdir [/full] [/s]
The /full switch shows extended file information.
The /s switch shows information in the current folder and subfolders.

The Database Dump Tool

You can use Rsdumpdb.exe to dump File System Agent (FSA) and Engine databases to text files. The FSA database contains pre-migration lists and the Engine database contains file and media mapping information for RSS.

To install the Database Dump tool, copy the Rsdumpdb.exe file from the Support\Reskit\Stormgmt\Rstool folder to the %SystemRoot%\System32 folder, and then run the file from there. There is no associated Dynamic Link Library (DLL) file to be copied or registered for this tool.

You can use Rsdump.exe at a command prompt with the following syntax:
rsdumpdb -e filename
This dumps the Engine database to a file name you specify in the filename section.
rsdumpdb -f filename
This dumps the FSA database to a file name you specify in the filename section.

Additional query words: rsm utilities rsdir rsdumpdb rsdiag

Keywords :
Version : WINDOWS:2000
Platform : WINDOWS
Issue type : kbinfo


Last Reviewed: December 30, 1999
© 2000 Microsoft Corporation. All rights reserved. Terms of Use.