Installing a fix pack

Use IBM® Installation Manager to download and extract the fix pack artifacts, then run a script to install the fix pack files.

1. Before applying the fix pack, create backups of the following items that will be overwritten by the fix pack:
   Note: These backups are especially important if you have customized the virtual MDM configuration, user interfaces, or datasource.
   • The contents of the folder MDM_INSTALL_HOME/mds/conf.
   • The contents of the folder WAS_PROFILE_HOME/InstalledApps/CELL_NAME/MDM-native-APP_NAME.ear/native.war/conf EXCEPT FOR odbc.ini.
     Important: Do not back up odbc.ini in this folder. The new version of the file is required.
   • The contents of the folder WAS_PROFILE_HOME/InstalledApps/CELL_NAME/MDM-native-APP_NAME.ear/native.war/work.
   • Any customizations that you have applied to the InfoSphere MDM user interface applications.
2. If you are behind a firewall, configure a proxy to ensure that IBM Installation Manager can connect to the predefined InfoSphere MDM fix pack repository. See the related links for details.
   Tip: If your version of Installation Manager is less than version 1.8.1 or you are behind a firewall and your organization does not allow the use of proxies, then you must acquire the fix pack from another source, such as IBM Fix Central:

   1. Locate the fix pack on Fix Central and download it to a local directory, MDM_INSTALL_HOME/updates.
   2. Extract the downloaded fix pack ZIP file.
   3. Start IBM Installation Manager.
   4. Select File > Preferences..., then click Add Repository....
   5. Click Browse..., then navigate to the extracted fix pack directories and select MDM_INSTALL_HOME/updates/fix_pack_version/delta/repository.config. Click OK.
   6. Click Apply, then click OK.
   7. Close IBM Installation Manager.
3. Start IBM Installation Manager.
4. Click Update.
5. If prompted, provide your IBM ID credentials.
6. Select the fix pack updates that you want to apply, then click Next.
7. Read and accept the license terms.
8. On the Upgrade Summary page, read about the fix pack and the issues that it resolves, then click Upgrade.
   Installation Manager downloads and extracts the fix pack artifacts into the file system. You will find the extracted fix pack files in MDM_INSTALL_HOME/updates/fix_pack_version.

   Important: If you wish to exclude any InfoSphere MDM components from being updated by the fix pack, you must modify the extracted FeatureFixpackApplied.properties file before completing this procedure. See the related links for details.
9. If your InfoSphere MDM instance has previously been upgraded from an older version, then you must manually update certain properties before you install a fix pack. If your instance has not been upgraded, then skip to the next step.

   The Apply_Fixpack madconfig script uses certain values in the MDM_Fixpack.properties file. These values point to the MDM database instance from the initial product installation, so if InfoSphere MDM has been upgraded from an older version using a different database, then the values must be changed to point to the current, upgraded MDM database instance before you can successfully install a fix pack:

   1. Open the properties file MDM_INSTALL_HOME/backup/<version>/properties/MDM_Fixpack.properties.
   2. Modify the values of any properties that point to the MDM database to ensure that they point to the current, upgraded database.
10. Start all of the InfoSphere MDM servers, web applications, and application server.
11. Open a command prompt and navigate to MDM_INSTALL_HOME/mds/scripts.
12. Run the script to apply the fix pack: ./madconfig.sh Apply_Fixpack
13. Provide the passwords according to the script's prompts.
14. Restart all of the InfoSphere MDM servers, web applications, and application server.