Skip to main content
Common Reference

The tungsten_read_master_events Command

The tungsten_read_master_events displays the raw contents of the primary datasource for the given THL records. It implements the Tungsten Script Interface as well as these additional options.

Usage
tungsten_read_master_events [options]

Where:

OptionDescription
--directoryThe $CONTINUENT_ROOT directory to use for running this command. It will default to the directory you use to run the script.
--forceContinue operation even if script validation fails.
--help
Aliases: -h
Show the help text.
--highDisplay events ending with this sequence number.
--info
Aliases: -i
Display info, notice, warning, and error messages.
--jsonOutput all messages and the return code as a JSON object.
--lowDisplay events starting with this sequence number.
--net-ssh-optionProvide custom SSH options to use for SSH communication to other hosts. This allows you to set explicit SSH options, such as changing the default network communication port, password, or other information. For example, using--net-ssh-option=port=80 will use port 80 for SSH communication in place of the default port 22.
--notice
Aliases: -n
Display notice, warning, and error messages.
--serviceReplication service to read information from.
--sourceDetermine metadata for the --after, --low, --high statements from this host.
--validateOnly run script validation.
--verbose
Aliases: -v
Show verbose information during processing.

Compatibility

The script only works with MySQL at this time.

Display all information after a specific sequence number

This may be used when you have had a primary failover or would like to see everything that happened after a certain event. It will read the start position from the sequence number passed and allow you to see all events, even if they were not extracted by the replication service.

shell> tungsten_read_master_events --after=1792

If you provide the --source option, the script will SSH to the host in question and read its THL information.

Display information between two sequence numbers

This will show the raw primary data between the two sequence numbers. It is inclusive so the information for the --low option will be included. This will only work if the sourceId for both sequence numbers is the same.

shell> tungsten_read_master_events --low=4582 --high=4725