Procedure 16.1. Setup a thread pool for an HTTP Connector

1. Define a thread factory

   Open up your configuration file (standalone.xml if modifying for a standalone server or domain.xml if modifying for a domain based configuration. This file will be in the EAP_HOME/standalone/configuration or the EAP_HOME/domain/configuration folder).
   Add the following subsystem entry, changing the values to suit your server needs.

   <subsystem xmlns="urn:jboss:domain:threads:1.0">
       <thread-factory name="http-connector-factory" thread-name-pattern="HTTP-%t" priority="9" group-name="uq-thread-pool"/>
   </subsystem>	
   
   

   If you prefer to use the CLI to do this task, then execute the following command in a CLI command prompt:

   [standalone@localhost:9999 /] ./subsystem=threads/thread-factory=http-connector-factory:add(thread-name-pattern="HTTP-%t", priority="9", group-name="uq-thread-pool")

2. Create an executor

   You can use one of six in-built executor classes to act as the executor for this factory. The six executors are: unbounded-queue-thread-pool, bounded-queue-thread-pool, blocking-bounded-queue-thread-pool, queueless-thread-pool, blocking-queueless-thread-pool and scheduled-thread-pool.
   In this example, we will use the unbounded-queue-thread-pool to act as the executor. Modify the values of max-threads and keepalive-time parameters to suit your server needs.

   <unbounded-queue-thread-pool name="uq-thread-pool">
     <thread-factory name="http-connector-factory" />
     <max-threads count="10" />
     <keepalive-time time="30" unit="seconds" />
   </unbounded-queue-thread-pool>			
   
   

   Or if you prefer to use the CLI:

   [standalone@localhost:9999 /] ./subsystem=threads/unbounded-queue-thread-pool=uq-thread-pool:add(thread-factory="http-connector-factory", keepalive-time={time=30, unit="seconds"}, max-threads=30)

3. Make the HTTP web connector use this thread pool

   In the same configuration file, locate the HTTP connector element under the web subsystem and modify it to use the thread pool defined in the previous steps.

   <connector name="http" protocol="HTTP/1.1" scheme="http" socket-binding="http" executor="uq-thread-pool" />
   

   Again, if you prefer to use the CLI:

   [standalone@localhost:9999 /] ./subsystem=web/connector=http:write-attribute(name=executor, value="uq-thread-pool")

4. Restart the server

   Restart the server (standalone or domain) so that the changes can take effect. Use the following CLI commands to confirm if the changes from the steps above have taken place:

   [standalone@localhost:9999 /] ./subsystem=threads:read-resource(recursive=true)
   {                  
       "outcome" => "success",
       "result" => {
           "blocking-bounded-queue-thread-pool" => undefined,
           "blocking-queueless-thread-pool" => undefined,
           "bounded-queue-thread-pool" => undefined,
           "queueless-thread-pool" => undefined,
           "scheduled-thread-pool" => undefined,
           "thread-factory" => {"http-connector-factory" => {
               "group-name" => "uq-thread-pool",
               "name" => "http-connector-factory",
               "priority" => 9,
               "thread-name-pattern" => "HTTP-%t"
           }},
           "unbounded-queue-thread-pool" => {"uq-thread-pool" => {
               "keepalive-time" => {
                   "time" => 30L,
                   "unit" => "SECONDS"
               },
               "max-threads" => 30,
               "name" => "uq-thread-pool",
               "thread-factory" => "http-connector-factory"
           }}
       }
   }
   [standalone@localhost:9999 /] ./subsystem=web/connector=http:read-resource(recursive=true)
   {
       "outcome" => "success",
       "result" => {
           "configuration" => undefined,
           "enable-lookups" => false,
           "enabled" => true,
           "executor" => "uq-thread-pool",
           "max-connections" => undefined,
           "max-post-size" => 2097152,
           "max-save-post-size" => 4096,
           "name" => "http",
           "protocol" => "HTTP/1.1",
           "proxy-name" => undefined,
           "proxy-port" => undefined,
           "redirect-port" => 443,
           "scheme" => "http",
           "secure" => false,
           "socket-binding" => "http",
           "ssl" => undefined,
           "virtual-server" => undefined
       }
   }