Configure the environment using wsadmin commands

IBM Business Monitor, V8.0.1 > Install IBM Business Monitor > Configure the environment > Use custom topology
Configure the environment using wsadmin commands

Rather than using the configuration wizard, you can configure the IBM Business Monitor environment using the WebSphere command-line administration tool (wsadmin).

The following wsadmin commands are required to configure IBM Business Monitor.

Required wsadmin commands
Command Purpose
wbmDeployCEIEventService Creates and configures the CEI event service that IBM Business Monitor requires to receive and send events.
wbmConfigureEventEmitterFactory Configures the event emitter factory that IBM Business Monitor requires to generate and send events. This command must be run after the wbmDeployCEIEventService command.
wbmDeployMessagingEngine Installs and configures the messaging engine and service integration bus required for IBM Business Monitor.
wbmDeployActionServices Installs the IBM Business Monitor action services application. This application invokes actions, such as sending dashboard alerts or email notifications, when it receives defined situation events. This command must be run after the wbmConfigureEventEmitterFactory command.
wbmDeployScheduledServices Installs the Monitor scheduled services application that schedules recurring services, such as the data movement service and the key performance indicator (KPI) history for monitor models.

The following wsadmin commands are optional.

Optional wsadmin commands
Command Purpose
wbmDeployCognosService wbmSetCognosDispatcher Installs a new IBM Cognos Business Intelligence service for multidimensional analysis, or connects to an existing IBM Cognos BI service.
wbmSetCognosDatabaseUser wbmSetCognosAdminUser Changes the passwords for the IBM Cognos BI content store database and the IBM Cognos BI administrator.
wbmRemoveCognosService Removes the IBM Cognos BI service that was installed with IBM Business Monitor.
wbmDeployDashboardsForMobileDevices Installs and configures the application that is required for running the dashboards on mobile devices.
wbmDeployEventEmitterServices Installs and configures the REST event emitter service and the JMS event emitter service applications. The JMS event emitter can asynchronously publish XML events to a Java Messaging Service (JMS) queue without the Common Base Event wrapper, so that XML events can be put on the JMS queue even when IBM Business Monitor services are unavailable. The REST event emitter can synchronously publish events without the Common Base Event wrapper. You define the XSD that describes the structure of the business information, and the REST API generates and sends the event in the correct format for IBM Business Monitor.
wbmDeployBPMEmitterService Installs and configures the IBM BPM event emitter service application for use by IBM BPM.
wbmConfigureQueueBypassDatasource Creates the data source needed to enable queue bypass communication when IBM Business Monitor is installed in a different cell from the CEI server.

To run the wsadmin tool:

Procedure
Open a command prompt, and change directories to the bin directory of the dmgr profile (by default, DMGR01) where WebSphere Application Server is installed, or to the bin directory of the stand-alone profile in a single-server environment.
Launch wsadmin by running one of the following commands:

wsadmin.sh -lang jacl -user <user_name> -password <password>
wsadmin.sh -lang jython -user <user_name> -password <password>
wsadmin.bat -lang jacl -user <user_name> -password <password>
wsadmin.bat -lang jython -user <user_name> -password <password>
Run the commands you need. The following example uses Jacl to run the wbmConfigureEventEmitterFactory command and then save the changes:
$AdminTask wbmConfigureEventEmitterFactory {-cluster firstCluster} $AdminConfig save
The following example uses Jython:
AdminTask.wbmConfigureEventEmitterFactory('[-cluster firstCluster]')
AdminConfig.save()
After running the commands, save the changes before exiting wsadmin. To save the changes, use the following syntax:
(jacl) $AdminConfig save
(jython) AdminConfig.save()
In a ND environment, 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.
Interactive mode

When you use an administrative command in interactive mode, you go through a series of steps to collect your input interactively. This process provides a text-based wizard and a similar user experience to the wizard in the administrative console. If you use the -interactive parameter, you are prompted to enter each value in turn.
The following examples show how to use this parameter.
(jacl) $AdminTask wbmConfigureEventEmitterFactory {-interactive} (jython) AdminTask.wbmConfigureEventEmitterFactory('-interactive')
What to do next

You can use the help command to obtain help for any administrative command.
(jacl) $AdminTask help wbmConfigureEventEmitterFactory
(jython) print AdminTask.help ('wbmConfigureEventEmitterFactory') 
For the details and parameters of the commands, see Configuration commands (wsadmin).

Create the deployment environment using custom topology

Related tasks:
Configure REST services using the command line
Configure Business Space using the command line
Create messaging engine tables manually
Configure how to receive events
Configure CEI event services

Related reference:
Configuration commands (wsadmin)

Related information:

Starting the wsadmin scripting client using wsadmin scripting (WebSphere Application Server)

Command	Purpose
wbmDeployCEIEventService	Creates and configures the CEI event service that IBM Business Monitor requires to receive and send events.
wbmConfigureEventEmitterFactory	Configures the event emitter factory that IBM Business Monitor requires to generate and send events. This command must be run after the wbmDeployCEIEventService command.
wbmDeployMessagingEngine	Installs and configures the messaging engine and service integration bus required for IBM Business Monitor.
wbmDeployActionServices	Installs the IBM Business Monitor action services application. This application invokes actions, such as sending dashboard alerts or email notifications, when it receives defined situation events. This command must be run after the wbmConfigureEventEmitterFactory command.
wbmDeployScheduledServices	Installs the Monitor scheduled services application that schedules recurring services, such as the data movement service and the key performance indicator (KPI) history for monitor models.

Command	Purpose
wbmDeployCognosService wbmSetCognosDispatcher	Installs a new IBM Cognos Business Intelligence service for multidimensional analysis, or connects to an existing IBM Cognos BI service.
wbmSetCognosDatabaseUser wbmSetCognosAdminUser	Changes the passwords for the IBM Cognos BI content store database and the IBM Cognos BI administrator.
wbmRemoveCognosService	Removes the IBM Cognos BI service that was installed with IBM Business Monitor.
wbmDeployDashboardsForMobileDevices	Installs and configures the application that is required for running the dashboards on mobile devices.
wbmDeployEventEmitterServices	Installs and configures the REST event emitter service and the JMS event emitter service applications. The JMS event emitter can asynchronously publish XML events to a Java Messaging Service (JMS) queue without the Common Base Event wrapper, so that XML events can be put on the JMS queue even when IBM Business Monitor services are unavailable. The REST event emitter can synchronously publish events without the Common Base Event wrapper. You define the XSD that describes the structure of the business information, and the REST API generates and sends the event in the correct format for IBM Business Monitor.
wbmDeployBPMEmitterService	Installs and configures the IBM BPM event emitter service application for use by IBM BPM.
wbmConfigureQueueBypassDatasource	Creates the data source needed to enable queue bypass communication when IBM Business Monitor is installed in a different cell from the CEI server.