Summary: Using existing Java and/or XAP installations
Overview GigaSpaces XAP.NET takes advantage of several runtime components from GigaSpaces XAP (and, as a consequence, Java). In most cases, this is transparent to the user, since the XAP.NET installation process includes the required Java and XAP files. However, in some cases, users may wish to use an existing Java or XAP installation (e.g. developing interoperability solutions, using both XAP and XAP.NET). This page explains how to install XAP.NET in such scenarios. Q. How do I install XAP.NET using an existing java installation? GigaSpaces XAP.NET is bundled with Sun JDK 6 update 14. If you've already installed Java and wish XAP.NET to use your Java installation instead of creating an additional installation, follow these steps: 1. Start XAP.NET installation. Review and accept the license. 2. In the Choose Setup Type dialog, select Custom, and click Next to continue. 3. In the Custom Setup dialog, expand the Core Components node in the feature tree, click Built-in Java and select Entire feature will be unavailable. Click Next to continue. 4. In the Java Installation Path groupbox, type the location of your installed Java, and click Next to continue. 5. Click Install to start the installation process. Q. I've already installed XAP.NET. Can I configure it to work with a different java version or location? Yes. Open the Windows Registry, find HKLM\SOFTWARE\GigaSpaces\XAP.NET\<version>\JavaHome and update the value to the new location. Q. How do I install XAP.NET using an existing XAP installation? GigaSpaces XAP.NET is bundled with GigaSpaces XAP components required at runtime. Developers engaged in interoperability solutions may prefer working with a full installation of the Java XAP, which contains documentation, examples and tutorials. If you wish XAP.NET to use an existing XAP installation instead of creating an additional installation, follow these steps: 1. Start XAP.NET installation. Review and accept the license. 2. In the Choose Setup Type dialog, select Custom and click Next to continue. 3. In the Custom Setup dialog, expand the Core Components node in the feature tree, click Built-in XAP Runtime, and select Entire feature will be unavailable. Click Next to continue. 4. In the XAP Runtime Components Installation Path groupbox, type the location of your installed XAP, and click Next to continue. 5. Click Install to start the installation process. Q. I've already installed XAP.NET. Can I configure it to work with a different XAP location? Yes. Open the Windows Registry, find HKLM\SOFTWARE\GigaSpaces\XAP\<version>\InstallDir and update the value to the new location. You cannot mix XAP.NET and XAP versions - always use the same version and build. Q. Can I package XAP.NET as a zip file instead of Windows Installer (msi)? XAP.NET installation is released as an msi file because simply copying the file to the target machine is not enough - a few machine settings need to be configured, and the preferred method of doing this to date is Windows Installer. If you wish, you can install XAP.NET on a single machine, package the installed XAP.NET folder as a zip and re-use it on other machines. You will need to manually configure those machines, though. The following settings required:
Setting |
Registry key |
XAP.NET needs to know where java is to load the jvm |
HKLM\SOFTWARE\GigaSpaces\XAP.NET\<version>\JavaHome |
XAP.NET needs to know where XAP is to access its JARs |
HKLM\SOFTWARE\GigaSpaces\XAP\<version>\InstallDir |
XAP needs to know where XAP.NET is to load its DLLs |
HKLM\SOFTWARE\GigaSpaces\XAP.NET\<version>\InstallDir |
Q. I need to minimize the installation size. Can I use a shared folder on a server to store part of the installation? Yes. You can manually set the registry settings shown above to point both java and XAP to a shared folder on a remote server. In such scenarios, the shared folder that contains XAP must be mapped as a network drive. XAP will fail to load if a network path is used (e.g. \\server\share). |