My Oracle Support Banner

Oracle HSM (SAM-QFS): Troubleshooting the samfsck Command (Doc ID 1378571.1)

Last updated on MARCH 28, 2024

Applies to:

Oracle Hierarchical Storage Manager (HSM) and StorageTek QFS Software - Version 4.6 and later
Information in this document applies to any platform.


The samfsck(1M) command can be executed for several different purposes : it can be used to check, modify, rename and/or repair a SAM-QFS filesystem.  In some cases, the outcome of the command can lead to unresolved issues or further actions to be taken.

This document will assist in troubleshooting the samfsck(1M) command.

The samfsck utility is used to guarantee filesystem consistency of metadata structures. These structures include filesystem superblocks, allocated space bit maps, directory blocks, and inode contents. When used for crash recovery, samfsck will analyze these filesystem components for errors, report detected errors, and optionally repair defects when the command line -F option is specified. The samfsck utility does not attempt to analyze or recover data errors present in user file data.

Nonfatal errors returned by samfsck(1M) are preceded by NOTICE. Nonfatal errors are lost blocks and orphans. The file system is still consistent if NOTICE errors are returned. You can repair these nonfatal errors during a convenient, scheduled maintenance outage.

Fatal errors are preceded by ALERT. These errors include duplicate blocks, invalid directories, and invalid indirect blocks. The file system is not consistent if these errors occur. Consider opening a new case with tech support if the ALERT errors cannot be explained by a hardware malfunction.

If the samfsck(1M) command detects file system corruption and returns ALERT messages, you should determine the reason for the corruption. If hardware is faulty, repair it before repairing the file system.

Troubleshooting Steps

To view full details, sign in with your My Oracle Support account.

Don't have a My Oracle Support account? Click to get started!

In this Document
Troubleshooting Steps
 To Repair a File System
 Troubleshooting repair issues (samfsck -F)
 Related issues

My Oracle Support provides customers with access to over a million knowledge articles and a vibrant support community of peers and Oracle experts.