How Do I Configure Unicast Discovery for Magic xpi 4.x? (Magic xpi 4.7)

Unicast means that the Lookup Service (LUS) is located on a specific machine, and that you know the host name or the IP address of this machine. This topic demonstrates how to configure unicast discovery to work with Magic xpi 4.x.

Unicast discovery configuration can be done both manually and automatically.

Manual Configuration of the Lookup Settings

To configure unicast discovery manually, you need to update some files, including defining the same Lookup Group entry and the same Lookup Locator entry in the files, as shown below:

1. In the magicxpi-setenv.bat file (located under: <Magic xpi installation>\Runtime\Gigaspaces\bin):

   1. Set the MAGIC_MULTICAST_ENABLED entry to false.

   2. Set the LOOKUPLOCATORS entry to the hosts that will run the Lookup Services (LUS). These values should be comma-separated.

   3. Leave the LOOKUPGROUPS entry's value as is.

2. In the Magic.ini file's [MAGICXPI_GS] section:

   1. Set the LookupLocators entry to the host that will run the Lookup Service (LUS).

   2. If the LookupLocators entry does not exist in the Magic.ini file, you should create it.

   3. Leave the LookupGroupName entry's value as is.

3. Configure the Mgreq.ini file (located in the <Magic xpi installation>\Runtime folder) with the same settings as those in the Magic.ini file (step 2).

4. Configure the Web requester's Mgreq.ini file (located in the scripts\config folder) with the same settings as those in the Magic.ini file (step 2).

5. Systinet uses the configuration settings from the Mgreq.ini file (located in the <Magic xpi installation>\Runtime folder). The location of the Mgreq.ini file is controlled by the -Dcom.magicsoftware.requester.conf JVM property, which is found in the %WASP_HOME%/bin/Install_GSA_service.bat file and in the %WASP_HOME%/bin/Server.bat file. If you make any changes to the Install_GSA_service.bat file, you must perform the following steps:

   1. Uninstall the Systinet service. To do this, open the command console as an administrator (CMD), and navigate to %WASP_HOME%/bin. Then, run the Uninstall_GSA_service.bat file.

   2. Install the Systinet service. To do this, open the command console as administrator (CMD) and navigate to %WASP_HOME%/bin. Then, run the Install_GSA_service.bat file.

   You need to have administrator rights to be able to uninstall or install a service.

Configuring the Grid Services Agent (GSA)

When running in the Unicast discovery mode, the LUS should be started locally on the computer designated in the LookupLocators entry. The rest of the installations should be configured to point to a specific LUS, and therefore should not start one.

1. Since the Grid Services Agent (GSA) loads the LUS, you also need to configure the GSA. This is done in the magicxpi-gs-agent.bat file (located under: <Magic xpi installation>\Runtime\Gigaspaces\bin). To configure the installation that starts the LUS, make the following changes to the magicxpi-gs-agent.bat file :

   1. Open the file with Notepad.

   2. Comment any existing line starting with call gs-agent.bat. You do this by adding rem at the beginning of the line.

   3. Locate the commented line that starts with: any machine with lus service:

   4. Copy the text from the call operator and paste it to the end of the script.

The line should be as follows: call gs-agent.bat gsa.gsc 2 gsa.global.gsm 1 gsa.lus 1 gsa.global.lus 0 gsa.mgdeploy 1

The gsa.lus 1 element indicates that the LUS should start with one instance and should be managed locally by the GSA, and not globally on the grid. The gsa.global.lus 0 element indicates that no global LUSs should be started.

2. To configure an installation that only uses the LUS, without starting it, make the following changes to the magicxpi-gs-agent.bat file:

   1. Open the file in Notepad.

   2. Comment any existing line starting with call gs-agent.bat. You do this by adding rem at the beginning of the line.

   3. Locate the commented line that starts with: any machine without lus service:

   4. Copy the text from the call operator and paste it to the end of the script.

The line should be as follows: call gs-agent.bat gsa.gsc 2 gsa.global.gsm 1 gsa.lus 0 gsa.global.lus 0 gsa.mgdeploy 1

The gsa.lus 0 element indicates that no local LUSs should be started. The gsa.global.lus 0 element indicates that no global LUSs should be started.