# Pentaho Support {% hint style="info" %} {% endhint %} Take a look at the Welcome Letter .. {% file src="/files/1sWSBeqdmHWHV7tNPdlw" %} Support Onboarding .. {% embed url="" %} Support Onboarding {% endembed %} {% tabs %} {% tab title="Tips for Submitting a Support Ticket" %} {% hint style="info" %} In order to assist us in addressing your inquiry or concern promptly and effectively, please be prepared to provide the following information: {% endhint %} {% stepper %} {% step %} **Explore Pentaho Documentation & Academy** Great resources with an AI assistent to help locate the information: [Pentaho Product Documentation](https://docs.pentaho.com/) [Pentaho Academy](https://academy.pentaho.com/) {% endstep %} {% step %} **What information is required?** If **asking a question**, please provide: * A description of what you are trying to achieve. * Configuration details regarding the Pentaho Suite and the affected environment/version. * If applicable, outline the steps you have already taken to either: * Consult support articles or the [Pentaho Product Documentation](https://docs.pentaho.com/) - please provide the exact URL. * Attempt to replicate the scenario. If **reporting an issue** with the product, in addition to the above, please provide: * Symptoms experienced and, if applicable, the exact error message(s). * Log files or other supporting documentation - For Pentaho, we recommend utilizing our [Support Utility](https://support.pentaho.com/hc/en-us/articles/360021624372-How-to-Install-and-Use-Pentaho-Support-Utility). * What changes have occurred that may have led to this condition? * Does the condition occur intermittently or every time a specific action is executed? * When did the condition first manifest? * If applicable, what steps have you taken to isolate and/or resolve the issue? What were the outcomes? * Impact on your business operations. {% endstep %} {% step %} **A screenshot or video can be worth a thousand words…** While detailed descriptions are incredibly useful for troubleshooting or addressing your question, a screenshot or video can be even more effective in helping us understand or replicate your issue. {% endstep %} {% endstepper %} {% endtab %} {% tab title="Pentaho Support Utility" %} {% hint style="info" %} The Pentaho Support Utility collects environment and configuration details into a single zip file that you can attach to your support ticket. This gives the support team immediate access to the background information they need to diagnose and resolve your issue, reducing back-and-forth requests for additional files and minimizing the time you spend gathering data. The utility is supported on Pentaho versions 7.x, 8.x, 9.x, and 10.x. For a complete list of supported software and hardware, refer to the Components Reference in Pentaho Documentation. Three tools are available for running the utility: **Pentaho Server Plugin**: provides a UI within the Pentaho Server to gather information from the currently running server instance. **Pentaho Data Integration Plugin**: operates within Spoon to collect details from your PDI environment. **Command Line Utility**: offers a standalone option for gathering information from either the Pentaho Server or PDI without requiring a running application. The server and PDI plugins are the preferred methods for running the utility. Use the command line tool only when Pentaho fails to start or when organizational policies prohibit plugin installation. If any individual collector fails during execution, the remaining collectors will continue to run and the resulting report will still provide value to the support team. You can identify failed collectors by reviewing the utility logs or checking for .failed files within the output zip. Some collected files and configuration details may contain passwords. While the utility attempts to remove all passwords during collection, Pentaho cannot guarantee complete removal in every case - particularly for files such as kettle.properties. {% endhint %} 1. Download the Pentaho Support Utility. {% embed url="" %}

Support Utilities

2. Select Pentaho Product: {% tabs %} {% tab title="Pentaho Server" %} {% hint style="info" %} {% endhint %} **To install the Pentaho Server Plugin:** 1. Download: `pentaho-support-utility-server-plugin.zip` file. 2. Unzip this file to: `pentaho-server/pentaho-solutions/system`. ```bash cd cd ~/Downloads/'Support Utility'/ unzip pentaho-support-utility-server-plugin-1.0.1.zip -d /opt/pentaho/server/pentaho-server/pentaho-solutions/system ``` {% hint style="info" %} If needed, configure the [password removal regular expression](https://support.pentaho.com/hc/en-us/articles/360021624372-How-to-Install-and-Use-Pentaho-Support-Utility#PRCF). {% endhint %} 3. Restart the Pentaho Server. ```sh cd cd /opt/pentaho/server/pentaho-server ./stop-pentaho.sh ``` ```sh cd cd /opt/pentaho/server/pentaho-server ./start-pentaho.sh ``` 4. x x {% endtab %} {% tab title="Pentaho Data Integration" %} {% hint style="info" %} {% endhint %} x x x {% endtab %} {% tab title="Command Line" %} {% hint style="info" %} {% endhint %} x x x x {% endtab %} {% endtabs %} {% endtab %} {% endtabs %} x --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://academy.pentaho.com/pentaho-10-installation/overview/pentaho-support.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.