# 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.5 Update 2 shortcut on your desktop.
- Click Start > All Programs > JReport 13.5 Update 2 > Start 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. 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.5 Update 2 > System Admin, 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.

Tip: If you don't know the IP address of the machine on which the server runs, and if it is the same machine where you run JReport Server, you can use localhost instead of the IP address. You can also open a console window such as telnet on the server machine and type hostname, then the name of the host 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:

- Creating dashboards, reports and Visual Analysis
- Viewing the JReport sample reports
- Scheduling to run reports by time or event
- Managing security principals
- Configuring server profiles to customize the server interface and functionality
- Viewing the product demos

To access the launch pad, click Start > All Programs > JReport 13.5 Update 2 > 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.

Note: If all normal user sessions have been used up, a request from a client viewer will be denied permission to log onto JReport Server. Only a normal user session can use a client viewer to log onto JReport Server, not the extra user session.

## 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.5 Update 2 > Stop 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.

Notes:

- JReport does not provide a keystore file since Jinfonet is not a trusted certificate authority and just provides a Keystore File Path option for you to configure the location of your trusted keystore file. There are many trusted authorities that can provide keystore files. Here is an example of creating a keystore file: http://docs.oracle.com/cd/E19509-01/820-3503/ggsxx/index.html.
- JReport Server Monitor does not support SSL.