Shipping the Import Appliance

Learn about the procedure for shipping the transfer appliance to Oracle after the data transfer has occurred.

Ship phase indicator for appliance transfer

This topic describes the tasks associated with shipping the import appliance containing the copied data to Oracle. The Infrastructure Engineer 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.

Shutting Down the Import Appliance

Shut down the import appliance before packing up and shipping the appliance back to Oracle.

Using the terminal emulator on the host machine, select Shutdown from the appliance serial console.

Important

The shutdown does not power off the appliance. Wait 10 minutes after issuing the shutdown, then turn the power switch off and disconnect the power cable.

Downloading the Shipping Label

You can request a shipping label for returning the appliance to Oracle and subsequently print it when needed. Use this feature when you cannot use the shipping label that came with the appliance because it is lost or no longer usable.

Note

The actual pickup window times in the generated return label can differ from the times you enter. Oracle uses the same address that the appliance was shipped to for the pickup as well.

Using the Console

Open the navigation menu and click Migration & Disaster Recovery. Under Data Transfer, click Imports. The Transfer Jobs page appears.
Select the Compartment from the list. The transfer jobs in that compartment are displayed in tabular form.
Find the transfer job whose associated import appliance you want to download a return shipping label. The list of appliances is displayed below the transfer job details.
Find the import appliance for which you want to download a shipping label.
Click the Actions menu (), and then click View Details. The Transfer Appliance Details page appears.
Click Request Return Shipping Label. The Request Return Shipping Label dialog box appears.
Use the Calendar tool to enter dates and times for the following fields:
- Pickup Window Start Time: Enter the beginning of the window of time when the selected carrier can pick up the appliance from the customer site. The pickup window start time you enter must to be at least 48 hours after requesting the label.
- Pickup Window End Time: Enter the end of the window of time when the selected carrier can pick up the appliance from the customer site.
Click Request. The Request Return Shipping Label dialog box closes and the Transfer Appliance Details page reappears with the Details field displaying Return Shipping Label Requested.

Oracle processes the return shipping label request with the selected carrier. When the return shipping label is ready for download, the Details field displays Return Shipping Label Available. A download link for the label appears in the Return Shipping Label URL field.
Click the download link in the Return Shipping Label URL field and print it when you are ready to return the import appliance.

You can update the requested return label if the status of the request is Return Label Requested. Refer to the import appliance's Details page to view the current status. See Getting an Import Appliance's Details.

Using the CLI

Use the oci dts appliance request-return-label command and required parameters to request a shipping label for returning the appliance to Oracle:

oci dts appliance request-return-label --pickup-window-start-time pickup_window_start_time 
--pickup-window-end-time pickup_window_end_time --job-id job_ocid --appliance-label appliance_label

pickup_window_start_time is the beginning of the window of time when the selected carrier can pick up the appliance from the customer site. The pickup window start time you enter must to be at least 48 hours after requesting the label.

pickup_window_end_time is the end of the window of time when the selected carrier can pick up the appliance from the customer site.

Use the following format for the all the dates: "yyyy-mm-dd hh:mm". All times given must be UTC.

For a complete list of flags and variable options for CLI commands, see the Command Line Reference.

For example:

oci dts appliance request-return-label --job-id ocid1.datatransferjob.oc1..exampleuniqueID 
--appliance-label XAKWEGKZ5T --pickup-window-start-time "2023-04-21 08:00" --pickup-window-end-time "2023-04-21 17:00"
Changing the state of the transfer appliance to RETURN_LABEL_REQUESTED
{
  "data": {
    "appliance-delivery-tracking-number": null,
    "appliance-delivery-vendor": null,
    "appliance-return-delivery-tracking-number": null,
    "creation-time": "2023-04-18T11:32:58+00:00",
    "customer-received-time": null,
    "customer-returned-time": null,
    "customer-shipping-address": {      
      "address1": "2300 Oracle Way",
      "address2": null,
      "address3": null,
      "address4": null,
      "addressee": "MyCompany",
      "care-of": "Robert Smith",
      "city-or-locality": "Austin",
      "country": "USA",
      "email": "rsmith@example.com",
      "phone-number": "6035550100",
      "state-or-region": "TX",
      "zipcode": "78741"     },
    "delivery-security-tie-id": "exampleuniqueID",
    "label": "XAKWEGKZ5T",
    "lifecycle-state": "RETURN_LABEL_REQUESTED",
    "next-billing-time": null,
    "pickup-window-end-time": "2023-04-21T17:00:00+00:00",
    "pickup-window-start-time": "2023-04-21T08:00:00+00:00",
    "return-security-tie-id": "exampleuniqueID",
    "return-shipping-label-uri": null,
    "serial-number": "exampleuniqueserialnumber",
    "transfer-job-id": "ocid1.datatransferjob.oc1..exampleuniqueID",
    "upload-status-log-uri": "JAKQVAGJF/XAKWEGKZ5T/upload_summary.txt"
  }
}

Packing and Shipping the Import Appliance to Oracle

Return the import appliance to Oracle within 30 days. If you need the appliance beyond the standard 30-day window, you can file a service request to ask for an extension of up to 60 days.

Important

Review and follow the instructions that were provided in the transit case with the appliance.

Unplug the power cord from the power source and detach the other end of the cord from the appliance.
Disconnect the appliance from your network.
Remove the return shipment tamper-evident security tie from the transit case.
Place the appliance, power cord, and serial cable in the transit case.

Warning

Oracle recommends assistance lifting and placing the appliance back into the transit case. The total shipping weight is about 64 lbs (29 kg) and appliance weight is about 38 lbs (17 kg).
Close and secure the transit case with the return tamper-evident security tie.
Loop the top of the plastic tie-on tag with return shipping label through the handle of the transit case. Remove the protective tape from the back of the tie-on tag, exposing the adhesive area on which to secure the tag onto itself. Use the provided zip tie to secure the tie-on tag to the handle.
Return the transit case:
- Attach the return label and arrange with the shipping vendor to drop off or pick up the appliance.
- If there are any issues with the return label, open a service request with Oracle to arrange for the appliance's return. See Support Ticket Management.

The shipping vendor notifies Oracle when the appliance is shipped back to Oracle for upload to Oracle Cloud Infrastructure Object Storage.

Validating the Shipping Phase

Perform the following command line interface (CLI) validation tasks at the end of this phase before continuing to the next phase. Performing the validation procedures described here assesses your environment and confirms that you have completed all necessary setup requirements successfully. Running these procedures also serves as a troubleshooting resource for you to ensure a smooth and successful data transfer.

Use the oci dts verify shipped command and required parameters to validate the Shipping phase tasks and configurations you made:

oci dts verify shipped --job-id job_ocid --appliance-label appliance_label 
--return-security-tie-id return_security_tie_id [OPTIONS]

Running this CLI command validates the following: Valid return tamper-evident security tie

For a complete list of flags and variable options for CLI commands, see the Command Line Reference.

For example:

oci dts verify shipped --job-id ocid1.datatransferjob.oc1..exampleuniqueID --appliance-label XAKWEGKZ5T 
--return-security-tie-id tie1
Verifying requirements after 'Shipping the Import Appliance'...
Checking Return Tamper-evident Security Tie... OK

Failure Scenarios

This section describes possible failure scenarios detected during validation:

Valid return tamper-evident security tie

Invalid return security tie

Checking Return Tamper-evident Security Tie... Fail
The provided physical security tie number 'tie1' does not match the number 'tie2' logged by Oracle. Please file a Service Request (SR).

What's Next

Now you can track your return import appliance shipment to Oracle and review post transfer logs and summaries. See Monitoring the Import Appliance and Data Transfer.

Oracle Cloud Infrastructure Documentation