- Login Page
- Server Status
- Document Tracking
- Audit Management
- Resource Search
- Advanced Properties
- Enabling Fiorano Web Console
Fiorano Webconsole provides a web based monitoring tool for the Fiorano ESB Network and hence is commonly called as the Dashboard. Apart from the monitoring feature, it also provides support for launching, stopping and restarting an application using a web interface. Below section gives a comprehensive insight on how to log on to the Dashboard and about the features available in each section of the Dashboard.
Fiorano ESB Webconsole can be accessed by starting the Fiorano Enterprise Server (FES) and then opening http://localhost:1980/ESBDashboard on a web browser.
Alternatively, access the Fiorano Web Container from the link present in the welcome page at http://localhost:1980.
Log in by entering the credentials configured for the FES; default credentials are:
- Username: admin
- Password: passwd.
Figure 1: Fiorano Web Console Login Page
The Fiorano 10 Web Console has eleven different sections, grouped logically, based on data presented:
- Server Status
- Document Tracking
- Audit Management
- Resource Search
- Advanced Properties
Server Status tab shows the details of the available Fiorano Servers. The top view shows the running status, memory usage and CPU Utilization. Further details are available on clicking the server links, which loads the bottom view with the following details:
- System Details - O/S and JVM statistics of the server
- Topics, Queues and Connections - List of JMS topics and queues present in the server and the connections created by the server
- Out and Error logs - Displays the server logs
Figure 2: Server Status tab showing System details
Figure 3: Server Status tab showing topics created by FES
Figure 4: Server Status tab showing connections created on FES
This section shows the details of the event processes running on the Fiorano Peer Server. The top view shows the list of event processes saved in the Fiorano Server. It also shows the details like running status, category and the Peer servers used. By clicking on the link for each event process, you get the details of the Service Instances running as part of it. This page also provides capabilities to launch, stop, restart an event process or its components, View Output and Error logs, and Export logs (These features is disabled if event process is in debug mode). The details for the services are displayed in the bottom view. This includes:
- Service Instance Name - Service components in the event process
- Service GUID - Service GUID of the component
- Version - Version of the component
- Status - Displays whether the component is running or not
- Running on Peer - Name of the peer server on which the component is launched
- Launch Type - Displays whether the component is launched as a separate process, in-memory or manual.
- Memory Usage - Displays memory usage for CCP enabled components
- Process ID - Displays process id for CCP enabled components which are executed as separate process
Figure 5: Applications Tab showing the details of the applications
You can monitor the performance of services by enabling the monitor performance in component CPS. Performance statistics are shown in two views:
This view shows performance messages sent by components in data form. You have the choice to select the components for which monitoring data should be displayed. Also, the time-interval for which monitoring data is displayed can be configured.
Figure 6: Data View tab
Performance of the component is represented in a graphical form. Graphs can be monitored for archived performance data or for the latest data. To show latest performance data, select Live Graph option. Maximum number of points plotted on the graph can be configured by specifying desired value for the Max Points field. It is recommended to use Firefox 2.0 or Internet Explorer to see Graph View.
Figure 7: Graph View
Provides the details of the events generated by the Fiorano Enterprise Server (FES) , the Fiorano Peer Server (FPS), Applications, Services, Security, and the SBW exceptions that occur while running various event processes.
Figure 8: Events tab showing the latest events
The Event tab has four sections:
- SMTP Alert Registration
- JMS Alert Registration
This gives the list of latest Events generated by FES and FPS. The visible Events can be filtered using the Event Type and Event Category options. Refer to Figure 9
To open Filter Event, perform the following steps:
- Click the Events tab from the Navigation Panel and choose Latest option; a list of latest Events generated by FES and FPS is displayed.
- Click the Filter Events button, as shown in the figure below; the Set Event Filters dialog box appears (Figure 10).
Figure 9 : Filter Events Button
- Choose the Event Type and Event Category from the drop-down list and click Done.
Figure 10: Set Events Filters dialog box
This section shows you Archived Events present in the database. You have the option to choose Event Type, Event Category, Date and Time range to view the corresponding Events.
To filter events, perform the following:
- Click the Events tab from the Navigation Panel and choose Archives option; a list of Archived Events is displayed.
- Click the Filter Events button, as shown in figure 11; the Set Event Filters dialog box appears (Figure 12).
Figure 11: Filter Events button
- Choose Event Type and Event Category from the drop-down list and click the Search button, as shown in the figure below. The result appears on the screen.
Figure 12: Set Event Filters dialog box
To delete Events, perform the following steps:
- Click the Events tab from the Navigation panel and choose the Archives option; a list of archived events appears.
- Select the relevant event and click the Delete selected records button.
Figure 13: Delete selected records button
- The Events Table Updated dialog box appears confirming the deletion; click OK.
Figure 14: Event Table Updated dialog box
SMTP Alert Registration
You can change the configuration of the mail server settings by going to the Configure SMTP Server Settings button. This page also provides an option to specify usernames and passwords in case the mail server requires authentication of these in order to send e-mails.
To add an Alert Configuration, perform the following:
- Click the Events tab form the Navigation Panel and choose SMTP Alert Registration option.
- Click the Add an Alert Configuration button; Configure SMTP Alert dialog box appears, as shown in Figure 16.
Figure 15: Add an Alert Configuration button
Choose the Event Type and Event Category from the drop-down list and enter the email ID of the recipient in Recipient Address field.
Figure 16: Configure SMTP Alert dialog box
- Finally, click the Add button to apply the changes. The list of currently configured email alerts appears.
Figure 17: Event e-mail registration option
To configure SMTP server settings, perform the following:
- Click the Events tab form the Navigation Panel and choose the SMTP Alert Registration option.
- Click the Configure SMTP Server Settings button; Configure SMTP Server Settings dialog box appears as shown in Figure 18.
- Enter the details and click on Validate button, if the validation is successful, then click SaveConfigurations button to save the configurations and click Done.
Figure 18: Configure SMTP Server Settings dialog box
JMS Alert Registration
You can configure the JMS server settings by going to the Configure JMS Server Settings button. This page also provides an option to specify usernames and passwords in case the JMS server requires authentication
To add an Alert Configuration, perform the following steps:
- Click the Events tab form the Navigation Panel and choose JMS Alert Registration option.
- Click the Add an Alert Configuration button; Configure JMS Alert dialog box appears, as shown in Figure 20.
Figure 19: Add an Alert Configuration button
Choose the Event Type and Event Category from the drop-down list and enter the Destination Name(can be new or existing destination).
Figure 20: Configure JMS Alert dialog box
- Finally, click the Add button to apply the changes. The list of JMS configured alerts appears.
Figure 21: Event JMS registration option
To configure JMS Server settings, perform the following steps:
- Click the Events tab form the Navigation Panel and choose the JMS Alert Registration option.
- Click the ConfigureJMSServerSettings button; Configure JMS Server Settings dialog box appears, as shown in Figure 22.
- Enter the details and click the Validate button. If the Validation is Successful, then click Save Configurations button to save the configurations, and click Done.
Figure 22: Configure JMS Server Settings dialog box
This section shows all the tracked documents in Fiorano Event Processes under SBW Workflows Count section along with details of the tracked documents under SBW Documents section below.
Figure 23: Document tracking tab showing tracked documents
The details of each tracked document can be seen by clicking the particular document's Workflow ID (see the figure above). This shows the document details such as the component processing it, time stamps, document IDs and the originating port of the tracked document.
Figure 24: Details of the tracked document
Properties of the tracked documents can be seen by clicking on a particular Document ID (see the figure above), which shows the tracked document message properties, details of attachments, application context, message body and other general properties.
Figure 25: Tracked document
Application Level Document Tracking
You can Enable/Disable Document Tracking at Application Level by clicking the Enable/Disable Application Level Document Tracking button present at the upper-right side of the screen. Select the Application and Version for which document tracking has to be enabled/disalbed and click Enable'/'Disable.
Figure 26: Application Level Document Tracking
You can reset the counters of Workflows and Exception Documents as visible in the Application Documents tab. The reset action can also be undone later. Click the Reset Counters button present at the upper-right side of the screen to . Select the Application and Version for which document tracking has to be reset and click Submit. The counters to be reset can be selected by selecting the appropriate checkbox, options being In Transit, Completed, Exception Documents and Undo Reset.
Figure 27: Reset Counters
Searching Tracked Documents
The Dashboard supports searching of tracked documents based on various criteria such as, Application Name, Version, Service, Port Name, User DOC ID, Workflow Instance ID, Document ID, FPS Name, Status. Document Status (EXECUTED or EXECUTING) and Message. In addition, documents can be searched based on their date they were generated. To provide the search options, click Search section and then click the Filter SBW Documents button present at the upper-right part of the screen.
Figure 28: Searching tracked documents
Documents can be selected as per choice and re-injected using the ReInject Selected Documents button present in the upper-right part of the screen. This is mainly used to re-inject failed documents, that is, the messages that reach the exception port.
Deleting Selected Documents
To delete a document or a selected set of documents, select the record(s) and click Delete Selected Documents button present in the upper-right part of the screen.
Scheduling Deletion of SBW Documents
To understand how to schedule a deletion task for old SBW documents and thereby create some disk space, refer How to schedule Deletion of SBW Documents section. This helps in avoiding issues like Low Disk Space error.
The monitoring section helps you add policies or alerts to monitor the Fiorano Network.
The Monitoring tab has the following sections:
- Monitor Messages
- Policy Manager
- Alert Manager
This tab allows to Monitor Pending Messages, Deliverable Messages, Undeleted Messages, Active Senders, and Receivers Count for the Queues of Applications in Running State. Queue Monitoring can be done in two views :
This view shows the Queue Information in data form.
To display data in Data view and monitor the Queues, click Filter Queues button at upper-right part of the screen; Monitoring Filter window appears.
Figure 29: Monitoring data Filters
Select PeerName, Application, Version and click Search Button; queues of the selected Applications will be displayed.
Figure 30: Enable Monitoring
The Queue Information will be displayed on clicking the Enable Monitoring button and to stop monitoring a particular queue, click the Stop Monitoring button.
Figure 31: Disable Monitoring
Queue Monitoring information is displayed in Graphical form. The Graph keeps on updating for every 5 seconds.
Figure 32: Graph View
This tab shows all the policies that are present in the Fiorano Network. This tab allows you to add new policies, edit or delete an existing policy, apply or suspend existing policies.
Two types of policies can be added:
- Backlog Policy
- LowMemory Policy
Figure 33: Policy Manager
This tab shows all the alerts that are present in the Fiorano Network. This tab allows you to add new alerts, edit or delete an existing alert.
Two types of alerts can be added:
- SMTP Alert
- JMS Alert
Figure 34: Alert Manager
This tab has two sub-tabs. These allow to specify the transport settings that will be used for sending the alerts. The settings can be specified for SMTP and JMS transports.
Figure 35: SMTP Transport
Figure 36: JMS Transport
Security section gives the security actions that can be performed in the Fiorano Network. These include adding/ editing users, groups, application level or group level permissions and validation or strength rules for passwords. These also include the principal store synchronization.
The Security tab has seven sections:
- Global Permissions
- Application Permissions
- Principal Store Sync
- Security Datastore Reset
- Password Rules
This tab shows you details of Users currently registered in the Fiorano network. The actions that can be undertaken in this tab include creating new users, deleting an existing user or changing password for an existing user, provided that you have the proper User Permissions to do so.
Figure 37: Users
This tab shows the groups registered in the Fiorano network. Groups allow grouping users together and applying actions on them together. The actions that can be undertaken in this tab include creating new groups, deleting/editing an existing group, provided that you have proper User Permissions to do so.
Figure 38: Groups
This tab shows the global permissions that are currently available in the Fiorano network. This tab allows you to edit or specify the users for whom these permissions will be applicable, provided that you have proper User Permissions to do so.
Figure 39: Global Permissions
This tab shows the application permissions that are available in the Fiorano network. This tab allows you to edit the application permissions for a user, provided that you have proper User Permissions to do so.
Figure 40: Application Permissions
Principal Store Sync
This tab shows the principal store synchronization status for the connected peers. This also allows you to synchronize the store for a peer.
Figure 41: Principal Store Sync
Security Datastore Reset
This tab shows the Security Datastore of the Enterprise Network. It also allows the authorized user to reset the entire Security Datastore viz. the Principals and the ACLs to system default.
Figure 42: Security Datastore Reset
This tab shows the validation and strength rules that are used for matching the passwords or determining their strengths. This tab allows you to add new rules or remove an existing one. By default, no validation rules are provided.
Figure 43: Password Rules
The Services tab shows the details of the event processes deployed as Web Services. You can view the status of web service either online or offline and has the option of enabling or disabling this option. You can also test RESTful deployed from the dashboard.
Figure 44: Web Services - Event process
Figure 45: Web Services tab
The details shown for the Event Process deployed as web services are:
- Context Name - Name of the context for the web service deployed
- End Point URL - Effective End Point URL is http://<peerserverip>:<httpport>/<rootContext>/ContextName
- Status - Shows whether the web service is online or offline
- Show WSDL - Gives the link to show WSDL
- Stub Name - Name of Stub for the deployed Event Process as web service
Audit Management section in web console allows you to define audit policies and search for audit events as per your requirement. This section has been divided into 3 sub-sections.
- Event Viewer
- Audit Policy Store Synchronization
In this view, you can view/edit available audit policies. These policies define the actions that will be audited by the system. In a fresh installation, all policies are in passive state, meaning none of the action is audited. You can selectively enable the actions that they want to audit.
Figure 46: Policies
This view shows audit events based on the search criteria's specified by you. A comprehensive list of audit event filters is available to refine the audit events as per your requirement. This view also allows saving search preferences for later use, thus avoiding the painful task of creating audit filters each time you need to search. Below is a snapshot of Event Viewer page rendered after searching for certain audit events.
Figure 47: Event Viewer
Audit Policy Store Synchronization
This view shows the result of synchronization of audit policy store operation (See image below). A synchronized audit policy store means that the same audit policies (as in Enterprise Server) are active in peer servers as well. If stores are not synchronized, the status field will display 'false' and the reason for which the synchronization not achieved will be displayed under Comment column. You can force re-synchronization of audit policies with a particular peer server by clicking on the image shown under 'Synchronize' column.
Figure 48: Audit Policy Store Synchronization
This section allows you to search for different resources that have been configured to be used by Fiorano Event Processes. The search for the resources can be performed on three different views:
- Application View
- Component View
- Resource View
Figure 49: Searching configured resources based on application view
Figure 50: Searching configured resources based on component view
Figure 51: Searching configured resources based on resource view
This tab allows you to change values of frequently used server properties from Dashboard.
Figure 52: Advanced Properties
Click the Change button of the attribute whose value has to be changed; Change value dialog box appears. Click OK after changing the value.
Figure 53: Change Attribute Value
Enabling Fiorano Web Console
The Fiorano Web Console can be enabled from Online as well as Offline mode.
To enable Fiorano Web Console in online mode (server running):
- Login to Peer server via JMX(FPS-JMX)
- Navigate to Fiorano > etc > Jetty Server > JettyServer > config and set EnableStart property to 'yes'.
- Right-click on FPS-JMX and click Save Configurations option.
- Shut down both Peer and Enterprise servers.
To enable Fiorano Web Console in offline mode (server not running):
- Open profile in eStudio, browse to Fiorano > etc > Jetty Server > JettyServer > config and set EnableStart property to 'yes'.
- Save profile.
After editing profile (online or offline), perform the following actions:
Clear peer repository using the following command
- Restart the servers.