How do I Configure J2EE Clusters Using Server Administration Service?

To configure a J2EE Server Cluster using the Server Administration Service:

Start the Administration Service.
Click the J2EE Server Cluster option in the Explore panel. This displays Step 1 of 3: Add Cluster in the Display panel. Provide details for the following fields:

Table 1: Step 1 of adding a J2EE Cluster

Fields Options Description

Name - Specify the name of the new cluster. Say, Test. This is a mandatory field.

EJB Cluster - The EJB Cluster is shown selected by default.

Web Cluster - Select whether you want this to be a Web cluster using the ‘Yes’ or ‘No’ options.

Database - The database stores the cluster configuration details. In this section, specify the following mandatory details:

- URL Specify here the URL of the database. Say, jdbc:oracle:thin:@db1.pramati.com:1521:db1. This is a mandatory field.

- Driver Specify the database driver name. This driver interfaces between the J2EE server and the database. Say, oracle.jdbc.driver.OracleDriver. This is a mandatory field. The driver jars are not picked up from a common location, but are taken from the path specified in the input box. In case the user does not specify the path, the server attempts to pick them up from the /lib/ext directory under the server installation directory, or from the system classpath.

- Username Specify the username used to connect to the database. For example, for an Oracle database, the username can be scott. This is a mandatory field.

- Password Specify the associated password used to connect to the database. For example, for an Oracle database, the password can be tiger. This is a mandatory field.

- Table Provide a table name for the database, say emp. This is a mandatory field.

- Override You can override previous cluster's data in this table by selecting 'yes'. You cannot override a table which is not present in a Pramati cluster table.

Click Next>> Step 2 of 3: Add Nodes page appears.

Table 2: Step 2 of adding a J2EE Cluster

Fields Description

EJB, Web Specify the type of the node. This can be EJB or Web. You can also select both the types.

Name Specify the name of the node. Say, MyNode.

Host name Specify the host name or IP address of the machine on which the node will run. Say, localhost.

Lookup port Specify the Lookup port on which the Naming service should start. Say, 9191.

HTTP port Specify the HTTP port on which the Web container will start. This is valid only when you specify the node type as Web or Both. Say, 8181.

HTTPS port Specify the secure communication port (HTTPS) on which you want the Web container to start. This is valid only when you specify the node type as Web or BOTH. You can enable or disable this port.

To add more than one node, provide similar details in the fields provided. You can also enable or disable the EJB timer service. By default it is disabled. When it is disabled, EJBs implemeting javax.ejb.TimedObject cannot be deployed on the Server. If the timer service is enabled, enter the timer persistence details. This is needed for the timer to survive container crashes.

Enter the datasource name to be used to persist the timer. The datasource is automatically created on the nodes in the cluster. Refer the section on Creating a Datasource.

The timer persistence table name has also to be given. The table would be created by the Server. Click Next. A successful node addition displays 'New Cluster Test created successfully.' in the Status panel.

The third step is to set the Session properties in case a failover happens. In the new page, you can:

Replicate data on all the nodes of the cluster, or
Maintain a backup on selected nodes of the cluster

Click Save to return to the Administration Service main page. The new cluster is seen listed here.

Related Topics:

Fields	Options	Description

Name	-	Specify the name of the new cluster. Say, Test. This is a mandatory field.
EJB Cluster	-	The EJB Cluster is shown selected by default.
Web Cluster	-	Select whether you want this to be a Web cluster using the ‘Yes’ or ‘No’ options.
Database	-	The database stores the cluster configuration details. In this section, specify the following mandatory details:
-	URL	Specify here the URL of the database. Say, `jdbc:oracle:thin:@db1.pramati.com:1521:db1`. This is a mandatory field.
-	Driver	Specify the database driver name. This driver interfaces between the J2EE server and the database. Say, `oracle.jdbc.driver.OracleDriver`. This is a mandatory field. The driver jars are not picked up from a common location, but are taken from the path specified in the input box. In case the user does not specify the path, the server attempts to pick them up from the /lib/ext directory under the server installation directory, or from the system classpath.
-	Username	Specify the username used to connect to the database. For example, for an Oracle database, the username can be scott. This is a mandatory field.
-	Password	Specify the associated password used to connect to the database. For example, for an Oracle database, the password can be tiger. This is a mandatory field.
-	Table	Provide a table name for the database, say emp. This is a mandatory field.
-	Override	You can override previous cluster's data in this table by selecting 'yes'. You cannot override a table which is not present in a Pramati cluster table.

Fields	Description

EJB, Web	Specify the type of the node. This can be EJB or Web. You can also select both the types.
Name	Specify the name of the node. Say, MyNode.
Host name	Specify the host name or IP address of the machine on which the node will run. Say, localhost.
Lookup port	Specify the Lookup port on which the Naming service should start. Say, 9191.
HTTP port	Specify the HTTP port on which the Web container will start. This is valid only when you specify the node type as Web or Both. Say, 8181.
HTTPS port	Specify the secure communication port (HTTPS) on which you want the Web container to start. This is valid only when you specify the node type as Web or BOTH. You can enable or disable this port.


© Pramati Technologies 2007	Runs on Pramati Server \| Feedback \| Legal