Oracle Cloud Infrastructure Documentation

Disk Data Transfer Reference

This topic provides complete task details for certain components associated with Disk-Based Data Transfers. Use this topic as a reference to learn and use commands associated with components included in the Disk-Based Data Transfer 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 that Oracle is to upload your data to.

Note

It is recommended that you create a compartment for each transfer job to minimize the required access your tenancy.

Tip

You can use the Console or the Data Transfer Utility to create a transfer job.

 

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
To create a transfer job using the Data Transfer Utility

Displaying Transfer Jobs

To display the list of transfer jobs using the Console
To display the list of transfer jobs using the Data Transfer Utility

Displaying Transfer Job Details

To display the details of a transfer job using the Console
To display the details of a transfer job using the Data Transfer Utility

Editing Transfer Jobs

To edit the name of a transfer job using the Console
To edit the name of a transfer job using the Data Transfer Utility
To edit the tags associated with a transfer job using the Data Transfer Utility
To delete the tags associated with a transfer job using the Data Transfer Utility

Deleting Transfer Jobs

Typically, you would delete a transfer job early in the transfer process and before you create any transfer packages or 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 disks associated with the transfer job.

To delete a transfer job using the Console
To delete a transfer job using the Data Transfer Utility

Closing Transfer Jobs

Tip

You can use the Console or the Data Transfer Utility to close a transfer job.

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
To close a transfer job using the Data Transfer Utility

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

Tip

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. The encryption passphrase is displayed to standard output to the data transfer administrator user and cannot be retrieved again. Create a local, secure copy of the encryption passphrase, so you can reference the passphrase again.

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

Deleting Transfer Disks

 

Tip

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

Canceling Transfer Disks

Tip

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. You can cancel a disk in a transfer package, while allowing the file upload from other disks.

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

To cancel a transfer disk using the Data Transfer Utility

Locking Transfer Disks

Tip

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

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

Transfer Packages

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

Tip

You can use the Console or the Data Transfer Utility to create a transfer package.

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
To create a transfer package using the Data Transfer Utility

Displaying Transfer Package Details

To display the details of a transfer package using the Console
To display the details of a transfer package using the Data Transfer Utility

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
To edit a transfer package using the Data Transfer Utility

Deleting Transfer Packages

Typically, you would delete a transfer package early in the transfer process and before you created any transfer disks. 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 all associated transfer disks. You cannot delete a transfer package once the package has been shipped to Oracle.

To delete a transfer package using the Console
To delete a transfer package using the Data Transfer Utility

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 all transfer disks 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
To cancel a transfer package using the Data Transfer Utility

Attaching Transfer Disks to a Transfer Package

Tip

You can use the Console or the Data Transfer Utility to attach a transfer disk to a transfer package.

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

A disk can be attached to one package, detached, and then attached to another package.

To attach a transfer disk to a transfer package using the Console
To attach a transfer disk to a transfer package using the Data Transfer Utility

You have attached a transfer disk to a transfer package, but have changed your mind about shipping that disk with the transfer package. You can also detach a transfer disk from one transfer package and attach that disk to a different transfer package.

To detach a transfer disk to a transfer package using the Console
To detach a transfer disk to a transfer package using the Data Transfer Utility