Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

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:

To configure the PTSP device driver session storage:

  1. From configuration mode, access the statements for the driver session storage.
  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.

    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.

    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.

    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.

    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.

    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

    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.

    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.

    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.

    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.

    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.

    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.

    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.

    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.

    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.

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