View a list of existing volume
backups and check that backups are available and completed with no
errors.
Syntax
cpd-cli oadp backup list \
# Global options
[--add_dir_header=true|false] \
[--alsologtostderr=true|false] \
[--cpd-namespace=<cpd-namespace>] \
[--kubeconfig=<kubeconfig-paths> \
[--log-level=info|debug|warn|error|panic|trace] \
[--log-backtrace-at=<source_code_file>:<line_number>] \
[--log_dir=<log_directory>] \
[--log_file=<log_file_name>] \
[--log_file_max_size=<uint>] \
[--logtostderr=true|false] \
[--namespace=<namespace-name>] \
[--one_output=true|false] \
[--skip_headers=true|false] \
[--skip_log_headers=true|false] \
[--stderrthreshold=<integer>] \
[--v=<integer>] \
[--verbose \
[--vmodule=<pattern1>=<n1>,<pattern2>=<n2>,<pattern3>=<n3>]
Arguments
Table 1: Global options arguments
| Argument |
Description |
<trace-location> |
The stack trace location |
<severity> |
The log severity level |
Options
Table 1: Command options
| Option |
Description |
|
--help
-h
|
Display command
help.
- Status
- Optional.
- Syntax
--help- Default value
- No default.
- Valid values
- Not applicable.
|
Global options
You can also use the following global options with this command:
Table 2: Command global options
| Option |
Description |
--add_dir_header |
Add the file directory to the
header of log messages.
- Status
- Optional.
- Syntax
--add_dir_header=true|false- Default value
- false
- Valid values
-
false- Do not add the file directory to the header of log messages.
true- Add the file directory to the header of log messages.
|
--alsologtostderr |
Log to standard error as well as
files.
- Status
- Optional.
- Syntax
--alsologtostderr=true|false- Default value
- false
- Valid values
-
false- Do not log to standard error as well as files.
true- Log to standard error as well as
files.
Note: This option has no effect when --logtostderr=true.
|
--cpd-namespace |
The IBM Software Hub namespace in
which the utility operates.
- Status
- Optional.
- Syntax
--cpd-namespace=<cpd-namespace>- Default value
- No default value.
- Valid values
- A valid IBM® Software
Hub
namespace.
Tip: The following command is an alternative to using this
option: cpd-cli oadp client config set cpd-namespace=<cpd-namespace>
However,
the option takes precedence over the command.
|
--kubeconfig |
Paths to a kubeconfig. Only
required if out-of-cluster.
- Status
- Optional.
- Syntax
--kubeconfig=<kubeconfig-paths>- Default value
- No default.
- Valid values
- Valid kubeconfig paths.
|
--log-level |
The command log
level.
- Status
- Optional.
- Syntax
-
--log-level=info|debug|warn|error|panic|trace
- Default value
-
info
- Valid values
-
-
debug
- Debug messages are written to the log.
-
error
- Error messages are written to the log.
-
info
- Informative messages are written to the log.
-
panic
- Panic messages are written to the log.
-
trace
- Trace messages are written to the log.
-
warn
- Warning messages are written to the log.
|
--log-backtrace-at |
When logging hits
<source_code_file> at line <line_number>, emit a stack trace. The default is any file at line
0.
- Status
- Optional.
- Syntax
--log-backtrace-at=<source_code_file>:<line_number>- Default value
-
No file and line 0 ( :0)
- Valid values
- A location in the source code file with the format
<source_code_file>:<line_number>.
|
--log_dir |
If non-empty, write log files in
this directory.
- Status
- Optional.
- Syntax
--log_dir=<log_directory>- Default value
No default.- Valid values
- A valid directory.
Note: This option has no effect when
--logtostderr=true.
|
--log_file |
If non-empty, use this log
file.
- Status
- Optional.
- Syntax
--log_file=<log_file_name>- Default value
No default.- Valid values
- A valid directory.
Note: This option has no effect when
--logtostderr=true.
|
--log_file_max_size |
The maximum size, in MB, that a
log file can grow to. If you specify 0, the maximum file size is
unlimited.
- Status
- Optional.
- Syntax
--log_file_max_size=<uint>- Default value
1800- Valid values
- A valid unsigned integer.
Note: This option has no effect when
--logtostderr=true.
|
--logtostderr |
Log to standard error instead of
files.
- Status
- Optional.
- Syntax
--logtostderr=true|false- Default value
true- Valid values
-
true- Log to standard error instead of files.
false- Log to files.
|
--namespace-n
|
The namespace where OADP is
installed.
- Status
- Optional.
- Syntax
--namespace=<oadp-namespace>- Default value
- No default value.
- Valid values
- Valid namespace name.
Tip: The following command is an alternative to using this
option: cpd-cli oadp client config set namespace=<OADP-operator-namespace>
However,
the option takes precedence over the command.
|
--one_output |
Specifies whether to only write
logs to their native severity level.
- Status
- Optional.
- Syntax
--one_output=true|false- Default value
false- Valid values
-
false- Write logs to their native severity level and also to each lower severity level.
true- Write logs only to their native severity level.
Note: This option has no effect when --logtostderr=true.
|
--skip_headers |
Specifies whether to avoid header
prefixes in log messages.
- Status
- Optional.
- Syntax
--skip_headers- Default value
- false
- Valid values
-
false- Do not avoid header prefixes in log messages.
true- Avoid header prefixes in log messages.
|
--skip_log_headers |
Specifies whether to avoid header
prefixes when opening log files.
- Status
- Optional.
- Syntax
--skip_log_headers- Default value
- false
- Valid values
-
false- Do not avoid headers when opening log files.
true- Avoid headers when opening log files.
Note: This option has no effect when --logtostderr=true.
|
--stderrthreshold |
Logs at or above the specified
severity threshold go to stderr. The threshold is used when you enable writing to files and
stderr.
- Status
- Optional.
- Syntax
--stderrthreshold=<integer>- Default value
- 2
- Valid values
- Any positive integer.
Note: This option has no effect when --logtostderr=true or
.--alsologtostderr=false
|
--v-v
|
Number for the log level
verbosity.
- Status
- Optional.
- Syntax
--v=<integer>- Default value
No default.- Valid values
- Any valid positive integer.
|
--verbose |
Logs include more detailed
messages.
- Status
- Optional.
- Syntax
--verbose- Default value
- No
default.
- Valid values
- Not applicable.
|
--vmodule |
A comma-separated list of
pattern=N settings for file-filtered logging.
- Status
- Optional.
- Syntax
--vmodule=<pattern1>=<n1>,<pattern2>=<n2>,<pattern3>=<n3>- Default value
No default.- Valid values
-
A valid comma-separated list of patterns with the format
<pattern>=<n>.
|
Examples
Note: The following examples use the recommended installation environment variables.
It is strongly recommended that you use a script to create
environment variables with the correct values for your
environment. For more information, see Setting up installation environment variables.
- List existing volume backups.
-
cpd-cli oadp backup list \
--namespace=${PROJECT_CPD_INST_OPERANDS}