HP-UX Secure Shell Getting Started Guide

7 Troubleshooting HP-UX Secure Shell
This chapter discusses methods to troubleshoot problems with HP-UX Secure Shell connections.
This chapter addresses the following topics:
• “Overview” (page 59)
• “Debugging the HP-UX Secure Shell Server” (page 59)
• “Debugging the HP-UX Secure Shell Client” (page 61)
• “Interpreting the Debug Output” (page 62)
• “Generating Debug Messages Using the LogLevel Configuration Directive” (page 64)
• “Logging Error and Debug Messages” (page 65)
• “Authentication Problems” (page 65)
• “Reporting Problems” (page 66)
Overview
HP-UX Secure Shell servers and clients provide built-in debugging. When an HP-UX Secure
Shell client tries to establish a connection with an HP-UX Secure Shell server, the HP-UX Secure
Shell server presents a list of authentication methods that it supports. If the HP-UX Secure Shell
client fails to authenticate itself using one method, it can try the next authentication method on
the list. HP-UX Secure Shell server attempts all supported authentication methods before declining
the connection request from the client.
When you experience a problem during a HP-UX Secure Shell connection, first run the HP-UX
Secure Shell client and server in debug mode. By default, debugging is not enabled on either the
HP-UX Secure Shell server or the HP-UX Secure Shell client. When invoked with appropriate
debugging command-line options, HP-UX Secure Shell server and client display messages about
their progress and failures. You can analyze these messages to identify problems. You can increase
the level of detail displayed in the debug output to obtain more information about the problem.
You can use either command-line options or the configuration directive on the HP-UX Secure
Shell server and client to control the debugging message level.
Depending on how debugging is configured, HP-UX Secure Shell logs error messages to the
console or to the /var/adm/syslog/syslog.log file.
Apart from the debugging options, the HP-UX Secure Shell Frequently Asked Questions (FAQ)
available at the following URL can help you solve some common problems: http://
www.docs.hp.com/en/internet.html#Secure%20Shell
Debugging the HP-UX Secure Shell Server
The HP-UX Secure Shell server logs debug and error messages in the /var/adm/syslog/
syslog.log file. You can also configure the HP-UX Secure Shell server to log the messages in
a different file.
Debugging Options
The HP-UX Secure Shell server daemon, sshd, provides the following debugging options:
Overview 59