The Rhapsody datastore is a file-based system used to store the engine configuration and state information as well as the message archive.

The default location for the datastore files is <RhapsodyInstallDirectory>\rhapsody\data.

Sub-directory Description

\backup

Contains the backups schedule.
\charactermap Stores the global mapping file, characterMapping.xml. Refer to Global Mapping File for details.
\cleanup Holds configuration details that control when cleanup is performed.

\cleanuptrace

Contains the cleanup trace log files used by the Management Console.

\commpoints

Contains indexes for certain communication points.

\config

Contains the Rhapsody configuration.

\filters

Used by the Duplicate Message Detection filter to store the data structure for tracking duplicate messages.

\idgeneration

Stores persistent information about the current state of each ID generator. 

\index

Contains indexes created to access properties on messages.

\lib

Contains external libraries that are common between many communication points. For example, you can add third-party JDBC drivers here instead of attaching them to each individual communication point. However, if you attach a library to a communication point it will override any library that is in this directory.

\logs

Contains the following log folders used by the Management Console:

  • \logs\audit
  • \logs\component

These files are not text logs, and should not be attached to support tickets. The text logs can be found in the log directory under the main Rhapsody binaries directory.


\lookuptable

Contains the following databases:

  • lookuptable – contains lookup table data.
  • failure – contains lookup failures that were recorded during the lookup process.

\messageevents

Contains data about events that occur to messages, which is used to display the message path in the Management Console.

\messagemodifier Not currently used for any purpose.

\messagestore

Holds both the message body, and all the metadata and properties of messages.

\messagetables

Contains indexes for the Hold Queue and Error Queue.

\modules

Contains all the uploaded modules, such as custom communication points and filters. 

\monitoring

Contains a settings file used by the Management Console.

\notifications

Contains notifications history and respective indexes etc.

\persistentmapstore

Used by communication points to store values that must be persisted, for example, a database key value.

\queue

Stores index files that point into the message store. These indexes control how messages are queued inside the engine. The \queue data store includes the:

  • Input Message Store.
  • Output Message Store.
  • Process Message Store.
  • Redirected Message Store.

\startup

Stores the startup state information for a communication point or route. The storage location of the startup metadata can be changed by adding the StartupService.directory property to the rhapsody.properties file. If this directory is not present, it is automatically created.

\statistics

Stores statistical information used to plot graphs in the Management Console, and also the total message counts for components.

\store

Used as a general storage location.  

\tmp

Used to store files temporarily as they are being processed by Rhapsody. 

\tracking

Used to store information about messages currently being tracked. 

\transaction

Contains a transaction system that operates in a similar way to a database.  

\users

Contains all the user data. This data is protected with encryption and a one-way hash system so that it is impossible to recover a password. If the contents of this directory are deleted the administration account is automatically recreated.

\validation

Contains the current data validation status, which is used to ensure that data is validated correctly after an unclean shutdown.