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.
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.
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.
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
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.
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.
- Viewing the network interface information (optional)
- Specifying a network card to bind the lookup service
- Limiting use to a specific network interface (multicast only) (optional)
- Using unicast to register with a lookup service (optional)
- Testing your configuration
- Troubleshooting your configuration, if you experience problems
For more details, refer to the Advanced Multi-NIC Configuration section.