Documentación de Oracle Cloud Infrastructure

Utilidad de transferencia de datos

En este tema se describe cómo instalar y configurar la utilidad de transferencia de datos para su uso en transferencias de datos basadas en disco. Además, en este tema se describe la sintaxis de los comandos de la utilidad de transferencia de datos.

Importante

Con esta versión, la utilidad de transferencia de datos solo admite transferencias de datos basadas en disco. El uso de la utilidad de transferencia de datos para transferencias basadas en dispositivo se ha reemplazado por la interfaz de línea de comandos (CLI) de Oracle Cloud Infrastructure.

La utilidad de transferencia de datos cuenta con la licencia universal permisiva 1.0 y la licencia de Apache 2.0. El contenido de terceros tiene licencias distintas según se describe en el código.

Nota

La utilidad de transferencia de datos se debe ejecutar como usuario raíz.

Requisitos previos

Para instalar y usar la utilidad de transferencia de datos, obtenga lo siguiente:

  • Cuenta de de Oracle Cloud Infrastructure.

  • Usuarios y grupos de Oracle Cloud Infrastructure necesarios con las políticas de IAM necesarias.

    Consulte para obtener información detallada.

  • Un equipo host de datos con lo siguiente instalado:

    • Oracle Linux 6 o posterior, Ubuntu 14.04 o posterior, o SUSE 11 o posterior. Todos los sistemas operativos Linux deben tener la capacidad de crear un sistema de archivos EXT.

      Nota

      Las máquinas basadas en Windows no están soportadas en los trabajos de transferencia basados en disco.

    • Java 1.8 o Java 1.11

    • hdparm 9.0 o posterior

    • Cryptsetup 1.2.0 o posterior

  • Acceso con firewall: si tiene un firewall restrictivo en el entorno donde utiliza la utilidad de transferencia de datos, es posible que necesite abrir la configuración del firewall en los siguientes rangos de direcciones IP: 140.91.0.0/16.

    También debe abrir el acceso a los rangos de direcciones IP de Object Storage: 134.70.0.0/17.

Instalación de la utilidad de transferencia de datos

Descargue e instale el instalador de la utilidad de transferencia de datos correspondiente al sistema operativo del host de datos.

Para instalar la utilidad de transferencia de datos en Debian o Ubuntu
Para instalar la utilidad de transferencia de datos en Oracle Linux o Red Hat Linux

Configuración de la utilidad de transferencia de datos

Antes de utilizar la utilidad de transferencia de datos, debe crear un directorio base de Oracle Cloud Infrastructure y dos archivos de configuración con las credenciales requeridas. Un archivo de configuración es para el administrador de transferencia de datos, el usuario de IAM con la autorización y los permisos para crear y gestionar trabajos de transferencia. El otro archivo de configuración es para el usuario de carga de transferencia de datos, el usuario temporal de IAM que Oracle utiliza para cargar sus datos en su nombre.

Directorio de transferencia de datos base

Cree un directorio base de Oracle Cloud Infrastructure:

mkdir /root/.oci/

Archivo de configuración para el administrador de transferencia de datos

Cree un archivo de configuración del administrador de transferencia de datos /root/.oci/config con la siguiente estructura:

[DEFAULT]
user=<The OCID for the data transfer administrator>
fingerprint=<The fingerprint of the above user's public key>
key_file=<The _absolute_ path to the above user's private key file on the host machine>
tenancy=<The OCID for the tenancy that owns the data transfer job and bucket>
region=<The region where the transfer job and bucket should exist. Valid values are: 
us-ashburn-1, us-phoenix-1, eu-frankfurt-1, and uk-london-1.>

Por ejemplo:

[DEFAULT]
user=ocid1.user.oc1..<unique_ID>
fingerprint=4c:1a:6f:a1:5b:9e:58:45:f7:53:43:1f:51:0f:d8:45
key_file=/home/user/ocid1.user.oc1..<unique_ID>.pem
tenancy=ocid1.tenancy.oc1..<unique_ID>
region=us-phoenix-1

Para el administrador de transferencia de datos, puede crear un solo archivo de configuración que contenga diferentes secciones de perfil con las credenciales para varios usuarios. A continuación, utilice la opción ‑‑profile para especificar qué perfil utilizar en el comando. A continuación se muestra un ejemplo de un archivo de configuración de administrador de transferencias de datos con diferentes secciones de perfil:

[DEFAULT]
user=ocid1.user.oc1..<unique_ID>
fingerprint=4c:1a:6f:a1:5b:9e:58:45:f7:53:43:1f:51:0f:d8:45
key_file=/home/user/ocid1.user.oc1..<unique_ID>.pem
tenancy=ocid1.tenancy.oc1..<unique_ID>
region=us-phoenix-1
[PROFILE1]
user=ocid1.user.oc1..<unique_ID>
fingerprint=4c:1a:6f:a1:5b:9e:58:45:f7:53:43:1f:51:0f:d8:45
key_file=/home/user/ocid1.user.oc1..<unique_ID>.pem
tenancy=ocid1.tenancy.oc1..<unique_ID>
region=us-ashburn-1

De forma predeterminada, el perfil DEFAULT se usa para todos los comandos de la utilidad de transferencia de datos. Por ejemplo:

dts job create --compartment-id <compartment_id> --bucket <bucket_name> --display-name <display_name> --device-type <disk>

En su lugar, puede emitir cualquier comando de la utilidad de transferencia de datos con la opción --profile para especificar un perfil de administrador de transferencia de datos diferente. Por ejemplo:

dts job create --compartment-id <compartment_id> --bucket <bucket_name> --display-name <display_name> --device-type <disk> --profile <profile_name>

Utilizando el archivo de configuración de ejemplo anterior, <profile_name> sería profile1.

Archivo de configuración para el usuario de carga de transferencia de datos

Cree un archivo de configuración /root/.oci/config_upload_user del usuario de carga de transferencia de datos con la siguiente estructura:

[DEFAULT]
user=<The OCID for the data transfer upload user>
fingerprint=<The fingerprint of the above user's public key>
key_file=<The _absolute_ path to the above user's private key file on the host machine>
tenancy=<The OCID for the tenancy that owns the data transfer job and bucket>
region=<The region where the transfer job and bucket should exist. Valid values are: 
us-ashburn-1, us-phoenix-1, eu-frankfurt-1, and uk-london-1.>

Por ejemplo:

[DEFAULT]
user=ocid1.user.oc1..<unique_ID>
fingerprint=4c:1a:6f:a1:5b:9e:58:45:f7:53:43:1f:51:0f:d8:45
key_file=/home/user/ocid1.user.oc1..<unique_ID>.pem
tenancy=ocid1.tenancy.oc1..<unique_ID>
region=us-phoenix-1

Importante

La creación de un archivo de configuración del usuario de carga con varios perfiles no se admite.

Entradas del archivo de configuración

La siguiente tabla muestra las entradas básicas que se necesitan para cada archivo de configuración y dónde obtener la información para cada entrada.

Nota

El servicio Data Transfer no admite frases de contraseña en los archivos de claves tanto para el administrador de transferencia de datos como para el usuario de carga de transferencia de datos.

Entrada Descripción y dónde obtener el valor ¿Necesario?
user

OCID del administrador de transferencia de datos o del usuario de carga de transferencia de datos, según el perfil que esté creando. Para obtener el valor, consulte Claves y OCID necesarios.

 Sí
fingerprint

Huella del par de claves que se utiliza. Para obtener el valor, consulte Claves y OCID necesarios.

 Sí
key_file

Ruta completa y nombre de archivo de la clave privada.

Importante: el par de claves debe estar en formato PEM. Para obtener instrucciones sobre la generación de un par de claves en formato PEM, consulte Claves y OCID necesarios.

Sí
tenancy

OCID de su arrendamiento. Para obtener el valor, consulte Claves y OCID necesarios.

 Sí
region

Región de Oracle Cloud Infrastructure. Consulte Regiones y dominios de disponibilidad.

Las transferencias de datos se admiten en las regiones Este de EE. UU. (Ashburn), Oeste de EE. UU. (Phoenix), Centro de Alemania (Fráncfort) y Sur de Reino Unido (Londres).

 Sí

Puede verificar las credenciales de usuario de carga de transferencia de datos con el siguiente comando:

dts job verify-upload-user-credentials --bucket <bucket_name>

Ubicación del archivo de configuración

La ubicación de los archivos de configuración es /root/.oci/config.

Uso de la utilidad de transferencia de datos

En esta sección se proporciona una visión general de la sintaxis de la utilidad de transferencia de datos.

Importante

La utilidad de transferencia de datos debe ejecutarse como usuario root.

Puede especificar las opciones de comandos de la utilidad de transferencia de datos mediante los siguientes comandos:

  • --option <value> o
  • --option=<value>

Sintaxis

La sintaxis básica de la utilidad de transferencia de datos es:

dts <resource> <action> <options>

Esta sintaxis se aplica a lo siguiente:

  • dts es el nombre abreviado del comando de utilidad.
  • job es un ejemplo de <resource>
  • create es un ejemplo de <action>
  • Otras cadenas de utilidad son <options>.

En los siguientes ejemplos se muestran los comandos habituales de la utilidad de transferencia de datos para crear un trabajo de transferencia.

dts job create --compartment-id ocid.compartment.oc1..exampleuniqueID --display-name "mycompany transfer1" --bucket mybucket --device-type disk

O bien:

dts job create --compartment-id=compartment-id ocid.compartment.oc1..exampleuniqueID --display-name="mycompany transfer1" --bucket=mybucket --device-type=disk
Nota

En los ejemplos anteriores, proporcione un nombre descriptivo para el trabajo de transferencia con la opción ‑‑display‑name. Evite introducir información confidencial al proporcionar nombres o descripciones de recursos.

Búsqueda de la versión instalada de la utilidad de transferencia de datos

Puede obtener la versión instalada de la utilidad de transferencia de datos mediante --version o -v. Por ejemplo:

dts --version

0.6.183

Acceso a la ayuda de la utilidad de transferencia de datos

Todos los comandos de ayuda de la utilidad de transferencia de datos tienen un componente de ayuda asociado al que puede acceder desde la línea de comandos. Para ver la ayuda, introduzca cualquier comando seguido de la opción --help o -h. Por ejemplo:

dts job --help

Usage:  job [COMMAND]
Transfer disk or appliance job operations -  {job <action> [options]}

Commands:
create                          Creates a new transfer disk or appliance job.
show                            Shows the transfer disk or appliance job details.
update                          Updates the transfer disk or appliance job details.
delete                          Deletes the transfer disk or appliance job.
close                           Closes the transfer disk or appliance job.
list                            Lists all transfer disk or appliance jobs.
verify-upload-user-credentials  Verifies the transfer disk or appliance upload user credentials.

Al ejecutar la opción de ayuda (--help o -h) para un comando especificado, se muestran todos los comandos y opciones subordinados para ese nivel de la utilidad de transferencia de datos. Si desea acceder a la ayuda de la utilidad de transferencia de datos para un comando subordinado específico, inclúyalo en la cadena de la utilidad de transferencia de datos; por ejemplo:

dts job create --help

Usage:  job create --bucket=<bucket> --compartment-id=<compartmentId>
    [--defined-tags=<definedTags>] --device-type=<deviceType>
    --display-name=<displayName>
    [--freeform-tags=<freeformTags>] [--profile=<profile>]

Creates a new transfer disk or appliance job.
			
--bucket=<bucket>                Upload bucket for the job.
--compartment-id=<compartmentId> Compartment OCID.
--defined-tags=<definedTags>     Defined tags for the new transfer job in JSON format.
--device-type=<deviceType>       Device type for the job: DISK or APPLIANCE.
--display-name=<displayName>     Display name for the job.
--freeform-tags=<freeformTags>   Free-form tags for the new transfer job in JSON format.
--profile=<profile>              Profile.

Siguiente paso

Ahora puede realizar transferencias de datos basadas en disco. Consulte Copia de datos en el disco de importación.