Collecting System Information for Troubleshooting

Tectia ConnectSecure 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 ifconfig
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 default installation directory on Windows:
- "C:\Program Files\SSH Communications Security\SSH Tectia" on 32-bit Windows versions
- "C:\Program Files (x86)\SSH Communications Security\SSH Tectia" on 64-bit Windows versions
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.

To collect system information, open a command prompt and enter the following command:

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 SSH Technical Support for analysis.

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