Setting Up the Enterprise Monitor

Basic Setup

In the namespace where you want to define the Enterprise Monitor:

1. Create client configurations to enable connections to each production that you are monitoring.

2. Create a production where the production class is Ens.Enterprise.ProductionOpens in a new tab or a subclass of that class. You can create the production in an IDE or create it using the Management Portal and then edit it in an IDE as follows:

   1. In an IDE, open the class that defines the production.

   2. Replace the class Ens.ProductionOpens in a new tab with Ens.Enterprise.ProductionOpens in a new tab. For example, if the class definition is

      Class EMon.EntMonitorProd Extends Ens.Production

      Edit it so that the class extends Ens.Enterprise.ProductionOpens in a new tab so that it appears as:

      Class EMon.EntMonitorProd Extends Ens.Enterprise.Production

   3. Compile the class.

3. Add the Ens.Enterprise.MonitorServiceOpens in a new tab business service to the production and enable it.

   Do not use the similarly named Ens.MonitorServiceOpens in a new tab.

4. Start the production.

5. Optionally, define Enterprise Monitor Roles so that users of the Enterprise Monitor are able to see only specific configuration items.

6. Verify that the Enterprise Monitor is working:

   1. In the namespace where you defined the production, click Interoperability > Monitor > Enterprise Monitor.

   2. If you do not see a green bar for each client production, see Troubleshooting.

Configuring Enterprise Monitor Roles

You can limit the production components that are visible in the Enterprise Monitor based on the roles of the current user and the categories specified in the production configuration for the component. When a user displays the Enterprise Monitor, it checks if the user has any roles specified in the Enterprise Monitor Roles. If none of the roles match, the Enterprise Monitor displays information about all the components in the productions. If one or more of the roles match, the Enterprise Monitor displays information about components that have one of the specified categories.

To add new roles or edit an existing role, select Enterprise Monitor Roles on the Enterprise Monitor. The following illustrates the Enterprise Monitor Roles page:

To add a new role, select New Role. To edit or delete a role, select edit or delete. When you enter the role and category, the form does not list the existing roles or categories. You must know these and enter them as text. Once you have entered a category, it is available as a check box when you add or edit a role.

Troubleshooting

If the Enterprise Monitor is not working, this troubleshooting list may help you resolve the problem:

• If the Enterprise Monitor displays a message with “No Message Bank or Enterprise Production is running in this namespace”, then ensure that the Enterprise Monitor production is running.

  The specific message is as follows:

  Not currently collecting monitor data from configured client systems - No Message Bank or Enterprise Production is running in this namespace (EMONITOR) on machine testmachine6070:
  

  

• If the Enterprise Monitor displays a message with “Not currently collecting monitor data from configured client systems,” that indicates that the Enterprise Monitor production is not based on the correct superclass. This production must be based on the Ens.Enterprise.ProductionOpens in a new tab class. To fix this problem, edit the production in an IDE and change the class that it extends. Then compile the class and stop and restart the production.

  The specific message is as follows:

  Not currently collecting monitor data from configured client systems - No Message Bank or Enterprise Production is running in this namespace (EMONITOR) on machine testmachine6070:
  

  

• If the Enterprise Monitor does not display an error message but the clients are not being polled and the data is not being updated:

  Ensure that the Enterprise Monitor production contains the Ens.Enterprise.MonitorServiceOpens in a new tab business service and that it is enabled.

• If you observe an error where a non-functioning login screen appears in the Enterprise Monitor instead of an embedded graph, change your configuration to use https rather than http. In addition, set the web application’s Session Cookie Label setting to None. You can access your web application’s settings from System Administration > Security > Applications > Web Applications.

• If the Enterprise Monitor is unable to access a specific client production, double check the connection details for that client.

See Also

• Options for Monitoring Multiple Productions

• Using the Enterprise Monitor