Testing System Environment
To perform a simple system testing you should use the space-instance.bat
script on windows or space-instance.sh
script on linux.
To set up a production environment,refer to Moving into Production Checklist.
Verifying Local Installation
- Run a single GigaSpaces space instance by moving to the
<XAP Root>\bin
directory and running thespace-instance.bat/sh
command. You should see such an output:
D:\gigaspaces-xap-premium-8.0.1-ga\bin>space-instance.bat
Starting a Space Instance
Setting space url to "/./mySpace?schema=default&properties=gs&groups="gigaspaces-8.0.1-XAPPremium-ga""
java version "1.6.0_24"
Java(TM) SE Runtime Environment (build 1.6.0_24-b07)
Java HotSpot(TM) 64-Bit Server VM (build 19.5-b02, mixed mode)
Log file: D:\gigaspaces-xap-premium-8.0.1-ga\bin\..\logs\2011-06-19~01.21-gigaspaces-service-192.168.1.101-12840.log
2011-06-19 01:21:03,458 INFO [com.gigaspaces.common.resourceloader] - Loading properties file from:
file:/D:/gigaspaces-xap-premium-8.0.1-ga/config/gs.properties
2011-06-19 01:21:03,896 INFO [com.gigaspaces.container] -
System Environment:
System:
OS Name: Windows 7
OS Version: 6.1
Architecture: amd64
Number Of Processors: 4
JVM Details:
Java Version: 1.6.0_24, Sun Microsystems Inc.
Java Runtime: Java(TM) SE Runtime Environment (build 1.6.0_24-b07)
Java VM: Java HotSpot(TM) 64-Bit Server VM 19.5-b02, Sun Microsystems Inc.
Java Home: d:\java\jdk1.6.0_24\jre
JVM Memory:
Max Heap Size (KB): 466048
Current Allocated Heap Size (KB): 116451
Network Interfaces Information:
Host Name: [my-PC]
Network Interface Name: lo / Software Loopback Interface 1
IP Address: 0:0:0:0:0:0:0:1
IP Address: 192.168.1.101
Zones: N/A
Process Id: 12840
GigaSpaces Platform:
Edition: XAP Premium 8.0.1 GA
Build: 5200
Home: D:\gigaspaces-xap-premium-8.0.1-ga\bin
..\
2011-06-19 01:21:04,231 INFO [com.gigaspaces.container] - Created RMIRegistry on: < 192.168.1.101:10098 >
2011-06-19 01:21:04,244 INFO [com.gigaspaces.container] - Webster HTTP server started successfully serving the
following roots: D:\gigaspaces-xap-premium-8.0.1-ga\bin
..\/lib;D:\gigaspaces-xap-premium-8.0.1-ga\bin
..\/lib/jini Webster
serving on: 192.168.1.101:9813
2011-06-19 01:21:04,741 INFO [com.sun.jini.reggie] - started Reggie: ab0f28be-5829-4566-861e-4ccad1da1c50,
[gigaspaces-8.0.1-XAPPremium-ga], jini://192.168.1.101:4166/
2011-06-19 01:21:05,046 INFO [com.gigaspaces.core.common] - Starting Space [mySpace_container:mySpace] with url
[/./mySpace?schema=default&properties=gs&groups=gigaspaces-8.0.1-XAPPremium-ga&state=started] ...
2011-06-19 01:21:05,515 INFO [com.gigaspaces.cache] - Cache manager created with policy [ALL IN CACHE],
persistency mode [memory]
2011-06-19 01:21:05,703 INFO [com.sun.jini.mahalo.startup] - Mahalo started: com.sun.jini.mahalo.TransientMahaloImpl@31bd669d
2011-06-19 01:21:05,712 INFO [com.gigaspaces.core.common] - Space [mySpace_container:mySpace] with url
[/./mySpace?schema=default&properties=gs&groups=gigaspaces-8.0.1-XAPPremium-ga&state=started] started successfully
- Make sure it loads without errors/exceptions. If you have error/exceptions check the following:
JAVA_HOME
environment variable - Make sure it points to a valid JDK folder.- Network setup - Make sure the machine has a valid network interface installed with a valid IP.
- hosts file - Make sure it includes entry for
localhost
or other machines you are accessing. - Multiple NICs - If your machine running multiple network interfaces, make sure you have the
XAP_NIC_ADDRESS
environment variable set to a valid IP of the machine. This should be done on every machine running GigaSpaces. - User permissions - Make sure you run the
gsInstnce.sh
script with a linux user that has permissions to write into the<XAP root>/logs
folder. CLASSPATH
environment variable - Make sure theCLASSPATH
environment variable is not specified. You might have some libraries specified as part of theCLASSPATH
that cause GigaSpaces to fail.XAP_HOME
- environment variable - Make sure theXAP_HOME
environment variable is not specified or pointing to a different GigaSpaces release folder. It might be you have some other GigaSpaces release installed on the same machine withXAP_HOME
variable pointing to this release folder.
- Ping the space by running the
<XAP Root>\bin\gs.bat/sh
utility:
gs space ping -url jini://*/*/mySpace
The following using multicast lookup discovery protocol. The first *
of the URL means search for the lookup service across the network using multicast.
The following result output should appear on the console:
D:\gigaspaces-xap-premium-8.0.1-ga\bin>gs space ping -url jini://*/*/mySpace
total 1
ping from <mySpace> space
with:
Finder URL: jini://*/*/mySpace?timeout=5000
Lease Timeout: 10 seconds
LookupFinder timeout: 5000 milliseconds
Buffer Size: 100
Iterations: 5
Average Time = 135 milliseconds
Subsequent space ping calls will have much faster response time. The fist space ping call introduce some meta data to the space. This happens only once.
If the space ping call fails with the following:
total 0
Service is not found using the URL: jini://*/*/mySpace?timeout=5000
You have the following options: - Make sure your network and machines running GigaSpaces are configured to have multicast enabled. See the How to Configure Multicast section for details on how to enable multicast. - Perform a space ping using unicast lookup discovery protocol: gs space ping -url jini://localhost/*/mySpace The following result should appear on the console:
D:\gigaspaces-xap-premium-8.0.1-ga\bin>gs space ping -url jini://localhost/*/mySpace
total 1
ping from <mySpace> space
with:
Finder URL: jini://localhost/*/mySpace?timeout=5000
Lease Timeout: 10 seconds
LookupFinder timeout: 5000 milliseconds
Buffer Size: 100
Iterations: 5
Average Time = 135 milliseconds
When the ping client running on a remote machine (other than the machine running the space), localhost
should be replaced with the machine hostname or IP running the space instance.
Verifying Remote Installation
Repeat the above steps #3, where the ping command is called from a machine different than the one running the space. You will have to install GigaSpaces both on the client and server machines.