Multiple Instances of Configuration Parameters
Multiple instances of the TIBCO iProcess® Objects Server can be run on a single machine. For more information, see Running Multiple Instances of the TIBCO iProcess® Objects Server.
If the multiple instance feature is being used, you can also specify multiple instances of the configuration parameters described in this section. This allows you to configure each instance of the TIBCO iProcess® Objects Server differently. You can define multiple instances of all configuration parameters except NumFiles, AnonymousUserName’X’, AnonymousSWUserName’X’, AnonymousPoolSize’X’, and AnonymousPrivilege’X’.
Configuring Multiple Instance Parameters on UNIX Systems
To specify a parameter for a particular instance, add "01" to the parameter name for the first instance, "02" for the second and so on. Any instance that does not have an individual parameter set will use the "common" parameter.
For example, if the following is the only "LOG_FILE_MAX_SIZE" parameter specified:
LOG_FILE_MAX_SIZE = 50
Then all instances will use a log size of 50MB.
If the following "LOG_FILE_MAX_SIZE" parameters have been defined:
LOG_FILE_MAX_SIZE = 50
LOG_FILE_MAX_SIZE03 = 100
Then instance 3 of the TIBCO iProcess® Objects Server will have a 100MB file size, while all other instances will have a 50MB file size.
TCPServiceName and UDPServiceName parameters work a little differently. For information about how these parameters work with multiple instances of TIBCO iProcess® Objects Servers, see This identifies the port number on which the TIBCO iProcess® Objects Server will listen for client connections. This can be specified in the following ways: and UDPServiceName.Configuring Multiple Instance Parameters on Windows Systems
The TIBCO iProcess® Objects Server Configuration Utility allows you to select each instance of the TIBCO iProcess® Objects Server on the machine so that parameters can be configured for that instance:
If the TIBCO iProcess® Objects Server is multiple-instance capable (i.e., it has CR 10974 implemented), the Multiple Instance Server check box will be checked when that server is selected in the server drop-down list. Also, for each TIBCO iProcess® Objects Server that is multiple-instance capable, the server name will be shown in the server drop-down list with “(default)” to the right of the name. Then, each instance of that TIBCO iProcess® Objects Server is shown in the list with a two-digit instance number appended to the server name. In the example shown above, the TIBCO iProcess® Objects Server named “vi10sql” has three instances.
If the TIBCO iProcess® Objects Server is multiple-instance capable, but you are not running multiple instances of that server, there will still be two entries for that server in the drop-down list: “<ServerName>(default)” and “<ServerName>01”.
Setting Default Parameter Values When Using the Configuration Utility
There are two types of default values for the TIBCO iProcess® Objects Server configuration parameters
| • | System defaults - These are the values to which all parameters are set when the TIBCO iProcess® Objects Server is initially installed. These default values are established by the system. |
The TIBCO iProcess® Objects Server Configuration Utility has been designed so that the color of the text indicates if a value is different from either the system default or the multiple-instance default.
| • | Values that are the same as the system default are displayed in black. |
| • | Values that are different than the system default are displayed in blue. Note that this also applies to parameters for TIBCO iProcess® Objects Servers that are non-multiple-instance servers. |
| • | Values that are different than the multiple-instance default are displayed in red. This, of course, only applies to TIBCO iProcess® Objects Servers that are multiple-instance capable. |
Setting Values to the Defaults
You can set parameter values back to the default values using the following methods:
| — | If a non-multiple-instance TIBCO iProcess® Objects Server is selected in the server drop-down list, clicking Set All Defaults causes all parameters for that server to be set to the system defaults. |
| — | If the “(default)” selection for a multiple-instance capable TIBCO iProcess® Objects Server is selected in the server drop-down list, clicking Set All Defaults causes the multiple-instance defaults for that TIBCO iProcess® Objects Server to be set to the system defaults. This also causes the parameters for instances of that TIBCO iProcess® Objects Server to take on the system default values, but ONLY if they had not previously been modified. In other words, any parameter values that had been changed for a particular instance of the TIBCO iProcess® Objects Server is not modified when you set the default parameters for that TIBCO iProcess® Objects Server. |
| — | If one of the instances of the TIBCO iProcess® Objects Server is selected in the server drop-down list (e.g., vi10sql02 in the example shown earlier), clicking on Set All Defaults causes the following dialog box to be displayed:
|
From this dialog box, you can set all of the parameters for that instance of the TIBCO iProcess® Objects Server to the system defaults or the multiple-instance defaults.
| • | Right-click drop-down menu - Right-clicking on an individual field or check box in the TIBCO iProcess® Objects Server Configuration Utility displays the following menu. |
This menu allows you to set that specific parameter to either the system default or multiple-instance default. Note that the Set to System Default selection is available only if the parameter value is currently different than the system default, and the Set to Multi-Instance Default selection is available only if the parameter value is currently different than the multiple-instance default.
This right-click drop-down menu also provides selections that allow you to perform standard Windows copy, paste, and undo functions.