Configuring 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).

About this task

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

Table 1. Required wsadmin commands
Command	Purpose
IBM Business Monitor CEI event service (wbmDeployCEIEventService command)	Creates and configures the CEI event service that IBM Business Monitor requires to receive and send events.
IBM Business Monitor event emitter factory (wbmConfigureEventEmitterFactory command)	Configures the event emitter factory that IBM Business Monitor requires to generate and send events. This command must be run after the wbmDeployCEIEventService command.
IBM Business Monitor messaging engine and bus (wbmDeployMessagingEngine command)	Installs and configures the messaging engine and service integration bus required for IBM Business Monitor.
IBM Business Monitor action services (wbmDeployActionServices command)	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.
IBM Business Monitor scheduled services (wbmDeployScheduledServices command)	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.

Table 2. Optional wsadmin commands
Command	Purpose
IBM Cognos BI service (wbmDeployCognosService command) Existing IBM Cognos BI connection (wbmSetCognosDispatcher command)	Installs a new IBM Cognos® Business Intelligence service for multidimensional analysis, or connects to an existing IBM Cognos BI service.
IBM Cognos BI content store database password maintenance (wbmSetCognosDatabaseUser command) IBM Cognos BI administrative access password maintenance (wbmSetCognosAdminUser command)	Changes the passwords for the IBM Cognos BI content store database and the IBM Cognos BI administrator.
Remove IBM Cognos BI service (wbmRemoveCognosService command)	Removes the IBM Cognos BI service that was installed with IBM Business Monitor.
IBM Business Monitor dashboards for mobile devices (wbmDeployDashboardsForMobileDevices command)	Installs and configures the application that is required for running the dashboards on mobile devices.
Event emitter services (wbmDeployEventEmitterServices command)	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, 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 . 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.
BPM emitter service (wbmDeployBPMEmitterService command)	Installs and configures the IBM Business Process Manager event emitter service application for use by IBM BPM.
Table-based bus configuration across multiple cells for IBM Business Monitor (wbmConfigureQueueBypassDatasource command)	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, complete the following steps:

Procedure

Open a command prompt, and change directories to the bin directory of the deployment manager 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 network deployment 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 IBM Business Monitor configuration commands (wsadmin scripting).