IBM Cognos BI service

You can use the wbmDeployCognosService command to install a new IBM® Cognos® Business Intelligence service to a server or cluster. IBM Business Monitor uses IBM Cognos BI to conduct multidimensional data analysis from your dashboards. In the four-cluster topology, IBM Cognos BI is deployed to the support cluster.

Purpose

The wbmDeployCognosService command installs and configures a new IBM Cognos BI service for use with IBM Business Monitor.

You can also configure IBM Cognos BI for IBM Business Monitor in the following ways:

Use the IBM Business Monitor configuration wizard.
Create a deployment environment configuration.
Create a stand-alone server during IBM Business Monitor installation.

Important: For cluster members, at least 1 GB of extra disk space is required for IBM Cognos BI because a runtime instance must be created on each cluster member.

The wbmDeployCognosService command performs the tasks described in the following list:

Deploy the IBM Cognos BI EAR file to a cluster or server
Set the environment variable on the server (JVM) to point to the IBM Cognos BI code based on the bit mode of the server (pointing to the bin directory for the 32-bit mode or the bin64 directory for the 64-bit mode).
Set a custom property on the server (JVM) to point to the startup XML (COG_ROOT) file.
Create the IBM Cognos BI startup XML file for all members in the cluster. The startup XML file has the addresses for the gateway, dispatcher, and Content Manager, along with the settings for the authorization providers and database connection for the content store.
Set the endpoints for Lifecycle to find IBM Cognos BI for cube creation.
Create WebSphere authentication aliases to store the IBM Cognos BI content store database user ID and password and the IBM Cognos BI administrative ID and password.

Examples

You can use Jacl or Jython to install the IBM Cognos BI service. You can specify either a server and node or a cluster, but not both. The following examples specify a cluster.

(jacl) $AdminTask wbmDeployCognosService {-cluster cluster01 -dbName COGNOSCS -dbUserName username -dbUserPassword password -adminUserName admin -adminPassword password}

(jython) AdminTask.wbmDeployCognosService('[-cluster cluster01 -dbName COGNOSCS -dbUserName username -dbUserPassword password -adminUserName admin -adminPassword password]')

The following examples specify a server and node.

(jacl) $AdminTask wbmDeployCognosService {-server server1 -node bamd02Node01 -dbName COGNOSCS -dbUserName username -dbUserPassword password -adminUserName admin -adminPassword password}

(jython) AdminTask.wbmDeployCognosService('[-server server1 -node bamd02Node01 -dbName COGNOSCS -dbUserName username -dbUserPassword password -adminUserName admin -adminPassword password]')

Parameters

The wbmDeployCognosService command accepts the parameters listed in the following table.

Parameter and Value	Required?	Description	Comments
-cluster `cluster_name` \| -server `server_name` -node `node_name`	Required	The cluster to install the IBM Cognos BI service on, or the server and node to install the IBM Cognos BI service on.	If you specify a cluster, do not specify the server or node. If you specify the server, you must also specify the node.
-dbName `database_name`	Required	The name of the database or service being used by IBM Cognos BI for the content store.
-dbUserName `database_user_name`	Required	The name of the database user for the content store.	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.
-dbUserPassword `password`	Required	The password of the database user for the content store.	To change the password later, use the wbmSetCognosDatabaseUser command or change the security authorization alias.
-adminUserName `admin_user_name`	Optional	The user name of the IBM Cognos BI administrator.	The user name is not required because all users are allowed access until IBM Cognos BI is set up to limit access to the Admin group.
-adminPassword `admin_password`	Optional	The password of the IBM Cognos BI administrator.	To change the password later, use the wbmSetCognosAdminUser command or change the security authorization alias.
-bitMode 32 \| 64	Optional	The mode that the IBM Cognos BI server is running in.	Specify 32-bit or 64-bit mode. The default is 32 unless the Java™ system properties indicate 64. See Configuring the new IBM Cognos BI service for information about setting the environment properties.