Your browser does not allow this site to store cookies and other data. Some functionality on this site may not work without them. See Privacy Policy for details on how we would use cookies.


Collecting System Information for Troubleshooting

Tectia Client includes a troubleshooting tool that automatically collects necessary data about the operating system and hardware, and about the installed Tectia product versions and their configurations into a file. The troubleshooting tool gathers the following information about the system configuration:

  • The operating system (OS) version and patches installed

  • OS configuration files and other OS information, for example about PAM, syslog, resolver, and ifconfg

  • Hardware information, for example the machine model, security class, and CPU version

  • OS status, for example the reserved ports and connections per socket

  • Tectia binaries, the tool checks the actual installation package versions and detects also debug packages

  • Tectia global configuration from the /etc/ and /opt/ directories on Unix, and from the "C:\Program Files\SSH Communications Security\SSH Tectia directory on Windows

  • User-specific Tectia configuration from user's home directory: $HOME/.ssh2 on Unix, and "C:\Documents and Settings\<username>" or "C:\Users\" on Windows

  • The user account running the troubleshooting tool

  • On Unix, it is configurable if everything stored in the specified user's configuration directories, including the private keys, are to be collected. This helps the Technical Support to better simulate the user's situation.

On Unix, run the troubleshooting tool with command:

# ssh-troubleshoot [options] info [command-options]

On Windows, run the troubleshooting tool with command:

ssh-troubleshoot.cmd [options] info

For details about the command options, refer to ssh-troubleshoot(8).

The collected data is stored in the results file named as follows:

  • On Unix: ssh-troubleshoot-data-<hostname>-<timestamp>.tar

  • On Windows: ssh-troubleshoot-data-<hostname>-<timestamp>.log

In the file name, hostname identifies the host from where the information was collected, and timestamp specifies the date and time when the information was stored into the file. The timestamp format is yyyymmdd-hhmmUTC. So the reports are not in local time, but use the UTC.

You can send the file to Tectia Technical Support for analysis.


Handle the output file with appropriate care as it may contain security-critical data.