You can configure the required IBM® Business Monitor environment
using the configuration wizard in the administrative console.
Before you begin
You must have completed the following tasks:
- Created and federated at least one IBM Business Monitor custom
profile or augmented an existing custom profile with IBM Business Monitor (see
"Creating and augmenting profiles").
- Created at least one cluster using the defaultWBM application
server template (see "Creating IBM Business Monitor clusters").
- Configured a local Common Event Infrastructure (CEI) event service
that IBM Business Monitor can
use to send and receive events (see "Configuring CEI event services").
Before starting the configuration
process, make sure that you are synchronizing node changes automatically
(in the administrative console, click and select Synchronize changes with Nodes).
Otherwise, you must synchronize changes manually after each major
step.
About this task
You can configure the required and optional components
using the IBM Business Monitor configuration
section of the administrative console. For instructions to manually
configure all of the IBM Business Monitor components,
use the related information links to access the task information.
Procedure
- In the navigation panel, click . A list of required and optional components
is displayed. Review the status of each component. If you have an
ND environment and have not configured a deployment environment, none
of the components will be installed or configured, and you must complete
the remaining steps to install and configure the components.
- Configure the outbound CEI event service by completing
the following steps. The outbound CEI event service is
used to send events from IBM Business Monitor, including
alerts. You must configure an event emitter factory to point to the
outbound CEI event service.
Important: Before configuring
the event emitter factory, you must have a local CEI service that
IBM Business Monitor can
use to send events. If you need to create a local CEI service, see
Configuring CEI event services for instructions.
- In the list of components, click Outbound
CEI event service. The status for the
outbound CEI event service and event emitter factory is displayed.
If you have an existing MonitorEmitterFactory, the name of the CEI
event service that the emitter factory is configured to use is listed
in the status box. If you have not already configured the emitter
factory, you will see the message "Local CEI event service exists,
but event emitter factory does not exist." In that case, you must
create and configure the emitter factory.
- Under Configure an event emitter factory,
select the server or cluster for the event emitter factory. All
available servers and clusters are listed. You can select only servers
that have a CEI event service configured. (The available servers and
clusters are shown with asterisks (*)). If you have more than one
server with the same name, be sure to choose the server on the correct
node.
- To launch the configuration wizard, click Configure
the Event Emitter Factory. An outbound event
emitter factory named MonitorEmitterFactory is created for the cell.
The status box for the outbound CEI event service is updated to indicate
the CEI event service that the MonitorEmitterFactory is configured
to use.
- Return to the configuration page by clicking IBM Business Monitor configuration in
the breadcrumb listing.
- Create the service integration bus and configure the messaging
engine by completing the following steps. IBM Business Monitor requires
its own bus and messaging engine before it can monitor events.
If
you do not have an existing bus, one is created for you when you configure
the messaging engine. The bus is named MONITOR.<cell_name>.Bus and
the name cannot be changed.
- In the list of components, click Messaging
engine. The status for the service integration
bus and the messaging engine is displayed.
- To launch the configuration wizard, click Configure
the Messaging Engine.
- On the Select a bus member panel,
choose one of the following options to select the location where the
messaging engine will be created, and click Next:
- Cluster: Choose this option to create the
messaging engine on an existing cluster. You must select the cluster
name from the list.
- Server: Choose this option to create the
messaging engine on a server. You must select the server from the
list. If you have more than one server with the same name, be sure
to choose the server on the correct node.
- On the Select the type of message store panel,
choose one of the following options, and click Next:
- Data store: A data store is a message store
that contains a set of tables that are accessible to all members of
the cluster that hosts the messaging engine.
- File store: A file store is a message store
that uses files in a file system through the operating system. This
option is not available if you chose Cluster on
the Select a bus member panel.
- If you are using a data store, choose one of the following
options on the Provide the message store properties panel:
- Create a default data source with generated JNDI name: By
default, the data store uses Derby. This option is not available if
you selected Cluster on the Select
a bus member panel.
- Use an existing data source: If you select
this option, complete the following fields:
- Data source JNDI name: Select the JNDI
name that corresponds to the database that you are planning to use.
For example, jdbc/wbm/MonitorMEDatabase.
- Schema name: Enter the schema name. For
example, MONME00.
- Authentication alias: Select the authentication
alias that you are planning to use. You must select the authentication
alias if you want the tables to be created. For example, Monitor_JDBC_Alias.
- Create tables: Select this option to create
the tables in the database. If you do not select this option, the
database administrator must create the tables.
- On the Confirm panel, review
the information and click Finish to complete
the configuration. The bus and messaging engine status
boxes are updated with the new configuration information.
Note: You
might have to wait a few moments for the messaging engine to start
successfully.
- Return to the configuration page by clicking IBM Business Monitor configuration in
the breadcrumb listing.
- Verify that the bus and messaging engine have the correct
user ID for your environment:
- In the navigation panel, click .
- Click the bus for the IBM Business Monitor server. The Buses configuration properties page is displayed.
- Under Additional Properties, click Security. Another properties page is displayed.
- Under Authorization Policy, click Users and
groups in the bus connector role.
- Verify that your user ID exists. If it does not exist,
complete these steps to add it:
- Click New.
- Select Users, and a enter a filter that
will find your user ID. Click Next.
- Select your ID from the list and click Next.
- Review the changes and click Finish.
- Return to the configuration page by clicking IBM Business Monitor configuration in
the breadcrumb listing.
- Install the IBM Business Monitor action
services application by completing the following steps. The
action services application invokes actions, such as sending dashboard
alerts or email notifications, when it receives defined situation
events emitted by and other applications. Situation events typically
indicate business situations that need attention, such as a printer
running out of paper or a metric exceeding a certain value.
- In the list of components, click Action services. The status for the application is displayed. If the application
is properly installed, the location of the installed application is
listed in the status box.
- Under Deploy action services,
select the server or cluster for the action services application from
the list. All available servers and clusters are listed.
You must select a server where IBM Business Monitor has
been installed. If you have more than one server with the same name,
be sure to choose the server on the correct node.
- To install the application, click Deploy
Action Services. The application is installed
and the Monitor action services group profile is created. The application
status box is updated with the location of the installed application,
named IBM_WBM_ACTIONSERVICES. If this application has been installed
to a cluster, the application will appear unavailable until all nodes
in the cluster have been synchronized.
- Return to the configuration page by clicking IBM Business Monitor configuration in
the breadcrumb listing.
- Install the Monitor scheduled services application by completing
the following steps. You must install this application
to schedule recurring services, such as the data movement service
and the key performance indicator (KPI) history for monitor models.
- In the list of components, click Monitor
scheduled services. The status for the
application is displayed. If the application is properly installed,
the location of the installed application is listed in the status
box.
- Under Deploy Monitor Scheduled Services,
select the server or cluster for the Monitor scheduled services application
from the list. All available servers and clusters are listed.
You must select a server where IBM Business Monitor has
been installed. If you have more than one server with the same name,
be sure to choose the server on the correct node.
- To install the application, click Deploy
Monitor Scheduled Services. The application
status box is updated with the location of the installed application,
named IBM_WBM_DATA_SERVICES. If this application has been installed
to a cluster, the application will appear unavailable until all nodes
in the cluster have been synchronized.
- Return to the configuration page by clicking IBM Business Monitor configuration in
the breadcrumb listing.
You can view the scheduled services for each installed monitor
model by clicking
- Optional: If you plan to use the IBM Cognos® Business Intelligence service
to conduct multidimensional analysis on your dashboards, in the list
of optional components, click Cognos. The status
for the service is displayed. If the service is properly installed,
the location of the installed service is listed in the status box.
(If you installed IBM Cognos BI with IBM Business Monitor and
created a stand-alone profile, the IBM Cognos BI service
is already deployed.)
- To deploy a new IBM Cognos BI service,
select the server or cluster for the IBM Cognos BI service
from the list. All available servers and clusters are listed.
(The available servers and clusters are shown with asterisks (*)).
If you have more than one server with the same name, be sure to choose
the server on the correct node.
Provide a database name to be used
for the content store. On DB2® and Microsoft SQL Server, the database
name must be different from the MONITOR database name. Provide a database
user name and password. If you use the same user name for the content
store as for the MONITOR database, you must use the same password.
Because the database user provided for accessing the content store
database must have privilege to create tables in the database, it
is recommended that you create a new database user for the content
store database only.
Note: The user name and
password for the IBM Cognos BI content
store database are kept in the Cognos_JDBC_Alias, which allows all
database credentials to be maintained in one place. Whenever you start
the IBM Business Monitor IBM Cognos BI server,
the current values are passed to the IBM Cognos BI configuration
to allow IBM Cognos BI access
to the content store. Because of this integration, you cannot change
the content store user name and password using the IBM Cognos BI Configuration
application.
If administrative
security is enabled, you must also provide the IBM Cognos BI administrator
user name and password.Click Create a New Cognos Service.
The status box is updated with the location of the installed service.
If this service has been installed to a cluster, the service will
appear unavailable until all nodes in the cluster have been synchronized
and restarted. If the deployment takes more time than is provided
by the administrative console response timeout, you might see a timeout
message. Wait a few more minutes before attempting to restart the
servers.
- If you already have an existing version of IBM Cognos BI installed,
under Use an existing Cognos service, provide
the external dispatcher URI of the IBM Cognos BI server. You can find this URI in the IBM Cognos BI configuration
client in (for example, http://my_host:my_port/p2pd/servlet/dispatch/ext).
If administrative security is enabled on the IBM Cognos BI server,
you must also provide the IBM Cognos BI administrator
user name and password.
Click Use an Existing Cognos
Service. The status box is updated with the location of
the installed service.
- Return to the configuration page by clicking IBM Business Monitor configuration in
the breadcrumb listing.
- Optional: If you plan to use the IBM Business Monitor dashboards
on mobile devices, you must install the application by completing
the following steps. If you do not plan to use the dashboards
on mobile devices, you are not required to complete these steps.
- In the list of optional components, click Dashboards
for mobile devices. The status for the
application is displayed. If the application is properly installed,
the location of the installed application is listed in the status
box.
- Under Deploy Dashboards for mobile devices,
select the server or cluster for the dashboards on mobile devices
application from the list. All available servers and clusters
are listed. You must select a server where IBM Business Monitor has
been installed. If you have more than one server with the same name,
be sure to choose the server on the correct node.
- To install the application, click Deploy
the Dashboards for Mobile Devices. The
application status box is updated with the location of the installed
application, named IBM_WBM_MOBILE_DASHBOARD. If this application has
been installed to a cluster, the application will appear unavailable
until all nodes in the cluster have been synchronized.
- Return to the configuration page by clicking IBM Business Monitor configuration in
the breadcrumb listing.
- Optional: If you plan to use the Java Messaging
Service (JMS) and Representational State Transfer (REST) event emitter
services, you must install the API service applications by completing
the following steps. Rather than coding or generating
Common Base Events directly, you can then use these event emitter
services. You provide the event XML, and the event emitter services
receive the event XML and wrap it in a Common Base Event so that IBM Business Monitor can
process it.
- In the list of optional components, click Inbound
event emitter services (JMS and REST). The
status for the applications is displayed. If the application are properly
installed, the locations of the installed applications are listed
in the status box.
- Under Deploy event emitter services,
select the server or cluster for the applications from the list. All available servers and clusters are listed. You must select
a server where IBM Business Monitor has
been installed. If you have more than one server with the same name,
be sure to choose the server on the correct node.
- To install the applications, click Deploy
Event Emitter Services. The application
status box is updated with the locations of the installed applications.
If the applications have been installed to a cluster, the applications
will appear unavailable until all nodes in the cluster have been synchronized.
- Return to the configuration page by clicking IBM Business Monitor configuration in
the breadcrumb listing.
- Optional: To configure the Representational
State Transfer (REST) Services Gateway for widgets for Business Space, complete
the following steps.
Note: Because the REST Services Gateway
is a shared component, you cannot configure it using the configuration
wizard. If you create clusters using the deployment environment configuration
wizard, or create a stand-alone profile, the REST Services Gateway
is configured for you. The REST Services Gateway must be deployed
and registered with Business Space before
your team can use the widgets in Business Space.
- In the administrative console, click or .
- Click the name of your server or cluster.
- On the Configuration page, under Business
Integration, click Rest Services.
- Optional: To configure Business Space, complete
the following steps.
Note: Because Business Space is a shared
component, you cannot configure it using the configuration wizard.
If you create clusters using the deployment environment configuration
wizard, or create a stand-alone profile, Business Space is configured
for you.
- In the administrative console, click or .
- Click the name of your server or cluster.
- On the Configuration page, under Business
Integration, click Business Space Configuration.
- After you have finished configuring components, synchronize
the nodes. In the administrative console, click System
administration > Nodes, select all of the nodes, and
click Full Resynchronize. Then stop and restart
all of the clusters and servers.
Results
To verify that all applications are correctly installed
and configured, log out of the administrative console. Then, log in
to the administrative console and navigate to . Verify that all items are complete and marked with
a green check icon.
What to do next
If you did not choose to create the messaging engine tables,
or did not have permission to create them, the tables must be created
manually by a database administrator. See "Creating messaging engine
tables manually" in the related links.
If you want to receive
events from a CEI event source that is running on a remote server,
you must also perform cross-cell configuration. See "Configuring how
to receive events" for instructions.