Install and configure InfoSphere Warehouse on System z

This article takes you through the installation of IBM® InfoSphere™ Warehouse on a Linux® partition on System z®. Learn about pre-installation requirements, then walk through the steps for a successful installation.


Sundari Voruganti, Data Warehouse Solutions for System z, IBM

Sundari Voruganti photoSundari Voruganti is a member of IBM's Data Warehousing on z SWAT Team with a primary focus on InfoSphere Warehouse on System z. She has over 10 years in the IT industry, mostly at IBM with over 5 years experience testing and providing customer support.

14 May 2009


InfoSphere Warehouse for System z is a suite of products that combines the strength of DB2 for z/OS® with a data warehousing infrastructure from IBM. You can use InfoSphere Warehouse for System z to build a complete data warehousing solution that uses your existing relational database to perform multidimensional reporting and analysis of data with cubing services. You can also use the in-database data movement and manipulation capabilities of SQL Warehouse Tool (SQW) to transform and load your data.

This article describes the installation and configuration of the InfoSphere Warehouse Server product on System z. You'll walk through the product installation on a Linux on System z partition connecting to a remote DB2 for z/OS database server. Figure 1 shows the systems involved in the installation:

Figure 1. Systems involved in this installation
Shows Linux on System z connected to DB2 for z/OS via JDBC and DB2 Connect

Pre-installation activities

InfoSphere Warehouse on System z installs into a Linux partition on System z. It uses DB2 for z/OS as the target data warehouse and as the source for Cubing Services data. DB2 stored procedures are used during installation and for certain product functions. So both the DB2 environment and the InfoSphere Warehouse must be prepared.

  • To prepare the DB2 environment, set up the following stored procedures on the DB2 for z/OS database server:

    Before you can use certain functions of the DB2 Driver for JDBC and SQLJ on a DB2 for z/OS subsystem, you need to enable a set of stored procedures for JDBC. Both the cube server and the Administration console use JDBC. Use the product documentation for details on how to install.

    Note: To set up and bind these stored procedures and related global tables, run the DB2-supplied SDSNSAMP batch job DSNTIJSG. The stored procedures ADMIN_JOB_FETCH, ADMIN_JOB_SUBMIT, ADMIN_JOB_CANCEL, and ADMIN_JOB_QUERY use the __login() function to switch users. Be sure that ADMIN_JOB_FETCH, ADMIN_JOB_SUBMIT, ADMIN_JOB_CANCEL, and ADMIN_JOB_QUERY stored procedures are defined to the RACF® program control. The executing WLM address spaces must be defined accordingly. Additional information is available in the DB2 V9 product documentation The IBM Redbooks® publication DB2 9 for z/OS Stored Procedures: Through the CALL and Beyond describes how to set up and use stored procedures.

  • To create and configure the InfoSphere Warehouse metadata database, follow these steps:
    1. Catalog the z/OS database using the following commands on the Linux for System z system:
      db2 catalog tcpip node <node name> remote <remote z/OS machine 
          name> server <remote machine port number>
      db2 catalog db <remote database name> as <local database name> 
         at node <node name>
    2. Create a database for the InfoSphere Warehouse metadata tables. The default is SQWCTRL. This name can be changed and must be entered when prompted during installation.
      db2 create database SQWCTRL stogroup <storage group>
    3. Grant authorities for the metadata database to the userid that will be connecting to the z/OS database during installation and configuration:

      This statement grants DBADM, create table, create index, create tablespace, drop, select and load authority to the userid.


      This statement grants create trigger authority to all schemas.

    4. Grant the userid that will be the creating the cube DBADM on the database where the cube will be created.

    Note: The metadata tables are created when the user first logs into the InfoSphere Administration Console (at the end of this installation). After the metadata tables have been created, only SELECT, UPDATE, DELETE and INSERT authorities are necessary for normal day to day operations for the tables in the metadata database (or SQWCTRL) for the userid that will be creating and deploying the cube.

Sometimes the following error is displayed while connecting to the z/OS database:

DB2 SQL Error: SQLCODE=-443, SQLSTATE=38112, 

This problem can be fixed by either rerunning the DSNTIJSG job which will rebind all the stored procedures and eliminate consistency errors, or by installing UK38087 and rebinding.

Installation on Linux on System z

To install the InfoSphere Warehouse server on Linux on System z, you need to log in with a userid that has root access (an account that has sudo authority) or as root. The InfoSphere Warehouse Server can be installed in one of multiple ways: with the wizard, in console mode, or as a silent install with a response file. More information is provided in the product documentation.

This article focuses on installation using the wizard. In order to install using the wizard, you'll need to VNC ( into the Linux on System z box, or run an X-Server. In order to display the wizard on your machine use the following command:

export DISPLAY=<your IP>:0.0

Copy and extract the installation files as described in the product documentation.

To install using the installation wizard, run the install script from the directory where you unzipped the files, as shown in Figure 2:

Figure 2. Run the install script
Shows screen capture of running install script

The Dprofile parameter is necessary so that the z version of the product is installed.

The following options are presented to the user to customize their installation. On the first screen, select the language and click OK.

Figure 3. Selecting language
Shows language drop down

The next screen welcomes you to the installation. Click Next to continue.

Figure 4. Welcome screen
Shows welcome screen

The next screen shows the license agreement. Click to accept and click Next.

Figure 5. License agreement
Shows License agreement and radio button to accept

On the next screen, select Install IBM InfoSphere Warehouse on System Z on this computer.

Figure 6. Selecting installation options
Shows installation options

On the next screen, specify the installation directory. If using the default, ensure that the directory /opt/IBM/ISWarehouse does not already exist. If you have uninstalled a previous installation of InfoSphere Warehouse, this directory will not be removed during the uninstall, so please remove, rename or provide another directory

Figure 7. Specify the installation directory
Shows specifying the installation directory

On the next screen, select the components. You should select all the components as shown, even if DB2 and WebSphere Application Server are already installed on the system. Options will be displayed later to pick your existing installation.

Figure 8. Selecting components
Shows selecting server components

On the next screen, specify the login information to enable WebSphere Application Server global security. This is the userid that will be used to stop and start WebSphere Application Server. This userid must exist on the system. If you want to create a dedicated user for InfoSphere Warehouse, and not share "wasadmin" with WebSphere Application Server (if it is already installed on the system), then the userid you are providing will need to be created beforehand manually.

Figure 9. Specify login information
Shows specifying wasadmin

The next screen will be presented if there is already a copy WebSphere Application Sever on the system. You can use an existing copy of WebSphere Application Server if it meets the version requirements of InfoSphere Warehouse as documented in the install guide.

Figure 10. WebSphere Application Sever options
Shows option to install new version of WAS or keep existing copy

If a DB2 Connect Personal Edition already exists on the computer, the next screen will be presented. A valid DB2 Connect license is needed to connect with the JDBC driver from Linux on System z to DB2 for z/OS. DB2 Connect Personal Edition is delivered with InfoSphere Warehouse for z to provide this license file. The existing copy can be used.

Figure 11. DB2 Connect install option
Shows option to install new copy of DB2 Connect or keep existing copy

If no DB2 Connect is available on the system, the next screen is presented. Provide the DB2 userid and password for the DB2 instance owner. A new directory is created.

Figure 12. Setting user information for the DB2 instance owner
Shows setting user informationt

On the next screen, specify the database to use for your warehouse metadata. This information is used to connect to the z/OS metadata database (which was cataloged earlier in the pre-installation activities). You cannot move ahead until a successful connection is established. This is the database created during the pre-installation activities above.

Note: Ensure the Location field is in uppercase. A lowercase location name will result in an error when you attempt to connect.

Figure 13. Specify database for warehouse metadata.
Shows entering database information: type, host, port number, location, database name, user name, password

Figure 14 shows a summary dialog that displays the options and components to install. Click Install to proceed.

Figure 14. Options and components to install
Shows summary of options and components selected for installation

The installation is complete.

Figure 15. Installation complete
Screen shows successful completion

Once the installation is complete, the administration console can be displayed using the URL:

http://<System name>:<WAS port>/ibm/warehouse/

For example: http://hostname:9080/ibm/warehouse/


You can now use the Administration Console to deploy and manage applications, control flows, database resources, and system resources. Learn more about the different components of InfoSphere Warehouse for System z and how to use them from the Information Center.



Get products and technologies



developerWorks: Sign in

Required fields are indicated with an asterisk (*).

Need an IBM ID?
Forgot your IBM ID?

Forgot your password?
Change your password

By clicking Submit, you agree to the developerWorks terms of use.


The first time you sign into developerWorks, a profile is created for you. Information in your profile (your name, country/region, and company name) is displayed to the public and will accompany any content you post, unless you opt to hide your company name. You may update your IBM account at any time.

All information submitted is secure.

Choose your display name

The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerWorks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

Required fields are indicated with an asterisk (*).

(Must be between 3 – 31 characters.)

By clicking Submit, you agree to the developerWorks terms of use.


All information submitted is secure.

Dig deeper into Information management on developerWorks

Zone=Information Management, Big data and analytics
ArticleTitle=Install and configure InfoSphere Warehouse on System z