Percona Logjam User's Manual

Percona Logjam is a tool to help replay production traffic against a database in multiple threads. It is unreleased; when the code is ready to release, there will be more information on this user's manual. Until then, this will serve as a specification of what remains to get the code release-ready.

Tasks we must finish before the tool is ready to release:

• Rename the tool to percona-logjam.
• Permit the tool to read from FILEs on the command-line as well as from STDIN.
• Get a code review.
• Create statically-linked 32-bit and 64-bit builds of the tool so it can be used without installing dependencies. (Oleg's task)
• Change the command-line options as follows:
  1. change usage information to “Usage: percona-logjam [OPTIONS] [FILE…]”
  2. update the help text for all of the options
  3. make the default port = 3306
  4. make the 'bool' options not require an argument
  5. change verbose-error to verbose-errors
  6. change passwd to password
  7. change disable_read to skip-read-queries
  8. change disable_write to skip-write-queries
  9. change db to database
  10. change block-count to parser-block-count
  11. change block-size to parser-block-size
  12. Change disable_foreigh_keys_check_in_write_thread option to –skip-foreign-key-checks
• Change the column names in the output (not yet defined)
• Write full documentation here
• Write an announcement blog post

Percona Logjam is currently in unreleased Beta.

To be completed later.

For portability and ease of use, we plan to build a single statically linked binary, which can be downloaded and used as-is.

To be completed later.

The following is a complete list of Percona Logjam's command-line options. You can always find a full list of the available command-line options and brief usage information by giving the --help option.

Percona Logjam reads from each FILE that you specify on the command line after program options. If you do not specify any FILE, or if FILE is -, Percona Logjam reads from standard input.

The Percona Logjam source code is not yet available.

For general discussion, please use the Percona-Discussion Google Group. You can use the #percona IRC channel on FreeNode to chat with community members.

For commercial support, maintenance packages, or to sponsor features, please contact Percona Sales.

Percona Logjam was written by Oleg Tsarev, based on ideas and specifications from Vadim Tkachenko and Baron Schwartz.