Preparación para las transferencias de datos de dispositivo

Versión mínima necesaria de la CLI

La versión mínima de la CLI necesaria para la importación de datos basada en aplicaciones es la 2.12.1.

Determinación de las versiones de CLI

Acceda a la siguiente URL para ver la versión disponible actualmente de la CLI:

https://github.com/oracle/oci-cli/blob/master/CHANGELOG.rst

Introduzca el siguiente comando en el símbolo del sistema para ver la versión de la CLI instalada actualmente en la máquina:

oci --version

Si tiene una versión en su máquina anterior a la versión disponible actualmente, instale la versión más reciente.

Requisitos del sistema operativo Linux

Consulte Requisitos para obtener una lista de los sistema operativos de Linux que soporten la CLI.

Instalación de la CLI

La instalación y la configuración de las CLI se describen detalladamente en Interfaz de línea de comandos (CLI).

Uso de la CLI

Puede especificar las opciones de la CLI mediante los siguientes comandos:

• --option value o

• --option=value

La sintaxis básica de la CLI es:

oci dts resource action options

Esta sintaxis se aplica a lo siguiente:

• oci dts es el nombre abreviado del comando de la CLI.

• job es un ejemplo de resource.

• create es un ejemplo de action.

• Otras cadenas son options.

El siguiente comando para crear un trabajo de transferencia muestra una construcción típica del comando de la CLI.

oci dts job create --compartment-id ocid1.compartment.oc1..exampleuniqueID --bucket MyBucket --display-name MyApplianceImportJob --device-type appliance

Acceso a la ayuda de la interfaz de línea de comandos

oci dts job --help
			
NAME
  dts_job -

DESCRIPTION
  Transfer disk or appliance job operations

AVAILABLE COMMANDS
  o change-compartment
  o close
  o create
  o delete
  o detach-devices-details
  ...

oci dts job create --help
			
NAME
  dts_job_create -

DESCRIPTION
  Creates a new transfer disk or appliance job.

USAGE
  oci dts job create [OPTIONS]

REQUIRED PARAMETERS
  --bucket [text]

Upload bucket name

--compartment-id, -c [text]

Compartment OCID

--device-type [text]

Creación del directorio de transferencia de datos

Cree un directorio de Oracle Cloud Infrastructure (.oci) en el mismo equipo host de control en el que está instalada la CLI de Oracle Cloud Infrastructure. Por ejemplo:

mkdir /root/.oci/

Los dos archivos de configuración (config y config_upload_user) se colocan en la ubicación que seleccione.

Creación del archivo de configuración del administrador de transferencia de datos

El archivo de configuración del administrador de transferencia de datos contiene las credenciales necesarias para trabajar con Oracle Cloud Infrastructure. Puede crear este archivo mediante una CLI de configuración o manualmente con un editor de texto.

Uso de la CLI de configuración

Ejecute la utilidad de la línea de comandos oci setup config para recorrer el proceso de configuración por primera vez. El comando le solicita la información necesaria para el archivo de configuración y las claves públicas/privadas de API. El cuadro de diálogo de configuración genera un par de claves de API y crea el archivo de configuración.

Para obtener más información sobre cómo buscar la información necesaria, consulte:

• Dónde obtener el OCID del arrendamiento y el OCID del usuario

• Regiones y dominios de disponibilidad

Configuración manual

Si desea configurar las claves públicas/privadas de API y escribir su propio archivo de configuración, consulte SDK and CLI Configuration File.

Cree el 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: 
supported regions>.

donde supported regions son las regiones que se muestran en Regiones compatibles con Data Transfer.

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

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

oci dts job create --compartment-id ocid.compartment.oc1..exampleuniqueID --bucket MyBucket --display-name MyDisplay --device-type appliance

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

oci dts job create --compartment-id ocid.compartment.oc1..exampleuniqueID --bucket MyBucket --display-name MyDisplay --device-type appliance --profile MyProfile

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

Si ha creado dos archivos de configuración independientes, utilice el siguiente comando para especificar el archivo de configuración que se utilizará:

oci dts job create --compartment-id compartment_id --bucket bucket_name --display-name display_name --config 
                
                

Creación del archivo de configuración del usuario de carga de transferencia de datos

El archivo de configuración config_upload_user 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. Cree este archivo de configuración 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: 
supported regions>.

donde supported regions son las regiones que se muestran en Regiones compatibles con Data Transfer.

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.

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

oci dts job verify-upload-user-credentials --bucket bucket_name

Configuración de notificaciones para una nueva solicitud de dispositivo de importación

Para incluir notificaciones de trabajo al solicitar un dispositivo de importación, incluya la opción --setup-notifications como parte del comando oci dts Appliance request:

oci dts appliance request --job-id ... --setup-notifications

Configuración de notificaciones para una solicitud de dispositivo de importación existente

Para configurar notificaciones para una solicitud de dispositivo de importación existente, ejecute el comando oci dts device setup-notifications en el dispositivo:

oci dts appliance setup-notifications --appliance-label appliance_label

Escenarios de fallos

En esta sección, se describen los posibles escenarios de fallo detectados durante la validación:

• Conectividad al servicio de transferencia de datos

  • Solicitud de timeout para el punto final de Data Transfer

    Checking Data Transfer Service connectivity... datatransfer.r1.oracleiaas.com is not reachable.
    Please ensure there there are no firewall rules blocking connectivity.
    RequestException:
    {
        "client_version": "Oracle-PythonCLI/3.22.0",
        "logging_tips": "Please run the OCI CLI command using --debug flag to find more debug information.",
        "message": "The connection to endpoint timed out.",
        "request_endpoint": null,
        "target_service": "CLI",
        "timestamp": "2023-02-01T11:46:02.374857",
        "troubleshooting_tips": " See [https://docs.oracle.com/en-us/iaas/Content/API/Concepts/sdk_troubleshooting.htm] for more information about resolving this error. If you are unable to resolve this issue, run this CLI command with --debug option and contact Oracle support and provide them the full error message."
    }

• Conectividad a Object Storage

  • Solicitud de timeout al punto final de Object Storage

    Checking Object Storage connectivity... objectstorage.r1.oracleiaas.com is not reachable.
    Please ensure there there are no firewall rules blocking connectivity.
    RequestException:
    {
        "client_version": "Oracle-PythonCLI/3.22.0",
        "logging_tips": "Please run the OCI CLI command using --debug flag to find more debug information.",
        "message": "The connection to endpoint timed out while trying to reach https://objectstorage.r1.oracleiaas.com",
        "request_endpoint": " GET https://objectstorage.r1.oracleiaas.com",
        "target_service": "CLI",
        "timestamp": "2023-02-01T12:52:33.979490",
        "troubleshooting_tips": "Try running curl https://objectstorage.r1.oracleiaas.com. If the curl doesn't work, check your network setting or contact your network administrator. See [https://docs.oracle.com/en-us/iaas/Content/API/Concepts/sdk_troubleshooting.htm] for more information about resolving this error. If you are unable to resolve this issue, run this CLI command with --debug option and contact Oracle support and provide them the full error message."
    }

• Usuarios, grupos y políticas de IAM necesarios para el usuario administrador

  • No hay ninguna política de autorización de Object Storage para el usuario administrador

    Checking Required IAM Users, Groups, and Policies... Fail
    Unauthorized access to Object Storage.
    Please ensure you have the required IAM Users, Groups, and Policies to access Object Storage.

  • No hay ninguna política de autorización de Data Transfer para el usuario administrador

    Checking Required IAM Users, Groups, and Policies... Fail
    Unauthorized access to Data Transfer Service.
    Please ensure you have the required IAM Users, Groups, and Policies to access Data Transfer Service.

• El cubo de carga pertenece al compartimento

  • El cubo de carga no existe

    Checking Upload Bucket exists in Compartment... Fail
    Bucket not found.
    The bucket 'e2e_test_hdx' does not exist in namespace 'bdtstest1' or you are unauthorized to access it.

  • El cubo de carga no está en el compartimento

    
    Checking Upload Bucket exists in Compartment... Fail
    The bucket 'e2e_test_hdd' does not belong to compartment 'ocid1.compartment.region1..aaaaaaaaph2r5w24faket2vsp22hiboxjzk4k3s47d2ut37jghjagfb3abca'.

• Transferencia de datos Los usuarios pueden crear, sobrescribir, inspeccionar y suprimir objetos del cubo en Object Storage

  • No hay ninguna política de autorización para el usuario de carga

    Checking Upload User credentials...
    Failed to Create object BulkDataTransferTestObject in bucket e2e_test_hdd using upload user in tenancy bdtstest1 as upload user
    Fail
    ServiceError:
    {
        "client_version": "Oracle-PythonSDK/2.90.0+2664, Oracle-PythonCLI/3.22.0",
        "code": "BucketNotFound",
        "logging_tips": "Please run the OCI CLI command using --debug flag to find more debug information.",
        "message": "Either the bucket named 'e2e_test_hdd' does not exist in the namespace 'bdtstest1' or you are not authorized to access it",
        "opc-request-id": "sea-1:tpz7tEO-SLezjoTd506L8R5wm3HewQNHFfpg-EKsAINe6P8fFj4b_znPyfujFeqq",
        "operation_name": "put_object",
        "request_endpoint": "PUT https://objectstorage.r1.oracleiaas.com/n/bdtstest1/b/e2e_test_hdd/o/BulkDataTransferTestObject",
        "status": 404,
        "target_service": "object_storage",
        "timestamp": "2023-02-07T06:39:24.816918+00:00",
        "troubleshooting_tips": "See [https://docs.oracle.com/iaas/Content/API/References/apierrors.htm] for more information about resolving this error. If you are unable to resolve this issue, run this CLI command with --debug option and contact Oracle support and provide them the full error message."
    }

• Derechos de dispositivo de transferencia de datos aprobados

  • No hay ningún derecho de servicio de transferencia de datos

    Checking Data Transfer Appliance Entitlement... Fail
    Unable to find Data Transfer Appliance Entitlement in Compartment 'ocid1.compartment.region1..aaaaaaaaa5mxm3fd6tanvthad5oplmdcmxjqdsoehidua7iz3sxauih3deja'.

  • Derecho de transferencia de datos no aprobado

    Checking Data Transfer Appliance Entitlement... Fail
    Data Transfer Appliance Entitlement needs to be in an APPROVED lifecycle state.

• Ya existe el trabajo de transferencia basada en dispositivo de importación de Data Transfer

  • No hay ningún trabajo de transferencia basado en dispositivo de transferencia de datos

    Checking Transfer Job and Appliance Request... Fail
    There is no Appliance Transfer Job 'ocid1.datatransferjob.oc1..exampleuniqueID' for Data Import into Bucket 'e2e_test_hdd'.

• Solicitud de dispositivo asociada a un trabajo de transferencia válido

  • Ninguna solicitud de dispositivo

    Checking Transfer Job and Appliance Request... Fail
    There is no Transfer Appliance Request for Appliance Transfer Job 'ocid1.datatransferjob.oc1..exampleuniqueID'.