Changing the initial installation configuration

The InfoSphere® MDM installation process generates configuration properties files that you can use to reconfigure the product at a later point in time.

About this task

The standard InfoSphere MDM installation process involves configuring key properties of the deployment at the same time as the installation occurs. The installation application generates a number of properties files that track the selections you have made in the IBM® Installation Manager session. These properties files are stored in MDM_INSTALL_HOME/properties.

To reconfigure the application, you can manually edit any of the generated properties files to change the product configuration as necessary, and then use the madconfig Configure_MasterDataManagement utility to apply the new configuration without having to complete a full reinstallation.

Procedure

Navigate to MDM_INSTALL_HOME/properties.
The initial InfoSphere MDM installation application will have generated some or all of the following properties files, depending on the features that you selected to install:

db.properties

When the MDM Database feature is installed through IBM Installation Manager, this properties file is created. It contains the configuration details of your database instance.

app.properties

When the MDM Application feature is installed through IBM Installation Manager, this properties file is created. It contains the configuration details of your InfoSphere MDM operational server instance.

<user interface>.properties

Depending on the user interface application components that you selected in IBM Installation Manager, a number of properties files are created. These files contain the configuration details of your InfoSphere MDM user interface application components.

MDM_isInstalled.properties

This property file stores configuration information about what InfoSphere MDM components are installed. This file has a key/value pair for each component that tracks whether each feature is installed (YES) or not (NO).

MDM_Rollback.properties

This property file is used in case of serious errors that cause the installation to be rolled back. It stores details about each InfoSphere MDM component and the state of that feature. This file has a key/value pair for each component that tracks whether each feature is successfully installed (YES), partially installed (PARTIAL), or not installed (NO).
If the status of any component is PARTIAL due to an error that the installation application encountered, then after the error has been corrected and the installation is rerun, the installation application will roll back only the partially installed component and rerun the installation for that and any other failed components.

This file also maintains the set of targets that are run while installing each component. These targets help to manage the rollback process.

MDM_Variables.properties

This property file is the default property file created during any InfoSphere MDM installation. The value of the property user.L2.mdm.feature.list contains a list of features that were selected in IBM Installation Manager.
If a configuration change is required, edit one or more of the properties files in MDM_INSTALL_HOME/properties to reflect the needed change.
Navigate to MDM_INSTALL_HOME/MDS/scripts and run the following madconfig script to apply the new configuration defined in the properties files:
- On Microsoft Windows systems, run
```
madconfig Configure_MasterDataManagement
```
- On Linux® or UNIX systems, run
```
./madconfig.sh Configure_MasterDataManagement
```
Tip: If you encounter any issues while running the configuration script, review the log files and take steps to correct the problem, then rerun the script.

The InfoSphere MDM product is reconfigured by the madconfig script based on the values in the properties files.
Optional: To remove an entire product configuration that was applied using the Configure_MasterDataManagement madconfig script, run the following script to remove all configuration files.
- On Microsoft Windows systems, run
```
madconfig Uninstall_MDM
```
- On Linux or UNIX systems, run
```
./madconfig.sh Uninstall_MDM
```
Important: Be careful about running the Uninstall_MDM madconfig script. Running Uninstall_MDM removes the configuration of all features, and not just the configuration of a particular component.
Optional: To remove an individual feature configuration that was applied using the Configure_MasterDataManagement madconfig script:
1. Open IBM Installation Manager and select Modify.
2. Remove the feature on the feature selection panel.
3. Run the madconfig script to configure the new product configuration:
  - On Microsoft Windows systems, run
```
madconfig Configure_MasterDataManagement
```
  - On Linux or UNIX systems, run
```
./madconfig.sh Configure_MasterDataManagement
```