IBM BPM, V8.0.1, All platforms > Install IBM BPM > IBM BPM Advanced for z/OS: Process Server > Configure IBM BPM Advanced for z/OS: Process Server > Configure components > Configure additional components > Configure Process Portal > Configure the Business Space component for Process Portal > Configure the Business Space component for ND environments

Configure the Business Space component using the command line

You can set up and configure the Business Space component using the wsadmin command. You can use the wsadmin command to perform the same configuration of Business Space that you can perform in the administrative console.

Before you begin this task, you must :

You can use the command line to configure Business Space if you want to write scripts instead of using the administrative console to configure Business Space. If you are not sure whether Business Space is already configured, you can run the getBusinessSpaceDeployStatus command to check whether Business Space is configured on a server, cluster, or cell. For more information about that command, see "getBusinessSpaceDeployStatus command."

To configure Business Space.


Procedure

  1. Open a command window.

    The wsadmin command can be found in the profile_root/bin directory for a stand-alone server environment, or in the deployment_manager_profile_root/bin directory for an ND environment.

  2. At the command prompt, type the wsadmin command to start the wsadmin environment.

  3. Use the installBusinessSpace command to install the Business Space enterprise archive (EAR) files in your runtime environment.

  4. Use the configureBusinessSpace command to configure the data source for Business Space and copy the scripts that configure the database tables to profile_root/dbscripts/BusinessSpace/ node_name_ server_name/ database_type/ database_name for a stand-alone server or profile_root/dbscripts/BusinessSpace/ cluster_name/ database_type/ database_name for a cluster.

    If you did not specify the createTables parameter as true when running the configureBusinessSpace command, run the scripts that configure the database tables. For more information about the scripts, see Configure the Business Space database.

    If you are using a database design file for database configuration, you can use the -bspacedbDesign parameter to designate that file when you run the configureBusinessSpace command.

    If you are using Windows Authentication with Microsoft SQL Server, make sure to specify the -dbWinAuth parameter as true.

  5. After each command, run AdminConfig.save( (Jython) or $AdminConfig save (Jacl).

  6. Run the scripts to configure the database tables for Business Space before starting the deployment environment or the clusters. See Configure the Business Space database.


Results

Configuring Business Space sets up a browser-based graphical user interface for the business users of your application that is running with the profile you set up. In Business Space, you and your application users can customize content from products in the WebSphere business process management portfolio.


Example

The following example uses Jython to run the installBusinessSpace and configureBusinessSpace commands to install the EAR files and configure the data source for Business Space on a cluster. The example designates the schema and the product database to use with Business Space when multiple products are installed. In a situation where both IBM BPM and IBM Business Monitor are installed, this example creates a Business Space data source using the properties of the IBM BPM data source. 

AdminTask.installBusinessSpace('[-clusterName myCluster -save
 true]')
AdminTask.configureBusinessSpace('[-clusterName 
	myCluster -schemaName mySchema -productTypeForDatasource
	WPS -save true]')

The following example uses Jacl: 

$AdminTask installBusinessSpace {-clusterName myCluster -save
 true}
$AdminTask configureBusinessSpace {-clusterName
 myCluster -schemaName mySchema -productTypeForDatasource
 WPS -save true}


What to do next

If you are using Oracle, the password of the authentication alias of the Business Space data source is set to the same name as the schema name of Business Space. The default value of the schema is IBMBUSSP. When you configure Business Space, you can specify a different schema on the administrative console or in the command line. In that case, the default password is the same as the schema you specify. If you want to use a different password for the Business Space user name, use the administrative console to updated JDBC Resources: Find the data source jdbc/mashupsDS. Modify the value of the authentication alias to make it match the password of the Business Space schema name. Save your changes and restart the server.

After configuring Business Space to enable Business Space for your runtime environment.

Tip: The Business Space component uses a proxy component to connect to your REST services. In some cases, if REST services are not responsive, you must update the connection timeout settings to your REST services, depending on the performance of the REST service servers. See Changing the timeout settings for the Business Space Ajax proxy.

Configure the Business Space component for ND environments


Related tasks:
Configure the Business Space component for Process Portal
Create a Business Space database design properties file
Configure the Business Space database
Configure REST services for a server, cluster, or component
Registering widget REST service endpoints using the command line
Enabling widgets for cross-cell environments
Enabling widgets to work with multiple endpoints
Set up security for the Business Space component and Process Portal


Related reference:
getBusinessSpaceDeployStatus command
installBusinessSpace command
configureBusinessSpace command