Explorer App is a full replacement of SwiftMQ Explorer contained in the commercial SwiftMQ UR and HA distributions.
It can be used to manage and monitor the router network that is connected to Flow Director.
The behavior and functionality of
Explorer App is similar to SwiftMQ Explorer so there is no learning curve if you switch
from one to the other.
Explorer App works on the management tree of a SwiftMQ router and issues
commands through CLI internally.
Explorer App does not communicate with the Management Swiftlet of a router but with its own flows that subscribe
directly to the management tree.
The default user is
admin with password
changeme. After login please change this password.
Open the menu at the upper left side. Click on
Authentication and you'll see 2 users:
admin is you. The other
user is someone who doesn't have the
App Configuration menu but sees the
It has also read-only access which means he cannot issue change commands with
Create as many users you like. For administrators assign the menu
admin.json. For normal users assign
you have created a new user you can specify read-only access by just toggling the
Read Only flag.
An administrator administers this app (create users, start/stop/view flows). It doesn't mean to be an administrator of the SwiftMQ router network. Those administrator are normal users with read-write access. Other non administrator users of a SwiftMQ router network will have read-only access.
Start the Flows
Click on the
Flow Orchestration menu. It shows you all
Select all flows and all routers. Click on the button
Set x Flows on y Routers and select
Activate as action:
SET and Flow Director will deploy and activate all flows on all routers:
Explorer App can now be used on all routers.
As an admin user
App Configuration menu is a
Explorer menu. Click on it brings up the
As a normal user
A normal user doesn't have a menu.
Explorer is immediately available after login.
The initial screen of
Explorer appears as follows:
The upper left side contains a selector to select the router. Below is the management tree of the selected router. This
panel can be slided in and out by clicking on the small arrow in the middle.
Explorer automatically selects the first
router that reports available. The right panel displays the content when you click on a node of the management tree.
To switch between routers use the selector at the top left:
To view the content of a certain node in the management tree, click on it. If it is an entity, it displays the content in the content area:
If it is an entity list, it displays the list as a table:
The content of a table is dynamic. Numeric values change their colors to red if the value has decreased and to green if the value has increased. No color is used if the value is unchanged.
The content that is displayed can be filtered by specifying a string in the upper right
Search field. The filter is
applied against the entity names and is a
The upper left circle button can be used to customize the displayed columns of the table. This is saved in the local storage of your browser.
Each table in the content area has also a chart area that can be slided in by clicking on the arrow at the right side in the middle:
The chart area has 3 slots to display 3 different charts. Click on
CONFIGURE to configure each slot with a chart by
selecting the columns you want to display. The configuration is also stored in the local storage at your browser so it
is persistent after re-login until you delete it.
The charts are displayed in the configured slots:
The charts display the current values with a history of 5 minutes (for area/bar charts). If you switch to other nodes of the management tree, data collection stops for these charts and is started new when you reselect this node.
Issue Change Commands
Change commands and their respective buttons are only available for users with read-write access.
If an entity is selected, the content is displayed in the content area. To edit values, press the
Then change the values and click
DELETE button is shown if the entity can be deleted. Click on it to delete the entity.
Changes are immediately saved in the configuration file of the SwiftMQ router.
Entity Lists (Tables)
Nodes in the management tree that represents an entity list (those with sub nodes) are shown as a table. Commands that can be applied are shown as buttons at the top left. Clicking on it will perform that command. This example creates a new queue:
Each entity in the table may have extra commands attached which are shown when clicking on the name:
Note that all commands will automatically save changes in the router configuration file.
Router Node Commands
There are commands that effect the router itself. These commands are shown if you click on the router node (top node):