Accessing JReport Server

You can access JReport Server through a web browser such as Internet Explorer, Firefox, or Google Chrome.

Starting and logging onto JReport Server

To log onto JReport Server, first start the server via one of the following ways:

• Double-click the JReport Server 13 Update 1 shortcut on your desktop.
• Click Start > All Programs > JReport 13 Update 1 > Server > Start JReport Server.
• Run the JRServer.bat/JRServer.sh file located in <install_root>\bin.
• Run the startup file from a command prompt or shell. For example, assume that JReport Server has been installed in C:\JReport\Server on Windows or /opt/JReport/Server on Linux, you can type the following commands:

  C:\>cd JReport\Server\bin
C:\JReport\Server\bin>JRServer.bat

  $cd /opt/JReport/Server/bin
$./JRServer.sh

Then,

• To access the JReport Console page:
  1. Click Start > All Programs > JReport 13 Update 1 > Server > JReport Server Console, or open a web browser and set the URL to http://ip_or_hostname:port (by default, the port for accessing the JReport Console page is 8888).
  2. On the welcome page, type your user name and password as assigned by your administrator. For first time users, the default user name and password are admin.
  3. Click Login and the JReport Console page will be displayed.
• To access the JReport Administration page:
  1. Click Start > All Programs > JReport 13 Update 1 > Server > JReport Server Administration, or open a web browser and set the URL to http://ip_or_hostname:port (by default, the port for accessing the JReport Administration page is 8889).
  2. In the Sign in dialog, type your user name and password as assigned by the administrator. For first time users, the default user name and password are admin.
  3. Click Login and the JReport Administration page will be displayed.

Fast launch pad for local users

Local users can also access JReport Server in a fast way with the launch pad, which is a convenient entry to access the server without having to start it. The launch pad provides some key functions of JReport Server by setting up the connections to corresponding JReport Server JSPs, which are:

• Viewing the JReport sample reports
• Creating new reports
• Scheduling to run reports by time or event
• Configuring server profiles to customize the server interface and functionality
• Managing security principals
• Visiting the JReport Demo Center

To access the launch pad, click Start > All Programs > JReport 13 Update 1 > Server > JReport Server Launch Pad.

Additional login channel for admin users

JReport Server provides a special channel that automatically creates an extra user session for management purposes if the license limit of the maximum number of concurrent users has been reached. The extra user session cannot be used to run reports or submit schedules. It can only be used by admin users for performing management operations. If your JReport Server license has a bounded limit to the maximum number of concurrent users, this feature will take effect.

Only one extra valid user session can be created and used within this special channel at any time. If an extra user session has already been created and it is still valid, your request for login will be prompted with a confirmation page asking you whether or not to close the existing extra user session. If you select Yes, a new extra user session will be created for you to perform management operations. Otherwise, you will not be allowed to log onto JReport Server.

Logging off and shutting down JReport Server

To log off JReport Server, click the Logout link on the upper right corner of the JReport Administration/Console page.

To shut down JReport Server normally:

• In a standalone environment, click the Shut Down the Server button on the JReport Administration page, or click Start > All Programs > JReport 13 Update 1 > Server > Stop JReport Server.
• In an integrated environment, shut down the application server according to the vendor's instructions.

Also, JReport provides a feature for handling an abnormal system exit that enables the program to close itself gracefully when the Java virtual machine (JVM) is terminated in response to a user interrupt, such as typing ^C, or a system-wide event such as user logoff or system shutdown.

SSL in standalone JReport Server

JReport Server supports HTTPS requests in standalone mode. Secure ports for HTTPS requests should use different ports from non-secure ports for HTTP requests. By default, port 6888 and 6889 are set as the secure ports separately for accessing JReport Console UI and JReport Administration UI. The URL for visiting JReport Server via HTTPS schema is like this:

https://IP_address or localhost:6888

SSL support is disabled by default. You need to enable it and configure corresponding settings in order to use HTTPS schema to visit JReport Server UI. This can be done either on the JReport Administration page or in the server.properties file located in the <install_root>\bin directory.

To enable SSL function via the administration UI:

1. Log onto the JReport Administration page. The default port is 8889.
2. Click Configuration on the system toolbar, and then select Service from the drop-down menu.
3. Check the Enable Secure Socket Layer Connection option.
4. Make sure that Secure Port and Secure Administration Port use different port numbers from Port and Administration Port.
5. Specify the other settings about Keystore.
6. Click Save.
7. Restart JReport Server in order for the settings to take effect.

To enable SSL function in the server.properties file:

1. Open the server.properties file located in the <install_root>\bin directory.
2. Set httpserver.ssl.enable to true.
3. Set the other properties starting with httpserver.ssl to meet your requirements.
4. Save the server.properties file.
5. Restart JReport Server in order for the settings to take effect.