Rsdiag Overview

  • Article

Applies To: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2

Rsdiag.exe: Remote Storage Diagnostic Utility

This command-line tool examines Remote Storage (HSM) databases and displays diagnostic information in text format about migration jobs, managed volumes of the version of NTFS file system used in Windows Server 2003, and physical media, as well as other Remote Storage information useful for system analysis.

Remote Storage stores its data in a series of databases and collection files in the Systemroot\System32\RemoteStorage directory. The data enables the Remote Storage service to associate file placeholders and file data, and to track managed and unmanaged volumes, files on managed volumes, jobs, and physical media. RsDiag lets you display this data in easy-to-read format on the console and in text files.

You can use RsDiag to display the following information:

  • The contents of the Remote Storage database (EngDb), the FSA database (FsaDb: premigrated files), the FSA temporary unmanaged database, and the collection files that store the configuration options for each volume (RsFsa.col) and for the installation (RsEng.col).

  • Version information for the configuration collection files.

  • Volumes that are eligible for Remote Storage management.

  • Properties of managed volumes.

  • Properties of physical media used for Remote Storage.

  • The physical location of the file data for premigrated and truncated files.

  • Remote Storage jobs scheduled on the system, including migration, validation, free space, managed, and unmanaged jobs. You can also use RsDiag to stop a job in progress.

  • The internal recall queue. You can use RsDiag to delete a job from the recall queue, preventing a file from being recalled.

  • Descriptions of error codes generated by Rss.exe and found in the Service and Driver logs in Event Viewer.

RsDiag works with the Rsdir Overview to help diagnose problems in the Remote Storage databases and, if necessary, recover lost data.

Corresponding UI

There is no corresponding user interface for this tool.

Concepts

Remote Storage extends the disk space on the computer by copying files to remote storage based on criteria that you establish, including the location and size of the files, and the amount of free space on the volume. Files are recalled from remote storage automatically when they are accessed.

Files stored remotely appear unchanged in Microsoft Windows Explorer. Users open them by the same methods, but the files do not consume any local disk space. Instead, Remote Storage uses NTFS Reparse Points as placeholders for the files on the local volumes. The Reparse Points store information about the file, including its actual location in remote storage.

System Requirements

The following are the system requirements for RsDiag:

  • This version of RsDiag runs only on Windows Server 2003. A version of RsDiag for Windows 2000 is included in the Support Tools directory of the Windows 2000 Server operating system.

  • The user must be a member of the Administrators group on the computer.

  • RsDiag is a local computer tool. You cannot use it to display information about volumes on a remote computer.

Files Required

  • Rsdiag.exe

  • Rstools.dll

The Rstools.dll library must be registered on the system. The Support Tools installation process registers the DLL. However, if you copy these files to another computer, you must register the DLL manually by typing the following at the command prompt:

regsvr32 RsTools.dll

For More Information

For more information about Remote Storage Server, download the "Enterprise Class Storage in the Next Generation of Windows NT" document from the Microsoft Windows 2000 Server Web site.

See Also

Concepts

Rsdiag Syntax
Rsdiag Examples
Alphabetical List of Tools
Topchk.cmd
Rsdir Overview
Rsdiag Overview
Iologsum Overview
Health_chk Overview
Ftonline Overview
Filever Overview
Efsinfo Overview
Dmdiag Overview
Dskprobe Overview
Diruse Overview
Dfsutil Overview
Connstat Overview
Cabarc Overview
Bitsadmin Overview