Lesson 1: Starting JReport Enterprise Server

In this lesson, you will learn how to start JReport Enterprise Server, open the JReport Console, run a public report, and learn the other report control commands available from the JReport Console.

Task 1: Start JReport Enterprise Server

The lesson assumes that you have installed JReport Enterprise Server with its default configuration. If you changed the default locations or port numbers using Custom Installation, then you will need to adjust the instructions in this lesson accordingly.

Start JReport Enterprise Server in one of the following ways:

These methods run the JReport Enterprise Server in its default non-logging mode. The JReport Enterprise Server can also be run in logging mode. In this mode, JReport Enterprise Server writes key actions to a log file. This is useful when you encounter problems and need to see the actual SQL calls issued to the DBMS, performance issues when reports are taking too long to run or failures when a report does not run at all. To run with full logging, start JReport Enterprise Server using DJREntServer.bat in <install_root>\bin.

After you issue the command to start JReport Enterprise Server, a command window appears with various startup messages. When you see the message "JReport Enterprise Server is ready for service.", you are ready to proceed to the next task. Do not close the command window.

Task 2: Access the JReport Console page

JReport Console page is an easy-to-use web-based interface of JReport Enterprise Server for selecting, viewing and scheduling report sets. To access the JReport Console page, follow these steps:

  1. Click Start > All Programs > JReport 9.0 > Server > JReport Server Console, or open a web browser and set the URL to http://localhost:8888.

    Internet Explorer and Firefox are browsers that have been certified to work with JReport products. However other browsers should also work fine.

  2. On the Welcome page, click the Login Now button.
  3. In the Connect to localhost dialog, enter admin for the user name and admin for the password.

    These are the initial user credentials built in to JReport Enterprise Server. One of the first things an administrator should do is to set up the correct user credentials so that appropriate report sets can be accessed by each user.

    The console window appears.

  4. By default, the root folder is open when you first log onto the JReport Console page. The User Directory panel is hidden on the left showing the folders of published report sets that are available to this user (admin in our case).
  5. Click Public Reports and then SampleReports. The report set list, along with pertinent information, is displayed.
  6. Click in any of the report set row, right-click in the row and a shortcut menu is then displayed, which contains the following commands:

    Run
    Runs the report set immediately using the default format. The default format is DHMTL.

    Advanced Run
    Runs the report set immediately after collecting additional specifications from you, including which report in the report set to run, what output format to use, which style group to apply, and any encoding options.

    Schedule
    Runs the report set based on a schedule. When you use Schedule to run a report set, the request is placed into a queue and processed in order submitted. The size of the queue and priority of the queue can be configured to make the most efficient use of resources. Lesson 5 describes scheduled report sets.

    Properties
    Does not run the report set, but allows you to define the archive policy, security, and a description associated with the report set. Lesson 6 describes security.

    Version
    Views report set version and scheduled/advanced run result version information.

    Delete
    Deletes the report set.

Lesson 1 summary

This lesson introduced the JReport Enterprise Server and its web-based interface, JReport Console page. JReport Console page provides an intuitive way for end users to access the report sets they need, run them on-demand or on a schedule, apply a different look and feel, and change the format in which they are output.