1.. _xtrabackup_files :
2
3============================================
4Index of files created by Percona XtraBackup
5============================================
6
7* Information related to the backup and the server
8
9    * :file:`backup-my.cnf`
10       This file contains information to start the mini instance of InnoDB
11       during the :option:`--prepare`. This is **NOT** a backup of
12       original :file:`my.cnf`. The InnoDB configuration is read from the file
13       :file:`backup-my.cnf` created by |xtrabackup| when the backup was
14       made. :option:`--prepare` uses InnoDB configuration from
15       ``backup-my.cnf`` by default, or from
16       :option:`--defaults-file`, if specified. InnoDB
17       configuration in this context means server variables that affect data
18       format, i.e. ``innodb_page_size`` option,
19       ``innodb_log_block_size``, etc. Location-related variables, like
20       ``innodb_log_group_home_dir`` or ``innodb_data_file_path``
21       are always ignored by :option:`--prepare`, so preparing
22       a backup always works with data files from the backup directory, rather
23       than any external ones.
24
25    * :file:`xtrabackup_checkpoints`
26       The type of the backup (e.g. full or incremental), its state (e.g.
27       prepared) and the |LSN| range contained in it. This information is used
28       for incremental backups.
29       Example of the :file:`xtrabackup_checkpoints` after taking a full
30       backup:
31
32       .. code-block:: text
33
34         backup_type = full-backuped
35         from_lsn = 0
36         to_lsn = 15188961605
37         last_lsn = 15188961605
38
39       Example of the :file:`xtrabackup_checkpoints` after taking an incremental
40       backup:
41
42       .. code-block:: text
43
44         backup_type = incremental
45         from_lsn = 15188961605
46         to_lsn = 15189350111
47         last_lsn = 15189350111
48
49    * :file:`xtrabackup_binlog_info`
50       The binary log file used by the server and its position at the moment of
51       the backup. Result of the :command:`SHOW MASTER STATUS`.
52
53    * :file:`xtrabackup_binlog_pos_innodb`
54       The binary log file and its current position for |InnoDB| or |XtraDB|
55       tables.
56
57    * :file:`xtrabackup_binary`
58       The |xtrabackup| binary used in the process.
59
60    * :file:`xtrabackup_logfile`
61       Contains data needed for running the: :option:`--prepare`.
62       The bigger this file is the :option:`--prepare` process
63       will take longer to finish.
64
65    * :file:`<table_name>.delta.meta`
66       This file is going to be created when performing the incremental backup.
67       It contains the per-table delta metadata: page size, size of compressed
68       page (if the value is 0 it means the tablespace isn't compressed) and
69       space id. Example of this file could looks like this:
70
71       .. code-block:: text
72
73        page_size = 16384
74        zip_size = 0
75        space_id = 0
76
77* Information related to the replication environment (if using the
78  :option:`--slave-info` option):
79
80    * :file:`xtrabackup_slave_info`
81       The ``CHANGE MASTER`` statement needed for setting up a slave.
82
83* Information related to the *Galera* and *Percona XtraDB Cluster* (if using
84  the :option:`--galera-info` option):
85
86    * :file:`xtrabackup_galera_info`
87       Contains the values of ``wsrep_local_state_uuid`` and
88       ``wsrep_last_committed`` status variables
89