Support Reports for PCE

To help Illumio troubleshoot issues with your PCE, you can generate support reports to send to Illumio Customer Support. There are two ways to generate support bundles: in the web console or at the command line. The web console is the generally preferable technique.

Note

To generate PCE Support Reports, you must be the Global Organization Owner for your PCE or a member of the Global Administrator role.

To download an already generated support report bundle from the web console, you must be the Global Organization Owner or Global Administrator.

Generate PCE Support Bundle in Web Console

The PCE web console has a Support Bundles page where you can generate PCE support reports. PCE support bundles can also be generated at the command line, but the web console provides a more convenient method which is accessible to more types of users.

Generate a support bundle

Choose Troubleshooting > VEN Support Bundles .
Click the PCE tab and then Generate.
Select optional content as desired.
Click Generate
When the support report is complete, it will be available to download on that page

Up to five previously generated PCE support bundles remain available for download in a list on the PCE Support Bundles tab.

Generate a Report for the last 24 hours

Use the option "all" to get the support report for the last 24 hours from the time the command is run:

sudo -u ilo-pce /opt/illumio-pce/illumio/bin/support_report all wait duration=24

This command gets the support report 3 hours prior to the ending time. In this example, Sept 14, 2018 at 15:40:

sudo -u ilo-pce /opt/illumio-pce/illumio/bin/support_report all wait duration=3 to=09/14/2018T15:40:00

Get all info in the logs

If you are not sure of the time the issue started, run this command instead:

sudo -u ilo-pce /opt/illumio-pce/illumio/bin/support_report all wait

Generate PCE Support Report at Command Line

Use the PCE support_report command-line tool to generate several types of PCE Support Reports:

PCE Support Report: Various diagnostic reports designed to provide Illumio Customer Support with PCE information, such as application logs, process information, and machine statistics.
PCE System Inventory Report: An inventory of the PCE software and all the objects you have created and configured, such as total number of workloads, rules, ruleset scopes, labels, pairing profiles, the number of VENs deployed, OS on deployed VENs, and any modified (non-default) API or object limits.
PCE Host Inventory Report: An inventory of the host, including information such as the number of processors configured on the host and the amount of physical disk space and memory being utilized.
PCE Support Report Search Function: You can search PCE log files by string and by a date range.

The PCE saves the support_report command and its arguments in report_log so that you can see the command that was used to generate the support report.

Support Report Command-line Syntax

To create a Support Report, follows these general steps:

Enter the support_report command with options.
When you include support_report search options (for example, from= and to=, or combinations), enter the support_report list command after entering the search options.

The output is a date-stamped tar file. When the support_report command is finished, it displays the path to the file.

Support Report Option	Description
None	Does a system inventory.
`system`	Generates a node report and inventory report.
`inventory`	Generates an inventory report only.
`list`	Runs the report defined by the latest `support_report` options.
`logs` (+ optional search arguments)	Includes logs and the optional search criteria.
`procs`	Includes process details in the Support Report.
`stats`	Includes statistics in the Support Report.

Run PCE Support or Inventory Report at Command Line

To run the PCE Support Report:

To generate the PCE Support Report to collect inventory, logs, statistics, and processes, run this command:
```
sudo -u ilo-pce /opt/illumio-pce/illumio/bin/support_report inventory system stats procs logs
```

To view options for the Support Report, add the help option:

sudo -u ilo-pce /opt/illumio-pce/illumio/bin/support_report help

To run a PCE inventory report:

Make sure your shell environment is correctly set up by running this command:
```
$ source /opt/illumio-pce/illumio/bin/illumio/scripts/support
```
To run the PCE system inventory report, run this command:
```
sudo -u ilo-pce illumio-pce-env inventory system
```
To run the PCE host inventory report, run this command:
```
sudo -u ilo-pce illumio-pce-env inventory host
```

View Host and System Inventory

You can use the following commands to get a quick source of information for troubleshooting or when working with Illumio Customer Support. Using these commands is a quicker and less detailed alternative to running a PCE support report.

To show host inventory for the "local" node:

$ illumio-pce-env show host-inventory

To show system inventory for the PCE:

$ illumio-pce-env show system-inventory

To show host inventory for all PCE nodes and also the PCE system inventory:

$ illumio-pce-env show inventory

Illumio Core Administration Guide 24.2.20 and 24.2.10