Configuring the Export Appliance

Learn about the appliance configuration tasks required for performing data exports.

Configure phase indicator for data export

This topic describes the tasks associated with configuring the export appliance after you receive it from Oracle. The Infrastructure Engineer role typically performs these tasks. See Roles and Responsibilities.

Note

  • Only use SFP+ transceivers that are compatible with Intel X520 NICs. Check Intel's current compatibility list to verify that the transceiver is compatible.

  • 1 GBase-T: Standard RJ-45 is supported, but its use affects data copying performance.

Unpacking and Connecting the Appliance to the Network

When the shipping vendor delivers your export appliance, Oracle updates the status as Delivered and provides the date and time the appliance was received in the Appliance Information section.

Your export 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.

Important

Retain all packaging materials! When shipping the export 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 export 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.

  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.

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

    Warning

    Oracle recommends assistance lifting the export 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 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.

Using the Console

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 Exports. The Export Jobs page appears.

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

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

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

Using the CLI

At the command prompt on the Control Host, run oci dts appliance show to delete an export appliance.

oci dts appliance show --job-id job_id --appliance-label appliance_label
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.

Connecting the Appliance to the Terminal Emulation Host

Connect the 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: 5ft (1.5m) USB to DB9 Male Serial RS232 Adapter Cable.

Setting Up Terminal Emulation

Set up terminal emulation so you can communicate with the appliance device 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 is sufficient to use PuTTY as a terminal emulator for the appliance.

Configuring the Export Appliance Networking

When the 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. If multiple interfaces are active, you are given the choice to select the interface to use.

Configuring Your Export 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 export 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.

Notify the Data Administrator

After completing the tasks in this topic, send the following appliance information IP address of the export appliance to the Data Administrator:

  • Appliance IP address

  • Access token

  • SSL certificate fingerprint