Adjusting the Number of POA Threads and Connections for Client/Server Processing

If the POA is configured with client/server processing enabled, it starts TCP handler threads to respond to current client/server requests, up to the number of threads specified by the TCP Handler Threads option. If the POA is not keeping up with the client/server requests from GroupWise^® client users, you can increase the maximum number of TCP handler threads so the POA can create additional threads. The default is 6 TCP handler threads; valid values range from 1 to 50.

Connections are the number of "sockets" through which client/server requests are communicated from the GroupWise client to the POA.

• Application connections: The TCP/IP connections between the POA and the GroupWise clients run by GroupWise users. Each GroupWise user creates one application connection when he or she starts GroupWise. The default is 2048.

• Physical connections: Additional TCP/IP connections created as users do specific activities in the GroupWise client. If a physical connection is idle for 5 seconds, it terminates, but another one is established on demand. Each GroupWise client user could have zero or multiple physical connections, depending on what activities he or she is doing. The default is 512.

If GroupWise client users cannot connect to the POA or if response is sluggish, you can increase the maximum number of connections.

1. In ConsoleOne^®, browse to and right-click the POA object > click Properties.

2. Click GroupWise > Agent Settings to display the Agent Settings page.

   
   

3. Increase the number in the TCP Handler Threads field to increase the maximum number of threads the POA can create for client/server processing.

   Plan on about one TCP handler thread per 20-30 client/server users. Or, you could increase the number of TCP handler threads in increments of three to five threads until acceptable throughput is reached. The optimum number of threads for a POA is affected by many factors, including available system resources.

4. Increase the number in the Max Physical Connections field to increase the number of activities the attached users can perform concurrently.

5. Increase the number in the Max App Connections field to increase the number of GroupWise users that can connect to the POA.

6. Click OK to save the new threads and connections settings.

   ConsoleOne then notifies the POA to restart so the new settings can be put into effect.

Corresponding Startup Switches
You could also use the /tcpthreads, /maxappconns, and /maxphysconns switches in the POA startup file to adjust the POA client/server processing.