User's Manual

228 Troubleshooting
Example
HSM_MEDIA_LOGGING
This debugging variable cannot be used with the fsesystem --enable-dbg command. It can only be
specified in the trace.cfg file.
Specifying this variable, you can prevent FSE from logging the actions performed on the FSE media, which
are normally logged into the FSE event log. Use the following line to disable media logging:
NOTE: Excessive logging may result in an FSE system performance becoming noticeably degraded. It
may be a good idea to disable media logging when you expect that many media operations will be
logged in a short period of time.
HSM_CALL_TIMEOUT
This debugging variable cannot be used with the fsesystem --enable-dbg command. It can only be
specified in the trace.cfg file.
In the FSE interprocess communication, the default timeout period for all omniORB (CORBA) calls is 2
days. For various reasons, you may want to change the default period to a different value. The timeout
value must be specified in milliseconds. Value 0 means no timeout.
Example
HSM_PT_DIRECT
By default, the FSE implementation uses direct SCSI pass-through mode for controlling SCSI devices. Some
SCSI and Fibre Channel host bus adapters (HBAs) are not compatible with this mode, which may result in
problems using the attached devices. The variable HSM_PT_DIRECT in trace.cfg allows such HBAs to
be used in the FSE implementation. You can switch communication with devices from direct SCSI
pass-through mode to buffered SCSI pass-through mode.
To use buffered SCSI pass-through mode, uncomment the following line in trace.cfg, or add it if
necessary:
HSM_BEA_VERIFY_POSITION
This debugging variable cannot be used with the fsesystem --enable-dbg command, neither can be
specified in the trace.cfg file. It can only be used as environment variable.
The variable enables tape medium position check functionality of the Back End Agent (BEA). This BEA
feature decreases the probability of data loss in SCSI bus reset events. Such events are not reported to the
FSE system in certain cases and cannot be handled appropriately.
If you configure tape medium position check, BEA can check the position of an FSE tape medium during
write operations. By default, these checks are performed only with AIT WORM media. (Note that FSE 3.2
does not support any WORM media.) To enable or disable position checks for all supported media
families, set the HSM_BEA_VERIFY_POSITION environment variable to one of the following:
• NEVER
This value disables tape medium position checks.
• ALWAYS
This value enables tape medium position checks for all supported media families.
export HSM_DEBUG_DISKBUF=corrupt
export HSM_MEDIA_LOGGING=no
export HSM_CALL_TIMEOUT=300000
export HSM_PT_DIRECT=no