Configure Multiple UMP Servers

This article describes how you set up a first-time multiple-UMP configuration. If you are upgrading a multiple-UMP configuration, see .
uim835
This article describes how you set up a first-time multiple-UMP configuration. If you are upgrading a multiple-UMP configuration, see Multiple UMP Configuration Upgrade.
Contents
Configure the Primary UMP Server
No steps are required for configuring the primary UMP server.
Configure a Secondary UMP Server
Use the steps in this section to configure a secondary UMP server. Repeat these steps to configure additional UMP servers.
Follow these steps:
  1. Deploy a robot to the host that you plan to use as the secondary UMP server.
    Do not run the UMP installer on the secondary UMP server.
  2. In Admin Console or Infrastructure Manager, distribute the following UMP server packages from the Archive to the secondary UMP server:
    • java_jre
    • nisapi_wasp
    • wasp
    • ump
    • ump_<portlet_name>
      Ensure that you drag each of the ump_<portlet_name> packages required for your environment from the Archive.
  3. Configure the wasp probe to use the following probe addresses:
    • data_engine - /<domain>/<hub>/<UIM_server>/data_engine
  4. Configure the wasp probe's relationshipviewer webapp to have the custom properties GraphServiceHost and GraphServicePort. GraphServiceHost is the IP address of the robot running the relationship_services probe, and GraphServicePort is the HTTP port relationship_services is using (default: 8182).
  5. Use Raw Configure to modify the <ump_common> section of the wasp configuration to use the following probe addresses:
    • ace = /<domain>/<hub>/<UIM_server>/ace
    • automated_deployment_engine = /<domain>/<hub>/<UIM_server>/automated_deployment_engine
    • discovery_server = /<domain>/<hub>/<UIM_server>/discovery_server
    • nas = /<domain>/<hub>/<UIM_server>/nas
    • service_host = /<domain>/<hub>/<UIM_server>/service_host
    • sla_engine = /<domain>/<hub>/<UIM_server>/sla_engine
    • ugs = /<domain>/<hub>/<UIM_server>/ugs
  6. Add the following keys with addresses as follows:
    • maintenance_mode = /<domain>/<hub>/<UIM_server>/maintenance_mode
    • udm_manager = /<domain>/<hub>/<UIM_server>/udm_manager
  7. Activate the wasp probe on the secondary UMP server.
    Activating the wasp is required to allow the probes to create database tables.
If desired, repeat the steps in this section on other robots to configure additional UMP servers.
Configure the Portal for Multiple UMP Servers
Use the steps in this section after configuring the secondary UMP server.
Be sure that you have permissions to change directories for your operating system before following these steps. Minimum permissions include Read, Write, and Execute.
Follow these steps:
  1. Deactivate the wasp probe on each UMP server.
  2. 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
  3. Create and share a shared document_library directory on the primary UMP server.
    • For Windows, share the directory <UIM_installation>/probes/service/data/document_library with full read/write access.
    • For Linux, share the directory <UIM_installation>/probes/service/data/document_library via NFS, and ensure that no_root_squash is enabled.
  4. On the secondary UMP server, replace the directory <UIM_installation>/probes/service/data/document_library with a link to the primary document_library share.
    • For Windows, use the
      mklink
      command as follows:
      mklink /d c:\<UIM_installation>\probes\service\data\document_library \\primary\<document_library_share> 
    • For 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
  5. (Only required for UMP servers that have network connections configured with
    both IPv4 and IPv6 addresses
    ). Add the following Java VM parameter to the wasp configuration:
    -Djava.net.preferIPv4Stack=true
  6. Activate the wasp probe on the primary UMP server.
  7. When the wasp is running on the primary UMP server, activate the wasp on the secondary UMP server.
The portal is now configured for multiple UMP servers.
Configure a Load Balancer
This section provides the high-level steps for configuring a load balancer for a multiple UMP server configuration. Use the steps in this section after you install and configure the primary and secondary UMP server.
Load balancers and the terms that vendors use to describe them vary. Refer to the documentation for your load balancer for specific configuration details. You may need to perform the high-level steps in this section in a different order than shown.
Follow these steps:
  1. Deploy the load balancer:
    1. Configure the load balancer with IP addresses for each UMP server.
  2. Create a node/device for each UMP server.
    1. Enter the name and IP address of each UMP server in your configuration.
  3. Create a pool/server farm:
    1. Provide a unique name for the pool/server farm.
    2. Add one or more health monitors, such as the gateway_icmp and http_head.
    3. Select a load balancing algorithm. The most common load balancing algorithm is round robin, where one connection is sent to each server on the list in turn.
    4. Add the nodes you created previously to the pool for port 80. Use port 443 for an HTTPS connection.
  4. Create a virtual server/context:
    1. Provide a unique name for the virtual server/context.
    2. Provide an IP address for the virtual server/context.
    3. Configure additional settings for the virtual server as follows:
      • Protocol = tcp
      • HTTP Profile = https
        or
        http
      • Source Port = preserve strict
      • Default Persistent Profile = cookie.
      Regardless of the load balancer, setting the Default Persistent Profile setting to
      cookie
      is required.
  5. Verify the load balancer was successfully configured by entering the IP of the virtual server/context in a web browser.
The load balancer is now configured for a multiple UMP server configuration.