Disk Import Reference

This topic provides complete task details for certain components associated with Disk-Based Data Imports. Use this topic as a reference to learn and use commands associated with components included in the Disk-Based Data Import procedure.

Transfer Jobs

A transfer job represents the collection of files that you want to transfer and signals the intention to upload those files to Oracle Cloud Infrastructure. A transfer job combines at least one transfer disk with a transfer package. Identify which compartment and Object Storage bucket to which Oracle will upload your data.

Tip

Create a compartment for each transfer job to minimize the required access your tenancy.

Creating Transfer Jobs

Create the transfer job in the same compartment as the upload bucket and supply a human-readable name for the transfer job. Avoid entering confidential information when providing transfer job names.

Creating a transfer job returns a job ID that you specify in other transfer tasks. For example:

ocid1.datatransferjob.region1.phx..<unique_ID>
To create a transfer job using the Console
  1. Open the navigation menu. Under Core Infrastructure, go to Object Storage and click Data Transfer - Imports.
  2. Select the designated compartment you are to use for data transfers from the list.

    A list of transfer jobs that have already been created is displayed.

  3. Click Create Transfer Job.

    The Create Transfer Job dialog appears.

  4. Enter a Job Name, and select the Upload Bucket from the list.

    Avoid entering confidential information in the transfer job name.

  5. Select Disk for the Transfer Device Type.
  6. Click Create Transfer Job.
To create a transfer job using the Data Transfer Utility
dts job create --bucket <bucket> --compartment-id <compartment_id> --display-name <display_name>
<display_name> is the name of the transfer job.

For example:

oci dts job create --bucket MyBucket1 --compartment-id ocid.compartment.oc1..exampleuniqueID --display-name MyDiskImportJob

Transfer Job : 
ID                : ocid1.datatransferjob.oc1..exampleuniqueID
CompartmentId     : ocid.compartment.oc1..exampleuniqueID
UploadBucket      : MyBucket1
Name              : MyDiskImportJob
Label             : JZM9PAVWH
CreationDate      : 2019/06/04 17:07:05 EDT
Status            : PREPARING
freeformTags      : *** none ***
definedTags       : *** none ***
Packages          : 
  [1] : 
    Label                        : PBNZOX9RU
    TransferSiteShippingAddress  : Oracle Data Transfer Service;  Job:JZM9PAVWH Package:PBNZOX9RU ; 21111 Ridgetop Circle; Dock B; Sterling, VA 20166; USA
    DeliveryVendor               : FedEx
    DeliveryTrackingNumber       : *** none ***
    ReturnDeliveryTrackingNumber : *** none ***
    Status                       : PREPARING
    Devices                      : [*** none ***]
    UnattachedDevices : [*** none ***]
    Appliances        : [*** none ***]When you use the  to display the details of a job, tagging details are also included in the output if you specified tags.

Optionally, you can specify one or more defined or free-form tags when you create a transfer job. For more information about tagging, see Resource Tags.

Defined Tags

To specify defined tags when creating a job:

dts job create --bucket <bucket> --compartment-id <compartment_id> --display-name <display_name> --defined-tags '{ "<tag_namespace>": { "<tag_key>":"<value>" }}'

For example:

oci dts job create --bucket MyBucket1 --compartment-id ocid.compartment.oc1..exampleuniqueID --display-name MyDiskImportJob --defined-tags '{"Operations": {"CostCenter": "01"}}'

Transfer Job : 
ID                : ocid1.datatransferjob.oc1..exampleuniqueID
CompartmentId     : ocid.compartment.oc1..exampleuniqueID
UploadBucket      : MyBucket1
Name              : MyDiskImportJob
Label             : JZM9PAVWH
CreationDate      : 2019/06/04 17:07:05 EDT
Status            : PREPARING
freeformTags      : *** none ***
definedTags       : 
  Operations : 
    CostCenter : 01  
Packages          : 
  [1] : 
    Label                        : PBNZOX9RU
    TransferSiteShippingAddress  : Oracle Data Transfer Service;  Job:JZM9PAVWH Package:PBNZOX9RU ; 21111 Ridgetop Circle; Dock B; Sterling, VA 20166; USA
    DeliveryVendor               : FedEx
    DeliveryTrackingNumber       : *** none ***
    ReturnDeliveryTrackingNumber : *** none ***
    Status                       : PREPARING
    Devices                      : [*** none ***]
    UnattachedDevices : [*** none ***]
    Appliances        : [*** none ***]When you use the  to display the details of a job, tagging details are also included in the output if you specified tags.
		
Note

Users create tag namespaces and tag keys with the required permissions. These items must exist before you can specify them when creating a job. See Working with Defined Tags for details.
Freeform Tags

To specify freeform tags when creating a job:

dts job create --bucket <bucket> --compartment-id <compartment_id> --display-name <display_name> --freeform-tags '{ "<tag_key>":"<value>" }'

For example:

oci dts job create --bucket MyBucket1 --compartment-id ocid.compartment.oc1..exampleuniqueID --display-name MyDiskImportJob --defined-tags '{"Operations": {"CostCenter": "01"}}'

Transfer Job : 
ID                : ocid1.datatransferjob.oc1..exampleuniqueID
CompartmentId     : ocid.compartment.oc1..exampleuniqueID
UploadBucket      : MyBucket1
Name              : MyDiskImportJob
Label             : JZM9PAVWH
CreationDate      : 2019/06/04 17:07:05 EDT
Status            : PREPARING
freeformTags      : 
  Pittsburg_Team : brochures
definedTags       : *** none ***
Packages          : 
  [1] : 
    Label                        : PBNZOX9RU
    TransferSiteShippingAddress  : Oracle Data Transfer Service;  Job:JZM9PAVWH Package:PBNZOX9RU ; 21111 Ridgetop Circle; Dock B; Sterling, VA 20166; USA
    DeliveryVendor               : FedEx
    DeliveryTrackingNumber       : *** none ***
    ReturnDeliveryTrackingNumber : *** none ***
    Status                       : PREPARING
    Devices                      : [*** none ***]
    UnattachedDevices : [*** none ***]
    Appliances        : [*** none ***]When you use the  to display the details of a job, tagging details are also included in the output if you specified tags.
		
Multiple Tags

To specify multiple tags, comma separate the JSON-formatted key/value pairs:

dts job create --bucket <bucket> --compartment-id <compartment_id> --display-name <display_name> --device-type disk --freeform-tags '{ "<tag_key>":"<value>" }', '{ "<tag_key>":"<value>" }'

Listing Transfer Jobs

To display the list of transfer jobs using the Console

Open the navigation menu. Under Core Infrastructure, go to Object Storage and click Data Transfer - Imports.

To display the list of transfer jobs using the Data Transfer Utility
dts job list --compartment-id <compartment_id>

For example:


dts job list --compartment-id ocid.compartment.oc1..exampleuniqueID
					
Transfer Job List : 
  [1] : 
    ID           : ocid1.datatransferjob.oc1..exampleuniqueID
    Name         : MyDiskImportJob
    Label        : JVWK5YWPU
    BucketName   : MyBucket1
    CreationDate : 2020/06/01 17:33:16 EDT
    Status       : INITIATED
    FreeformTags : *** none ***
    DefinedTags  : 
      Financials : 
        key1 : nondefault

When you use the Data Transfer Utility to list jobs, tagging details are also included in the output if you specified tags.

Displaying Transfer Job Details

To display the details of a transfer job using the Console
  1. Open the navigation menu. Under Core Infrastructure, go to Object Storage and click Data Transfer - Imports.
  2. Find the transfer job for which you want to display the details.
  3. Click the Actions icon (Actions icon), and then click View Details.
To display the details of a transfer job using the Data Transfer Utility
dts job show --job-id <job_id>

For example:

dts job show --job-id ocid1.datatransferjob.oc1..exampleuniqueID
					
Transfer Job : 
ID                : ocid1.datatransferjob.oc1..exampleuniqueID
CompartmentId     : ocid.compartment.oc1..exampleuniqueID
UploadBucket      : MyBucket1
Name              : MyDiskImportJob
Label             : JZM9PAVWH
CreationDate      : 2019/06/04 17:07:05 EDT
Status            : PREPARING
freeformTags      : *** none ***
definedTags       : *** none ***
Packages          : 
  [1] : 
    Label                        : PBNZOX9RU
    TransferSiteShippingAddress  : Oracle Data Transfer Service;  Job:JZM9PAVWH Package:PBNZOX9RU ; 21111 Ridgetop Circle; Dock B; Sterling, VA 20166; USA
    DeliveryVendor               : FedEx
    DeliveryTrackingNumber       : *** none ***
    ReturnDeliveryTrackingNumber : *** none ***
    Status                       : PREPARING
    Devices                      : [*** none ***]
    UnattachedDevices : [*** none ***]
    Appliances        : [*** none ***]

When you use the Data Transfer Utility to display the details of a job, tagging details are also included in the output if you specified tags.

Editing Transfer Jobs

To edit the name of a transfer job using the Console
Note

You can only change the name of a transfer job using the Console. If you want to change other attributes of the transfer job, use the Data Transfer Utility instead.
  1. Open the navigation menu. Under Core Infrastructure, go to Object Storage and click Data Transfer - Imports.
  2. Find the data transfer job that you want to edit.
  3. Click the Actions icon (Actions icon), and then click Edit.
  4. Edit the name of the transfer job.

    Avoid entering confidential information in the transfer job name.

  5. Click Save.
To edit the name of a transfer job using the Data Transfer Utility
dts job update --job-id <job_id> --display-name <display_name>

<display_name> is the new name of the transfer job. Avoid entering confidential information in the transfer job name.

For example:


dts job update --job-id ocid1.datatransferjob.oc1.phx.aaaaaaaa4tccxsktptbexdy6ipmfqome5acvieqthlqvts6lltqv5qxo2fiq --display-name MyRenamedJob

Transfer Job : 
  ID                : ocid1.datatransferjob.oc1..exampleuniqueID
  CompartmentId     : ocid.compartment.oc1..exampleuniqueID
  UploadBucket      : MyBucket1
  Name              : MyRenamedJob
  Label             : JZM9PAVWH
  CreationDate      : 2019/06/04 17:07:05 EDT
  Status            : PREPARING
  freeformTags      : *** none ***
  definedTags       : *** none ***
  Packages          : [*** none ***]
  UnattachedDevices : [*** none ***]
  Appliances        : [*** none ***]
To edit the tags associated with a transfer job using the Data Transfer Utility

The Data Transfer Utility replaces any existing tags with the new key/value pairs you specify.

To edit defined tags, provide the replacement key value pairs:

dts job update --job-id <job_id> --defined-tags '{ "<tag_namespace>": { "<tag_key>":"<value>" }}'

For example:


dts job update --job-id ocid1.datatransferjob.oc1..exampleuniqueID --defined-tags '{"Operations": {"CostCenter": "42"}}'
					
Transfer Job : 
  ID                : ocid1.datatransferjob.oc1..exampleuniqueID
  CompartmentId     : ocid.compartment.oc1..exampleuniqueID
  UploadBucket      : MyBucket1
  Name              : MyDiskImportJob
  Label             : JZM9PAVWH
  CreationDate      : 2019/06/04 17:07:05 EDT
  Status            : PREPARING
  freeformTags      : *** none ***
  definedTags       : 
    operations : 
      costcenter : 42
  Packages          : [*** none ***]
  UnattachedDevices : [*** none ***]
  Appliances        : [*** none ***]

To edit free-form tags, provide the replacement key/value pairs:

dts job update --job-id <job_id> --freeform-tags '{ "<tag_key>":"<value>" }'

For example:


dts job update --job-id ocid1.datatransferjob.oc1..exampleuniqueID --freeform-tags '{"Chicago_Team":"marketing_videos"}'
					
Transfer Job : 
  ID                : ocid1.datatransferjob.oc1..exampleuniqueID
  CompartmentId     : ocid.compartment.oc1..exampleuniqueID
  UploadBucket      : MyBucket1
  Name              : MyDiskImportJob
  Label             : JZM9PAVWH
  CreationDate      : 2019/06/04 17:07:05 EDT
  Status            : PREPARING					
  freeform-tags     :
    Chicago_Team : marketing_videos
  definedTags       : *** none ***
  Packages          : [*** none ***]
  UnattachedDevices : [*** none ***]
  Appliances        : [*** none ***]
To delete the tags associated with a transfer job using the Data Transfer Utility

The Data Transfer Utility replaces any existing tags with the new key/value pairs you specify. If you want to delete some of the tags, you would specify new tag string that does not contain the key/value pair you want to delete.

Partial tag deletion is handled in the same way as you edit tags:

  • To edit free-form tags, provide the replacement key/value pairs:
dts job update --job-id <job_id> --freeform-tags '{ "<tag_key>":"<value>" }'
  • To edit defined tags, provide the replacement key value pairs:
dts job update --job-id <job_id> --defined-tags '{ "<tag_namespace>": { "<tag_key>":"<value>" }}'

To delete all free-form tags:

dts job update --job-id <job_id> --freeform-tags '{}'

To delete all defined tags:

dts job update --job-id <job_id> --defined-tags '{}'

Moving Transfer Jobs Between Compartments

Note

You can only use the Console to move disk-based data transfer jobs between compartments.
To move a data transfer job to a different compartment using the Console
  1. Open the navigation menu. Under Core Infrastructure, go to Object Storage and click Data Transfer - Imports.
  2. Select the Compartment from the list.

    The transfer jobs in that compartment are displayed.

  3. Click the link under Transfer Jobs for the transfer job that you want to move.

    The Details page for that transfer job appears.

    Alternatively, you can click the Actions icon (Actions icon), and then click Move Resource.

  4. Click Move Resource in the Details page.

    The Move Resource to a Different Compartment dialog appears.

  5. Choose the compartment you want to which you want to move the transfer job from the list.
  6. Click Move Resource.

You are returned to the Details page for that transfer job.

To move a data transfer job to a different compartment using the Data Transfer Utility
dts job move --job-id <job_id> compartment-id <compartment_id> <options>

<compartment_id> is the compartment to which the data transfer job is being moved.

<options> are:

  • --if-match: The tag that must be matched for the task to occur for that entity. If set, the update is only successful if the object's tag matches the tag specified in the request.
  • --from-json: Provide input to this command as a JSON document from a file using the file://path-to/file syntax. The --generate-full-command-json-input option can be used to generate a sample JSON file to be used with this command option. The key names are pre-populated and match the command option names (converted to camelCase format, e.g. compartment-id --> compartmentId), while the values of the keys need to be populated by the user before using the sample file as an input to this command. For any command option that accepts multiple values, the value of the key can be a JSON array. Options can still be provided on the command line. If an option exists in both the JSON document and the command line then the command line specified value will be used. For examples on usage of this option, please see our "using CLI with advanced JSON options" link: https://docs.cloud.oracle.com/iaas/Content/API/SDKDocs/cliusing.htm#AdvancedJSONOptions.

To confirm the transfer, display the list of transfer jobs in the new compartment. See Listing Transfer Jobs for more information.

Verifying Upload User Credentials

Note

You can only use the CLI command to verify upload user credentials.

You can verify the current upload user credentials to see if there are any problems or updates required. If any configuration file is incorrect or invalid, the upload fails.

To verify the upload user credentials of a transfer job using the CLI
dts job verify-upload-user-credentials --bucket <bucket>

<bucket> is the upload bucket for the transfer job.

For example:

dts job verify-upload-user-credentials --bucket MyBucket1
					
created object BulkDataTransferTestObject in bucket MyBucket1
overwrote object BulkDataTransferTestObject in bucket MyBucket1
inspected object BulkDataTransferTestObject in bucket MyBucket1
read object BulkDataTransferTestObject in bucket MyBucket1

Depending on your user configuration, you may get an error message returned similar to the following:

ERROR : key_file /root/.oci/oci_api_key.pem is not a valid file

If a user credential issue is identified, fix it and rerun the verify-upload-user-credentials CLI to ensure that all problems are addressed. Then you can proceed with transfer job activities.

Deleting Transfer Jobs

Typically, you would delete a transfer job early in the transfer process and before you create any transfer packages or their associated disks. For example, you initiated the data transfer by creating a transfer job, but changed your mind. If you want to delete a transfer job later in the transfer process, you must first delete all transfer packages and their associated disks from the transfer job.

To delete a transfer job using the Console
  1. Open the navigation menu. Under Core Infrastructure, go to Object Storage and click Data Transfer - Imports.
  2. Find the data transfer job that you want to delete.
  3. Click the Actions icon (Actions icon), and then click Delete.

    Alternatively, you can delete a transfer job from the View Details page.

  4. Confirm the deletion when prompted.
To delete a transfer job using the Data Transfer Utility
dts job delete --job-id <job_id>

For example:

dts job delete --job-id ocid1.datatransferjob.oc1..exampleuniqueID

Confirm the deletion when prompted. The transfer job is deleted with no further action or return. To confirm the deletion, display the list of transfer jobs in the compartment. See Listing Transfer Jobs for more information.

Closing Transfer Jobs

Typically, you would close a transfer job when no further transfer job activity is required or possible. Closing a transfer job requires that the status of all associated transfer packages be returned, canceled, or deleted. In addition, the status of all associated transfer disks must be complete, in error, missing, canceled, or deleted.

To close a transfer job using the Console
  1. Open the navigation menu. Under Core Infrastructure, go to Object Storage and click Data Transfer - Imports.
  2. Find the data transfer package for which you want to display the details.
  3. Click the Actions icon (Actions icon), and then click View Details.

    Alternatively, click the hyperlinked name of the transfer job.

  4. Click Close Transfer Job.
To close a transfer job using the Data Transfer Utility
dts job close --job-id <job_id>

For example:


dts job close --job-id ocid1.datatransferjob.oc1..exampleuniqueID

Transfer Job : 
  ID                : ocid1.datatransferjob.oc1..exampleuniqueID
  CompartmentId     : ocid.compartment.oc1..exampleuniqueID
  UploadBucket      : MyBucket1
  Name              : MyDiskImportJob
  Label             : JZM9PAVWH
  CreationDate      : 2019/06/04 17:07:05 EDT
  Status            : CLOSED
  freeformTags      : *** none ***
  definedTags       : *** none ***
  Packages          : [*** none ***]
  UnattachedDevices : [*** none ***]
  Appliances        : [*** none ***]

Transfer Disks

The section describes the creation and management transfer disks.

Important

Before creating a transfer disk from an attached disk, remove all partitions and any file systems. To prevent the accidental deletion of data, the Data Transfer Utility does not work with disks that already have partitions or file systems. Disks are visible to the Data Host as block devices and must provide a valid response to the hdparm -I <device> Linux command.

Creating Transfer Disks

Note

You can only use the Data Transfer Utility to create a transfer disk.

When you create a transfer disk, the Data Transfer Utility:

  • Sets up the disk for encryption using the passphrase
  • Creates a file system on the disk
  • Mounts the file system at /mnt/orcdts_<label>

For example:

 /mnt/orcdts_DJZNWK3ET

When you register a transfer disk, Oracle Cloud Infrastructure generates a strong encryption passphrase that is used to encrypt the transfer disk. This passphrase is displayed in the return when you run the command. Create a local, secure copy of the encryption passphrase so you can reference the passphrase again. You cannot retrieve the passphrase after it is shown here. This passphrase is used to encrypt this disk and normally will not be needed again. However, if the system is restarted before all files are copied to the filesystem and the disk is then finalized through this CLI, you will need to provide the passphrase.

Creating a transfer disk requires the job ID returned from when you created the transfer job and the path to the attached disk (for example /dev/sdb).

To create a transfer disk using the Data Transfer Utility
dts disk create --job-id <job_id> --block-device <block_device>

When the run the disk create command, the CLI displays information regarding the creation of the disk, and prompts you to continue in several places. When the disk is created the following disk information is displayed:

dts disk create --job-id ocid1.datatransferjob.oci1..exampleuniqueID --block-device /dev/sdb
...				
Transfer Disk : 
  Label:               : DNKZQ1XKC
  SerialNumber:        : VB6fc3b4a1-5d90f001
  Status               : PREPARING
  EncryptionPassphrase : passphrase
Important

Record the passphrase in a secure, local location.

Displaying Transfer Disk Details

Note

You can only use the Data Transfer Utility to display details for a specified transfer disk.
To display the details of a disk using the Data Transfer Utility
dts disk show --job-id <job_id> --disk-label <disk_label>

For example:

dts disk show --job-id ocid1.datatransferjob.oci1..exampleuniqueID --disk-label DNKZQ1XKC

Transfer Disk : 
  Label:               : DNKZQ1XKC
  SerialNumber:        : VB6fc3b4a1-5d90f001
  UploadStatusLogUrl   : JVPWPQV6U/DNKZQ1XKC/upload_summary.txt
  Status               : PREPARING

The path syntax for the upload status log URL is <transfer_job_label>/<disk_lable>/upload_summary.txt.

Deleting Transfer Disks

Note

You can only use the Data Transfer Utility to delete a transfer disk.

Typically, you would delete a transfer disk during the disk preparation process. You created, attached, and copied data to the transfer disk, but have changed your mind about shipping the disk. If you want to reuse the disk, remove all file systems and create the disk again.

To delete a transfer disk using the Data Transfer Utility
dts disk delete --job-id <job_id> --disk-label <disk_label>

For example:

dts disk delete --job-id ocid1.datatransferjob.oci1..exampleuniqueID --disk-label DNKZQ1XKC

Deleted Disk: DNKZQ1XKC					

Canceling Transfer Disks

Note

You can only use the Data Transfer Utility to cancel a transfer disk.

If you shipped a disk to Oracle, but have changed your mind about uploading the files, you can cancel the transfer disk.

Oracle cannot process canceled transfer disks. Oracle returns canceled transfer disks to the sender.

To cancel a transfer disk using the Data Transfer Utility
dts disk cancel --job-id <job_id> --disk-label <disk_label>

For example:

dts disk cancel --job-id ocid1.datatransferjob.oci1..exampleuniqueID --disk-label DNKZQ1XKC
					
Canceled Disk: DNKZQ1XKC

Locking Transfer Disks

Note

You can only use the Data Transfer Utility to lock a transfer disk.

Locking a transfer disk safely unmounts the disk and removes the encryption passphrase from the Data Host.

To lock a transfer disk using the Data Transfer Utility
dts disk lock --job-id <job_id> --disk-label <disk_label> --block-device <block_device>

For example:


dts disk lock --job-id ocid1.datatransferjob.oci1..exampleuniqueID --disk-label DNKZQ1XKC --block-device /dev/sdb
 
Copying upload user credentials.
created object BulkDataTransferTestObject in bucket MyBucket1
overwrote object BulkDataTransferTestObject in MyBucket1
inspected object BulkDataTransferTestObject in bucket MyBucket1
read object BulkDataTransferTestObject in bucket MyBucket1
Scanning filesystem to validate manifest. If special files are encountered, they will be listed below.
validated manifest
/dev/sdb DNKZQ1XKC is encrypted and locked
Locked disk.

Unlocking Transfer Disks

If you need to unlock the transfer disk, you are prompted for the encryption passphrase that was generated when you created the transfer disk.

To unlock a transfer disk using the Data Transfer Utility
dts disk unlock --job-id <job_id> --disk-label <disk_label> --block-device <block_device> --encryption-passphrase <encryption_passphrase>

For example:

dts disk unlock --job-id ocid1.datatransferjob.oci1..exampleuniqueID --disk-label DNKZQ1XKC --block-device /dev/sdb --encryption-passphrase passphrase					

Encryption passphrase ('q' to quit):
enabled cleartext read/write on device
Unlocked and mounted disk.

Attaching Transfer Disks to Transfer Packages

Attach a transfer disk to a transfer package after you have done the following tasks in order:

  • Copied your data onto the disk
  • Generated the required manifest file
  • Run and reviewed the dry-run report
  • Locked the transfer disk in preparation for shipment
Note

You can only attach a single disk to each transfer package.
To attach a transfer disk to a transfer package using the Console
  1. Open the navigation menu. Under Core Infrastructure, go to Object Storage and click Data Transfer - Imports.
  2. Find the transfer job associated with the transfer package having the disk attached.
  3. Click the Actions icon (Actions icon), and then click View Details.

    A list of transfer packages is displayed.

  4. Find the transfer package that you want to attach a disk to.
  5. Click the Actions icon (Actions icon), and then click View Details.

    Alternatively, click the hyperlinked name of the transfer package.

    The transfer disk is displayed.

  6. Click Attach Transfer Disks.

    The Attach Transfer Disks dialog appears.

  7. Select the Transfer Disks that you want to attach to the transfer package.
  8. Click Attach.
To attach a transfer disk to a transfer package using the Data Transfer Utility
dts disk attach --job-id <job_id> --package-label <package_label> --disk-label <disk_label>

For example:

dts attach  --job-id ocid1.datatransferjob.oci1..exampleuniqueID --package-label PWA8O67MI --disk-label DNKZQ1XKC
					
Attached disk: DNKZQ1XKC to package: PWA8O67MI

See Transfer Packages for more information, including how to obtain the package label.

Detaching Transfer Disks from Transfer Packages

To detach a transfer disk to a transfer package using the Console
  1. Open the navigation menu. Under Core Infrastructure, go to Object Storage and click Data Transfer - Imports.
  2. Find the transfer package for which you want to detach a transfer disk.
  3. Click the Actions icon (Actions icon), and then click View Details.

    Alternatively, click the hyperlinked name of the transfer package.

    The attached transfer disk is displayed.

  4. Click the Actions icon (Actions icon), and then click View Details.

    Alternatively, click the hyperlinked name of the transfer disk.

  5. Click Detach Transfer Disk.
To detach a transfer disk to a transfer package using the Data Transfer Utility
dts disk detach --job-id <job_id> --package-label <package_label> --disk-label <disk_label>

For example:

dts detach --job-id ocid1.datatransferjob.oci1..exampleuniqueID --package-label PWA8O67MI --disk-label DNKZQ1XKC

Detached disk: DNKZQ1XKC from package: PWA8O67MI

Querying Transfer Disks

You can query the transfer disk for information regarding the physical transfer disk such as the loops, sizes, and mountpoints.

Note

You can only use the Data Transfer Utility to query the transfer disk.
To query the transfer disk using the Data Transfer Utility
dts disk query
			
NAME   TYPE   SIZE UUID                                 LABEL          MOUNTPOINT
loop0  loop 140.7M                                                     /snap/gnome-3-26-1604/92
loop1  loop   4.2M                                                     /snap/gnome-calculator/501
sda    disk  40.8G                                                     
└─sda1 part    12G xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx                 /
sr0    rom   56.9M 2020-02-18-17-20-05-35               VBox_GAs_6.1.4 /media/user/VBox_GAs_6.1.4

Transfer Packages

A transfer package is the virtual representation of the physical disk package that you are shipping to Oracle for upload to Oracle Cloud Infrastructure.

Creating Transfer Packages

Creating a transfer package requires the job ID returned from when you created the transfer job. For example:

ocid1.datatransferjob.region1.phx..exampleuniqueID
To create a transfer package using the Console
  1. Open the navigation menu. Under Core Infrastructure, go to Object Storage and click Data Transfer - Imports.
  2. Find the transfer job for which you want to create a transfer package.
  3. Click the Actions icon (Actions icon), and then click View Details.

    Alternatively, click the hyperlinked name of the transfer job.

    A list of transfer packages that have already been created is displayed.

  4. Click Create Transfer Package.

    The Create Transfer Package dialog appears.

  5. Select a Vendor from the list.
  6. Click Create Transfer Package.

The Data Transfer Package dialog appears displaying information such as the shipping address, the shipping vendor, and the shipping status.

To create a transfer package using the Data Transfer Utility
dts package create --job-id <job_id>

For example:

dts package create --job-id ocid1.datatransferjob.oci1..exampleuniqueID
									
Transfer Package : 
  Label                        : PWA8O67MI
  TransferSiteShippingAddress  : Oracle Data Transfer Service;  Job:JZM9PAVWH Package:PWA8O67MI ; 21111 Ridgetop Circle; Dock B; Sterling, VA 20166; USA
  DeliveryVendor               : *** none ***
  DeliveryTrackingNumber       : *** none ***
  ReturnDeliveryTrackingNumber : *** none ***
  Status                       : PREPARING
  Devices                      : [*** none ***]

Displaying Transfer Package Details

To display the details of a transfer package using the Console
  1. Open the navigation menu. Under Core Infrastructure, go to Object Storage and click Data Transfer - Imports.
  2. Find the transfer job for which you want to see the details.
  3. Click the Actions icon (Actions icon), and then click View Details.

    Alternatively, click the hyperlinked name of the transfer job.

    A list of transfer packages that have already been created is displayed.

To display the details of a transfer package using the Data Transfer Utility
dts package show --job-id <job_id> --package-label <package_label>

For example:

dts package show --job-id ocid1.datatransferjob.oci1..exampleuniqueID --package-label PWA8O67MI
									
Transfer Package : 
  Label                        : PWA8O67MI
  TransferSiteShippingAddress  : Oracle Data Transfer Service;  Job:JZM9PAVWH Package:PWA8O67MI ; 21111 Ridgetop Circle; Dock B; Sterling, VA 20166; USA
  DeliveryVendor               : *** none ***
  DeliveryTrackingNumber       : *** none ***
  ReturnDeliveryTrackingNumber : *** none ***
  Status                       : PREPARING
  Devices                      : [*** none ***]

Editing Transfer Packages

Edit the transfer package and supply the tracking information when you ship the package.

To edit a transfer package using the Console
  1. Open the navigation menu. Under Core Infrastructure, go to Object Storage and click Data Transfer - Imports.
  2. Find the transfer job for which you want to see the associated transfer packages.
  3. Click the Actions icon (Actions icon), and then click View Details.
  4. Find the transfer package that you want to edit.
  5. Click the Actions icon (Actions icon), and then click View Details.
  6. Click Edit.

    Change the vendor and supply the tracking information as needed.

  7. Click Edit Transfer Package.

Deleting Transfer Packages

Typically, you would delete a transfer package early in the transfer process and before you create its associated transfer disk. You initiated the transfer job and package, but have changed your mind. If you delete a transfer package later in the transfer process, you must first detach the associated transfer disk. You cannot delete a transfer package once the package has been shipped to Oracle.

To delete a transfer package using the Console
  1. Open the navigation menu. Under Core Infrastructure, go to Object Storage and click Data Transfer - Imports.
  2. Find the transfer job for which you want to see the associated transfer packages.
  3. Click the Actions icon (Actions icon), and then click View Details.
  4. Find the transfer package that you want to edit.
  5. Click the Actions icon (Actions icon), and then click View Details.
  6. Click Edit.

    Change the vendor and supply the tracking information as needed.

  7. Click Edit Transfer Package.
To delete a transfer package using the Data Transfer Utility
dts package delete --job-id <job_id> --package-label <package_label>

For example:

dts package delete --job-id ocid1.datatransferjob.oci1..exampleuniqueID --package-label PWA8O67MI
					
Deleted package with label: PWA8O67MI

Canceling Transfer Packages

If you shipped a transfer package, but have changed your mind about uploading the data, you can cancel a transfer package. Before canceling a transfer package, you must first cancel the transfer disk associated with that transfer package. Oracle cannot process canceled transfer packages. Oracle returns canceled transfer packages to the sender.

To cancel a transfer package using the Console
  1. Open the navigation menu. Under Core Infrastructure, go to Object Storage and click Data Transfer - Imports.
  2. Find the transfer job for which you want to see associated transfer packages.
  3. Click the Actions icon (Actions icon), and then click View Details.
  4. Find the transfer package that you want to cancel.
  5. Click the Actions icon (Actions icon), and then click View Details.
  6. Click Cancel Transfer Package.
To cancel a transfer package using the Data Transfer Utility
dts package cancel --job-id <job_id> --package-label <package_label>

For example:

dts package cancel --job-id ocid1.datatransferjob.oci1..exampleuniqueID --package-label PWA8O67MI

Canceled package with label: PWA8O67MI