MaxConnections

The MaxConnections configuration property identifies the maximum number of clients that you can connect to the Open Server application.

Syntax

MaxConnections=integer

Range

1–5000

Default

Value

integer is the maximum number of clients that you can connect to Open Client. This value must accommodate the MaxSvcConnections for all the access services operating on the same server.

Comments

For UNIX only, this property prevents your system from failing as a result of running out of UNIX file descriptors.
Use this formula to determine the MaxConnections server.cfg value and the file descriptor setting, on UNIX, for the ECDA process:
```
MaxConnections = (((max file descriptors per process /1.10) - 50) /3)
```
where:
- max file descriptors per process is determined by your UNIX administrator by using the ulimit -a utility to determine the number of file decriptors that are configured in your UNIX environment for your DirectConnect process. To obtain this information, you must be logged in as the user, have permission to start ECDA, and must set the environment variables for ECDA to run.
- 1.10 equals a 10% safety factor to build in extra descriptors.
- 50 equals the number of file descriptors reserved for the DirectConnect server.
- 3 equals the number of file decriptors that could potentially be used by each concurrent client connection.
  Example:
```
(((2000 file descriptors /1.10) - 50) / 3) = 589 (fractional part is truncated)
```
In this example, MaxConnections is configured to a maximum of 589. If the number of connections must be greater due to the number of users using ECDA at a peak time, use the following formula to determine the correct number of file descriptors that your UNIX administrator should configure for the ECDA process:
```
File descriptors = (((MaxConnections desired) x 3) + 50) x 1.10
```
where:
- 3 equals the number of file decriptors that could potentially be used by each concurrent client connection to ECDA.
- 50 equals the number of file descriptors reserved for the DirectConnect server.
- 1.10 equals a 10% safety factor to build in extra descriptors.
In the previous example, if the file descriptors constrained the calculated number of MaxConnections to 589 and you need 1000 connections, use this:
```
(((1000 MaxConnections desired x 3) + 50) x 1.10) = 3355 (file descriptors)
```

The 3355 file descriptors provide you with enough file descriptors to handle your desired number of concurrent connections (1000) for your ECDA process. To meet this requirement, your UNIX administrator must increase the number of file descriptors available for the ECDA process.