Skip past navigation linksSecure Global Desktop Administration Guide > Arrays, servers and load balancing > Editing application server load balancing properties

Editing application server load balancing properties

You can tune Secure Global Desktop load balancing by editing application server load balancing properties. The properties are stored in a properties file, which you can edit with a text editor. There are three properties files:

This topic describes how you edit the properties files and what properties are available. For detailed information on how to use the properties, see Tuning application server load balancing.

Only edit these properties if you are sure you know what you're doing.

The global load balancing properties file

The file tier3lb.properties contains the default load balancing properties for the array. The file is in the /opt/tarantella/var/serverconfig/global directory. You should only edit these properties on the primary Secure Global Desktop server in the array. The primary will copy the amended files to the secondaries.

In the tier3lb.properties properties file, the properties are prefixed with tarantella.config.tier3lb, for example tarantella.config.tier3lb.weighting.

The table below:

Property Default value Purpose Can be
overridden?
connectretries 3 The number of times the Secure Global Desktop server tries to connect to the application server to request CPU/memory updates. No
listeningport 3579 The UDP port the Secure Global Desktop server uses to listen for data sent by the load balancing service. No
longtimeout 900 The pause in seconds between groups of attempts by the Secure Global Desktop server to connect to the application server. No
maxmissedsamples 20 The number of missed samples used to calculate whether the CPU/memory data for the application server is too unreliable to be used. No
probe.listeningport 3579 The TCP port the load balancing service uses to listen for requests from Secure Global Desktop servers, for example, when to start sending updates. Yes
probe.percentchange 10 The minimum percentage increase or decrease in CPU/memory use that must be reported to the Secure Global Desktop server. Yes
probe.replyfrequency 30 The interval in seconds at which the load balancing service sends CPU/memory measurements to the Secure Global Desktop server. The minimum value for this property is 2. Yes
probe.samplerate 15 The interval in seconds between CPU/memory measurements. The minimum value for this property is 1. Yes
probe.windowsize 3 The number of CPU/memory measurements used to calculate the CPU/memory average. The minimum value for this property is 1. Yes
scaninterval 60 The interval in seconds between scans of the Secure Global Desktop server's list of load-balanced application servers. No
shorttimeout 60 The interval in seconds between attempts by the Secure Global Desktop server to connect to the application server. No
sockettimeout 5 The socket timeout in seconds. No
updatelimit 5 The limit used to calculate when the load balancing service has stopped sending updates. No
weighting 100 The weighting of load measurements relative to the other application servers. Yes

Note The following properties also appear in the tier3lb.properties properties file, but they must not be changed:

Skip past preformatted texttarantella.config.name=tier3lb
tarantella.config.type=server

The application server load balancing properties file

You can override some of the array default properties by creating a server-specific load balancing properties file. You have to manually create this file in the /opt/tarantella/var/serverconfig/global/t3hostdata directory. You should only create a server-specific properties file on the primary Secure Global Desktop server in the array. The primary will copy the file to the secondaries.

The properties you can override are shown in the table above.

In the server-specific properties file, the properties are prefixed with tarantella.config.tier3hostdata, for example tarantella.config.tier3hostdata.weighting.

To create a server-specific properties file:

  1. On the primary Secure Global Desktop server, change to the /opt/tarantella/var/serverconfig/global/t3hostdata directory.
  2. Copy the template.properties file to a file called hostname.properties in the same directory, for example, paris.indigo-insurance.com.properties.
  3. Open the file in a text editor.
  4. Find the line containing the tarantella.config.tier3hostdata.name property.
  5. After the "=", add the ENS name of the application server. The name must be enclosed in quotes and each part of the host name must be escaped using a backslash. For example, to apply the properties to the host paris.indigo-insurance.com, type ".../_ens/o\=Indigo Insurance/cn\=paris".
  6. Uncomment the lines (by deleting the "#") which contain the properties you want to be override. Only uncomment the properties you want to be different from the array defaults.
  7. Change the values of the properties you want to override.
  8. Save the changes and close the file.
  9. Do a warm restart of the primary Secure Global Desktop server (tarantella restart --warm).

Note The template.properties file contains comments to help you create a server-specific file.

The UNIX application server properties file

The UNIX application server properties file contains the settings that are used when the load balancing service is first started or whenever the service is restarted, for example if the server is rebooted.

The properties file is installed in the same directory as the Sun Secure Global Desktop Enhancement Module on the application server. By default, this is /opt/tta-tem.

You should only make changes to these properties:

If you change these properties, you must manually stop and restart the load balancing service.

In the UNIX server properties file, the properties are prefixed with tarantella.config.tier3loadbalancing, for example tarantella.config.tier3loadbalancing.port.

Related topics