When you raise a problem with a Tideway Customer Support, a support case will be raised which describes the observed behavior. This case will be used to track the resolution of the problem. Frequently you will be asked for information on the state of the appliance, configuration information, logs, record data, and so on. Collecting additional data that Customer Support request can be accomplished using the Appliance Support page.

To access the Appliance Support page; from the Appliance section of the Administration tab, click the Support Services icon.

From the Appliance Support page you can do the following:

• Collect Tideway Foundation logs between specified dates.
• Collect Target Host Data and session logs for specified IP addresses or ranges.
• Collect Miscellaneous files.
• Create named archives of collected data.
• Download and manage archives of collected data.

The following systems and aspects of the appliance create logs which may be useful to Customer Support when diagnosing problems with the appliance:

• Application Server – used to diagnose UI errors.
• Security – used to track user access and actions.
• Performance – used to diagnose performance problems.
• Discovery – used to diagnose discovery and data quality issues.
• Model – used to diagnose queries or reporting problems.
• Reasoning – used to diagnose discovery and data quality issues.
• Tomcat – used to diagnose problems with the Tomcat web server.
• Others – used to diagnose miscellaneous problems, for example, script problems.
• Application Server Error Messages – used to diagnose UI errors.
• Audit Logs – used for general diagnostics and user errors.
• Discovery Slaves – used to diagnose Windows discovery problems.

The discovery data and logs are also stored on the appliance. These may be useful to Customer Support when diagnosing discovery problems:

• Session logs – raw discovery data used for diagnosing discovery and data quality issues.
• Record data – used to reproduce discovery problems on test appliances.
• Pool data – used to reproduce discovery problems on test appliances.

The following files and system logs may be useful to Customer Support when diagnosing problems with the appliance:

• Configuration files – used to check the appliance configuration.
• System messages – used to diagnose appliance related problems.
• omniNames files – used to check communications configuration.
• Installed packages – used to ensure that the correct packages are installed.
• bash history – used to check the command line history.
• sar logs – used to diagnose performance problems.
• Tripwire reports – used to view these reports.
• Tideway output files – used to check the output files.
• Slave configuration – used to check the configuration of Windows discovery slaves.

Creating an Archive of Collected Data for Tideway Customer Support

To Select Tideway Foundation Logs

From the Foundation Logs By Date section of the Appliance Support page:

1. Select the start date from which you want to collect logs using the drop-down selectors in the From field.
2. Select the end date using the drop-down selectors in the To field.
3. Using the checkboxes, select the log files that Tideway Customer Support have requested.

To Select Target Host Data

From the Target Host Data section of the Appliance Support page:

1. Enter one of the following in the IP Ranges field:
   • IP addresses, as a single address or a range, for example, 172.17.1.1 or 172.17.1.1-5
   • A subnet, for example 172.17.1.0/24
2. To retrieve session logs for these IP addresses, select the Get session logs checkbox.
3. Using the selection boxes, select the additional data files that Tideway Customer Support have requested.

To Select Miscellaneous Files

From the Miscellaneous Files section of the Appliance Support page:

1. Select the start date from which you want to collect logs using the drop-down selectors in the From field.
2. Select the end date using the drop-down selectors in the To field.
3. Using the checkboxes, select the files that Tideway Customer Support have requested.

To Create an Archive

To create an archive of the selected logs, data, and files; from the Create Archive section of the Appliance Support page:

1. Enter a name for the archive in the Name field.
2. Enter a description for the archive in the Description field.
3. Click the Gather button.

The selected logs, data, and files are gathered into an archive and saved on the appliance. The archive and information relating to the archive are displayed in a new row of the Gathered Data Files section.

The following information is displayed for each archive:

• Name – the name of the archive.
• Description – the description entered when the archive was created.
• Date – the date that the archive was created.
• Size – the size (in bytes) of the archive.
• User – the user who created the archive.
• State – the state of the archive. This can be: Creating or Complete.
• Summary – a View button. Click this to see a list of the archive contents in a popup window.

Retrieving Archives to Send to Tideway Customer Support

To retrieve an archive, click its name in the Gathered Data Files section. A file download window specific to your browser type is displayed. Click Save to save the file to a location on your file system.