Oracle Cloud Infrastructure Documentation

Monitoring the Appliance Return

Monitor phase indicator for appliance transfer

This topic describes the tasks to be done after the data transfer is complete the transfer appliance has been returned to Oracle. The Project Sponsor role typically performs these tasks. See Roles and Responsibilities.

Note

You can only run Oracle Cloud Infrastructure CLI commands from a Linux host. This differs from running CLI commands for other Oracle Cloud Infrastructure Services on a variety of host operating systems. Appliance-based commands require validation that is only available on Linux hosts.

Monitoring the Status of Your Transfer Appliance Return Shipment

The shipping vendor notifies Oracle when your transfer appliance is picked up and shipped back for upload to Oracle Cloud Infrastructure Object Storage.

To monitor the status of your transfer appliance return shipment using the Console
To monitor the status of your transfer appliance using the CLI

Transfer Appliance Status Values

Here are the transfer appliance status values, listed in alphabetic order:

canceled
You can change your mind about uploading your data to Oracle Cloud Infrastructure Object Storage and cancel your transfer appliance. Ship the appliance back to Oracle and then cancel the appliance. Oracle always uses secure wipe tools on the boot and data areas whenever a transfer appliance is returned.
complete
Oracle completed your transfer appliance data upload. Your data is available in your designated bucket in Oracle Cloud Infrastructure Object Storage.
customer lost
You have not returned a data transfer appliance within the required 90 days.
delivered
Oracle received a delivery confirmation from the shipping vendor that your transfer appliance was delivered. When the appliance is delivered, Oracle provides the date and time the appliance was received in the transfer appliance details. Appliance usage tracking begins.
error
Oracle encountered an unrecoverable error trying to process your transfer appliance. Oracle cannot upload your data from the appliance. To protect your data, Oracle uses secure wipe tools on the boot and data areas any transfer appliance that cannot be processed.
Complete another request for a transfer appliance.
Oracle preparing
Oracle approved your transfer appliance request. The status displays preparing until the transfer appliance is shipped to you.
Oracle received
Oracle received your transfer appliance shipment. The status displays Oracle received until Oracle begins processing and uploading your transfer appliance.
Oracle received canceled
You canceled your transfer appliance after you shipped the appliance back to Oracle. Oracle received your canceled transfer appliance. Oracle does not upload the appliance data.
preparing
You activated your transfer appliance. You can now copy your data onto the transfer appliance. The status displays preparing until you ship the transfer appliance back to Oracle.
processing
Oracle is processing and uploading the data from your transfer appliance. The status displays the processing status until Oracle completes uploading your data from your transfer appliance.
rejected
Oracle denied your transfer appliance request.
Important

If your appliance request is denied and you have questions, contact your Sales Representative or file a Service Request (SR).
requested
You successfully completed your request for a transfer appliance. The status displays requested until Oracle approves your transfer appliance request.
return shipped
Oracle received confirmation from the shipping vendor that you shipped your transfer appliance back to Oracle. The status displays return shipped until Oracle receives your transfer appliance.
return shipped canceled
You canceled your transfer appliance after the appliance was delivered to you or after you shipped the appliance back to Oracle. Oracle received confirmation from the shipping vendor that your canceled transfer appliance is on the way back to Oracle. The status displays return shipped canceled until Oracle receives your transfer appliance.
shipping
Oracle completed the necessary preparations and shipped your transfer appliance. When the appliance is shipped, Oracle provides the serial number of the appliance, the shipping vendor, and the tracking number in the appliance details. The status displays shipping until the appliance is delivered to you.

Reviewing the Upload Summary

Oracle creates upload summary log files for each uploaded appliance. These log files are placed in the bucket where data was uploaded to Oracle Cloud Infrastructure. The upload summary file compares the appliance's manifest file to the contents of the target Oracle Cloud Infrastructure Object Storage bucket after file upload.

Note

If you chose to upload your data to an Archive Storage bucket, you must first restore the log file object before you can download that file for review.

The top of the log report summarizes the overall file processing status:

P - Present: The file is present in both the device and the target bucket
M - Missing: The file is present in the device but not the target bucket. It was likely uploaded and then deleted by another user before the summary was generated.
C - Name Collision: The file is present in the manifest but a file with the same name but different contents is present in the target bucket.
U - Unreadable: The file is not readable from the disk
N - Name Too Long: The file name on disk is too long and could not be uploaded

Complete file upload details follow the summary.

This screenshot shows an example of the data transfer log file.

If you upload more than 100,000 files, the upload details are broken into multiple pages. You can only download the first page from the Console. Download the rest of the pages directly from the Object Storage bucket. The subsequent pages have the same object name as the first page, but have an enumerated suffix.

Closing a Transfer Job

Tip

You can use the Console or the Oracle Cloud Infrastructure CLI 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 appliances be returned, canceled, or deleted.

To close a transfer job using the Console
To close a transfer job using the CLI

What's Next

You have completed the process of setting up, running, and monitoring the Appliance-Based Data Transfer. If you determine that another appliance-based data transfers is required, repeat the procedure from the beginning.