Configuring Appliance Data Imports

Configure phase indicator for appliance transfer

This topic describes the tasks associated with configuring the Appliance-Based Data Import. The Infrastructure Engineer role typically performs these tasks. See Roles and Responsibilities.

Unpacking and Connecting the Import Appliance to the Network

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.

Important

Your import appliance arrives in a transit case with a telescoping handle and wheels. The case amenities allow for easy movement to the location where you intend to place the appliance to upload your data.

Retain all packaging materials! When shipping the import appliance back to Oracle, you must package the appliance in the same manner and packaging in which the appliance was received.

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.

    Warning

    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. Under Core Infrastructure, go to Object Storage and click Data Transfer - Imports.
    2. Find the transfer job and import appliance associated with the removed security tie.
    3. Click the Actions icon (Actions icon), 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
    oci dts appliance show --job-id <job_id> --appliance-label <appliance_label>

    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": "123 Main Street",
          "address2": null,
          "address3": null,
          "address4": null,
          "addressee": "MyCompany",
          "care-of": "John Doe",
          "city-or-locality": "Anytown",
          "country": "USA",
          "email": "john.doe@mycompany.com",
          "phone-number": "3115551212",
          "state-or-region": "NY",
          "zipcode": "12345"
        },
        "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.

    Warning

    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. Under Core Infrastructure, go to Object Storage and click Data Transfer - Imports.
    2. Find the transfer job and import appliance associated with the return shipment security tie.
    3. Click the Actions icon (Actions icon), 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
    oci dts appliance show --job-id <job_id> --appliance-label <appliance_label>

    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": "123 Main Street",
          "address2": null,
          "address3": null,
          "address4": null,
          "addressee": "MyCompany",
          "care-of": "John Doe",
          "city-or-locality": "Anytown",
          "country": "USA",
          "email": "john.doe@mycompany.com",
          "phone-number": "3115551212",
          "state-or-region": "NY",
          "zipcode": "12345"
        },
        "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.

    Warning

    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.0299 kg) and appliance weight is 38 lbs (17.2365 kg).
  6. Connect the appliance to your local network using one of the following:

    • 10GBase-T: Standard RJ-45
    • SFP+: The transceiver must be compatible with Intel X520 NICs.
  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.

Connecting the Import Appliance to the Terminal Emulation Host

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

Note

You might need to download the driver for this cable on your Terminal Emulation Host: https://www.cablestogo.com/product/26887/5ft-usb-to-db9-male-serial-rs232-adapter-cable#support

Setting Up Terminal Emulation

Appliance-based transfers require you to set up your host for terminal emulation so you can communicate with the appliance through the appliance's serial console. This communication requires installing serial console terminal emulator software. We recommend using the following:

  • PuTTY for Windows
  • ZOC for OS X
  • PuTTY or Minicom for Linux

Configure the following terminal emulator software settings:

  • Baud Rate: 115200
  • Emulation: VT102
  • Handshaking: Disabled/off
  • RTS/DTS: Disabled/off
Note

PuTTY does not allow you to configure all of these settings individually. However, you can configure the PuTTY default settings by selecting the Serial connection type and specifying "115200" for the Serial Line baud speed. This configuration is sufficient to use PuTTY as a terminal emulator for the appliance.

Configuring the Import Appliance Networking

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:
Note

It can take up to 5 minutes for the serial console menu to display. Press Enter if you do not see the serial console configuration menu after this amount of time.

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. From the Terminal Emulation Host, 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.

Notifying the Data Administrator

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