Example 2: Setting Up a Logi JReport Server Cluster for a Production Environment
This topic demonstrates how to set up a Logi JReport Server Cluster on Unix by configuring the Cluster UI on each Logi JReport Server. There will be three computers in the cluster. They are node1 (IP address: 192.168.0.1), node2 (IP address: 192.168.0.2) and node3 (IP address: 192.168.0.3). All Logi JReport Servers in the cluster use Apache Derby as the server system database.
Take the following steps to set up the cluster:
- Make the time difference between the target computers be within one minute.
- Install Logi JReport Server on each of the three nodes in directories
/home/JReport/Server1
,/home/JReport/Server2
and/home/JReport/Server3
respectively using the appropriate license key for the cluster, and install Logi JReport Server Monitor on one of the nodes. - Launch the Logi JReport Server installed to
/home/JReport/Server1
on node1. - Log onto its server console, point to Administration on the system toolbar, select Configuration > Cluster > Configuration from the drop-down menu.
- In the Configuration page, specify a cluster name and check the Enable Cluster option, then select Save to enable the cluster.
- Restart the Logi JReport Server on node1, and go to the Administration > Configuration > Cluster > Configuration page again.
- Leave the Load Balancer Type as Round Robin.
- Check the Cluster Scheduler Lease option to enable scheduler leases for the cluster, then set the active count, valid time and check interval for the cluster scheduler lease respectively. The defaults of 2 active schedules with a time of 300 seconds and check interval of 30 seconds are a good starting point.
- Keep the cluster storage history, realm and CRD result number of copies to 2. This means that each resource will be copied to 2 of the 3 servers so there will be no single point of failure for the resources.
- Keep the default value 2 for Cluster Memory Storage Number of Copies, thus 2 memory copies will be shared in the cluster.
- Check the Notify via E-mail When a Server Is Down option, and in the E-mail Address text box, input the e-mail addresses of the people to whom you want to send a notification e-mail.
- Keep the default values for Properties Directory, Realm Directory, Resource Root, History Directory and Temporary Files Directory.
- In the Server's RMI Host text box, type the IP address or host name of Server1 as 192.168.0.1. Type the port number in the Server's RMI Port text box as 1129.
- Select Save to accept all the changes.
- Select Administration > Configuration > Server DB > System DB to open the System DB page of Server1, then in the Configuration tab, copy the URL in the URL text box to a temporary file. Go to the Realm DB page to copy the URL using the same way.
In order to use a Logi JReport Server Cluster, all nodes in the cluster must use the same database. In this case, all three nodes will use the database Server1 uses. This ensures that all servers in the cluster share a single DBMS instance.
- Shut down the server.
- Launch the Logi JReport Server installed to
/home/JReport/Server2
on node2. - Log onto its use console and access the Administration > Configuration > Cluster > Configuration page.
- In the Configuration page, use the same cluster name as Server1, thus making Server2 join the existing cluster. Check the Enable Cluster option, then select Save to enable the cluster.
- Restart the Logi JReport Server on node2 and log onto its server console again.
- Go to the Administration > Configuration > Server DB > System DB/Realm DB page, make the system database and realm database in the URL text box the same as those of node1.
- Go to the Administration > Configuration > Cluster > Configuration page again.
- In the Server's RMI Host text box, type the IP address or host name of Server2 as 192.168.0.2. Type the port number in the Server's RMI Port text box as 1129.
- Select Save to accept all the changes, then shut down the server.
- Copy rmi.auth in
/home/JReport/Server1/bin
to/home/JReport/Server2/bin
. This allows RMI to be authorized between node1 and node2. - Launch the Logi JReport Server installed to
/home/JReport/Server3
on node3. Just like what we did with node2, enable cluster and make node3 join the existing cluster too. - Restart the Logi JReport Server on node3 and log onto its server console again.
- Go to the Administration > Configuration > Server DB > System DB/Realm DB page, make the system database and realm database in the URL text box the same as those of node1.
- Go to the Administration > Configuration > Cluster > Configuration page.
- In the Server's RMI Host text box, type the IP address or host name of Server3 as 192.168.0.3. Type the port number in the Server's RMI Port text box as 1129.
- Select Save to accept all the changes, then shut down the server.
- Just as we did with node2, copy rmi.auth in
/home/JReport/Server1/bin
to/home/JReport/Server3/bin
. - Start the server Derby DBMS service by running the startNetworkServer.sh file in
/home/JReport/Server1/derby/bin
. - Launch the server on node1. In the Command Prompt window, you will see the following information:
Logi JReport Server is ready for service.
- Similarly, launch the server on node2 and node3.