SDX 6.4.x Network Guide > Configuring Applications to Communicate with an SAE > Configuring NIC Proxies from SDX Configuration Editor

Configuring NIC Proxies from SDX Configuration Editor

Tasks to configure a NIC proxy from SDX Configuration Editor are:

• Configuring Resolution Information for a NIC Proxy.
• For applications that use client/server mode (not NIC local host mode):

• (Optional) Configuring the NIC Proxy Cache.
• (Optional but recommended) Configuring the NIC Proxy for NIC Replication.

Configuring Resolution Information for a NIC Proxy

To use SDX Configuration Editor to configure a NIC resolution:

1. In the navigation pane, select a configuration file for the NIC proxy you want to configure.
2. Depending on the configuration file, select the NIC proxy tab or the NIC proxy section on another tab.
3. Expand the Resolution section.
4. In the Resolution section, edit or accept the default values for the fields.

See NIC Proxy Resolution Fields.

5. Select File > Save.
6. Right-click the configuration file, and select System Configuration > Export to LDAP Directory.

NIC Proxy Resolution Fields

In SDX Configuration Editor, you can modify the following fields in the Resolution section of a NIC Proxy pane or section of a pane in a configuration file.

Resolver Name

• NIC resolver that this NIC proxy uses.
• Value—Path to NIC resolvers relative to the static configuration object in the directory
• Guidelines—This resolver must be the same as one that is configured on the NIC host.
• Default—No value
• Property—nic.server

Key Type

• Type of data used that the key provides for the NIC resolution.
• Value—Varies according to the application that is using the NIC proxy; choose from the menu.
• Guidelines—This key must be the same as the one for the specified resolver that is configured on the NIC host.
• Default—No value
• Property—nic.keytype

Value Type

• Type of value to be returned in the resolution.
• Value—Varies according to the application that is using the NIC proxy; choose from the menu.
• Default—No value
• Property—nic.valuetype

Expect Multiple Values

• Specifies whether or not the key can have multiple corresponding values.
• Value

• Yes—Key can have multiple corresponding values.
• No—Key can have only one value.

• Default—No
• Property—nic.expectmultiple

Constraints

• Condition that must or may be satisfied before the next stage of the resolution process can proceed.
• Value—Comma-separated list of the data types of constraints specified for the NIC resolution on the NIC host
• Guidelines—Provide a value only if the constraint will be provided by the application in the resolution request. Typically, you do not need to provide a value for this field.
• Default—No value
• Property—nic.constraints

Use Local NIC Host

• Specifies whether or not the NIC proxy uses a NIC local host if one is configured and running within the application.
• Value

• Yes—NIC hosts runs within the same application as the NIC proxies for the application.
• No—NIC host can run on a machine other than the one on which the NIC proxies are located.

• Default—Yes
• Property—nic.localhost

Configuring the NIC Proxy Cache

In the Cache section of the pane, you can modify cache properties for the NIC proxy to optimize the resolution performance for your network configuration and system resources. Typically, you can use the default values for the cache properties.

To use SDX Configuration Editor to configure NIC proxy cache properties:

1. In the navigation pane, select a configuration file for the NIC proxy you want to configure.
2. Depending on the configuration file, select the NIC proxy tab or the NIC proxy section on another tab.
3. Expand the Cache section.
4. In the Cache section, edit or accept the default values for the fields.

See NIC Proxy Cache Fields.

5. Select File > Save.
6. Right-click the configuration file, and select System Configuration > Export to LDAP Directory.

NIC Proxy Cache Fields

In SDX Configuration Editor, you can modify the following fields in the Cache section of a NIC Proxy pane or section of a pane in a configuration file.

Cache Size

• Maximum size of the cache in which the NIC proxy retains data.
• Value—Integer in the range 0-4294967295

• 0—Cache is disabled
• Other values—Actual size of the cache

• Guidelines—You can change this value without restarting the NIC host. If you decrease the cache size or disable the cache while the NIC proxy is running, the NIC proxy removes entries in order of descending age until the cache size meets the new limit.
• Default—10000
• Property name—nic.maxCacheSize

Cache Cleanup Interval

• Time interval at which the NIC proxy removes expired entries from its cache.
• Value—Number of seconds in the range 5-4294967295
• Default—15 seconds
• Property name—nic.cleanupInterval

Cache Entry Age

• Maximum time that the NIC proxy can cache an entry. The NIC proxy compares this property with the life expectancy of each entry and uses the lower value to determine when to remove the entry.
• Value—Number of seconds in the range 0-4294967295

• 0 or unspecified—Life expectancy of the data, which determines expiration of data
• Other values—Actual time that the NIC proxy caches entries

• Default—0
• Property name—nic.maxCacheEntryAge

Configuring the NIC Proxy for NIC Replication

In most cases, NIC hosts should be configured to use NIC replication. In the NIC Host Selection section of the pane, specify the groups of NIC hosts to be contacted to resolve a request.

To use SDX Configuration Editor to configure NIC replication for a NIC proxy:

1. In the navigation pane, select a configuration file for the NIC proxy you want to configure.
2. Depending on the configuration file, select the NIC proxy tab or the NIC proxy section on another tab.
3. Expand the NIC Host Selection section and the Blacklisting section.
4. In the NIC Host Selection section and the Blacklisting section, edit or accept the default values for the fields.

See NIC Host Selection Fields.

5. Select File > Save.
6. Right-click the configuration file, select System Configuration > Export to LDAP Directory.

NIC Host Selection Fields

In SDX Configuration Editor, you can modify the following fields in the NIC Host Selection section of a NIC Proxy pane or section of a pane in a configuration file.

Groups

• List of groups of NIC hosts that the NIC proxy can contact.
• Value—Comma-separated list of names of groups
• Default—No value
• Example—ontarioHost, vancouverHost
• Property name—nic.groups

Selection Criteria

• Selection algorithm that the NIC proxy uses to determine which NIC host to contact.
• Value

• Round Robin—NIC proxy selects NIC hosts in a fixed, cyclic order. The NIC proxy always selects the next host in the list.
• Random Pick—NIC proxy selects NIC hosts randomly from the list.
• Priority List—NIC proxy selects NIC hosts according to their assigned priorities in the list. If the host with the highest priority in the list is not available, the NIC proxy tries the host with the next-highest priority, and so on.

• Guidelines—Use Round Robin or Random Pick to distribute resolution requests among NIC hosts. Use Priority List if you prefer to use a particular NIC host; for example, you may reduce operating costs by using a local NIC host.
• Default—Round Robin
• Property name—nic.repStrategy

Try Next System on Error

• Specifies whether or not the NIC proxy should contact the next specified NIC host if a NIC host is determined to be unavailable.
• Value

• Yes—NIC proxy should contact the next specified host.
• No—NIC proxy should not contact the next specified host.

• Default—Yes
• Property name—nic.tryNextOnError

Number of Retries Before Blacklisting

• Number of times the NIC proxy tries to communicate with a NIC host before the NIC proxy stops communicating with the NIC host for a period of time.
• Value—Integer in the range 0-2147483647
• Default—3
• Property name—nic.numOfRetries

Blacklist Retry Interval

• Interval at which the NIC proxy attempts to connect to an unavailable NIC host.
• Value—Number of seconds in the range 0-2147483647
• Default—15
• Property name—nic.retryInterval