Jolt

[Attributes and Console Screen Reference for Jolt]

Jolt is a Java-based client API that manages requests to BEA Tuxedo services via a Jolt Service Listener (JSL) running on the Tuxedo server. The Jolt API is embedded within the WebLogic API, and is accessible from a servlet or any other BEA WebLogic application. The Jolt Java client class library can be used in HTTP servlets running in WebLogic Server and provides an interface between HTML browser clients and BEA Tuxedo services.

 

---

Configuring Jolt for WebLogic Server

The following sections provide information on how to configure WebLogic Server to interoperate with Tuxedo using Jolt. Consult your BEA Product Documentation for detailed information on how to configure and use Jolt.

 

Set Your Environment

You must update your CLASSPATH environment variable used by your WebLogic Server and command-line shells to include the following files from your Tuxedo installation:

• jolt.jar
• joltjse.jar
• joltwls.jar

 

Create a Jolt Startup & Shutdown Class

You must create a Startup and a Shutdown class to establish and terminate the connection between Tuxedo and WebLogic Server. WebLogic Server uses the PoolManagerStartUp class to establish a connection to Tuxedo whenever the WebLogic Server is started or restarted. The shutdown class instructs WebLogic Server to invoke the PoolManagerShutDown class to disconnect the Jolt session pools from Tuxedos when the WebLogic Server shuts down. For more information on Startup and Shutdown classes, see Startup and Shutdown Classes.

1. In the left pane, expand the Deployments folder.
2. Click on the name of the Startup & Shutdown folder.
3. Click on the Configure a new Startup Class ... link.
4. In the Name field, enter the name for your Jolt Startup class. Example: MyJoltStartupClass.
5. In the ClassName field, enter the following: bea.jolt.pool.servlet.weblogic.PoolManagerStartUp
6. Click to enable Failure is Fatal.
7. Click Create.
8. Target and Deploy your Jolt Startup class and click Apply.
9. Click on the name of the Startup & Shutdown folder.
10. Click on the Configure a new Shutdown Class ... link.
11. In the Name field, enter the name for your Jolt Shutdown class. Example: MyJoltShutdownClass.
12. In the ClassName field, enter the following: bea.jolt.pool.servlet.weblogic.PoolManagerShutDown
13. Click Create.
14. Target and Deploy your Jolt Shutdown class and click Apply.

 

---

Configuring a Jolt Connection Pool

The following sections provide information on how to configure Jolt Connections Pools for you Tuxedo ATMI applications.

 

Create a Jolt Connection Pool

1. Click the Jolt node in the left pane. The Jolt Connection Pools table displays in the right pane showing all the Jolt connection pools defined in the domain.
2. Click the Configure a New Jolt Connection Pool text link. A dialog displays in the right pane showing the tabs associated with configuring a new connection pool.
3. Enter values in the Name, Minimum Pool Size, Maximum Pool Size, and the Recv Timeout attribute fields. Click the Security Context Enabled checkbox to enable security context.
4. Click Create to create a connection pool instance with the name you specified in the Name field. The new instance is added under the Jolt node in the left pane.
5. Click the Addresses tab to provide Jolt Service Listener (JSL) addresses for a connection pool. See Configuring Connection Failure Handling.
6. Click the User tab to create a user identity. See Configuring a User Security Identity.
7. Restart the Administration Server so that your changes can take effect.

 

Assign Jolt Connection Pools to a Server

1. Click the instance node in the left pane under Jolt to select a connection pool for assignment. A dialog displays in the right pane showing the tabs associated with this instance.
2. Click the Target and Deploy tab.
3. To assign a connection pool to a selected server, click one or more servers in the list of Independent Servers that has an empty check box. A check mark is displayed next to each server assigned to a Jolt connection pool.
4. To remove a connection pool from a server, click one or more servers in the list of Independent Servers that has a check mark. An empty check box is displayed next to each server that is not assigned to a Jolt connection pool.
5. Click Apply to save your assignments.

 

Assign Jolt Connection Pools to a Cluster

1. Click the instance node in the left pane under Jolt for the connection pool you want to assign. A dialog displays in the right pane showing the tabs associated with this instance.
2. Click the Target and Deploy tab.
3. To assign a connection pool to a cluster, select one or more clusters in the list of clusters that has an empty check box. A check mark is displayed next to each cluster assigned to a Jolt connection pool.
   1. To assign a connection pool to the all of the servers in a cluster, click All servers in the cluster.
   2. To assign a connection pool to selected servers in a cluster, click Part of the cluster. Select one or more clusters of the available servers.
4. To remove a connection pool from a cluster, select one or more servers in the list of clusters that has a check mark. An empty check box is displayed next to each cluster that is not assigned to a Jolt connection pool.
5. Click Apply to save your assignments.

 

Configuring Connection Failure Handling

1. Click the instance node in the left pane under Jolt for the connection pool you want to assign. A dialog displays in the right pane showing the tabs associated with this instance.
2. Click the Configuration tab.
3. Click the Addresses tab.
4. Assign a list of primary JSL addresses.
5. Assign a list of Failover JSL addresses.
6. Click Apply to save your assignments.

 

Configuring a User Security Identity

1. Click the instance node in the left pane under Jolt for the connection pool you want to assign. A dialog displays in the right pane showing the tabs associated with this instance.
2. Click the Configuration tab.
3. Click the User tab.
4. In User Name, assign a user identity.
5. In User Role, assign a user role.
6. In User Password, click change to assign a user password.
7. In Application Password, click change to assign a user password.
8. Click Apply to save your assignments.

 

---

Administering Active Jolt Connection Pools

The following sections provide information on the Active Jolt Connection Pools page. This page allows you to view statistics about the active Jolt connection pools in your WebLogic Server domain.

 

Monitor Active Instances of a Jolt Connection Pool

1. Click the Jolt node in the left pane. The Jolt Connection Pools table displays in the right pane showing all the Jolt connection pools defined in the domain.
2. Click the Name of the Jolt connection pool you want to monitor.
3. Click the Monitoring tab.
4. Click the Monitor all Active Pools text link.

 

Resetting a Jolt Connection Pool

You can reset the Jolt connection pool without having to restart WebLogic Server. Clicking on the Reset icon brings down the existing connections to the Jolt servers and reconnects to them.