Contents

The default configuration of FioranoMQ gives optimum performance under most traffic loads and most common message sizes ranging from 0-10 KB.
FioranoMQ administrators can tune in the following configurations to get much better performance from the FioranoMQ Server.

PTP Configuration Parameters

FioranoMQ provides the following configuration parameters to tune the point-to-point messaging model.

In-Memory Persistent Message Buffer

FioranoMQ Server buffers the persistent messages in its in-memory cache besides storing these messages in the persistent store. This buffering is done to ensure fast delivery of messages to the listening receivers. The variable named PersistentInMemoryBufferSize depicts the size of the in-memory buffer whose default value is 512 KB (512*1024). This can be increased to higher values when the message send rate is quite high in which case this buffer gets filled up faster than a scenario where the send rate of messages is lower.
Following steps enable you to configure this parameter through Fiorano Studio in an online mode:

  1. Invoke the Fiorano Studio and login to the FioranoMQ Server.
  2. Select Destinations > Queues sub-node from the Server Explorer pane.
  3. Select the Queue name whose properties are to be displayed.
  4. In the Properties pane, enter the new value against the property named PersistentInMemoryBufferSize.

In-Memory Non-Persistent Message Buffer

FioranoMQ Server stores the published non-persistent messages in an in-memory table. The size of this buffer is taken care by the parameter named NPInMemoryBufferSize and its default value is 1 MB. This buffer can get fully loaded if the message send rate is quite high as compared to the message receive rate. When this buffer fills up, the FioranoMQ senders cannot push any more new messages into the buffer and they are blocked till a receiver is activated on the concerned queue to empty the buffer.
Therefore, it is recommended to set the size of the buffer to such a value that the chances of its becoming full are minimal especially in those cases where the senders are sending messages at a much faster rate than the rate at which receivers are receiving them.
Following steps enable you to configure this parameter through Fiorano Studio in an online mode:

  1. Invoke the Fiorano Studio and login to the FioranoMQ Server.
  2. Select Destinations > Queues sub-node from the Server Explorer pane.
  3. Select the Queue name whose properties are to be displayed.
  4. In the Properties pane, enter the new value against the property named PersistentInMemoryBufferSize.

Prefetch Count

Prefetch count is the number of messages that a client will request from the server in one receive call. Prefetch count can be set through a parameter named PrefetchCount using Fiorano Studio in the offline mode. The default value of this variable is 3. PTP prefetching enables FioranoMQ Server to deliver at most prefetch count messages to the receiving client at each receive call.
Perform the following steps to configure this parameter:

  1. Invoke the Fiorano Studio.
  2. Select Tools > Configure Profile from the menu bar, select the FioranoMQ folder, and click the Open button. This shifts the FioranoMQ environment to the offline mode.
  3. Navigate to FioranoMQ -> Fiorano -> mq -> ptp -> QueuingSubSystem in the Profile Manager pane. The properties of the PTP Manager are displayed in the Properties pane.
  4. Select ellipsis against the parameter PrefetchCount. Enter the new value in the resulting PrefetchCount dialog box and click OK.
  5. Right-click on FioranoMQ domain in the Server Explorer pane and select the Save option.

Prefetch Threshold

Prefetch threshold denotes minimum number of messages in the local buffer of the client that will trigger a request for delivery of more messages to the client. Prefetch threshold can be set through a parameter named PrefetchThreshold using Fiorano Studio in the offline mode.
The default value of this variable is 1. The number of messages that are requested from the server when threshold limit is reached is equal to the prefetch count.
Perform the following steps to configure this parameter:

  1. Invoke the Fiorano Studio.
  2. Select Tools > Configure Profile from the menu bar, select the FioranoMQ folder, and click the Open button. This shifts the FioranoMQ environment to the offline mode.
  3. Navigate to FioranoMQ -> Fiorano -> mq -> ptp -> QueuingSubSystem in the Profile Manager pane. The properties of the PTP Manager are displayed in the Properties pane.
  4. Select ellipsis against the parameter PrefetchThreshold. Enter the new value in the resulting PrefetchThreshold dialog box and click OK.
  5. Right-click on FioranoMQ domain in the Profile Manager pane and select the Save option.

PTP Prefetch size

This parameter is used to specify total size of messages (in bytes) that will be sent by FioranoMQ Server in every receive call made by the client. Prefetch size can be set through a parameter named MaxPrefetchSize using the Fiorano Studio in the offline mode. The default value of this variable is 512 KB. If both prefetch size and prefetch count are specified, then the number of messages sent by FioranoMQ Server is controlled by the minimum value among these two parameters.
Perform the following steps to configure this parameter:

  1. Invoke the Fiorano Studio.
  2. Select Tools > Configure Profile from the menu bar, select the FioranoMQ folder and click the Open button. This shifts the FioranoMQ environment to the offline mode.
  3. Navigate to FioranoMQ -> Fiorano -> mq -> ptp -> QueuingSubSystem in the Profile Manager pane. The properties of the PTP Manager are displayed in the Properties pane.
  4. Select ellipsis against the parameter MaxPrefetchSize. Enter the new value in the resulting MaxPrefetchSize dialog box and click OK.
  5. Right-click on FioranoMQ domain in the Profile Manager pane and select the Save option.

Queue Sender blocking interval

This parameter denotes the time interval in milliseconds for which sender will be blocked when it is unable to push more messages in the in-memory buffer maintained by FioranoMQ Server. Blocking interval can be set using the parameter named SenderBlockingInterval through Fiorano Studio in an online mode. The default value of this variable is 10 milliseconds. This parameter is used only in case of persistent messages. Setting this parameter to -1 allows a sender to continuously publish messages without blocking. Sender blocking interval is ignored if no receivers are registered on a queue.
Perform the following steps to configure this parameter:

  1. Invoke the Fiorano Studio and login to the FioranoMQ Server.
  2. Select Destinations > Queues sub-node from the Server Explorer pane.
  3. Select the Queue name whose properties need to be displayed.
  4. In the Properties pane, enter the new value against the property named SenderBlockingInterval and press Enter.
Adaptavist ThemeBuilder EngineAtlassian Confluence