ndb_print_backup_file obtains diagnostic information from a cluster backup file.
Usage
ndb_print_backup_file [-P password] file_name
file_name
is the name of a cluster
backup file. This can be any of the files
(.Data
, .ctl
, or
.log
file) found in a cluster backup
directory. These files are found in the data node's backup
directory under the subdirectory
BACKUP-
, where
#
#
is the sequence number for the
backup. For more information about cluster backup files and
their contents, see
Section 25.6.8.1, “NDB Cluster Backup Concepts”.
Like ndb_print_schema_file and
ndb_print_sys_file (and unlike most of the
other NDB
utilities that are
intended to be run on a management server host or to connect to
a management server) ndb_print_backup_file
must be run on a cluster data node, since it accesses the data
node file system directly. Because it does not make use of the
management server, this utility can be used when the management
server is not running, and even when the cluster has been
completely shut down.
This program can also be used to read undo log files.
Options
ndb_print_backup_file supports the options described in the following list.
--backup-key
,-K
Command-Line Format --backup-key=key
Specify the key needed to decrypt an encrypted backup.
-
Command-Line Format --backup-key-from-stdin
Allow input of the decryption key from standard input, similar to entering a password after invoking mysql
--password
with no password supplied. -
Command-Line Format --backup-password=password
Type String Default Value [none]
Specify the password needed to decrypt an encrypted backup.
-
Command-Line Format --backup-password-from-stdin
Allow input of the password from standard input, similar to entering a password after invoking mysql
--password
with no password supplied. -
Command-Line Format --control-directory-number=#
Type Integer Default Value 0
Control file directory number. Used together with
--print-restored-rows
. -
Command-Line Format --defaults-extra-file=path
Type String Default Value [none]
Read given file after global files are read.
-
Command-Line Format --defaults-file=path
Type String Default Value [none]
Read default options from given file only.
-
Command-Line Format --defaults-group-suffix=string
Type String Default Value [none]
Also read groups with concat(group, suffix).
-
Command-Line Format --fragment-id=#
Type Integer Default Value 0
Fragment ID. Used together with
--print-restored-rows
. -
Command-Line Format --help
--usage
Print program usage information.
-
Command-Line Format --login-path=path
Type String Default Value [none]
Read given path from login file.
-
Command-Line Format --no-login-paths
Skips reading options from the login path file.
-
Command-Line Format --no-defaults
Do not read default options from any option file other than login file.
-
Command-Line Format --no-print-rows
Do not include rows in output.
-
Command-Line Format --print-defaults
Print program argument list and exit.
-
Command-Line Format --print-header-words
Include header words in output.
-
Command-Line Format --print-restored-rows
Include restored rows in output, using the file
LCP/
, for which the values are set as follows:c
/Tt
Ff
.ctlc
is the control file number set using--control-directory-number
t
is the table ID set using--table-id
f
is the fragment ID set using--fragment-id
-
Command-Line Format --print-rows
Print rows. This option is enabled by default; to disable it, use
--no-print-rows
. -
Command-Line Format --print-rows-per-page
Print rows per page.
-
Command-Line Format --rowid-file=path
Type File name Default Value [none]
File to check for row ID.
-
Command-Line Format --show-ignored-rows
Show ignored rows.
-
Command-Line Format --table-id=#
Type Integer Default Value [none]
Table ID. Used together with
--print-restored-rows
. -
Command-Line Format --usage
Display help text and exit; same as
--help
. -
Command-Line Format --verbose[=#]
Type Integer Default Value 0
Verbosity level of output. A greater value indicates increased verbosity.
-
Command-Line Format --version
Display version information and exit.