dumpoplog

Lists the contents of a replica's operation log

Applicability

Product Command type
MultiSite multiutil subcommand
Platform
Windows™

Synopsis

dumpoplog


[ –cl/an clan-name ] [ –site site-name ] –fam/ily family-name
–u/ser username [ –p/assword ] password [ –l/ong | –s/hort]
[ –at replica ] [ oplog-ID... | [ –from oplog-ID ]
[ –to oplog-ID ] ] [ –since date-time ] [ –reverse ]

Description

Use dumpoplog to list information in a replica's operation log (oplog). The oplog tracks all database transactions, including record changes and schema modifications. Each oplog entry has an oplog ID.

Restrictions

You must have Super User privileges.

Options and arguments

Specifying the clan, site, and family

Default
Clan: First clan replicated at this site. If there is more than one dbset connection registered on this host, –clan is required.

Site: Current site. If there is more than one site on this host, –site is required.

Family: No default; you must specify a family.

–cl/an clan-name
Name of the replica’s clan.
–site site-name
Name of the replica’s site.
–fam/ily family-name
User database family: Database name given to the user database when it was created.

Schema repository family: The family name is MASTR.

Specifying a user name and password

Default
You must specify a user name and password.
–u/ser user
Name of a user with Super User privileges.
–p/assword password
Password associated with the specified user.

Specifying the information to display

Default
If you do not specify a format, the –short format is used. All oplog entries are listed.
–l/ong | –s/hort
With –long, displays all columns of the oplog, including information about the schema revision that applies to the packet data. With –short, displays each database operation that took place.
–at replica
Lists the oplog entries that originated from the sites you specify.
oplog-ID...
Lists the oplog entries you specify.
–from oplog-ID
Lists a range of oplog entries starting with oplog-ID and ending with the latest one or the one specified with –to. Specify oplog IDs as integers.
–to oplog-ID
Lists a range of oplog entries ending with oplog-ID and starting with 1 or the one specified with –from. Specify oplog IDs as integers.
–since date-time
Lists all oplog entries after date-time. The date-time argument can have any of the following formats:
date.time | date | time | now
where:
date:
= day-of-week | long-date
time:
= h[h]:m[m][:s[s]] [UTC [ [ + | - ]h[h][:m[m] ] ] ]
day-of-week:
= today |yesterday |Sunday | ... |Saturday |Sun | ... |Sat
long-date:
= d[d]month[[yy]yy]
month:
= January |... |December |Jan |... |Dec

Specify the time in 24-hour format, relative to the local time zone. If you omit the time, the default value is 00:00:00. If you omit the date, the default value is today. If you omit the century, year, or a specific date, the most recent one is used. Specify UTC if you want the time to be resolved to the same moment in time regardless of time zone. Use the plus (+) or minus (-) operator to specify a positive or negative offset to the UTC time. If you specify UTC without hour or minute offsets, the default setting is Greenwich Mean Time (GMT). (Dates before January 1, 1970 Universal Coordinated Time (UTC) are not valid.)

Examples:
  • 22-November-2002
  • sunday
  • yesterday.16:00
  • 0
  • 8-jun
  • 13:00
  • today
  • 9-Aug.10:00UTC
–reverse
Reverse the order of the list of oplog entries.

Examples

In these examples, the lines are broken for readability. You must enter each command on a single physical line. The output of each example is not shown due to space limitations.

  • List the oplog of operations associated with the DOC family at the boston_hub replica.



    multiutil dumpoplog -clan telecomm -site boston_hub -family DOC
    -user susan -p passwd


  • List the oplog of the sanfran_hub operations at the sanfran_hub replica.



    multiutil dumpoplog -clan telecomm -site sanfran_hub -family DEV
    -user jcole -p passwd -short -at sanfran_hub


  • List the oplog of all operations in the bangalore replica as of January 28, 2002.



    multiutil dumpoplog -clan telecomm -site bangalore -family DOC
    -user masako -p passwd -short -since 28-Jan-2002


  • List oplog entries 3 through 6 from the boston_hub replica.



    multiutil dumpoplog -clan telecomm -site boston_hub -family DEV
    -user susan passwd -long -from 3 -to 6


  • List the first oplog entry in the tokyo replica.



    multiutil dumpoplog -clan testclan -site tokyo -family TEST
    -user masako -p passwd -long -from 1