Skip to main content
Hitachi Vantara Lumada and Pentaho Documentation

Tour the Pentaho User Console


Familiarize yourself with the different pages and controls of User Console with this tour.

If you use file management tools or any web browser, you should feel right at home with the User Console. To familiarize yourself with the different pages and controls of User Console, let us take you through a quick tour.

Login to the User Console

Follow these steps to login to the User Console:

  1. Launch a Web browser and enter the URL of the Pentaho server. The page loads an introductory screen with a Login section.
  2. Enter your user name and password and click Login.


    You are now logged into the User Console and ready to start creating and running reports and dashboards.


The first thing you see after you log into the User Console is the Home page, which serves as the portal for you to access Pentaho tools and features. Home contains easy access buttons so that you can Browse Files, Create New reports and dashboards, view Pentaho Documentation, and quickly open recently viewed or favorite files.



Item Name Function
File:Documentation/5.4/0L0/120/010/grCallout1.png Home indicator Indicates the current User Console perspective that you are using. The Home menu lets you flip easily from page to page, or return to your Home page.
File:Documentation/5.4/0L0/120/010/grCallout2.png Getting Started Displays some resources to help you get familiar with the User Console. The Welcome tab shows an introductory video about Pentaho products. The Samples tab holds a variety of small sample reports and dashboards that you can use to get familiar with the software. The Tutorials tab contains a number of tutorial videos that give you a visual guide to the software.
File:Documentation/5.4/0L0/120/010/grCallout3.png Current User Shows the name of the person currently logged in to the User Console. Clicking the arrow next to the name lets you log out of the User Console.
File:Documentation/5.4/0L0/120/010/grCallout4.png Browse Files Brings you to the Browse Files window, where you can locate your files using the Browsing and Files panes, and manage them using the Actions pane.
File:Documentation/5.4/0L0/120/010/grCallout5.png Create New Gives you the option to create a new Interactive Report, Analyzer Report, or Dashboard. If you have permissions to work with Data Sources, this button also gives you the option to create a new Data Source.
File:Documentation/5.4/0L0/120/010/grCallout6.png Documentation - documentation for Pentaho products.
File:Documentation/5.4/0L0/120/010/grCallout7.png Recents Shows a list of your most recently opened files. Clicking on the star next to a recently opened file adds it to your Favorites list.
File:Documentation/5.4/0L0/120/010/grCallout8.png Favorites Shows a list of your favorite files for quick access.

Browse Files

The Browse Files page helps you keep your files and folders organized and makes them easier for you to find and work with.


Item Name Function
File:/grCallout1.png Browse Files indicator Indicates the current User Console perspective that you are using. Browse Files shows you how to locate your files and folders and the different actions you can do with them.

Displays a series of three panes: the Browsing, Files, and Actions panes.

File:/grCallout2.png Folders Shows a list of folders that you can browse through to locate your files.

You can also use the Browsing pane to create new folders or delete old ones.

After you select something in the Browsing pane, the Actions pane populates with a list of things you can do with the folders.

File:/grCallout3.png Files Generates and shows a list of all files contained in the folder that is selected in the Browsing pane.

After you select a file, the Actions pane populates with a list of things you can do with the file.

File:/grCallout4.png File Actions

Shows a list of different things that you can do with the selected folder or file.

The Actions pane gives you the ability to:
  • Quickly open files in the current window or in a new one
  • Run files in the background
  • Edit, delete, cut, copy, or paste files or folders
  • Share files with others
  • Schedule reports to run automatically
  • Add files to your Favorites widget
  • View the Properties of a file or folder


The Opened page activates after you open a file from the Browse Files page and provides a simple space to work with your files.


Item Name Function
File:/grCallout1.png Opened indicator


New Interactive, Analyzer, Dashboard, or Data Source

Indicates the current User Console perspective that you are using. Opened displays the files that you access from the Browse Files pane.
  • Open... serves as a quick way to browse for more files to open without leaving the Opened page. These additional files open in new tabs across the Report Window.
  • Quick start buttons to create a new Interactive or Analyzer, Dashboards. You can also use this button to create a new Data Source, if you have permissions to work with data sources.
File:/grCallout2.png Edit, Save, and Save As Gives you the ability to perform these functions on the active file in the Report Window: edit, save the file with a default name in the same location, or save the file with a different name and in any location on the repository or your desktop
File:/grCallout3.png Report Window Displays the file or report that is currently opened, and lets you edit or work with the file.


You can schedule reports to run automatically. All of your active scheduled reports appear in the list of schedules, which you can get to by clicking the Home drop-down menu, then the Schedules link, in the upper-left corner of the User Console page. You can also access the list of schedules from the Browse Files page, if you have a report selected.

The list of schedules shows which reports are scheduled to run, the recurrence pattern for the schedule, when it was last run, when it is set to run again, and the current state of the schedule.


Item Name Function
File:/grCallout1.png Schedules indicator Indicates the current User Console perspective that you are using. Schedules displays a list of schedules that you create, a toolbar to work with your schedules, and a list of times that your schedules are blocked from running.
File:/grCallout2.png Schedule Name Lists your schedules by the name you assign to them. Click the arrow next to Schedule Name to sort schedules alphabetically in ascending or descending order.
File:/grCallout3.png Repeats Describes how often the schedule is set to run.
File:/grCallout4.png Source File Displays the name of the file associated with the schedule.
File:/grCallout5.png Output Location Shows the location that the scheduled report is saved.
File:/grCallout6.png Last Run Shows the last time and date when the schedule was run.
File:/grCallout7.png Next Run Shows the next time and date when the schedule will run again.
File:/grCallout8.png Status Indicates the current Status of the schedule. The state can be either Normal or Paused.
File:/grCallout9.png Blockout Times Lists the times that all schedules are blocked from running.

You can edit and maintain each of your schedules by using the controls above the schedules list, on the right end of the toolbar.

Icon Name Function
File:/sspucRefreshIcon.png Refresh Refreshes the list of schedules.
File:/sspucRunNowIcon.png Run Now Runs a selected schedule(s) at will.
File:/sspucStopScheduleIcon.png Stop Scheduled Task Pauses a specified schedule. Use Start Schedule to start paused jobs.
File:/sspucStartScheduleIcon.png Start Scheduled Task Resumes a previously stopped schedule.
  Edit Scheduled Task Edits the details of an existing schedule.
File:/sspucRemoveScheduleIcon.png Remove Scheduled Task Deletes a specified schedule. If the schedule is currently running, it continues to run, but it will not run again.


The User Console has two themes built in, called Crystal and Onyx. The default display shows the Crystal theme, but if you prefer, you can change the theme so the console displays the Onyx theme.

  1. From any page of the User Console, click View in the upper-left menu bar.
  2. Select Themes, then Onyx, from the drop-down menu.


    The Home page refreshes and appears with the Onyx theme.


The User Console has three main tools. This table helps you decide what tools best fit for your needs and provides links to the corresponding articles.

Explore Considerations Choose Options
Interactive Reports Analyzer Reports Dashboard Designer
Summary Interactive Reports is a web-based design interface which is used to create both simple and on-demand operational reports without depending on IT or report developers. Analyzer Reports is an analytical visualization tool that filters and drills down into business information contained in Pentaho Analysis data sources. Dashboard Designer allows users to create dashboards with little or no training. The dashboard is several different reports brought together inside one screen.
Expertise Basic computer skills and knowledge of web browsers. Basic computer skills, knowledge of web browsers, familiarity with data structures. Basic computer skills and knowledge of web browsers.
Time Approximately 30 minutes. Approximately 30 to 60 minutes. Approximately 30 minutes.

Use Interactive Reports to create operational or financial reports, create reports that provide you with significant control over formatting elements such as fonts, background color, and column widths and sorting.

Use Analyzer Reports to perform advanced sorting and filtering of your data, create drill through reports to access underlying data, view chart visualizations, or to analyze business data quickly in a dynamic environment.

Use Dashboard Designer if you want to create an interface to view multiple reports at once, view charts and graphs within one space while you create reports in another, and have quick access to web pages that you visit often.