Utilitário de Transferência de Dados

Este tópico descreve como instalar e configurar o Utilitário de Transferência de Dados para uso em transferências de dados baseadas em disco. Além disso, este tópico descreve a sintaxe dos comandos do Utilitário de Transferência de Dados.

Importante

Nesta release, o Utilitário de Transferência de Dados só suporta transferências de dados baseadas em disco. O uso do Utilitário de Transferência de Dados para transferências baseadas em appliance foi substituído pela CLI (interface de linha de comando) do Oracle Cloud Infrastructure.

O Utilitário de Transferência de Dados é licenciado de acordo com a Licença Permissiva Universal 1.0 e a Licença Apache 2.0. O conteúdo de terceiros é licenciado separadamente, conforme descrito no código.

Observação

O Utilitário de Transferência de Dados deve ser executado como o usuário raiz.

Pré-requisitos

Para instalar e usar o Utilitário de Transferência de Dados, obtenha o seguinte:

• Uma conta no Oracle Cloud Infrastructure.

• Usuários e grupos obrigatórios do Oracle Cloud Infrastructure com as políticas do IAM obrigatórias.

  Consulte para obter detalhes.

• Uma máquina Host de Dados com os seguintes itens instalados:

  • Oracle Linux 6 ou mais recente, Ubuntu 14.04 ou mais recente, ou SUSE 11 ou mais recente. Todos os sistemas operacionais Linux devem ter a capacidade de criar um sistema de arquivos EXT.

    Observação
    
    Não há suporte para máquinas baseadas no Windows em jobs de transferência baseados em disco.

  • Java 1.8 ou Java 1.11

  • hdparm 9.0 ou mais recente

  • Cryptsetup 1.2.0 ou mais recente

• Acesso ao firewall: Se você tiver um firewall restritivo no ambiente em que estiver usando o Utilitário de Transferência de Dados, talvez seja necessário abrir a configuração do firewall para os seguintes intervalos de endereços IP: 140.91.0.0/16.

  Você também precisa abrir o acesso aos intervalos de endereços IP de armazenamento de objetos: 134.70.0.0/17.

Instalando o Utilitário de Transferência de Arquivos

Faça download do instalador do Utilitário de Transferência de Dados correspondente ao sistema operacional do seu Host de Dados e instale-o.

Configurando o Utilitário de Transferência de Dados

Antes de usar o Utilitário de Transferência de Dados, você deve criar um diretório base do Oracle Cloud Infrastructure e dois arquivos de configuração com as credenciais necessárias. Um arquivo de configuração é para o administrador de transferência de dados, que é o usuário do IAM com autorização e permissões para criar e gerenciar jobs de transferência. O outro arquivo de configuração é para o usuário de upload da transferência de dados, que é o usuário temporário do IAM autorizado pela Oracle a fazer upload de seus dados em seu nome.

Diretório Base de Transferência de Dados

Crie um diretório base do Oracle Cloud Infrastructure:

mkdir /root/.oci/

Arquivo de Configuração do Administrador de Transferência de Dados

Crie um arquivo de configuração do administrador de transferência de dados /root/.oci/config com a seguinte estrutura:

[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 exemplo:

[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 o administrador de transferência de dados, você pode criar um único arquivo de configuração que contenha diversas seções de perfil com as credenciais de vários usuários. Em seguida, use a opção ‑‑profile para especificar qual perfil será usado no comando. Aqui está um exemplo de um arquivo de configuração do administrador de transferência de dados com diversas seções 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

Por padrão, o perfil DEFAULT é usado para todos os comandos do Utilitário de Transferência de Dados. Por exemplo:

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

Em vez disso, você pode emitir qualquer comando do Utilitário de Transferência de Dados com a opção --profile para especificar outro perfil de administrador de transferência de dados. Por exemplo:

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

Usando o exemplo de arquivo de configuração acima, <profile_name> seria profile1.

Arquivo de Configuração para Usuário de Upload de Transferência de Dados

Crie um arquivo de configuração /root/.oci/config_upload_user do usuário de upload de transferência de dados com a seguinte estrutura:

[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 exemplo:

[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

Não há suporte para a criação de um arquivo de configuração do usuário de upload com vários perfis.

Entradas do Arquivo de Configuração

A tabela a seguir lista as entradas básicas necessárias para cada arquivo de configuração e onde obter as informações de cada entrada.

Você pode verificar as credenciais do usuário de upload de transferência de dados usando o seguinte comando:

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

Localização do Arquivo de Configuração

A localização dos arquivos de configuração é /root/.oci/config.

Usando o Utilitário de Transferência de Dados

Esta seção apresenta uma visão geral da sintaxe do Utilitário de Transferência de Dados.

Importante

O Utilitário de Transferência de Dados deve ser executado como o usuário root.

Você pode especificar opções de comando do Utilitário de Transferência de Dados usando os seguintes comandos:

• --option <value> ou
• --option=<value>

Sintaxe

A sintaxe básica do Utilitário de Transferência de Dados é:

dts <resource> <action> <options>

Essa sintaxe é aplicada ao seguinte:

Os exemplos a seguir mostram comandos típicos do Utilitário de Transferência de Dados para criar um job de transferência.

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

Ou:

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

Descobrindo a Versão Instalada do Utilitário de Transferência de Dados

Você pode obter a versão instalada do Utilitário de Transferência de Dados usando --version ou -v. Por exemplo:

dts --version

0.6.183

Acessando a Ajuda do Utilitário de Transferência de Dados

Todos os comandos de ajuda do Utilitário de Transferência de Dados têm um componente de ajuda associado que você pode acessar da linha de comando. Para exibir a ajuda, informe qualquer comando seguido pela opção --help ou -h. Por exemplo:

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.

Quando você executa a opção de ajuda (--help ou -h) para um comando especificado, todos os comandos subordinados e opções desse nível do Utilitário de Transferência de Dados são exibidos. Se você quiser acessar a ajuda do Utilitário de Transferência de Dados para um comando subordinado específico, inclua-o na string do Utilitário de Transferência de Dados, por exemplo:

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.

O Que Vem a Seguir

Agora você está pronto para executar transferências de dados baseadas em disco. Consulte Copiando os Dados para o Disco de Importação