#### Service tab

This tab allows you to configure the service settings of JReport Enterprise Server. See the tab.

The following are the options available in the Service tab:

Port

Specifies a port as the TCP port on which JReport Enterprise Server listens.

When you start JReport Enterprise Server, you will need to specify a port as the TCP port on which the server listens. The port can be an integer between 1 and 65535. However, numbers less than 1024 are usually reserved by system, and so numbers larger than 1024 are preferred. JReport Enterprise Server uses 8888 as the default port.

Administration Port

Specifies the port used for remote administration. If JReport Enterprise Server is running as a standalone web server, the administrator can specify the port for client users to configure and administer the server remotely. This port is where the servlet for remote administration (`jet.server.servlets.RcServlet`) listens. The default administration port is 8889.

Maximum Number of Handlers

Specifies the maximum number of connection handlers.

A connection is set up between the server-side and a client-side when a request from the client-side reaches the server. The maximum number of requests that can be handled depends on the maximum number of handlers. When there is a limit on the maximum number of connection handlers, if there are no free connection handlers available, a request from the client-side will be blocked. In which case, the request will either be handled after a connection handler has been set free, or be refused when timeout occurs. A connection handler is set free after the server sends a response to a client request.

Maximum Number of Connections

Specifies the maximum number of HTTP connections between the server-side and client-side.

The maximum number of connections depends on the number of requests that can be handled. It should be larger than the maximum number of handlers. For example, if the maximum number of handlers is 10, and the maximum number of connections is 12, when the eleventh and twelfth requests come, they will be blocked until a handler has been set free. When the thirteenth request comes, it will be refused.

Connection Timeout in _ Milliseconds

Specifies the maximum time in milliseconds for a request from a client-side to be blocked before being refused by the server. A request will be blocked if there are no free connection handlers in the server. However, it cannot be blocked forever, and if there are still no free connection handlers after the time specified here (in milliseconds), then the request will be refused back to the client.

Enable Secure Socket Layer Connection

If enabled, you can use HTTPS schema to visit JReport Enterprise Server UI in the standalone mode.

- Secure Port
  The port used for visiting JReport Console page via HTTPS schema. It should be different from the Port for HTTP schema.
- Secure Administration Port
  The port used for visiting JReport Administration page via HTTPS schema. It should be different from the Administration Port for HTTP schema.
- Keystore File Path
  The location of your trusted keystore file.
- Keystore Password
  The password used to protect the integrity of the keystore.
- Keystore Type
  The type of keystore to be instantiated. The valid values are JKS and PKCS12.
- Keystore Protocol
  The encryption/decryption protocol to be used on the socket. The valid values are SSL and TLS.
- Keystore Algorithm
  The X509 algorithm to use. This defaults to the Sun implementation (SunX509). For IBM JVMs you should use IbmX509.

Servlet Properties File Name

Displays the full path of the property file of the servlet jet.server.servlet.JRServlet.

Assuming that JReport Enterprise Server has been installed to `C:\JReport\Server`, the servlet property file is `C:\JReport\Server\bin\servlet.properties`.

Active Realm

Specifies the realm that will take effect when the server starts up.

A realm is the context of JReport Enterprise Server where the entities reside. A user is a kind of entity that is contained in a realm. Different users in one realm must have different names. There can be multiple realms in the server, but only one is active at runtime. Only the users and resources in the active realm are accessible. Realm names cannot contain the "/" or "\" character.

Provide Service On

Specifies whether JReport Enterprise Server listens on all network addresses or just some.

- All Network Addresses
  If checked, JReport Enterprise Server listens on all network addresses, which means that all the hosts of the machine are active, and the client-end can connect with any of the hosts of this server.
- Network Address At
  If checked, JReport Enterprise Server listens on the specified hosts, and you can specify them by inputting the host names or IP addresses.

Notes:

- The machine that JReport Enterprise Server runs on can be multi-homed (for example, two interface cards have been installed on the machine), if there is more than one IP address. JReport Enterprise Server opens the listening port at host name 'localhost' or at IP address '127.0.0.1' automatically.
- When Network Address At is checked, if you want to specify all the host addresses to be active, input * into this field; if you want to specify more than one address to be active, you should separate them using a blank, for example, "leo 204.177.148.110".

Active Host Address

Lists the current active host' address.

Save

Applies changes to JReport Enterprise Server.