Updating the deployed properties files for physical MDM

After you install or upgrade InfoSphere® MDM, you might need to update the deployed properties files if they require changes that cannot be made by using the Configuration Manager. Use this procedure to update deployed properties files.

About this task

Attention: Updating properties dynamically is not ideal. Whenever possible, port your custom properties to the Configuration Manager.

Because the properties files are packaged in a .jar and deployed as a business level application (BLA) shared library asset, they cannot be changed by only altering a property value. When installed, a duplicated properties.jar file is extracted to a deployment subdirectory of the BLA composition unit. This extraction allows updates to be done in near real time without having to reinstall the enterprise bundle application (EBA). For example, if the name of the application deployment is E001 and the WebSphere® Application Server installation home directory is opt/IBM/WebSphere/AppServer/, then the location of deployed property files is in the installed asset directory of the application profile. In this case, opt/IBM/WebSphere/AppServer/profiles/Node01/installedAssets/com.ibm.mdm.server.resources.properties-E001.jar/BASE

You can modify the content of the JAR file directly on the node. In a multinode or cluster topology, the changes must be manually replicated to all nodes and servers. The best way to update the properties is by using the WebSphere Application Server Integrated Solutions Console (admin console), which handles the propagation for you.

Procedure

  1. Start the WebSphere Application Server Integrated Solutions Console and go to Applications > Application Types > Assets.
    1. Select the com.ibm.mdm.server.resources.properties-deployment_name_used_for_install.jar file.
    2. Click Export to export the currently deployed properties. From here, you can download the library to your local system for updating.
  2. Edit the values and files by using the expanded properties files of the com.ibm.mdm.server.resources.properties-deployment_name_used_for_install.jar package that you downloaded in step 1.
  3. Repackage the changed properties into a new com.ibm.mdm.server.resources.properties-deployment_name_used_for_install.jar file. Ensure that you keep the same name as the original library.
  4. In the WebSphere Application Server Integrated Solutions Console, select the com.ibm.mdm.server.resources.properties-deployment_name_used_for_install.jar file again.
    1. Click Update.
    2. On the next screen, choose the type of update you want and select the new properties JAR.
      For example: select the Replace entire asset option along with the new or updated properties JAR. Updating the properties asset by using this option automatically propagates the changes to all nodes and servers.
  5. After the update is complete, you must restart the BLA application.