Contents

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...


Figure 4: Common configuration options

Status Information

This tab lists the system properties and the corresponding values.

Click the information button present at the upper-right part of the SystemProperties page to view information such as the name of the logged in user, the access mode, time and date of FioranoMQ Server startup,  FioranoMQ product version number, build number, and the JVM version indicates whether the server JVM is 32 or 64 bits. 

Image Added
Figure 5: Status information

Angular WMT Views

Each tab in the left navigation panel of the WMT Angular dashboard are explained in detail in the following sections.

...

This view contains all existing Users and their respective connection status. Users are set as connected if a JMX connection is made or if a JMS client is started. This view also gives information about the maximum connection limit that is set for each user and the current number of connections created by the user.


Figure 56: Monitor Users MonitorUsers View

ConfigureUsers

This view contains the function to modify users. The options available are Add User, Delete Selected Users, Change Password for User, and set Maximum Connections per user, Import Users, and Export Users. These options are present in the Select Operation drop-down menu. To use any one of the option, click the Go button after selecting the required option.

...

The Import Users and Export Users options help copying users to another FioranoMQ Server. Export option allows exporting of all data to a standard file present on any machine. (Mapping needs to be done if the file is present on another machine.) The data can be imported to any other server that starts with FioranoMQ. 


Figure 67: Configure Users ConfigureUsers View

2. Groups

Configure Groups ConfigureGroups view contains information about all groups and its members. Groups can be added using the Add Groups option and deleted using the Delete Selected Groups option. For modifying members of an existing group, use the Edit Members in Group option after selecting the required group. These options are available in the Select Operation drop-down menu. Select the operation from the options available and click the Go button.


Figure 78: GroupViewGroup view

After selecting a group, if the selected operation is "Add Members to Group", an overlay panel a dialog box containing all members which could be added is displayed. Select the members and click Add to add the selected member to the selected group.


Figure 89: Editing Group Membersmembers

After selecting a group, if the selected action is "Remove Members from Group", an overlay panel containing all the current members of the group is displayed. Select the members and click Remove to remove the selected members from the selected group.


Figure 910: Removing Group Membersmembers

3. Topics

Monitor TopicsMonitorTopics

This section contains the information about existing topics with the sum of each displayed on the top of the page. An Active Topic refers to a topic that contains either a publisher or a subscriber. The Select Operation drop down lists the operations that can be executed on each Topic destination selected. The Send Message operation will send persistent text messages to the topic(s) selected. The Corrupted Topics check box, if selected, displays all the corrupted topics in the MonitorTopics view; by default, the view displays all the Topics (Corrupted and Non-Corrupted Topics). The corrupted topics can be recovered and replayed using the Recover Selected Topics and Replay Messages from Topics operations respectively.


Figure 1011: MonitorTopics View

Configure TopicsConfigureTopics

This section allows all operations to be performed on topics such as CreateTopic and DeleteSelectedTopics. The Restart Topics operation helps restart a specific Topic destination to apply the changes made to parameter values. The Shutdown Topics operation shuts the unwanted Topic destinations. 

...

Tip

More information on Destination Level Configurations is available in the Support for Destination Level Configuration section.


Figure 1112: ConfigureTopics View

By selecting the EditTopicProperties options from using the Edit Topic Subsystem Properties operation present under the Select ActionOperation drop-down menu and clicking the Go button, it is possible to view all topic subsystem properties and their corresponding values. Values with a different background color When properties highlighted in Bold are modified, the changes need to be saved . Once saved, the Server needs to and the server must also be restarted to make them take effect or if for them to apply the changes. If the changes are done at the destination level by using the Edit Topic restart alone will get the changes effected. A description of the property that is selected is provided at the bottom of the browser. The mouse may be moved over the textbox Properties operation, restart of that particular topic alone is enough to apply the changes. The mouse can be hovered over the text box to view the description of the any property. The Export Topics and Import Topics operations can be used to save topics to a standard file as well as to create all of them in a FioranoMQ server Server that is running. The operations -  

Note

Import Topics and Export Topics operations can be used only by the 'admin' User.

Tip
titleQuick Navigation

 Pressing CTRL key while selecting a table entry in either the MonitorTopics or ConfigureTopics view instantly navigates to the same table entry in the other component.


Figure 1213: Editing Topic Propertiesproperties

4. Queues

Monitor QueuesMonitorQueues

This view contains the information about existing queues with the sum of each displayed at the top of the table. Here, the Active Queue refers to the queues which contain either a sender or receiver. DeliverableMessages and UndeletedMessages are not updated at regular intervals. To update these values select all the required queues or invoke UpdateSelectedQueues or UpdateAllQueues Update Selected Queues or Update All Queues present in the Select Operation drop-down menu. Deliverable Messages count is the number of messages yet to be delivered from the Queue, and Undeleted Messages count denotes the number of messages yet to be acknowledged by the Consumer and deleted from the data base. 

The SendMessage Send Message operation will send persistent text messages to the queue(s) selected. The Corrupted Queues check box, if selected, displays all the corrupted queues in the MonitorQueues view; by default, the view displays all the Queues (Corrupted and Non-Corrupted Queues). The corrupted queues can be recovered and replayed using the Recover Selected Queues and Replay Messages from Queues operations respectively. The Purge Messages operation deletes all the messages in a selected Queue.


Figure 1314: MonitorQueues Viewview

The Browse Messages operation can be handy in browsing messages on a selected Queue and view its properties. 


Figure 14 15 : BrowseMessages  Browse Messages operation

Configure QueuesConfigureQueues

This view allows all operations to be performed on queues such as CreateQueue and DeleteSelectedQueues.  One can The Restart Queues operation restart a specific Queue destination to get apply the parameter changes done on it to get effected using the Restart Queues operationmade. The Shutdown Queues operation shuts unwanted Queue destinations. 

The Edit Queue Properties can  operation can be used to edit all properties related to a queue destination, whereas, the Edit Queue Subsystem Properties operation can be used to modify similar properties at the global level for all Queues.

Tip

More information on Destination Level Configurations is available in the Support for Destination Level Configuration section.

By using the EditQueueProperties Edit Queue Properties operation present under the Select Operation drop-down menu, it is possible to view all queue subsystem properties and their corresponding values. Values with different background colour  When properties highlighted in Bold are modified, the changes need to be saved . After saving, the Server needs to and the server must also be restarted for them to apply the changes. If the changes are done at the destination level by using the Edit Queue Properties operation, Queue restart alone will get of that particular queue alone would be enough to apply the changes effected. Description of each property that is selected is provided at the bottom of the browser. Hover the mouse over the textbox . The mouse can be hovered over the text box to view the description of the property. You are notified if any property requires save configuration and server restart was modified. The . The Export Queues and Import Queues operations operations can be used to save queues to a standard file as well as to create all of them in a the FioranoMQ Server server that is running.

Note

Import Queues and Export Queues operations can be used only by the 'admin' User.

Tip
titleQuick Navigation

 Pressing CTRL key while selecting a table entry in either the MonitorQueues or ConfigureQueues view quickly instantly navigates the user to the same table entry in the other component.

Noteinfo

As JMSProducer is a light weight object for which just a single message producer instance is created for it. So, even though multiple JMSProducers are created from the same JMSContext, it is considered as a single message producer object and while monitoring, the producer count of that context is shown as 1 (irrespective of the number of producers created).

5. ConnectionFactories

MonitorConnectionFactory

This view lists all the connection factories along with their important properties (such as ConnectUrl, AutoUpdate, Description, and Type), with a sum of each displayed at the top of the table.


Figure 1516: MonitorConnectionFactory Viewview

ConfigureConnectionFactory

This view allows various operations to be performed such as Create CF, Delete Selected CF, Edit CF Properties on Connection Factories. The Edit CF Properties can be used to edit all the properties related to the selected connection factory. The Create CF option present under the Select Operation drop-down list can be used to create new Connection Factories and the Delete Selected CF can be used to delete existing Connection Factories.


Figure 1617: ConfigureConnectionFactory ViewConfigureConnectionFactory view

Export and Import CF can be used to save Connection Factories to a standard file and to create all of them in a FioranoMQ Server that is running.

Note

Import and Export CF can be used only by the 'admin' User.

Tip
titleQuick Navigation

Pressing CTRL key while selecting a table entry in either the MonitorConnectionFactory or ConfigureConnectionFactory component instantly navigates to the same table entry in the other component.

6. Policies

ConfigurePolicies

Policies allow users to change permissions on a specific destination for a specific principal. By default, the view will show No restrictions on policies if the user had not modified any permission. If a user wants to modify any particular permission, then the user needs to use the Add Permissions option present in the Select Operations drop-down menu. A dialog box will appear with properties such as User Name, Destination Name, Positive Permissions, and Negative Permissions. After all required values are provided, click on Add button. The modified permissions will be updated in the table.


Figure 1718: Editing policies of a destination

...

The IP Access List view lists down the IP addresses which are allowed to connect to the the FioranoMQ server. By default, all the IP addresses are accepted by FioranoMQ Server, which is denoted by *.*.*.* representation. The Select Operation drop-down has two operations - Add IPAddress, for adding a new IP Address set/range to the allowed list and Remove IPAddress, for removing the IP Address entry from the list already available. While adding a new IP Address set/range, it can be added as IPV4 or IPV6 address(es).


Figure 1819: Adding IP address

7. Routes

...

If there are any routes present on the Server, those details will be displayed in the table. If no routes are present, a message "No routes available in the Server" is displayed in the table.


Figure 1920: Route added in the list

To Add or Delete a route from the Server, choose the appropriate operation from the Select Operation drop-down menu.


Figure 2021: Adding Route

Select any of the routes present in the table to display the properties of the corresponding routes in the table.


Figure 2122: Route Addedproperties

8.

...

Dashboard

The MonitorPerformanceGraphs view under Dashboard gives a graphical representation of Time vs Threads/Connections/Memory in the x axis and y axis respectively. The entries in the y axis may be selected based on the requirement; selecting more than one of these options displays graphs one below the other.


Figure 2223: Displaying a graph of Time Vs Memory

9. DurableSubscribers

Monitor DurableSubscriberMonitorDurableSubscriber

This view contains all existing durable subscribers listed along with other relevant information such as Subscription state, the Topic destination it is subscribing to, the deliverable number of messages for each durable Subscriber, the ClientId of the connection, and if it is a Shared Subscriber or not, and the number of active consumers under each Shared Subscriber.

A summary is present at the top of this window, denoting the total number of Durable Subscriptions for this instance of FioranoMQ Server. The Active Topics counter is updated based on the number of Topics having Active Durable Subscribers running. The Passive Topics counter is updated for Topics having Passive Durable Subscriptions.


Figure 2324: Monitor durable subscriptions

The Select Operation drop down has a single operation - 'Browse Messages' on a Durable Subscriber. 


Figure 2425: Browse messages Messages operation for durable subscription

Configure DurableSubscriptionConfigureDurableSubscription

This view contains all durable subscriber names in the form of subscriberID::clientID. Messages can be unsubscribed or purged messages for passive durable subscribers from this view. Any operations involving active durable subscribers throw a warning message.

Tip
titleQuick Navigation

Pressing Control CTRL key while selecting a table entry in either the MonitorDurableSubscription or ConfigureDurableSubscription component instantly navigates to the same table entry in the other component.

10. Connections

Monitor ConnectionsMonitorConnections

This view lists all types of connections along with their relevant properties, such as the 'ClientID' of the connection, the 'ClientAddress' indicates the IP address from which this connection is created, 'Type' of connection whether it belongs to PTP or PUBSUB model or an MQTT Connection type, the 'Destinations' column gives the list of destinations that this connection is using in the form either creating Producers or Consumers, the 'CreationTime', the 'User' credentials used for creating this connection, and the 'Protocol' used, the 'Total PSQSize' and the 'Max PSQSize'. It has three tabs, namely "Connections", "LPC" and "API keys".

A summary is present at the top of this window denoting the total number of connections and the under each category, PTP/PUBSUB/Admin connections.


Figure 2526: Monitor connections MonitorConnections view

Connections

Click on each Connection a connection row to display the following additional connection information:

  • Build Number: The build number of the client connection
  • CSPBaseDir: The CSP base directory used for this connection
  • ClientID: The ClientID used by this connection
  • ConnectionStarted: Boolean which indicates whether or not this connection has been started
  • Destination List: The list of destinations that this connection is using
  • Number of Browsers: The number of Browsers created under this connection
  • Number of Consumers: The number of Consumers created under this connection
  • Number of Producers: The number of Producers created under this Connection
  • Runtime Connection Type: The type of client runtime used to create this connection
  • Server Port: The server port to which this Connection is created.
  • Session Count: The number of Sessions created under this Connection
  • Version Number: The FioranoMQ Version number used by the Client Connection.
  • SocketInfoList: The list of sockets used by this connection


Figure 26: Monitor connections - connection 27: Connection information

LPC

This tab lists all connections which use the LPC protocol.


Figure 2728: Monitor connections  MonitorConnections - LPC tab view

API keys

This tab lists all the API keys which are used for the purpose of invoking resource methods on the server side, from the application. Some additional information such as the last-use timestamp of the API key, the IP address and the user involved in the creation of the API key are shown. Note that the API key which is being used by this instance of the WMT Angular application is highlighted in green.


Figure 2829: Monitor connections  MonitorConnections - API keys tab view

Configure ConnectionsConfigureConnections

This view has two tabs namely "Connections" and "API keys". The Connections tab allows the disconnection of a connection based on the clientID. The "API keys" tab allows the revocation of the desired API keys. Note that the API key which is being used by this instance of the WMT Angular application is highlighted in green.

Tip
titleQuick Navigation

Pressing Control CTRL key while selecting a table entry in either the MonitorConnections or ConfigureConnections component quickly instantly navigates to the same table entry in the other component. This can be done through both the Connections tab and the API keys tab.

11. Sockets

The MonitorSockets view contains information about all the sockets currently open within the Server. The sockets are created for each of the connections made to the server by the clients. The table gives information on Server ports, information about the client, the transport type, IP address of the Server, and whether SSL is enabled.


Figure 2930: Monitor SocketsMonitorSockets view

12. Logs

Monitor Log

...

MonitorLog

This view allows the user to fetch details of logs, view log details, and clear log details.

Configure Logs

...

ConfigureLogs

This view lists all the loggers used in the FioranoMQ Server. Selecting any particular logger changes its level.


Figure 3031: Changing the log level of a particular logger

13. JMX

This The ConfigureFMQServer view under JMX lists all the Mbeans along with their attributes and operations. When a particular Mbean is selected, a table containing the following two tabs gets displayedNavigate to the specific Mbean and click on it to display its Attributes and Operations. Click the Invoke button to invoke the particular attribute/operation.

Attributes

The Attributes tab lists all the attributes of present in the Mbean along with their values, parameter types and details such as AttributeName, Type, DefaultValue and isRestatRequired (whether a restart of the Server is required for changes to take effect) and an option to invoke these attributes.


Figure 3132: Attribute View of JMX

Operations

This tab lists all the operations present in that Mbean enabling the User to the Mbean along with their details such as OperationName, Impact, ReturnType, and isRestatRequired (whether a restart of the Server is required for changes to take effect) and an option to invoke these operations.


Figure 3233: Operations View view of JMX

14. AdvancedProperties

This view contains frequently used properties and their values. For example, the PORT_PRPERTIES tab contains the properties RMIBasedJMXServerPort and JettyServer port. These two ports and the JMS Server listening port (which is represented by the property "SocketAcceptorPort" under the category called ConnectionManager properties, under the tab called ConnectionManager__1) need to be unique for running multiple instances of the server on the same IPAddress. All of these values can be modified.


Figure 3334: PORT_PRPERTIES PROPERTIES tab in the AdvancedProperties Viewview

15. Licenses

The MonitorLicense view displays information of about all the licenses available. The License Filename list-box lists the available licenses. Selecting a license displays lists its corresponding license information in the table:below


Figure 3435: LicensesLicense information

16. SystemProperties

The SystemProperties view lists all the relevant properties and the corresponding values of the system on which the FioranoMQ Server is hosted. These values cannot be modified through the WMT Angular.


Figure 3536: System Properties

Status Information

This tab lists the system properties and the corresponding values.

Click the information button present at the upper-right part of the SystemProperties page to view information such as the name of the logged in user, the access mode, time and date of FioranoMQ Server startup,  FioranoMQ product version number, build number, and the JVM version indicates whether the server JVM is 32 or 64 bits. 

Image Removed
Figure 36: Status information

17. Audit Manager

Using the Audit Manager view it is possible to configure the Audit Storage Policies as well as monitor the audit events recorded in the Server.

...

In the Configuring Audit Policies view, the various kinds of Storage Policies which are responsible for generating Audit events are configured. In order to do this, the Modify Audit Storage Policy operation needs to be invoked after selecting one of the Storage Policies listed in the table inside the view. The storage policy will then need to be configured.


Figure 38: ConfigureAuditPolicies > Modify Audit Storage PolicyA ModifyAuditEvent policy

The recording of Audit events can be stopped by configuring the same storage policy that is used for enabling Audit Events. In order to do this, the action 'De-activate Storage Policy' needs to be invoked after selecting the Storage Policy which is to be de-activated.

...

Adaptavist ThemeBuilder EngineAtlassian Confluence