Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Configuring a NIC Proxy for the SRC 3GPP Gateway (SRC CLI)

 

Tasks to configure the NIC proxy are:

Configuring Resolution Information for a NIC Proxy

You create a NIC proxy for each subscriber type to be configured. Subscriber types that have different subscriber ID types can use the same NIC proxy.

Use the following configuration statements to configure the NIC proxy:

To configure resolution information for a NIC proxy:

  1. From configuration mode, access the statement that configures the NIC proxy configuration. In this sample procedure, the NIC proxy called nic2 is configured.

  2. Specify the path to the NIC resolver that this NIC proxy uses. This resolver must be the same as the one that is configured on the NIC host.

  3. Specify the NIC data type that the key provides for the NIC resolution. You can provide a qualifier to a data type to distinguish between different instances of a data type in a resolution scenario, or to provide information about a data type to clarify the use of that data type in a resolution.

    Note

    The only valid key-type for the SRC 3GPP gateway is SessionHandle.

  4. Specify the type of value to be returned in the resolution for the application that uses the NIC proxy.

    For the SRC 3GPP gateway, you must set value-type to SaeId.

  5. (Optional) If the key can have more than one value, specify that the key can have multiple corresponding values.

  6. (Optional. Available at the Advanced editing level.) If the application provides a constraint in the resolution request, specify the data type for the constraint. The constraint represents a condition that must or may be satisfied before the next stage of the resolution process can proceed.

    Configure a constraint only if the constraint will be provided by the application in the resolution request. Typically, you do not need to configure constraints.

  7. (Optional) Verify your configuration.

Changing the Configuration for the NIC Proxy Cache

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 settings for the cache properties. The configuration statements are available at the Advanced editing level.

Use the following configuration statements to change values for the NIC proxy cache:

To configure the cache for a NIC proxy:

  1. From configuration mode, access the statement that specifies the NIC proxy configuration. In this sample procedure, the NIC proxy called nic2 is configured.

  2. (Optional) Specify the maximum number of keys for which the NIC proxy retains data.

    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.

  3. Specify the time interval at which the NIC proxy removes expired entries from its cache.

  4. (Optional) Specify how long an entry remains in the cache.

  5. (Optional) Verify your configuration.

Configuring a NIC Proxy for NIC Replication

Typically, you configure NIC replication to keep the NIC highly available. You configure NIC host selection to specify the groups of NIC hosts to be contacted to resolve a request, and to define how the NIC proxy handles NIC hosts that the proxy is unable to contact. The configuration statements are available at the Normal editing level.

Use the following configuration statements to configure NIC host selection for a NIC proxy:

To configure a NIC proxy to use NIC replication:

  1. From configuration mode, access the statement that specifies the NIC proxy configuration. In this sample procedure, the NIC proxy called nic2 is configured.

  2. (Optional) Specify the list of groups of NIC hosts that the NIC proxy can contact for resolution requests.

  3. (Optional) If you configure more than one group, specify the selection criteria that the NIC proxy uses to determine which NIC host to contact.

    where:

    • roundRobin—NIC proxy selects NIC hosts in a fixed, cyclic order. The NIC proxy always selects the next host in the list.

    • randomPick—NIC proxy selects NIC hosts randomly from the list.

    • priorityList—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.

      Priorities are defined by the order in which you specify the groups. You can change the order of NIC hosts in the list by using the insert command.

  4. (Optional) Verify your configuration.

  5. Access the statement that specifies the NIC proxy configuration for blocklisting—the process of handling nonresponsive NIC hosts.

  6. (Optional) Specify whether or not the NIC proxy should contact the next specified NIC host if a NIC host is determined to be unavailable.

  7. (Optional) Change the 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. The default is 3.

  8. (Optional) Change the interval at which the NIC proxy attempts to connect to an unavailable NIC host. The default is 15 seconds.

  9. (Optional) Verify your configuration.

Configuring NIC Test Data

To test a resolution without the NIC, you can configure a NIC proxy stub to take the place of the NIC. The NIC proxy stub comprises a set of explicit mappings of data keys and values in the NIC proxy configuration. When the SRC component configured to use a NIC proxy stub passes a specified key to the NIC proxy stub, the NIC proxy stub returns the corresponding value. When you use a NIC proxy stub, no NIC infrastructure is required.

Use the following configuration statements to configure a NIC proxy stub from the [edit] hierarchy level.

To use the NIC proxy stub for the SRC 3GPP gateway:

  1. In configuration mode, navigate to the NIC proxy configuration and specify the data type of the key you want to map to a value. In this sample procedure, the key nic2 is specified for the NIC proxy called nic2.

  2. Enable a NIC proxy stub for a resolution.

  3. Specify the values of the keys for testing. These statements are available at the Advanced CLI editing level.

    where:

    • name—Indicates the NIC data value for the proxy.

    • value—Specifies a value for the NIC data type.

    For example, to set up a login name to IP mapping for login name jane@virneo.com to the IP address 192.0.2.30: