Managing Consumption of Router Resources

This section describes the ways how you, as a network administrator, can manage the consumption of router resources on a Message VPN-basis. It also describes how you can set resource consumption limits for endpoints and to control access to resources through client profiles.

Note that to effectively plan how to manage router resources on a Message VPN‑basis, you should be familiar with the following:

  • the system-level limits for Guaranteed Message delivery (for example, the maximum number of Message VPNs and the maximum combined number of queues and topic endpoints that are permitted)
  • the maximum Guaranteed message ingress rates offered by the types of VMRs and appliances used in your network. These rates are useful for determining what type of load Message VPNs could encounter.

In addition, if you are deploying routers in high-availablity (HA) pairs and/or you are using replication for disaster-recovery site protection, you must ensure that the routers used in the HA pairs and/or replication clusters are evenly matched. That is, the routers that are provisioned should have equivalent operating limits so that if a failover occurs, the router that takes over service can support the same number of active client and Message VPNs that the out-of-service router was supporting.

Overbooking Router Resources

You can configure Message VPNs on the Solace router so that:

  • a full overbooking of all router resources is allowed

    This means that any Message VPN can consume all available router resources. This is the router default.

  • partial overbooking of router resources by Message VPNs is allowed

    This means that no single Message VPN may consume all resources, but their configured resource consumption limits are high enough that, in combination, they could reach the system limit.

  • no overbooking of router resources is allowed

    This means that the sum of the configured consumption limits of all Message VPNs will not exceed the system limits.

Example Overbooking Scenarios

The scenarios below show examples of full, partial, and no overbooking scenarios for the maximum permitted number of client connections for a model of 3260 appliance that has a total system limit of 9,000 simultaneous client connections:

  • Fully-Overbooked Routers—Scenario A shows a fully overbooked router where the maximum permitted number of simultaneous client connections for each Message VPN is the same as maximum allowed for the entire router.

    Full Overbooking of Router

  • Partially-Overbooked Routers—Scenario B shows a partially overbooked router. Although no single Message VPN allows the maximum permitted number of simultaneous client connections, the limits for the Message VPNs in combination exceed the system limit.

    Parital Overbooking of Router

  • Non-Overbooked Routers—Scenario C shows a router that is not overbooked. In this scenario the total maximum number of permitted simultaneous client connections for the entire router cannot be exceeded even when the values for each Message VPN are combined.

    No Overbooking of Router

Setting Consumption Limits for VPNs

The table below lists the router configuration parameters that you can use to control the consumption of router resources on a per-Message VPN-basis.

Message VPN-Based Limits

Resource Parameter

To set, see...

The maximum number of clients that can simultaneously connect to a Message VPN.

Note:  The number of simultaneous client allowed for a Message VPN depends on the type of Solace router.

Configuring Maximum Connections

The maximum number of local client subscriptions that can be added to a Message VPN.

Configuring Maximum Subscriptions

The maximum amount of system-level message spool disk space (in MB) that a Message VPN can use.

Note:  The default value for the amount of disk storage permitted for a Message VPN is 0. Therefore, a value must be configured after a Message VPN is created so that it can spool messages.

Configuring the Max Spool Usage

Note:  This is also configurable on a per-Guaranteed endpoint‑basis.

The maximum number of simultaneous transacted sessions allowed for a Message VPN.

Configuring the Max Number of Transacted Sessions

The maximum number of queue and topic endpoints that can be created.

Configuring the Max Number of Endpoints

The maximum number egress flows (that is, Guaranteed message client receive flows) that can be created.

Configuring the Max Number of Flows

The maximum number ingress flows (that is, Guaranteed message client publish flows) that can be created.

Configuring the Max Number of Flows

Setting Consumption Limits for Endpoints

The table below lists the router configuration parameters that you can use to control the consumption of router resources on a per-endpoint-basis.

Endpoint-Based Limits

Resource Parameter

To set, see...

The maximum number of messages spooled to an endpoint that can be delivered to a client on a flow but remained unacknowledged the client.

The maximum message size (in bytes) permitted for the given durable message queue or topic endpoint.

The maximum amount of message spool disk space (in MB) that a queue or a topic endpoint is permitted to use.

Controlling Client Access to Resources

For each Message VPN, you can configure client profiles that set limits to control clientsʼ consumption of router resources. These client profiles are then applied to the client usernames that clients use to authentication with the router.

The following table lists client profile parameters that affect the amount of router resources clients can consume.

Router Resources Accessed Through Client Profiles

Resource Parameter

To set, see...

The maximum number of client connections that can simultaneously connect with the same client username account.

Configuring Max Connections Per Username

The maximum number of local client subscriptions allowed for a single client connection.

Configuring Max Permitted Subscriptions

The maximum depth of egress per-client priority queues, as measured in work units of 2048 bytes.

Configuring Egress Priority Queues

The maximum number of topics the router can track for performing the eliding function on each client connection.

Configuring the Maximum Number of Topics to Elide

Allow or deny clients to publish Guaranteed messages.

Note:  Publishing Guaranteed messages consumes message spool resources in the Message VPN when messages are enqueued for delivery to Guaranteed Messaging consumers. You can adjust this parameter to ensure that only authorized clients are allowed to publish Guaranteed messages.

Allowing Guaranteed Message Sends

Allow or deny clients to create Guaranteed endpoints.

You can adjust this parameter to ensure that only authorized clients are allowed to create Guaranteed endpoints.

Allowing Guaranteed Endpoint Creates

The maximum number of durable and non‑durable queues and topic endpoints that can be owned by clients using the same client username.

Allowing Guaranteed Endpoint Creates

Allow or deny clients to use transacted sessions using Solace messaging APIs.

You can adjust this parameter to ensure that only authorized clients are allowed to create Guaranteed endpoints.

Allowing Transacted Sessions

The maximum number of simultaneous transacted sessions allowed for a single client connection.

Configuring the Max Number of Transacted Sessions