Connecting to a Server through Single Properties File
To set up connection to single server, user needs to configure single properties file. This properties file is referred to as the global properties file.
How it Works
The following steps describe what happens when the client attempts to connect to the server for the first time.
The client creates a session. This, in turn, creates a new load balancer, which stores the server IP, Port, and Protocol parameters and the connection timeout and interval values. If persistent connections are enabled, then the load balancer also creates a connection pool.
Note
If persistent connections are not enabled, the load balancer does not create a connection pool. Connection pools enable the client to reuse existing connections if it needs them after receiving the server response. The CipherTrust Manager recommends enabling persistent connections, because the performance cost of maintaining a connection pool is much less than the cost of opening a new connection for each client request.
The client requests a connection from the load balancer. Since this is the first connection request, the load balancer creates a connection. (When the client makes future requests, the load balancer searches the connection pool for existing connections before creating a new one.)
The client waits for a server response for the duration specified by Connection_Timeout. If the server does not respond within timeout period, or refuses connection, the connection fails and client ignores the server for the duration specified by Connection_Retry_Interval. If the server responds in time, the connection is successful.
The client obtains the connection.
The client uses the connection to send a request to the server.
The server sends the response.
The client receives the response. If persistent connections are enabled, then the load balancer keeps the connection in the pool; otherwise, it closes the connection.
The client requests another connection. If persistent connections are enabled, the load balancer searches the connection pool for an existing connection.
Related Parameters
The connection to an individual server uses the following parameters in the properties file:
NAE_IP
KMIP_IP
NAE_Port
KMIP_Port
Protocol
Connection_Timeout
Connection_Retry_Interval
Refer to Network Configuration Parameters and Connection Configuration Parameters to know more about the network and connection configuration related properties.
