Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation
Guide That Contains This Content
[+] Expand All
[-] Collapse All

    Configuring the State Synchronization Plug-In Interface (SRC CLI)

    Some external plug-ins, such as the Admission Control Plug-In (ACP) application and the SAE plug-in agent for the NIC, support state synchronization with the SAE. The state synchronization plug-in interface allows external plug-ins to maintain the state of active subscriber, service, and interface sessions without having to store intermediate versions of the state locally.

    Use the following configuration statements to configure the state synchronization plug-in:

    shared sae configuration plug-ins state-synchronization {fail-queue-size fail-queue-size;fail-queue-size-during-sync fail-queue-size-during-sync;fail-queue-age fail-queue-age;batch-time batch-time;keepalive-time keepalive-time;}
    shared sae configuration plug-ins manager {threads threads;}

    To configure the state synchronization plug-in interface:

    1. From configuration mode, access the state synchronization plug-in configuration.
      user@host# edit shared sae configuration plug-ins state-synchronization
    2. Configure the maximum number of plug-in events that are stored while the communication with a state synchronization plug-in is interrupted.
      [edit shared sae configuration plug-ins state-synchronization]user@host# set fail-queue-size fail-queue-size
    3. Configure a threshold for the in-memory fail queue size to raise an SNMP event trap. When the plug-in events stored in the in-memory fail queue during synchronization exceed the configured threshold, the SRC software raises the trap but allows further events to be stored in the queue. The SNMP trap is used to notify about the constant increase in the heap usage due to events stored in the queue.

      Note: While configuring a value for the fail-queue-size-during-sync variable, you must take into account the events that get stored in the in-memory fail queue when the NIC response rate is lesser than the ramp up rate of subscribers.

      [edit shared sae configuration plug-ins state-synchronization]user@host# set fail-queue-size-during-sync fail-queue-size-during-sync
    4. Configure the maximum time that plug-in events are stored while the communication with a state synchronization plug-in is interrupted.
      [edit shared sae configuration plug-ins state-synchronization]user@host# set fail-queue-age fail-queue-age
    5. Configure the time that the SAE waits for other plug-ins to become ready before starting a synchronization sequence.
      [edit shared sae configuration plug-ins state-synchronization]user@host# set batch-time batch-time
    6. Configure the time that the SAE waits after an event before sending a ping to the remote plug-in.
      [edit shared sae configuration plug-ins state-synchronization]user@host# set keepalive-time keepalive-time
    7. Configure the number of threads that the SAE maintains for plug-in synchronization.
      [edit shared sae configuration plug-ins state-synchronization]user@host# up [edit shared sae configuration plug-ins]user@host# set manager threads 5
    8. (Optional) Verify your configuration.
      [edit shared sae configuration plug-ins state-synchronization]
      user@host# show
      fail-queue-size 5000;
      fail-queue-size-during-sync 10000;
      fail-queue-age -1;
      batch-time 60;
      keepalive-time 60;
      [edit shared sae configuration plug-ins manager]
      user@host# show
      threads 5;

    Modified: 2014-12-08