13.2 Configuring Permission Clustering to Use TCP or UDP

You can configure the permission clustering to use TCP or UDP. The configuration process must be completed on each server in the cluster because the local settings are saved on the file system for each server.

To configure the permission clustering to use TCP or UDP:

  1. Log in to Identity Applications as the an administrator and go to Configuration > Caching and Cluster.

  2. In the Caching Management page that opens, click Cluster Cache Configuration.

  3. Navigate to Global Settings and perform the following actions:

    1. Enable the Global check box in the Permission Index Cluster Enabled row.

    2. Click Permission Index Cluster Properties, specify a value in the text field in the Global column:

      To use TCP, specify the following string:

      TCP(bind_addr=idmapps;bind_port=$bindport):TCPPING(initial_hosts=$host_details;port_range=5):MERGE3(min_interval=10000;max_interval=30000):FD_SOCK:
      FD(timeout=2500;max_tries=5):VERIFY_SUSPECT(timeout=1500):BARRIER:
      pbcast.NAKACK2(use_mcast_xmit=false):UNICAST3:pbcast.STABLE(desired_avg_gossip=50000;max_bytes=4M):pbcast.GMS(print_local_addr=true;join_timeout=2000):MFC(max_credits=2M;min_threshold=0.4):FRAG2(frag_size=60K):pbcast.STATE_TRANSFER

      For example:

      TCP(bind_addr=idmapps;bind_port=7815):TCPPING(initial_hosts=192.168.162.10[7815],192.168.162.11[7815];port_range=3):MERGE3(min_interval=10000;max_interval=30000):FD_SOCK:FD(timeout=2500;max_tries=5):VERIFY_SUSPECT(timeout=1500):BARRIER:pbcast.NAKACK2(use_mcast_xmit=false):UNICAST3:pbcast.STABLE(desired_avg_gossip=50000;max_bytes=4M):pbcast.GMS(print_local_addr=true; join_timeout=2000):MFC(max_credits=2M;min_threshold=0.4):FRAG2(frag_size=60K):pbcast.STATE_TRANSFER

      To use UDP, specify the following string:

      UDP(mcast_addr=$host;mcast_port=$port):PING:FD(timeout=10000;max_tries=5):VERIFY_SUSPECT:pbcast.NAKACK2:UNICAST3:pbcast.STABLE:FRAG:pbcast.GMS

      For example,

      UDP(mcast_addr=228.8.8.8;mcast_port=45654):PING:FD(timeout=10000;max_tries=5):VERIFY_SUSPECT:pbcast.NAKACK2:UNICAST3:pbcast.STABLE:FRAG:pbcast.GMS

      For UDP, the cluster nodes must reside in the same subnet.

      For more information, see the JGroups 4.0.12 documentation.

  4. (Conditional) Perform the following actions for using TCP:

    1. Set bind_port. This value must take into account the ports that are already in use and the value for port_range to avoid port conflicts. Depending on your configuration, you may need to troubleshoot to find an unused port.

    2. Change the IP addresses to include the IP addresses of all the nodes in the cluster and their bind_port values. The list should begin with the local IP address.

  5. Save the changes. These changes are written to the local file system for your server. Remember to make these changes for all servers in the cluster. Any server that does not have these changes uses the Global Settings values.

  6. Restart the server.

NOTE:bind_port and mcast_port should be different for Permission Index Cluster Properties and Cluster Properties.