One Identity Safeguard for Privileged Sessions 6.9.3 - Administration Guide

Collecting logs and system information of the boot process for error reporting

If you have a problem related to the boot process of the appliance, the One Identity Support Team might request you to collect system-state and debugging information about the boot process. This information is collected automatically, and contains log files, the configuration file of One Identity Safeguard for Privileged Sessions (SPS), and various system-statistics.

If the problem you want to reproduce does not require a reboot, see Collecting logs and system information for error reporting instead.

To collect information about the boot process

1. Navigate to Basic Settings > Management > Verbose system logs > Enable.

2. (Optional) If the error you want to reproduce is related to the audited network traffic, for example, it occurs when a used connects to a protected SSH server, consider increasing the log level of the related traffic (for example, SSH). For details, see Changing log verbosity level of One Identity Safeguard for Privileged Sessions (SPS).

   Note that earlier versions of SPS increased the log level of the audited traffic automatically.

3. Reproduce the event that causes the error (for example, reboot the appliance).

4. Navigate to Basic Settings > Troubleshooting > Create support bundle and click Create support bundle.

   Figure 349: Basic Settings > Troubleshooting > Create support bundle — Collecting debug information

   

5. Click Save support bundle with debug logs and save the created zip file. The name of the file uses the debug_info-<hostname>YYYYMMDDHHMM format.

   SPS includes the configuration files of any plugins installed. Note that depending on the plugin, these configuration files can contain sensitive information, such as passwords or API keys. In this case, edit the plugin-related files in the plugins directory of the support bundle and delete the sensitive information.

6. (Optional) If you have increased the verbosity level of the audited network traffic, decrease it to the default level.

7. Navigate to Basic Settings > Management > Verbose system logs > Disable.

8. Attach the file to your support ticket.

Support hotfixes

This section describes support hotfixes and their installation in One Identity Safeguard for Privileged Sessions (SPS).

Support hotfixes are official additions (signed .deb packages created by the Support Team) to a specific SPS release. By uploading a hotfix to an SPS appliance, it is possible to apply a modification (for example, a bugfix) quickly and without making the firmware Tainted. The hotfix files only work with the version of SPS they are created for.

You can upload the hotfix file you received from our Support Team in the SPS user interface.

Installing support hotfixes

This section describes the most important requirements and information regarding the installation procedure of support hotfixes.

Prerequisites

The hotfix files are normally not publicly accessible for download (unless attached to Knowledgebase Articles). As a result, if you want to install them to your SPS, you must first contact our Support Team for a hotfix file specifically created for your request. Consider that you cannot delete the installed hotfix file from SPS without the Support Team's assistance. In addition, rebooting the SPS appliance after deleting an installed hotfix is necessary. We strongly recommend that you only install hotfixes to SPS if you contact our Support Team for instructions beforehand.

To install the support hotfix file

1. Navigate to Basic Settings > System > Firmwares.

   Figure 350: Uploading a hotfix file in the SPS user interface

   
2. Under the Upload new hotfix: section, click Choose File and select the hotfix file you want to upload.

3. Click Upload.

   Caution: Consider the following: Clicking Upload immediately installs the hotfix to SPS. Installing multiple hotfix files to a single configuration of SPS is possible, but you cannot delete an individual hotfix file from SPS without the Support Team's assistance. Installing a new firmware will delete all hotfix files installed on the previous version of SPS. If you have to delete an individual hotfix file from SPS without installing a new firmware first, contact our Support Team.

4. If installation is successful, SPS will list information about the hotfix under Installed hotfixes:, such as Name, Version and Description.

   NOTE: Upload will fail in the following cases:

   • The hotfix file version does not pass the version check.
   • The hotfix file package is not properly signed by our Support Team.
   • The file you want to upload is not an appropriate .deb package or the file is corrupted.

   If upload fails, SPS will revert to its previous state automatically.

Status history and statistics

SPS displays various statistics and status history of system data and performance on the dashboard at Basic Settings > Dashboard. The dashboard is essentially an extension of the system monitor: the system monitor displays only the current values, while the dashboard creates graphs and statistics of the system parameters.

The dashboard consists of different modules. Every module displays the history of a system parameter for the current day. To display the graph for a longer period (last week, last month, or last year), select the Week, Month, or Year options, respectively. Hovering the mouse over a module enlarges the graph and displays the color code used on the graph.

All types of data is collected every five minutes. This means that if changes are more frequent, it might not be represented in the graphs.

To display statistics of a module as a table for the selected period, click on the graph.

Figure 351: Basic Settings > Dashboard — The dashboard

The following modules are displayed on the dashboard of SPS:

• Connection statistics: Number of active connections per protocol.

• Memory: The memory used by the system.

• Disk: Filesystem usage for the different partitions.

• CPU: CPU usage.

• Network connections: Number of network connections.

• Physical interface 1 (eth0): Traffic on physical interface 1.

• Physical interface 2 (eth1): Traffic on physical interface 2.

• Physical interface 3 (eth2): Traffic on physical interface 3.

• Load average: Average load of the system.

• Number of processes: The number of running processes.

Topics:

Connection statistics

Figure 352: Basic Settings > Dashboard > Connection statistics

The Connection statistics module on the Dashboard is based on statistics of high-level proxy-service protocols (SSH, RDP, VNC, ICA, and so on). These numbers display all active high-level proxy-service protocols, but these numbers are counted by all service connections too, which are connected to some protocols. Because of this, these numbers can differ from the numbers displayed on the Active Connections page.

For example, if there are several active ICA connections in your system, it means that there are approximately the same number of CGP connections that are opened and counted in the Connection statistics module under the ICA label. If these CGP or ICA high-level proxy-service protocols are opening more than one TCP connections, these connections will be counted in the Network connetion module as different TCP connections, but these will count as only one connection on the Active Connections page.

Statistics

The connection types displayed can be the following:

• RDP: The number of RDP connections.

• SSH:The number of SSH connections.

• HTTP: The number of HTTP connections.

• ICA: The number of Citrix connections.

• Telnet: The number of Telnet connections.

• VNC: The number of VNC connections.

The Min, Average and Max values are displayed as a whole number if the value is constant for the statistics interval (the statistics are stored every 5 minutes). If minor changes occur in the actual values (for example, new connections are established), these changes can be displayed as fractions.