Installation Startup Kit for custom installations

The Installation Startup Kit includes files and scripts to help you prepare your environment before you install InfoSphere® MDM.

Use the Installation Startup Kit tools to help you to complete a custom installation.

You can extract the files and scripts in the Installation Startup Kit from the downloaded InfoSphere MDM package file disk1.zip/StartUpToolkit. The location that you extract the Startup Kit to will be referred to in this documentation as the STARTUPKIT_INSTALL_HOME.

Database creation and configuration
Run the database scripts in the Installation Startup Kit before you begin the InfoSphere MDM installation. The scripts automatically create the appropriate tables, tablespaces, buffer pools, encoding specifications, and triggers that are required for your edition.

The installation application can create the necessary tablespaces for your deployment. Alternatively, you can create them prior to installing InfoSphere MDM using the provided scripts.

Tip: Create one temporary tablespace for each blocksize. For example, if you have 16K tablespaces, then create a 16K temporary tablespace.
  • The scripts to create IBM® DB2® databases and tablespaces are located in STARTUPKIT_INSTALL_HOME/CoreData/Full/DB2/Standard/ddl/
    • CreateDB.sql
    • CreateTS.sql
  • The scripts to create a DB2 for z/OS® database and install core and domain data:
    • STARTUPKIT_INSTALL_HOME/CoreData/Full/DB2/ZOS/pds/
    • STARTUPKIT_INSTALL_HOME/Full/DB2/ZOS/pds/
    The scripts are configured to run from a TSO session using JCL scripts in the mainframe.
  • Script to create an Oracle database: STARTUPKIT_INSTALL_HOME/CoreData/Full/Oracle/Standard/ddl/create_schema_ora.sql
  • Script to create a Microsoft SQL Server database: STARTUPKIT_INSTALL_HOME/CoreData/Full/SQLServer/ddl/CreateDB.sql
  • Microsoft SQL Server files that are used for XA transactions are located in STARTUPKIT_INSTALL_HOME/SQLServer JTA:
    • sqljdbc.dll files to support either 32-bit or 64-bit SQL Server are in win32 and win64_amd64
    • instjdbc.sql
Enhanced installation debug logging
The Installation Startup Kit includes a properties file that you can use to enable enhanced debug logging to capture additional details of the InfoSphere MDM installation processes. This file is located at STARTUPKIT_INSTALL_HOME/InstallationManagerDebug/log.properties.

In addition to standard installation log events, enhanced debug logging captures detailed information about the following:

  • Each file or plugin that IBM Installation Manager downloads from a web repository or retrieves from a local file system DISK repository.
  • Each action that IBM Installation Manager performs, including:
    • running ANT actions
    • invoking Java™ classes
    • executing .sh scripts
  • Processing for all IBM Installation Manager internal metadata.
  • All user input data, including details of how this data is modified during install, uninstall, or rollback actions.
Important: After you have enabled enhanced debug logging, the logged information in ./InstallationManager/logs can include password details entered by the user during the installation. Ensure that these logs are stored in a secure place to avoid password exposure.

Additionally, if there are any manual steps required to complete your installation, the enhanced debug logging will prompt you about the next steps to take. For example, if you selected the option to separate the installation and configuration, then the debug file will prompt you to run the madconfig scripts that will enable you to configure your installation.

If you use a silent installation to install InfoSphere MDM web application user interfaces, then the debugging messages will include the URLs of the deployed web applications.

To enable enhanced debug logging in ./InstallationManager/logs, copy STARTUPKIT_INSTALL_HOME/InstallationManagerDebug/log.properties into ./InstallationManager/logs before starting IBM Installation Manager to begin installing InfoSphere MDM.

Messaging component setup
The Installation Startup Kit includes scripts that you can use to install the InfoSphere MDM messaging component when WebSphere® MQ is on a machine that is different than the one where IBM Installation Manager is running, use the scripts custSetupMQServer.mqsc and ChannelAuth.mqsc.
Prerequisite checking tool
The prerequisite checking command line tool helps to prevent you from beginning an installation that will be unable to successfully complete due to missing prerequisites. This tool has the following capabilities:
  • Runs prerequisite checks for InfoSphere MDM installation.
  • Performs basic data collection – Collects logs and configuration files.
  • Performs extended data collection – Collects logs, configuration files, and metadata stored in the database
The prerequisite checking tool's data collection capabilities can be useful after an InfoSphere MDM has completed or if you need to troubleshoot an installation. The results of these collections are stored in a compressed file.
Silent installation response files
The Installation Startup Kit includes sample response files (.res). These files are samples that can be used as templates for running silent installations. The sample response files are located in STARTUPKIT_INSTALL_HOME at the root level.