nodedump - utility to dump node contents to file
------------------------------------------------

Revision: 2016-05-12

usage: nodedump [options] node-number destination-file
options:
 -v         - verbose
 -d flags   - debug flags
 -c cfg     - configuration file name
 -b size    - Buffer cache size (MB)

The nodedump utility may be used to dump the binary contents of a node to a
file. In the database server environment, a node is the equivalent of a file
in the file system. Node storage is allocated in 8 KB units (pages).

The purpose of this utility is to help the Eloquence support team at Marxmeier
Software AG to perform diagnostics or data recovery in special cases.

Usage instructions:

1) Download the nodedump archive according to your platform and unpack
the contained nodedump executable into a directory of your choice.
You could, for example, unpack it into the Eloquence bin directory to
integrate it into your Eloquence environment.

2) As instructed by the Eloquence support team, invoke the nodedump utility
on a specific node to create a binary dump of this node to a file.

The example below would dump the contents of node #20 (the sysobjects table
from the system catalog) to a file named n20.bin in the current directory:

/path/to/nodedump 20 n20.bin


Please note that in case the database server is active, the database server
should be put in on-line backup mode to prevent that the node is modified
while it is dumped. This is because the nodedump utility directly accesses
the database server data volume files. The on-line backup mode makes sure
that the data volumes do not change.

To put the database server into on-line backup mode, a sequence like below
may be used:

/opt/eloquence/8.x/bin/dbctl -u dba backup start
... invoke the nodedump utility ...
/opt/eloquence/8.x/bin/dbctl -u dba backup stop


If you have questions or feedback, please contact: support@marxmeier.com

Your Eloquence team at Marxmeier Software AG