Client Node level
Using NCache Web Manager
Launch NCache Web Manager by browsing to
http://localhost:8251
(Windows) or<server-ip>:8251
(Windows + Linux).In the left navigation bar, click on Clustered Caches or Local Caches, based on the cache to configure. Against the cache name, click on View Details.
This opens up the detailed configuration page for the cache. Go to the Client Nodes tab and click on the icon to open client node settings.
On Main tab you can configure Connection Timeout, Connection Retries, Retry Interval and Client Request Timeout. All values are in seconds.
Using the Settings tab, you can:
Enable/disable client load balancing using the check box Enable Client Load Balancing.
Specify Server Priority for this client.
- Click on Save Changes to apply this configuration to the cache.
Manually Editing NCache Configuration
Following are the cache level configurations in client.ncconf.
<configuration>
<ncache-server connection-retries="5" retry-connection-delay="0"
retry-interval="1" client-request-timeout="90"
connection-timeout="5" port="9800"
local-server-ip="20.200.20.30"/>
</configuration>
These configuration tags are explained below.
Client Request TimeOut
client-request-timeout
is the period for which client API waits for a response for a command from the server. After this period is elapsed an "OperationFailedException" is thrown. By default it is 90 seconds and minimum value could be 60 seconds. Time span specified less than minimum value will automatically be reset to minimum value i.e. 60 seconds.
Connection Retries
connection-retries
are the number of retries the client makes on the whole list of servers mentioned in the client.ncconf at the time of connection establishment. It is the same for connection break scenario.
Retry interval
If connection with cache server breaks, then client tries to reconnect with the server and retry-interval
flag introduces the delay between each retry. This flag is specified in seconds.
Connection TimeOut
connection-timeout
is the period threads wait before throwing OperationFailedException
during connection-break, while one thread tries to establish connection with cache server. If the connection is successfully established then, all threads will complete their respective operations. Otherwise, they will throw OperationFailedException
.
Retry Connection Delay
retry-connection-delay
is the time interval when client API waits before going through another iteration of connection-retries
. Delay is specified in seconds.
Local Server IP
local-server-ip
is the ip address of your local server machine.
Port
port
specifies the TCP port at which the client sends the connection request to the server.