3.3 Modifying the JBoss domain.conf file

Modify the JBoss run file of each JBoss Application Server instance in the AEM forms on JEE cluster to add AEM forms on JEE options.

Before you start this procedure, determine how your AEM forms cluster implements cluster caching so that you can correctly configure an argument for cluster caching. You can implement cluster caching by using either TCP or UDP, but not both. The following factors may affect your choice:

(Recommended) Use TCP if your cluster is either IPv4-based or IPv6-based. On an IPv6-based cluster, you must use TCP to be IPv6-compliant.

If you implement cluster caching by using TCP, also ensure that you configure the TCP locators correctly. (See “Configuring the caching locators (caching using TCP only)” .)
Option to use UDP is available only for IPv4 based cluster.

It is recommended to use TCP instead of UDP multicasting for production systems because of the inherent reliability of the TCP protocol.

To modify the JBoss domain.conf file:

Open the following file in a text editor:
- (Windows) [appserver root] /bin/domain.conf.bat
- (UNIX) [appserver root] /bin/domain.conf
In the JAVA_OPTS line, add or change the following argument:
```
-Dadobeidp.serverName=<server name>
```
Note: The value for <server name> can be any value; however, you must configure a unique <server name> value for each node of the AEM forms cluster, as in this example:
- On one node of the cluster, configure the -Dadobeidp.serverName=server1 argument
- On another node of the cluster, configure the -Dadobeidp.serverName=server2 argument.
You can configure additional nodes for the AEM forms cluster in a similar manner but with unique <server name> values.
In the JAVA_OPTS line, the following argument might already be set for IPv4. If not, then set the agrument:
```
-Djava.net.preferIPv4Stack=true
```
For IPv6, Remove -Djava.net.preferIPv4Stack=true and add the following arguments:
```
-Djava.net.preferIPv6Addresses=true 
-Djava.net.preferIPv6Stack=true 
```
Configure a JVM argument for cluster caching. In the JAVA_OPTS line, add or change one of the following arguments:

Caching using UDP discovery
- Configure the multicast port argument in the following format:
```
-Dadobe.cache.multicast-port=<port number>
```
  Note: The value for <port number> can be any available port between 1025 and 65535. The multicast port must be unique to the AEM forms cluster (that is, the port must not be used by any other cluster on the same network, any attempt to use the same port by any other cluster on the same network would result in bootstrap failure). It is recommended that you configure the same <port number> on all nodes in the AEM forms cluster, as in this example:
```
-Dadobe.cache.multicast-port=33456
```
- Setting multicast address argument is optional. Default muticast addresses for IPv4 and IPv6 are as following:
```
IPv6 - FF38::1234 
IPv4 - 239.192.81.1
```
  If you have restriction on multicast addresses in your network, use following argument to set multicast addresses:
```
-Dadobe.cache.multicast-address=<ip address>
```
  The value for <ip address> is the IP address used for multicast networking. The IP address is ignored if adobe.cache.multicast-port is zero.
  
  The multicast address must be unique to the AEM forms cluster and must not be used by any other cluster on the same network. It is recommended that you configure the same <ip address> on all nodes in the AEM forms cluster. For example:
```
-Dadobe.cache.multicast-address=239.192.81.1
```
- For machines with multiple Network Interfaces
  
  Some machines may be connected to multiple networks via multiple Network Interface Cards (NICs). For such machines, set the JVM property - Dadobe.cache.bind-address to the IP address of the network interface card that you are using for forms server.
```
-Dadobe.cache.bind-address=<IP Address>
```
  Note: It is recommended to set JVM property -Dadobe.cache.bind-address for machines with one Network Interface Card, also.
Caching using TCP only
- For IPv4, configure the cluster locators argument in the following format:
```
-Dadobe.cache.cluster-locators=<IPaddress>[<port number>],<IPaddress> [<port number>]
```
  For IPv6, configure the cluster locators argument in the following format:
```
-Dadobe.cache.cluster-locators=<hostname>@<IPv6 address>[<port number>],<hostname>@<IPv6 address>[<port number>]
```
  Note: Configure, as a comma-separated list, the locators for all nodes of the cluster. The value for <IPaddress> is the IP address of the computer that is running the locator. The value for <port number> is any unused port between 1025 and 65535. It is recommended that you configure the same <port number> on all nodes in the AEM forms cluster, as in this example:
```
-Dadobe.cache.cluster-locators=10.20.30.5[22345],10.20.30.6[22345]
```
  Note: Do not run TCP locators on all the nodes of the AEM forms Cluster. It is good practice to run minimum two locators. One TCP locator serves as a primary locator and other TCP locator serves as a secondary locator to handle failover issues. You can add more than two TCP locators as backup locators but it is not mandatory. For information on configuring TCP locators, see 4.4 Configuring the caching locators in clusters (caching using TCP only) .
To prevent application server from Denial of Service attacks configure the following JVM argument:
```
-DentityExpansionLimit=10000
```
(Unix only) Open the domain.conf file and search -Dadobeidp.serverName=server1 . The file has mutiple instances of searched term, delete an instance.
Save the edited files.
Repeat steps 1 to 6 for each node in the cluster.