Skip to main content
Pentaho Documentation

Diagnosis Tips

Overview

To help you maintain the health of your Pentaho system, we provide tips to help you diagnose processing errors and monitor the Pentaho Server performance.

To help you maintain the health of your Pentaho system, we provide tips to help you diagnose processing errors and monitor the Pentaho Server performance.

Disable Server and Session-Related Timeouts to Debug

Follow the instructions below to disable server and session timeouts associated with the User Console.

These instructions are applicable when you are in a test environment. Once you go live, we recommend you set your timeouts to five or ten minutes so that sensitive Pentaho Server-related data can be protected. The time must be expressed in minutes.

  1. Open the server.xml file located under pentaho-server/tomcat/conf.

  2. Find the connectionTimeout="20000" parameter and change its value to zero ("0"). If this value is set to a negative number it will never timeout.
  3. Open the web.xml file, located under pentaho-server/tomcat/webapps/pentaho/WEB-INF/web.xml.
  4. Find the session-timeout parameter and change its value to negative one ("-1").
  5. Save the file and refresh the user console.

Define Result Row Limit and Timeout

When a query in the User Console returns an unusually large number of rows, this may impact server performance. To limit the number of rows returned by a query and to set up a timeout, you must create two custom properties, max_rows and timeout, in the Metadata Editor.

The values you define for the row number limit (max-rows) and timeout properties are passed to the JDBC driver.

To define max rows and timeout:

  1. In the Metadata Editor, expand the Business Model node and select Orders.
  2. Right-click Orders and choose Edit. The Business Model Properties page displays a list of properties that were previously defined.
  3. In the Business Model Properties page, click the Add icon. The Add New Property page dialog box appears.
  4. Enable Add a custom property.
  5. In the ID text box, type max_rows. IMPORTANT: The ID is case-sensitive and must be typed exactly as shown.
  6. Click the down-arrow in the Type field and choose, Numeric. The Business Model Properties page appears. The max_rows property is listed under Custom in the navigation tree.
  7. In the right pane, under Custom, enter a value for your max_rows property. For example, if you enter "3000" as your value, the number of rows allowed to display in a query result is constrained to 3,000.
  8. Repeat steps 3 through 6 to for the timeout custom property.
  9. In the right pane, under Custom, enter a value for your timeout property. The timeout property requires a numeric value defined in number of seconds. For example, if you enter, 3600, the limit for query results is one minute.
  10. Click OK in the Business Model Properties page to save your newly created properties.