export-import import create

Start an import.

Syntax

cpd-cli export-import import create <cpd-import-name> \
[--arch=<system-cpu-architecture>] \
[--backoff-limit] \
[--cpdconfig=<cpd-configuration-location>] \
[--from-export=<cpd-export-name>] \
[--from-schedule=<import-schedule-name>] \
[--instance-name=<service-instance-name>] \
[--log-level=info|debug|warn|error|panic|trace] \
[--namespace=<namespace-name>] \
--profile=<cpd-profile-name> \
[--service-type=<cpd-service-type>] \
[--values=<yaml-file-name1,yaml-file-name2,...>] \
[--verbose]

Arguments

Table 1: Command arguments
Argument Description
<cpd-import-name> The name of the import to create.

Options

Table 1: Command options
Option Description
--arch The type of hardware the cluster runs on.
Status
Optional.
Syntax
--arch=${CPU_ARCH}
Default value
x86_64
Valid values
x86_64
The 64-bit version of the x86 instruction set architecture.
ppc64le
The little-endian variant of the PowerPC 64-bit architecture.
--backoff-limit The number of times to retry an export or import job before the job fails. Setting --backoff-limit=0 disables the retry.
Status
Optional.
Syntax
--backoff-limit=<backoff-limit>
Default value
1
Valid values
The backoff-limit can be any integer value equal to or greater than 0.
A backoff-limit of 0 disables retry.
--cpdconfig The IBM Software Hub
 configuration location. For example, $HOME/.cpd-cli/config.
Status
Optional.
Syntax
--cpdconfig=<cpd-configuration-location>
Default value
$HOME/.cpd-cli/config
Valid values
A valid IBM® Software Hub configuration location.
--from-export The name of the export file to import.
Status
Optional.
Syntax
--from-export=<cpd-export-name>
Default value
No default.
Valid values
A valid Cloud Pak for Data export file name.
--from-schedule The name of the schedule to import from.
Status
Optional.
Syntax
--from-schedule=<import-schedule-name>
Default value
No default.
Valid values
A valid schedule name.

--help

-h

 Display command help.
Status
Optional.
Syntax
--help
Default value
No default.
Valid values
Not applicable.
--instance-name Specify the Cloud Pak for Data service instance name.
Status
Optional.
Syntax
--instance-name=<service-instance-name>
Default value
No default.
Valid values
A Cloud Pak for Data service instance name.
--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.
warn
Warning messages are written to the log.
trace
Trace messages are written to the log.

--namespace

-n

 The namespace name in which the utility should operate.
Status
Optional.
Syntax
--namespace=<namespace-name>
Valid values
A valid project (namespace) name. Use ${PROJECT_CPD_INST_OPERANDS}.
--profile The name of the profile that you created to store information about an instance of Cloud Pak for Data and your credentials for the instance.
Status
Required.
Syntax
--profile=<cpd-profile-name>
Default value
No default.
Valid values

The name of the profile that you created.
--service-type The Cloud Pak for Data service instance type.
Status
Optional.
Syntax
--service-type=<cpd-service-type>
Default value
No default.
Valid values
Any valid Cloud Pak for Data service type. For example, 'dv'. Use the 'cpd-cli service-instance list' command to find the service type.

--values

-r

 Specify values in one or more YAML files.
Status
Optional.
Syntax
--values=<yaml-file-name1,yaml-file-name2,...>
Default value
No default.
Valid values
One or more YAML file names.
--verbose Logs include more detailed messages.
Status
Optional.
Syntax
--verbose
Default value
No default.
Valid values
Not applicable.

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.

Import Cloud Pak for Data data from <cpd-export-name> in the ${PROJECT_CPD_INST_OPERANDS} namespace.
The export must be completed successfully before the import can run. Only one import job can run at a time. The completed import job must be deleted before starting a new import.
cpd-cli export-import import create <cpd-import-name> \
--from-export=<cpd-export-name> \
--namespace=${PROJECT_CPD_INST_OPERANDS} \
--arch=${CPU_ARCH} \
--profile=${CPD_PROFILE_NAME} \
--log-level=debug \
--verbose