Installing Business Space on WebSphere Application Server for z/OS

Answer

Before installing Business Space with WebSphere Operational Decision Manager, you must configure the event runtime on WebSphere Application Server for z/OS. Follow the instructions in Configuring the event runtime to run on WebSphere Application Server.

Note: Back up your WebSphere Application Server for z/OS before proceeding with a Business Space installation.

Create and configure the databases for Business Space
You must complete this task before you proceed with the installation of Business Space.

The relevant database scripts are available in the following directory: <WODM_InstallDir>/events/bspace/dbscripts/BusinessSpace/DB2zOS. Modify these scripts for your own installation.

Use the following scripts to create the database, in the order they are shown here:
createStorageGroup_BusinessSpace.sql
createDatabase.sql
createTablespace_BusinessSpace.sql
createTable_BusinessSpace.sql

If you use RACF in WebSphere Application Server for z/OS security, the RACF administrator must run the following commands to ensure that authority is set up for Business Space.
RDEF EJBROLE CLID.Allauthenticated
RDEF EJBROLE CLID.businessspaceusers
SETR RACLIST(EJBROLE) REFRESH
PE CLID.Allauthenticated CLASS(EJBROLE) ID(<userid>) ACCESS(READ)
PE CLID.businessspaceusers CLASS(EJBROLE) ID(<userid>) ACCESS(READ)

Installing Business Space into WebSphere Application Server for z/OS
1. Ensure that the values you have set for the installation parameters are accurate for your environment. There is an additional property for Business Space, which is set to the default (WebSphere Operational Decision Manager installation). You can change this value if necessary.
These parameters are found in the following locations:

i) <Component Directory>/config/was/setenv.sh
ii) <Component Directory>/config/db/setenv.sh
iii) <Component Directory>/config/wbe/setenv.sh

2. Set your umask using the following command:
umask 002
This is required by the next shell command which sets up the links to Business Space.
3. Run <Component Directory>/config/was/create_bspace_links.sh to set up the links to the Business Space.
4. Restart WebSphere Application Server for z/OS.
5. Run <Component directory>/config/was/configure_bspace_datasource.sh <username> <password> to set up the Business Space data source.
6. In the WebSphere Application Server for z/OS console, click: Resources > JDBC > JDBC providers > Decision Center for Business Space JDBC driver. Change the classpath to your database classpath directory.
7. Restart WebSphere Application Server for z/OS.
8. Test the data sources in WebSphere Application Server for z/OS to confirm that they are functional. Ensure the database is ready and all RACF authorities are set up.
Note: Do not proceed with step 9 until your environment is set up correctly.
9. Run <Component directory>/config/was/install_bspace.sh to install the Business Space application.
10. Run <Component directory>/config/was/install_wbe_widgets.sh to install the Business Space widgets.
11. Run <Component directory>/config/was/standalone_install_ute.sh <User ID> to install the events test application to use the testing widget.
Note: There is an outstanding issue: an error message './standalone_install_ute.sh 79: FSUM7351 not found' is displayed on the completion of this script. This reported error can be safely ignored. Look at the preceding line for any completion or error information.
12. Restart WebSphere Application Server for z/OS.
Note: The first time you restart the server, Business Space writes information to the database. Therefore the first time you start WebSphere Application Server for z/OS after installing Business Space, the startup can be very slow. It is quicker on subsequent startups.
You can locate Business Space:
http://<machineName>:<WC_Port>/BusinessSpace
or
https://<machineName>:<WC_SecurePort>/BusinessSpace