Help Sheet - Appliance Import Procedures

Follow the tasks in this help sheet after you login to the host where you will be mounting the Data Transfer Appliance (import appliance) and copying data.

You need to run all Command Line Interface (CLI) tasks as sudo.

• Have the IP address for the import appliance.

• Have the access token for the import appliance.

• Have the transfer job OCID.

• Have the appliance label information.

• Ensure there is no firewall and communication is open between the import appliance the host where it will be mounted.

• Open the firewall to the Data Transfer service on the IP address ranges: 140.91.0.0/16.

• Open the firewall to the Object Storage IP address ranges: 134.70.0.0/17.

• Set the environment variable If HTTP proxy environment is needed to allow access to the internet. The proxy environment allows Oracle Cloud Infrastructure CLI to communicate with the Data Transfer Appliance Management Service and the import appliance over a local network connection.

  export HTTPS_PROXY=http://www-proxy.myorg.com:80

• Go to root as sudo and install NFS utilities if they are not already installed (first command for RHEL, OEL and second command for Debian, Ubuntu):

  sudo yum install nfs-utils 
  sudo apt-get install nfs-common

• Continue as root.

• Initialize the appliance. Have the import appliance access token ready.

  oci dts physical-appliance initialize-authentication --job-id job_id --appliance-cert-fingerprint appliance_cert_fingerprint --appliance-ip appliance_ip --appliance-label appliance_label

  When prompted, supply the access token, and answer y to permit overwriting of data.

• Configure the import appliance encryption:

  oci dts physical-appliance configure-encryption --job-id job_id --appliance-label appliance_label

• Unlock the import appliance:

  oci dts physical-appliance unlock --job-id job_id --appliance-label appliance_label

• Create an NFS dataset:

  oci dts nfs-dataset create --name dataset_name

• Export the dataset:

  oci dts nfs-dataset set-export --name dataset_name --rw true --world true

• Activate the dataset:

  oci dts nfs-dataset activate --name dataset_name

• Check the dataset is exported:

  showmount -e appliance_ip

• Mount the dataset:

  mkdir -p /mnt/mountpoint_name
  oci dts nfs-dataset activate --name dataset_name

• Copy files to the DTA. The tar method is recommended but other types of copies such as cp or rsync can also be used.

  Here are two examples:

  • tar -cvzf /mnt/nfs-dts-1/filesystem.tgz filesystem/

  • 
    tar cvzf /mnt/nfs-dts-1/filesystem.tgz filesystem/ |xargs -I '{}' sh -c "test -f '{}' && md5sum '{}'"|tee tarzip_md5 

• Deactivate the dataset:

  oci dts nfs-dataset deactivate --name dataset_name

• Seal the dataset. Note this can be a long running process.

  oci dts nfs-dataset seal --name dataset_name [--wait]

• Monitor the sealing process:

  oci dts nfs-dataset seal-status --name dataset_name

• Download the dataset seal manifest:

  oci dts nfs-dataset get-seal-manifest --name dataset_name --output-file output_file_path

• Finalize the import appliance:

  oci dts physical-appliance finalize --job-id job_id --appliance-label appliance_label

• Shut down the import appliance by selecting option #8 on the terminal emulation host.
• Have the import appliance packed and shipped to Oracle.

• Monitor the status of the data upload from the DTA to your object storage bucket in OCI:

  oci dts appliance show --job-id job_id --appliance-label appliance_label

• Once the data upload is finished, check the object storage bucket from the Console and get the upload file location

• Download the upload file and review them to understand what was transferred:

  oci os object get --namespace object_storage_namespace --bucket-name bucket_name --name object_name --file file_location

• Close the import job:

  oci dts job close --job-id job_id

• Delete the import appliance associated with the import job:

  oci dts appliance delete --job-id job_id --appliance-label appliance_label

• Delete the transfer job:

  oci dts job delete --job-id job_id