Playing the contents of .snap and .xlog files to a Tarantool instance | Tarantool
Tarantool
Check out the new release policy
Reference Tooling tt CLI utility Commands Playing the contents of .snap and .xlog files to a Tarantool instance

Playing the contents of .snap and .xlog files to a Tarantool instance

tt play URI FILE .. [flags]

tt play plays the contents of snapshot (.snap) and WAL (.xlog) files to another Tarantool instance. A single call of tt play can play multiple files.

--from Play operations starting from the given LSN
--to Play operations up to the given LSN. Default: 18446744073709551615
--replica Filter the operations by replica id. Can be passed more than once
--space Filter the operations by space id. Can be passed more than once
--show-system Play the operations on system spaces

tt play plays operations from .xlog and .snap files to the destination instance one by one. All data changes happen the same way as if they were performed on this instance. This means that:

  • All affected spaces must exist on the destination instance. They must have the same structure and space_id as on the instance that created the snapshot or WAL file.

    To play a snapshot or a WAL to a clean instance, include the operations on system spaces by adding the --show-system flag. With this flag, tt plays the operations that create and configure user-defined spaces.

  • The operations’ LSNs will change unless you play all operations that took place since the instance startup.

  • Replica IDs will change in accordance with the destination instance configuration.

When calling tt play with filters by LSN (--from and --to flags) and replica ID (--replica), remember that LSNs differ across replicas. Thus, if you pass more than one replica ID via --from or --to, the result may not reflect the actual sequence of operations.

  • Play the contents of 00000000000000000000.xlog to the instance on 192.168.10.10:3301:

    tt play 192.168.10.10:3301 00000000000000000000.xlog
    
  • Play operations on spaces with space_id 512 and 513 from the 00000000000000000012.snap snapshot file:

    tt play 192.168.10.10:3301 00000000000000000012.snap --space 512 --space 513
    
  • Play the contents of 00000000000000000000.xlog including operations on system spaces:

    tt play 192.168.10.10:3301 00000000000000000000.xlog --show-system
    
Found what you were looking for?
Feedback