Troubleshooting the SAM-FS Stager
When investigating a problem staging files, it is important to determine if the problem is limited to one file or is persistent and affects many files.
One way to determine if the problem affects one file or many is to monitor the
display. This display shows staging activity. Once you are in the
display, press the Control key and tap
The display now shows the file being staged.
If you find that just one file or just the files on one VSN are not staging, you should check the
sls -D display for that file to see if the archive copies are marked damaged. If only one archive copy is damaged, use the
undamage to undamage archive copy, then try the stage again. I all archive copies are damaged, the additional step of undamaging the file will be necessary.
If attempts to undamage archive copy does not resolve the problem, you should then attempt to stage other archive copies. If no other archive copies exist, use the disaster recovery techniques described in the Appendix of the SAM-FS System Administrator's Guide to retrieve the file.
Files not staging properly can generally be traced to one of several conditions:
- Is the file system full? Is there room in the file system to stage the file?
- Are archive copies marked damaged? Is the media bad?
- Is the VSN listed in a robot?
- Is a drive available for staging?
- Is the drive reporting hardware problems?
- Is excessive recycling occurring?
Checking Stager Log files for possible errors reported
- Log files related to the stager process that may be helpful in problem determination are:
- stager log file (configurable)
- recycler log file (configurable)
- The samu cli display may also provide some assistance.
Supporting Documentation and Additional data collection
- Enable daemon tracing
- Enable stager logging