Préparation des transferts de données d'appliance

Version minimale requise de l'interface de ligne de commande

La version minimale requise de l'interface de ligne de commande dans le cadre de l'import de données basé sur l'appliance est 2.12.1.

Identification des versions d'interface de ligne de commande

Accédez à l'URL suivante pour connaître la version d'interface de ligne de commande actuellement disponible :

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

Entrez la commande suivante à l'invite pour connaître la version d'interface de ligne de commande actuellement installée sur votre ordinateur :

oci --version

Si vous disposez sur votre ordinateur d'une version antérieure à celle actuellement disponible, installez la dernière version.

Exigences relatives au système d'exploitation Linux

Reportez-vous à Exigences pour obtenir la liste des systèmes d'exploitation Linux qui prennent en charge l'interface de ligne de commande.

Installation de l'interface de ligne de commande

L'installation et la configuration des interfaces de ligne de commande sont décrites en détail dans Interface de ligne de commande (CLI).

Utilisation de l'interface de ligne de commande

Vous pouvez spécifier des options d'interface de ligne de commande à l'aide des commandes suivantes :

• --option value ou

• --option=value

Voici la syntaxe de base de l'interface de ligne de commande :

oci dts resource action options

Cette syntaxe s'applique aux éléments suivants :

• oci dts est le nom abrégé de la commande d'interface de ligne de commande.

• job est un exemple d'élément resource.

• create est un exemple d'élément action.

• Les autres chaînes sont des éléments options.

La commande suivante permettant de créer un travail de transfert présente une construction de commande d'interface de ligne de commande typique.

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

Accès à l'aide de l'interface de ligne de commande

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]

Création du répertoire de transfert de données

Créez un répertoire Oracle Cloud Infrastructure (.oci) sur l'ordinateur hôte de contrôle où l'interface de ligne de commande Oracle Cloud Infrastructure est installée. Par exemple :

mkdir /root/.oci/

Les deux fichiers de configuration (config et config_upload_user) sont placés à l'emplacement de votre choix.

Création du fichier de configuration d'administrateur de transfert de données

Le fichier de configuration d'administrateur de transfert de données contient les informations d'identification requises pour utiliser Oracle Cloud Infrastructure. Vous pouvez créer ce fichier à l'aide d'une interface de ligne de commande de configuration ou manuellement à l'aide d'un éditeur de texte.

Utilisation de l'interface de ligne de commande de configuration

Exécutez l'utilitaire de ligne de commande oci setup config pour suivre le processus de première configuration. La commande vous invite à entrer les informations requises pour le fichier de configuration et les clés publiques/privées d'API. La boîte de dialogue de configuration génère une paire de clés d'API et crée le fichier de configuration.

Pour plus d'informations sur la recherche des informations requises, reportez-vous aux rubriques suivantes :

• Emplacement de l'OCID de la location et de l'OCID de l'utilisateur

• Régions et domaines de disponibilité

Configuration manuelle

Si vous voulez configurer vous-même les clés publiques et privées de l'API et écrire votre propre fichier de configuration, reportez-vous à Fichier de configuration du kit SDK et de l'interface de ligne de commande.

Créez le fichier de configuration d'administrateur de transfert de données /root/.oci/config avec la structure suivante :

[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>.

où supported regions correspond aux régions répertoriées dans Régions prises en charge de Data Transfer.

Par exemple :

[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

Pour l'administrateur de transfert de données, vous pouvez créer un seul fichier de configuration contenant différentes sections de profil avec les informations d'identification de plusieurs utilisateurs. Ensuite, utilisez l'option --profile pour spécifier le profil à utiliser dans la commande. Voici un exemple de fichier de configuration d'administrateur de transfert de données avec différentes sections de profil :

[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

Par défaut, le profil DEFAULT est utilisé pour toutes les commandes d'interface de ligne de commande. Par exemple :

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

Toutefois, vous pouvez émettre n'importe quelle commande d'interface de ligne de commande avec l'option --profile pour indiquer un autre profil d'administrateur de transfert de données. Par exemple :

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

Dans l'exemple de fichier de configuration ci-dessus, profile_name serait profile1.

Si vous avez créé deux fichiers de configuration distincts, utilisez la commande suivante pour spécifier celui à utiliser :

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

Création du fichier de configuration d'utilisateur de téléchargement de transfert de données

Le fichier de configuration config_upload_user concerne l'utilisateur de téléchargement de transfert de données, à savoir l'utilisateur IAM temporaire utilisé par Oracle pour télécharger les données en votre nom. Créez ce fichier de configuration avec la structure suivante :

[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>.

où supported regions correspond aux régions répertoriées dans Régions prises en charge de Data Transfer.

Entrées du fichier de configuration

Le tableau suivant présente les entrées de base requises pour chaque fichier de configuration et indique où obtenir les informations correspondantes.

Vous pouvez vérifier les informations d'identification d'utilisateur de téléchargement de transfert de données à l'aide de la commande suivante :

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

Configuration de notifications pour une nouvelle demande d'appliance d'import

Pour inclure des notifications de travail lors de la demande d'une appliance d'import, ajoutez l'option --setup-notifications dans la commande oci dts appliance request :

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

Configuration de notifications pour une demande d'appliance d'import existante

Afin de configurer des notifications pour une demande d'appliance d'import existante, exécutez la commande oci dts appliance setup-notifications sur l'appliance :

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

Scénarios d'échec

Cette section décrit les scénarios d'échec possibles détectés lors de la validation :

• Connectivité au service Data Transfer

  • Demande d'expiration de l'adresse de transfert de données

    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."
    }

• Connectivité à Object Storage

  • Demande d'expiration de l'adresse 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."
    }

• Utilisateurs, groupes et stratégies IAM requis pour l'utilisateur admin

  • Aucune stratégie d'autorisation Object Storage pour l'utilisateur admin

    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.

  • Aucune stratégie d'autorisation de transfert de données pour l'utilisateur admin

    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.

• Le bucket de téléchargement appartient au compartiment

  • Le bucket de téléchargement n'existe pas

    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.

  • Le bucket de téléchargement ne se trouve pas dans le compartiment

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

• Transfert de données : les utilisateurs de téléchargement peuvent créer, écraser, inspecter et supprimer des objets du bucket dans Object Storage

  • Aucune stratégie d'autorisation pour l'utilisateur de téléchargement

    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."
    }

• Habilitation pour l'appliance Data Transfer approuvée

  • Aucune habilitation au service de transfert de données

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

  • Habilitation de transfert de données non approuvée

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

• Le travail de transfert basé sur l'appliance d'import Data Transfer existe

  • Aucun travail de transfert basé sur l'appliance Data Transfer

    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'.

• Demande d'appliance associée à un travail de transfert valide

  • Aucune demande d'appliance

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