Multiple Network Cards

GigaSpaces can be configured for a multiple network card environment. For security reasons, network administrators may choose to configure their network with limited access of one card open to outside connections, and another card for internal connections. The default network card configuration is not always set to the network card used for internal connection, and thus needs to be configured.

The java.rmi.server.hostname system property is used to resolve the NIC address for all services, which bind to a specific network interface, e.g. Jini unicast discovery lookup host, Webster, etc. More specifically, multicast and unicast discovery both use this property to limit and set the desired network interface card.

The XAP_NIC_ADDRESS environment variable is exposed as part of the $GS_HOME\bin\setenv script. By default, this value is configured to use the hostname of the machine.

Since the java.rmi.server.hostname system property is set by default to the XAP_NIC_ADDRESS environment variable, and propagated across all product components/layers; in most cases, you don't need to edit the setenv file or any other configuration file.

To apply this configuration easily, the XAP_NIC_ADDRESS variable can be passed at the script level of each node startup, before the call to setenv, thus overriding the default value set for this property in the setenv script.

Make sure your network and machines running GigaSpaces are configured to have multicast enabled. Refer to Multicast Configuration for details on how to enable multicast.

Configuring GigaSpaces for Multiple NICs

This procedure lists the general configuration process steps that are required to test and configure the Multi-NIC settings in GigaSpaces. Refer to these sections only if the out-of-the-box settings fail to work.

  1. Viewing the network interface information (optional)
  2. Specifying a network card to bind the lookup service
  3. Limiting use to a specific network interface (multicast only) (optional)
  4. Using unicast to register with a lookup service (optional)
  5. Testing your configuration
  6. Troubleshooting your configuration, if you experience problems

For more details, refer to the Advanced Multi-NIC Configuration section.