DataSplice Server

Configuration Files

All of the server configuration files are stored as xml documents in the <Instance Root>\Server\Storage\ folder. These files must be writable by the DataSplice server process.

• Options - Contains the server and plug-in settings for the current instance.
  
• Permissions - Specifies the views available to the various roles.
  
• Users - Contains information about the internally managed users and groups. External accounts do not have any persisted settings.
  
• Views - Contains the hierarchy of view objects.
  

Cache Files

The server persists certain runtime data in the <Instance Root>\Server\ServerData\ folder. Most of this data is temporary cached information, but the Sessions folder contains information about the current offline sessions, which allows these sessions to persist across service restarts.

Resource Files

The <Instance Root>\Server\Resources\ folder contains various resource files that are used by the applications and plug-ins:

• Text - Localized resources for the application text values. These are synchronized to the clients after successfully connecting.
• Scripts - Helper batch scripts that perform a variety of tasks.
• JavaScript - Include scripts used by the Scripting Plug-in.
• Maximo <Version> Storage - Default configuration settings for various versions of Maximo installed by the integration plug-in.
• JavaTest - Test Java applications provided by the Maximo Integration Plug-in to aid in diagnosing connection issues.
  

Registry Settings

Certain instance-specific options are stored in the system registry under the HKLM\Software\DataSplice3.1_<instance name>\ key. For this reason, the user account used to run the DataSplice service needs permission to modify the HKLM hive.

Desktop Clients

Cache Files

Information about the current session and available views is cached in the current user's <Application Data>\DataSplice3.1\RemoteClient\ folder (AdminClient for the Administration Client). The Application Data folder can vary based on system configuration, but is typically C:\Documents and Settings\<User Name>\Application Data\ on Windows XP machines, and C:\Users\<User Name>\App Data\Roaming\ on Windows Vista and later systems.

Because SQL Server is used to persist offline data, the cache folder does not actually contain and of the user data.

Registry Settings

Various minor settings, such as window positions, recently used value lists, etc. are persisted in the HKCU\Software\DataSplice3.1\RemoteClient\ key (DSAdmin for the Administration Client).

Handheld Clients

Cache Files

Session data is stored in the same location as the application in the ClientData subfolder. This allows the client to be installed on storage cards, or other non-volatile locations and ensures that cached data is stored such that it will not be lost if the device loses power, etc.

SQL Server Mobile stores database information as a single file, so the ClientData\DataSplice.sdf file contains all the offline data for the current user.

Resource Files

Several subfolders in the local resource folder for the client applications are used to provide local values for the applications and plug-ins. These are typically synchronized from the server after connecting, and thus do not need to be handled manually.

Registry Settings

as for the desktop application.