Copyright © Cloud Software Group, Inc. All Rights Reserved

Modify Unicast Discovery URL in CDD file

When API Exchange Gateway server configuration is manually copied to any server from where it was installed and configured, it requires to edit the discover URL and listen URL.

Discover URL

The discover URL specifies how the Core Engine (node) listens for discovery requests from nodes attempting to join the cluster. When a cluster starts up, and also when new members join a cluster, a discovery process enables the members to discover each other. The discover URL specifies how an Core Engine (node) listens for discovery requests from nodes attempting to join the cluster.

The discovery URL for well-known address configuration uses the following format:

   tcp://ip:port[;ip:port]*

After the discovery is complete, the members communicate internally using a listen URL.

Listen URL

The listen URL is used for direct communication between the members of the metaspace. The listen URL value must be different for each cluster member.

The listen URL uses this format:

tcp://interface:port[-EndPort |*]/

The cluster member binds to the specified interface and the specified port when creating the TCP socket. Specify the parameters as follows.

Parameter	Notes
interface	To specify a value, use the desired IP address. The value for interface must be the same in both the discovery and the listen URLs for a node. If there are multiple interfaces on one machine, specify the interface you want to use and do not rely on the default value. The default value for interface is the first available interface provided by the operating system for the machine.
port	To specify a single port use the port number in the listen URL, as shown in this example: tcp://interface:6000/ The default value is the first available port in the 50000+ range.

How to edit the Discover URL and Listen URL (using text editor)

To edit the discover URL and listen URL, follow these steps:

1.	Open the ASG_HOME/bin/asg_core.cdd file for editing.

2.	Edit the following properties and set the value to the actual IP address of the machine, and an unused port.

For example:

   <property name="be.engine.cluster.as.discover.url"    value="tcp://127.0.0.1:6000/"/>

   <property name="be.engine.cluster.as.listen.url"    value="tcp://127.0.0.1:6000-*/"/>

3.	Save the file.

How to edit the Discover URL and Listen URL (using Studio)

You can edit the discover and listen URL in the Cluster Deployment Descriptor (asg_core.cdd) file as follows:

1.	Navigate to the ASG_HOME/bin directory.

2.	Copy the asg_core.cdd file to ASG_HOME/projects/ASG_DefaultImplementation folder.

3.	Navigate to the ASG_HOME/studio/eclipse directory.

4.	Type the following command to start the Studio:

./studio

5.	If you are prompted, select or create the Eclipse workspace directory where your project files will be stored. (If you check the option to use this workspace as a default, you are not prompted again.)

6.

Click OK.

7.	Close the Welcome screen.

8.	From the File menu select Import.

9.	In the Import Select wizard, select an import source as General > Existing Projects into Workspace and click Next. You see the Import Projects dialog.

10.	In the Import Projects dialog Select root directory field, browse to and select the project: ASG_HOME/projects/ASG_DefaultImplementation.

11.	Click Finish.

12.	In the Studio Explorer, expand the ASG_DefaultImplementation project node. Verify that you see the asg_core.cdd file.

13.	Double-click the asg_core.cdd file.

14.	Select Cluster tab > General on the left. On the right, expand cluster node to edit the following properties:

   be.engine.cluster.as.discover.url

   be.engine.cluster.as.listen.url

15.	Set the values to the actual IP address of the machine, and an unused port.

For example,

   be.engine.cluster.as.discover.url=tcp://127.0.0.1:6000/

   be.engine.cluster.as.listen.url=tcp://127.0.0.1:6000-*/

16.	Save the file.

17.	Back up the original asg_core.cdd file in the ASG_HOME/bin directory.

18.	Copy the modified asg_core.cdd file from ASG_HOME/projects/ASG_DefaultImplementation to the ASG_HOME/bin directory.

If you select the "Copy projects into workspace" option during the import of the project, then the modified asg_core.cdd file exists in the workspace directory. Make sure to copy the asg_core.cdd file from workspace directory to the ASG_HOME/bin directory.

 

 

 

 

Copyright © Cloud Software Group, Inc. All Rights Reserved