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/
- 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
- The scripts to create IBM® DB2® databases and tablespaces are
located in STARTUPKIT_INSTALL_HOME/CoreData/Full/DB2/Standard/ddl/
- 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
- 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.