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 PTSP Device Driver Session Store (SRC CLI)

    In most cases, all attributes have reasonable defaults and should not require configuration. The configuration should be changed only by advanced users wishing to tune the performance.

    Use the following configuration statements to configure the PTSP device driver session storage configuration:

    shared sae configuration driver junos-ptsp session-store { maximum-queue-age maximum-queue-age;maximum-queued-operations maximum-queued-operations;maximum-queue-size maximum-queue-size;maximum-file-size maximum-file-size;minimum-disk-space-usage minimum-disk-space-usage;rotation-batch-size rotation-batch-size;maximum-session-size maximum-session-size;disk-load-buffer-size disk-load-buffer-size;network-buffer-size network-buffer-size;retry-interval retry-interval;communications-timeout communications-timeout;load-timeout load-timeout;idle-timeout idle-timeout;maximum-backlog-ratio maximum-backlog-ratio;minimum-backlog minimum-backlog;}

    To configure the PTSP device driver session storage:

    1. From configuration mode, access the statements for the driver session storage.
      user@host# edit shared sae configuration driver junos-ptsp session-store
    2. (Optional) Specify the maximum age that a queue of buffered store operations (such as adding a session to the store or removing a session from the store) can reach before the queue is written to a session store file.
      [edit shared sae configuration driver junos-ptsp session-store] user@host# set maximum-queue-age maximum-queue-age

      Enter a value for the number of milliseconds in the range 0–2147483647. A value of –1 indicates that there is no limit. A value of 0 causes the session store to write each store operation to a session store file immediately.

    3. (Optional) Specify the number of buffered store operations that are queued before the queue is written to a session store file.
      [edit shared sae configuration driver junos-ptsp session-store] user@host# set maximum-queued-operations maximum-queued-operations

      Enter an integer in the range 0–2147483647. A value of –1 indicates that there is no limit. A value of 0 causes the session store to write each store operation to a session store file immediately.

    4. (Optional) Specify the maximum size that a queue of buffered store operations can reach before the queue is written to a session store file.
      [edit shared sae configuration driver junos-ptsp session-store] user@host# set maximum-queue-size maximum-queue-size

      Enter the number of bytes in the range 0–2147483647.

    5. (Optional) Specify the maximum size of session store files. When a file reaches this size, a new file is created.
      [edit shared sae configuration driver junos-ptsp session-store] user@host# set maximum-file-size maximum-file-size

      Enter the number of bytes in the range 0–2147483647.

    6. (Optional) Specify the percentage of space in all session store files that is used by live sessions. When the space in the session store files that is used by live sessions decreases to this percentage, the oldest session store file is compacted and appended to the newest session store file, and then the oldest session store file is deleted.
      [edit shared sae configuration driver junos-ptsp session-store] user@host# set minimum-disk-space-usage minimum-disk-space-usage

      Enter a percentage of disk space in the range 1–100. We recommend a range of 30-50.

    7. (Optional) Specify when the oldest session store file is rotated. The value specifies the number of sessions that are rotated from the oldest file to the newest file at the same time. While a set of sessions is rotated, no other session store activity can take place
      [edit shared sae configuration driver junos-ptsp session-store] user@host# set rotation-batch-size rotation-batch-size

      Enter an integer in the range 0–2147483647.

    8. (Optional) Specify the maximum size of a single subscriber or service session. Use this parameter to reserve memory for an internal buffer.
      [edit shared sae configuration driver junos-ptsp session-store] user@host# set maximum-session-size maximum-session-size

      Enter the number of bytes in the range 0–2147483647.

    9. (Optional) Specify the size of the buffer that is used to load all of a session store's files from disk at startup.
      [edit shared sae configuration driver junos-ptsp session-store] user@host# set disk-load-buffer-size disk-load-buffer-size

      Enter the number of bytes in the range 0–2147483647.

    10. (Optional) Specify the size of the buffer that holds messages or message segments that are waiting to be sent to passive session stores.
      [edit shared sae configuration driver junos-ptsp session-store] user@host# set network-buffer-size network-buffer-size

      The number of bytes entered must be larger than or equal to 21 plus maximum-session-size and less than 2147483647.

    11. (Optional) Specify the time interval to be allowed between attempts by the active session store to connect to missing passive session stores.
      [edit shared sae configuration driver junos-ptsp session-store] user@host# set retry-interval retry-interval

      Enter the number of milliseconds in the range 0–2147483647.

    12. (Optional) Specify the amount of time in milliseconds that a session store should wait before closing when it is blocked from reading or writing a message. This timeout does not apply when a session store is waiting for a remote session store to load its state from disk.
      [edit shared sae configuration driver junos-ptsp session-store] user@host# set communications-timeout communications-timeout

      Enter the number of milliseconds. (A nonpositive number means wait forever. This is not recommended.)

    13. (Optional) Specify the amount of time in milliseconds that an active session store should wait for a passive session store or a passive session store waits for an active session store to load its data from disk before it closes the connection to the session store.
      [edit shared sae configuration driver junos-ptsp session-store] user@host# set load-timeout load-timeout

      Enter the number of milliseconds. (A nonpositive number means wait forever. This is not recommended.)

    14. (Optional) Specify the amount of time that a passive session store waits for activity from the active session store before it closes the connection to the active session store. This timeout applies after the session store startup and initial update processes are complete.
      [edit shared sae configuration driver junos-ptsp session-store] user@host# set idle-timeout idle-timeout

      Enter the number of milliseconds in the range 0–2147483647.

    15. (Optional) Specify the maximum backlog ratio. Along with the minimum backlog size, this ratio specifies when the active session store closes the connection to a passive session store because of a backlog of messages waiting to be sent. After the startup and initial update processes are complete, if the backlog becomes too large, the connection to the passive session store is closed. After the retry interval ends, a new connection is opened.

      If the backlog of unsent operations (in bytes) divided by the total size (in bytes) of all live store operations is greater than this number, the connection is closed.

      [edit shared sae configuration driver junos-ptsp session-store] user@host# set maximum-backlog-ratio maximum-backlog-ratio

      Enter a floating point number.

    16. (Optional) Specify the size of the minimum backlog. Along with the maximum backlog ratio, this number specifies when the active session store closes the connection to a passive session store because of a backlog of messages waiting to be sent to the passive session store. After the startup and initial update processes are complete, if the backlog becomes too large, the connection to the passive session store is closed. After the retry interval ends, a new connection is opened. If the maximum backlog ratio is met, the active session store does not close the connection unless the backlog of messages (in bytes) is greater than this number.
      [edit shared sae configuration driver junos-ptsp session-store] user@host# set minimum-backlog minimum-backlog

      Enter the number of bytes in the range 0–2147483647.

    Published: 2014-06-25