21.2. Configuring Bean Pools

Procedure 21.1. Create a bean pool using the Management Console

1. Login to the Management Console. Refer to Section 3.3.2, “Log in to the Management Console”.
2. Click on the Configuration tab at the top of the screen. Expand the Container menu and select EJB 3. Select the Bean Pools tab.
3. Click Add. The Add EJB3 Bean Pools dialog appears.
4. Specify the required details, Name, Max Pool Size, Timeout value, and Timeout unit.
5. Click Save button to finish.

Procedure 21.2. Create a bean pool using the CLI

1. Launch the CLI tool and connect to your server. Refer to Section 3.4.4, “Connect to a Managed Server Instance Using the Management CLI”.
2. Use the add operation with the following syntax.

   /subsystem=ejb3/strict-max-bean-instance-pool=BEANPOOLNAME:add(max-pool-size=MAXSIZE, timeout=TIMEOUT, timeout-unit="UNIT")

   • Replace BEANPOOLNAME with the required name for the bean pool.
   • Replace MAXSIZE with the maximum size of the bean pool.
   • Replace TIMEOUT
   • Replace UNIT with the required time unit. Allowed values are: NANOSECONDS, MICROSECONDS, MILLISECONDS, SECONDS, MINUTES, HOURS, and DAYS.
3. Use the read-resource operation to confirm the creation of the bean pool.

   /subsystem=ejb3/strict-max-bean-instance-pool=BEANPOOLNAME:read-resource

Procedure 21.3. Remove a bean pool using the Management Console

1. Login to the Management Console. Refer to Section 3.3.2, “Log in to the Management Console”.
2. Click on the Configuration tab at the top of the screen. Expand the Container menu and select EJB 3. Select the Bean Pools tab.
3. Select the bean pool to remove in the list.
4. Click Remove. The Remove Item dialog appears.
5. Click Confirm to confirm.

Procedure 21.4. Remove a bean pool using the CLI

1. Launch the CLI tool and connect to your server. Refer to Section 3.4.4, “Connect to a Managed Server Instance Using the Management CLI”.
2. Use the remove operation with the following syntax.

   /subsystem=ejb3/strict-max-bean-instance-pool=BEANPOOLNAME:remove

   • Replace BEANPOOLNAME with the required name for the bean pool.

Procedure 21.5. Edit a bean pool using the Management Console

1. Login to the Management Console. Section 3.3.2, “Log in to the Management Console”
2. Click on the Configuration tab at the top of the screen. Expand the Container menu and select EJB 3. Select the Bean Pools tab.
3. Select the bean pool you want to edit.
4. Click Edit.
5. Edit the details you want to change. Only Max Pool Size, Timeout value, and Timeout Unit can be changed.
6. Click Save to finish.

Procedure 21.6. Edit a bean pool using the CLI

1. Launch the CLI tool and connect to your server. Refer to Section 3.4.4, “Connect to a Managed Server Instance Using the Management CLI”.
2. Use the write-attribute operation with the following syntax for each attribute of the bean pool to be changed.

   /subsystem=ejb3/strict-max-bean-instance-pool=BEANPOOLNAME:write-attribute(name="ATTRIBUTE", value="VALUE")

   • Replace BEANPOOLNAME with the required name for the bean pool.
   • Replace ATTRIBUTE with the name of the attribute to be edited. The attributes that can be edited in this way are max-pool-size, timeout, and timeout-unit.
   • Replace VALUE with the required value of the attribute.
3. Use the read-resource operation to confirm the changes to the bean pool.

   /subsystem=ejb3/strict-max-bean-instance-pool=BEANPOOLNAME:read-resource

Procedure 21.7. Assign Bean Pools for Session and Message-Driven Beans using the Management Console

1. Login to the Management Console. Section 3.3.2, “Log in to the Management Console”
2. Click on the Configuration tab at the top of the screen. Expand the Container menu and select EJB 3. Select the Container tab.
3. Click Edit.
4. Select the bean pool to use for each type of bean from the appropriate combo-box.
5. Click Save to finish.

Procedure 21.8. Assign Bean Pools for Session and Message-Driven Beans using the CLI

1. Launch the CLI tool and connect to your server. Refer to Section 3.4.4, “Connect to a Managed Server Instance Using the Management CLI”.
2. Use the write-attribute operation with the following syntax.

   /subsystem=ejb3:write-attribute(name="BEANTYPE", value="BEANPOOL")

   • Replace BEANTYPE with default-mdb-instance-pool for Message-Driven Beans or default-slsb-instance-pool for stateless session beans.
   • Replace BEANPOOL with the name of the bean pool to assign.
3. Use the read-resource operation to confirm the changes.

   /subsystem=ejb3:read-resource

Procedure 21.9. Assign a Bean Pool for a Session or Message-Driven Bean using the @Pool annotation

1. Add the @Pool annotation to the bean and specify the name of the bean pool to be used.

   @Stateless
   @Pool("slsb-strict-max-pool")
   public class HelloBean implements HelloBeanRemote {

   This will override any default settings created in the management interfaces.
2. The @org.jboss.ejb3.annotation.Pool annotation is part of the JBoss EJB3 External API and must be added as a dependency. If you are using Maven, the following dependency should be added to your pom.xml file:

   <dependency>
     <groupId>org.jboss.ejb3</groupId>
     <artifactId>jboss-ejb3-ext-api</artifactId>
     <version>2.1.0</version>
   </dependency>