When troubleshooting, Ping Identity Support might ask you to use the collect support data tool to compile information about your PingAccess installation.
By default, the tool collects information from:
- <PA_Home>/log (the most recent files of each type within a size limit)
- <PA_Home>/conf (configuration files)
Information the tool collects includes:
- Environment details, such as:
- Files present and their sizes
- Certificate data
- Version data
- Java Virtual Machine (JVM) details
- System details, such as:
Sytem details vary depending on the operating system you're using.
The tool consists of the following files in the PingAccess home directory:
If Ping Identity Support needs more information about the PingAccess installation than the default configuration provides, Support might ask you to add a data collector to the tool by modifying its csd_configuration.yaml file.
To collect support data with the tool:
- Using your PingAccess administrator account and a terminal, go to the <PA_Home>/bin directory.
Use one of the following commands to run the collect support data tool,
depending on your operating system:
- On a Windows operating system, use ./collect-support-data.bat.
- On a Unix-based operating system, use ./collect-support-data.sh.
If Ping Identity Support directs you to do so, you can use additional options with these commands. For example, you can run the command with the
For more information, see the PingFederate and PingAccess Support Data Collector knowledge base article.
As the tool collects data, it displays its progress and any errors it detects. When it finishes collecting data, the tool places the data in a .zip file in the current directory. The format of the file's name is support-data-ping-$<hostname>-r-$<timestamp>.zip.
Review any errors that the tool brought up during the collection process, and
any errors that've been added to the
If necessary, resolve the errors and run the tool again.
- Send the support data .zip file to Ping Identity Support.