Summary: Directories structure configuration.

Overview

XAP.NET installation creates a certain directory structure, which has 3 key directories:

  • Installation directory - where XAP.NET is installed, and under which, resides the Bin directory that contains the XAP.NET libraries and executables.
  • Runtime directory - where XAP JARS, dependencies and Java core configuration files reside.
  • Java home directory - where the JVM libraries reside.

The directory structure is created during the installation of XAP.NET, and the directories location is updated in the registry. Normally the location of these directories does not need to be updated.
However, in some scenarios, such as a side-by-side installation (XAP and XAP.NET installation on the same machine) or using a different JVM, this directory structure needs to be changed.

Changing the Java Home Default Directory Value

XAP.NET comes with a built-in JVM library, and the registry Java home value points to that JVM. If a different JVM is needed, you can edit the registry value HKLM\Software\GigaSpaces\XAP.NET <version number>\JavaHome and change the directory to the new JVM directory location.

Changing the Runtime Directory Value

If a different runtime directory is needed, instead of the one that was set by the installer, you need to edit the registry value HKLM\Software\GigaSpaces\XAP <version number>\InstallDir. Alternatively this value can be configured per application by inserting a configuration element in the app.config of the application.

The following configuration sets RuntimeDir to C:\MyRuntimeDir:

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <configSections>
    <section name="GigaSpaces" type="GigaSpaces.Core.Configuration.GigaSpacesCoreConfiguration, GigaSpaces.Core"/>
  </configSections>
  <GigaSpaces>
    <RuntimeDir Path="C:\MyRuntimeDir"/>
  </GigaSpaces>
</configuration>

You can also define a relative path from your application's running path to your runtime directory. For example:

...
 <GigaSpaces>
       <RuntimeDir Path="..\..\..\"/>
 </GigaSpaces>

Changing the Installation Directory Value

If XAP.NET isn't installed using the installer, all the registry values described above need to be manually created. One of them is the installation directory. The following registry key and value must be created: HKLM\Software\GigaSpaces\XAP.NET <version number>\InstallDir, and point to the place where the XAP.NET directory resides.

GigaSpaces.com - Legal Notice - 3rd Party Licenses - Site Map - API Docs - Forum - Downloads - Blog - White Papers - Contact Tech Writing - Gen. by Atlassian Confluence