Configuring Appliance Data Imports

When the shipping vendor delivers your import appliance, Oracle updates the status as Delivered and provides the date and time the appliance was received in the Transfer Appliance Details.

Here are the tasks involved in unpacking and getting your import appliance ready to configure.

1. Inspect the tamper-evident security tie on the transit case.

   If the appliance was tampered with during transit, the tamper-evident security tie serves to alert you.

   Caution
   
   

   If the security tie is damaged or is missing, do not plug the appliance into your network! Immediately file a Service Request (SR).

2. Remove and compare the number on the security tie with the number logged by Oracle.

   To see the security tie number logged by Oracle using the Console:

   1. Open the navigation menu and click Migration & Disaster Recovery. Under Data Transfer, click Imports. The Transfer Jobs page appears.

   2. Find the transfer job and import appliance associated with the removed security tie.

   3. Click the Actions menu (), and then click View Details.

   4. Look at the contents of the Send Security Tie ID field in the Transfer Appliance Details and compare that number with the number on the physical tag.

   To see the security tie number logged by Oracle using the CLI:

   Use the oci dts appliance show command and required parameters to monitor the status of your import appliance request.

   oci dts appliance show --job-id job_id --appliance-label appliance_label [OPTIONS]

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

   For example:

   oci dts appliance show --job-id ocid1.datatransferjob.oc1..exampleuniqueID --appliance-label XAKWEGKZ5T
   					
   {
     "data": {
       "appliance-delivery-tracking-number": null,
       "appliance-delivery-vendor": null,
       "appliance-return-delivery-tracking-number": null,
       "creation-time": "2020-05-20T22:08:13+00:00",
       "customer-received-time": null,
       "customer-returned-time": null,
       "customer-shipping-address": {
         "address1": "2300 Oracle Way",
         "address2": null,
         "address3": null,
         "address4": null,
         "addressee": "Example, Inc.",
         "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": "PROCESSING",
       "next-billing-time": null,
       "return-security-tie-id": "exampleuniqueID",
       "serial-number": "exampleuniqueserialnumber",
       "transfer-job-id": "ocid1.datatransferjob.oc1..exampleuniqueID",
       "upload-status-log-uri": "JAKQVAGJF/XAKWEGKZ5T/upload_summary.txt"
     }
   }

   Compare the value of the delivery-security-tie-id attribute with the number on the physical tag to ensure they match.

   Caution
   
   

   If the number on the physical security tie does not match the number logged by Oracle, do not plug the appliance into your network! Immediately file a Service Request (SR).

   Note
   
   

   Keep possession of the security tie after you have finished unpacking and connecting the appliance. Include it when returning the appliance to Oracle. Failure to include the security tie can result in a delay in the data migration process.

3. Open the transit case and ensure that the case contains the following items:

   • Appliance unit and power cable (two types of power cables provided: C14 and C13 to 14)

   • USB to DB-9 serial cable

   • Return shipping instructions (retain these instructions)

   • Return shipping label, label sleeve, tie-on tag, and zip tie

   • Return shipment tamper-evident security tie (use this tie to ensure secure transit case back to Oracle)

4. Compare the number on the return shipment security tie with the number logged by Oracle.

   To see the security tie number logged by Oracle using the Console:

   1. Open the navigation menu and click Migration & Disaster Recovery. Under Data Transfer, click Imports. The Transfer Jobs page appears.

   2. Find the transfer job and import appliance associated with the return shipment security tie.

   3. Click the Actions menu (), and then click View Details.

   4. Look at the contents of the Return Security Tie ID field in the Transfer Appliance Detailsand compare that number with the number on the physical tag.

   To see the security tie number logged by Oracle using the CLI:

   Use the oci dts appliance show command and required parameters to monitor the status of your import appliance request.

   oci dts appliance show --job-id job_id --appliance-label appliance_label [OPTIONS]

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

   For example:

   oci dts appliance show --job-id ocid1.datatransferjob.oc1..exampleuniqueID --appliance-label XAKWEGKZ5T
   					
   {
     "data": {
       "appliance-delivery-tracking-number": null,
       "appliance-delivery-vendor": null,
       "appliance-return-delivery-tracking-number": null,
       "creation-time": "2020-05-20T22:08:13+00:00",
       "customer-received-time": null,
       "customer-returned-time": null,
       "customer-shipping-address": {
         "address1": "2300 Oracle Way",
         "address2": null,
         "address3": null,
         "address4": null,
         "addressee": "Example, Inc.",
         "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": "PROCESSING",
       "next-billing-time": null,
       "return-security-tie-id": "exampleuniqueID",
       "serial-number": "exampleuniqueserialnumber",
       "transfer-job-id": "ocid1.datatransferjob.oc1..exampleuniqueID",
       "upload-status-log-uri": "JAKQVAGJF/XAKWEGKZ5T/upload_summary.txt"
     }
   }

   Compare the value of the return-security-tie-id attribute with the number on the physical tag to ensure they match.

   Caution
   
   

   If the number on the return security tie does not match the number logged by Oracle, file a Service Request (SR). These security tie numbers must match or Oracle cannot upload data from your returned appliance.

5. Remove the import appliance from the case and place the appliance on a solid surface or in a rack.

   Warning
   
   

   We recommend assistance lifting the appliance out of the transit case and placing the appliance in a rack or on a desk top. The total shipping weight is about 64 lbs (29 kg) and appliance weight is about 38 lbs (17 kg).

6. Connect the appliance using 10GBase-T: Standard RJ-45.

7. Attach one of the provided power cords to the appliance and plug the other end into a grounded power source.

8. Turn on the appliance by flipping the power switch on the back of the appliance.

Connect the import appliance to your designated Terminal Emulation Host computer using the provided USB to DB-9 serial cable.

When the import appliance boots up, an appliance serial console configuration menu is displayed on the Terminal Emulation Host to which the appliance is connected.

    Oracle Cloud Data Transfer Appliance 
      - For use with minimum dts version: dts-0.4.140
      - See "Help" for determining your dts version

1) Configure Networking
2) Show Networking
3) Reset Authentication
4) Show Authentication
5) Show Status
6) Collect Appliance Diagnostic Information
7) Generate support bundle
8) Shutdown Appliance
9) Reboot Appliance
10) Help

Select a command:

The appliance supports a single active network interface on any of the 10-Gbps network ports. If only one interface is cabled and active, that interface is chosen automatically. When multiple interfaces are active, you are given the choice to select the interface to use.

To configure your import appliance networking:

1. Access the Terminal Emulation Host and select Configure Networking from the appliance serial console menu.

2. Provide the required networking information when prompted:

   • IP Address: IP address of the appliance.

   • Subnet Mask Length: The count of leading 1 bit in the subnet mask. For example, if the subnet mask is 255.255.255.0 then the length is 24.

   • Default Gateway: Default gateway for network communications.

   For example:

   Configure Networking:
   ^C to cancel
   
   Configuring IP address, subnet mask length, gateway
   Example:
   IP Address : 10.0.0.2
   Subnet Mask Length : 24
   Gateway : 10.0.0.1
   
   Address: 10.0.0.1
   Subnet Mask Length: 24
   Gateway: 10.0.0.1
   
   Configuring IP address 10.0.0.1 netmask 255.255.255.0 default gateway 10.0.0.1
   Enabling enp0s3
   Now trying to restart the network
   
   Network configuration is complete
   
   New authentication material created.
   
   Client access token                   : 4iH1gw1okPJO
   Appliance certificate MD5 fingerprint : BF:C6:49:9B:25:FE:9F:64:06:7E:DF:F5:F9:E5:C6:56
   Press ENTER to return...

When you configure a network interface, the appliance software generates a new client access token and appliance X.509/SSL certificate. The access token is used to authorize your Control Host to communicate with the Data Transfer Appliance's Management Service. The x.509/SSL certificate is used to encrypt communications with the Data Transfer Appliance's Management Service over the network. Provide the access token and SSL certificate fingerprint values displayed here when you use the CLI commands to initialize authentication on your host machine.

You can change the selected interface, network information, and reset the authentication material at any time by selecting Configure Networking again from the appliance serial console menu.

After completing the tasks in this topic, send the following import appliance information to the Data Administrator:

• Appliance IP address

• Access token

• SSL certificate fingerprint

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 configured command and required parameters to validate the Configuring phase tasks and configurations you made:

oci dts verify configured --job-id job_ocid --appliance-label appliance_label --delivery-security-tie-id delivery_security_tie_id --appliance-ip appliance_ip [OPTIONS]

Running this CLI command validates the following:

• Valid delivery tamper-evident security tie

• Connectivity to the appliance

For example:

oci dts verify configured --job-id ocid1.datatransferjob.oc1..exampleuniqueID --appliance-label XAKWEGKZ5T --delivery-security-tie-id tie1 --appliance-ip 10.0.0.1
Verifying necessary requirements after 'Configuring Appliance Data Imports'...
Checking Delivery Tamper-evident Security Tie... OK
Checking Appliance Reachability... OK

You are now ready to load your data to the disk. See Copying Data to the Import Appliance.