ssh-troubleshoot — tool for collecting system information


ssh-troubleshoot [options] [command [command-options] ]


ssh-troubleshoot is a tool for collecting information on the operating system (its version, patches, configuration settings, installed software components, and the current environment and state) and on the Tectia installation (installed product components and versions, their state, and the global and user-specific configurations).

The collected information will be stored in a file named ssh_troubleshoot_<host>_<date>_<time>.tar . Send the file to the SSH technical support for analysis to help in troubleshooting situations.

To get all necessary information, run the command as an administrator, because it might need root access to some directories.

The default location of this tool is /opt/tectia/sbin/, and that path should be set in the user's PATH. Otherwise ssh-troubleshoot can be run only by pointing directly to the executable file. In case you want to install Tectia tools to any non-default directory, for example to /usr/lpp/tectia/, you must set that directory in the user's PATH.


Enter each option separately, they cannot be combined. The following options are available:

-d, --debug LEVEL

Sets the debug level string to LEVEL.

-k, --keep-going

Defines that the data collecting is continued as long as possible, even after errors are encountered.

-o, --output FILENAME

Defines a non-default output file for storing the collected data.

If FILENAME is '-', the collected data is added to the standard output. The default output file is created in a temporary archive directory and stored as ssh-troubleshoot-data-<hostname>-<timestamp>.tar. The timestamp is in format: yyyymmdd-hhmmUTC.

-u, --user USERNAME

Defines another user for the info command, the default is the current user. This affects the home directory from which the user-specific Tectia configuration files are fetched.

-q, --quiet

Suppresses detailed reporting about the command progress, reports only errors.

-h, --help

Displays this help text.


ssh-troubleshoot accepts the following command:


Gathers information about the system configuration. The collected data will be stored as a tar file.



Collects everything from the specified user's configuration directories, including the private keys. By default, the private keys nor unrecognized files are not included in the result data.