Overview of the StateBuilder and gateways

The StateBuilder is an executable, statbld.exe, located in the intsallationDirectory/pw/server/bin directory. It records saved states of the cell at regular intervals. When it starts, the cell loads its last saved state (mcdb). All transactions it performs are stored in a transaction file (xact). As soon as the transaction file reaches a certain size, or after a certain period, the StateBuilder is started. It produces a new saved state from the previous file and from the transaction file. When the cell terminates and restarts, any trailing transaction file is first processed by the StateBuilder to produce a new saved state. A history of saved states and corresponding transaction files can be kept. The mcdb and xact files of that history have their time stamp in the file name.

All mcdb and xact files are located in the installationDirectory/pw/server/var/cellName directory. The StateBuilder runs as configured in the cell's mcell.conf file, which is described in StateBuilder configuration file. The configuration of how the StateBuilder itself operates is in the statbld.conf file.

The following table lists the file naming conventions for the StateBuilder.

StateBuilder file name conventions

There is also a statbld.trace file for the configuration of StateBuilder tracing. For further information, see Configuring tracing for StateBuilder.

The StateBuilder uses the gateway.export file in conjunction with its statbld.conf file to export event data. For more information, see StateBuilder configuration file and Exporting events.