Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Configuring the Session Store Feature (SRC CLI)

 

You can configure three things for the session store feature:

Configuring Session Store Parameters for a Device Driver

Use the following configuration statements to configure session store parameters within a device driver configuration:

To configure session store parameters within a device driver configuration:

  1. From configuration mode, access the configuration statement that configures the session store for your device driver. In this sample procedure, the session store for a Junos device driver is configured in the se-region group.

  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.

  3. (Optional) Specify the number of buffered store operations that are queued before the queue is written to a session store file.

  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.

  5. (Optional) Specify the maximum size of session store files.

  6. (Optional) Specify the percentage of space in all session store files that is used by live sessions.

  7. (Optional) Specify the number of sessions that are rotated from the oldest file to the newest file at the same time that the oldest session store file is rotated.

  8. (Optional) Specify the maximum size of a single subscriber or service session.

  9. (Optional) Specify the size of the buffer that is used to load all of a session store’s files from disk at startup.

  10. (Optional) Specify the size of the buffer that holds messages or message segments that are waiting to be sent to passive session stores.

  11. (Optional) Specify the time interval between attempts by the active session store to connect to missing passive session stores.

  12. (Optional) Specify the amount of time that a session store waits before closing when it is blocked from reading or writing a message.

  13. (Optional) Specify the time that an active session store waits 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.

  14. (Optional) Specify the time that a passive session store waits for activity from the active session store before it closes the connection to the active session store.

  15. (Optional) Specify when the active session store closes the connection to a passive session store because of a backlog of messages waiting to be sent.

  16. (Optional) Verify your configuration.

Configuring Global Session Store Parameters

This topic describes how to configure global session store parameters that are shared by all session store instances (active or passive) on the SAE. You can also configure session store parameters within a device driver configuration.

Use the following configuration statements to configure global session store parameters.

To configure global session store parameters:

  1. From configuration mode, access the configuration statement that configures the global session store parameters. In this sample procedure, the global session store is configured in the se-region group.

  2. (Optional) Specify the expiry age of the dormant session store file. The service activation engine (SAE) deletes the session store file if it is not modified for the configured period. The value range is 0–2,147,483,647 milliseconds. By default, the value is set to 604,800,000 milliseconds—that is, 7 days.

  3. (Optional) Specify the frequency at which the server monitors the age of the session store file. The value range is 1000–2,147,483,647 milliseconds. By default, the value is set to 3,600,000 milliseconds—that is, 1 hour.

  4. (Optional) Specify the IP address or hostname that the session store infrastructure on this SAE uses to listen for incoming TCP connections from active session stores.

  5. (Optional) Specify the TCP port number on which the session store infrastructure on this SAE listens for incoming connections from active session stores.

  6. (Optional) Specify the root directory in which the session store creates files.

  7. (Optional) Verify your configuration.

Note

For the set file-expiry-age and set file-expiry-age-check-interval parameters, we recommend that you configure a value that is nearer to the default value. You must restart the SAE for the configuration changes to take effect.

Reducing the Size of Objects for the Session Store Feature

You can use serialized data compression to reduce the size of sessions objects that the SAE sends across the network for the session store feature. Enabling this property reduces the size of objects, but increases the CPU load on the SAE.

Use the following configuration statement to specify whether or not session objects are compressed.

To specify whether or not session objects are compressed:

  1. From configuration mode, access the sae configuration. In this sample procedure, data compression is configured in the se-region group.

  2. Enable reducing the size of session objects (subscriber and service sessions) that the SAE sends across the network for the session store feature.

  3. (Optional) Verify your configuration.