### Cluster dialog

To access the Cluster dialog, click Cluster on the system toolbar of the JReport Administration page. The Cluster dialog is only available when your JReport Enterprise Server license permits the cluster feature.

There are three tabs in this dialog as listed below:

- Config tab
- Weight tab
- Admin tab

#### Config tab

Use this tab to configure the servers in a cluster. See the tab.

New Server

Click to add a new server to the cluster.

Predefined server list

Lists the relevant information of the clustered servers.

- Server Name
  Displays the name of the server.
- Host Address
  Displays the host address of the server.
- RMI Port
  Displays the RMI port of the server.
- Backup Priority
  Displays the backup priority of the server.
- Control
  Controls the server. You can click the Delete link in the column to delete a specified server from the cluster.

Notes:

- The backup priority for each backup server cannot be the same, but can be left empty. The default priority for the admin server is 0, which is the highest level of priority in the cluster.
- When you add a new server, if the server is a backup server, you must specify a backup priority for it, otherwise it will be considered as a slave server and will never be promoted to be the admin server.
- When you add a new server, if the server is a slave server, leave the backup priority field empty. Specifying a backup priority for a slave server makes no sense to the cluster and will take no effect.
- The name of the server you are adding does not necessarily need to be the same as the computer name from where the server runs.

#### Weight tab

Use this tab to configure the performance weight on the admin server. See the tab.

Catalog

Specifies the catalog that will be used for performance weight testing.

Report Set

Specifies the report set that will be used for performance weight testing.

Clustered Server Name

Displays the name of the clustered server.

Admin Server

Specifies whether the clustered server is the admin server or not.

Performance Weight

If you have chosen the Least Weighted Current Report Sets (Weighted Min-load) (loadbalance.type=2 in the server.properties file) algorithm for load balancing, you will have to configure a performance weight for each clustered server on the admin server. See Configuring performance weight for how to set performance weight and how this algorithm works.

Performance weight is a positive float number. The higher performance weight you set to a clustered server, the higher chance it may get selected by the admin server during load balancing.

Test

Calculate each clustered server's performance weight value at current time.

OK

Applies the settings.

Cancel

Cancels the settings.

Help

Displays this help document.

#### Admin tab

Use this tab to administrate the servers in a cluster. See the tab.

Shut Down Server

Specifies the server you want to shut down from the drop-down list.

Shut Down

Shuts down the specified server.

Enable notification after a server has been shut down

Specifies to send a notification mail after a server is shut down.

- E-mail Address
  Specifies the e-mail address to which the notification will be sent after a server is shut down.

Note: This feature only applies to the JReport Enterprise Server Cluster environment due to requiring at least one running server to send the mail when the other server is shut down.

OK

Applies the settings.

Cancel

Cancels the settings.

Help

Displays this help document.

###### Related topics:

- Setting up a JReport Enterprise Server cluster