Upgrade a Multiple UMP Configuration

In this article, learn how to upgrade a multiple UMP configuration. You run the upgrade and complete post-upgrade tasks.
uim902-9-0-2
In this article, learn how to upgrade a multiple UMP configuration. You run the upgrade and complete post-upgrade tasks.
 
 
2
 
 
Run the Upgrade
 
Follow these steps:
 
  1. Deactivate the wasp probe on the primary and secondary UMP server.
  2. Deactivate the robot running the secondary UMP server.
  3. Delete the symbolic link directory 
    <UIM_installation>/probes/service/data/document_library
     on the secondary UMP server.
  4. Execute the UMP installer from the primary hub, and select the primary UMP server as the target.
     Verify that your first UMP is working correctly. Also, take a backup of your database.
  5. Restart the robot running the secondary UMP server.
  6. Drag the following packages from the Archive to the secondary UMP server:
    • java_jre
    • wasp
    • nisapi_wasp
    • ump
    • ump_<portlet_name>
       Ensure that you drag each of the ump_<portlet_name> packages that are required for your environment from the Archive.
  7. If the following keys and addresses are not already present, add them to wasp through the Raw Configure option, ump_common section:
    • maintenance_mode = /<domain>/<hub>/<UIM_server>/maintenance_mode
    • udm_manager = /<domain>/<hub>/<UIM_server>/udm_manager
    • mpse = /<domain>/<hub>/<UIM_server>/mpse
  8. On each UMP server, add or uncomment the following two lines in <UIM_installation>/probes/service/wasp/webapps/ROOT/WEB-INF/classes/portal-ext.properties:
    • cluster.link.enabled=true
    • lucene.replicate.write=true
  9. Activate, and then deactivate, the wasp probe. 
    This action is required to create the directory that is described in the next step.
  10. Configure a shared document_library directory on the primary UMP server.
    • (Windows) Share the directory <UIM_installation>/probes/service/data/document_library with full read/write access.
    • (Linux) Share the directory <UIM_installation>/probes/service/data/document_library using NFS, and ensure that no_root_squash is enabled.
  11. On the secondary UMP server, replace the directory <UIM_installation>/probes/service/data/document_library with a link to the primary document_library share.
    • (Windows) Use the 
      mklink
       command as follows:
      mklink /d c:\<UIM_installation>\probes\service\data\document_library \\primary\<document_library_share>
    • (Linux) Use the 
      mount
       command as follows:
      mount -t nfs <primary>:/<UIM_installation>/probes/service/data/document_library <UIM_installation>/probes/service/data/document_library
  12. On UMP servers that have interfaces that are configured with 
    both IPv4 and IPv6 addresses
    , add the following Java VM parameter to the wasp configuration:
    -Djava.net.preferIPv4Stack=true
  13. Activate the wasp probe on the primary UMP server.
  14. When the wasp is running on the primary UMP server, activate the wasp on the secondary UMP server.
You have successfully upgraded the multiple UMP server configuration.
Complete Post-Upgrade Tasks
Complete the following tasks after the upgrade is complete:
Clear Browser After Upgrading
If you upgraded from a previous UMP version, clear your browser completely to remove older versions of components that might be cached.
 
Follow these steps:
 
  1. Log out from UMP.
  2. Clear the browser cookies and cache.
  3. Exit all browser windows.
  4. Log in to UMP.