export-import import create

Important: IBM Cloud Pak® for Data Version 4.7 will reach end of support (EOS) on 31 July, 2025. For more information, see the Discontinuance of service announcement for IBM Cloud Pak for Data Version 4.X.

Upgrade to IBM Software Hub Version 5.1 before IBM Cloud Pak for Data Version 4.7 reaches end of support. For more information, see Upgrading IBM Software Hub in the IBM Software Hub Version 5.1 documentation.

Create an IBM® Cloud Pak for Data import.

Syntax

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

Arguments

Argument Description
<cpd-import-file-name> The name of the import to create.

Table 1: Command arguments

Options

Option Description
--arch Provide the CPU architecture (hardware) of the cluster.
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 retries for an export or import job before the job is considered a failure. 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 Cloud Pak for Data
 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 Cloud Pak for Data configuration location.
--from-export The Cloud Pak for Data export file name from which to import.
Status
Optional.
Syntax
--from-export=<cpd-export-file-name>
Default value
No default.
Valid values
A valid Cloud Pak for Data export file name.
--from-schedule The schedule name from which to import.
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=<cpd-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
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.

--namespace

-n

 The namespace name in which the utility should operate.
Status
Optional.
Syntax
--namespace=<namespace-name>
Default value
${PROJECT_CPD_INST_OPERANDS}
Valid values
A valid project (namespace) name.
--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-configuration-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.

Table 2: Command options

Examples

Note: The following examples use the recommended installation environment variables.

Use a script to create environment variables with the correct values for your environment. For more information, see Best practice: Setting up install variables.

Import Cloud Pak for Data data from <cpd-export-file-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-file-name> \
--from-export=<cpd-export-file-name> \
--namespace=${PROJECT_CPD_INST_OPERANDS} \
--arch=${CPU_ARCH} \
--profile=<cpd-configuration-profile-name> \
--log-level=debug \
--verbose