G.3 Utilitário de Agente de Migração para Linux

Antes de instalar ou usar o Agente de Migração, verifique se o sistema atende aos Requisitos do Utilitário de Agente de Migração.

G.3.1 Fazendo download e instalando o Agente de Migração em uma carga de trabalho de origem do Linux

Antes de instalar o Utilitário de Agente de Migração para Linux, verifique se a máquina de origem tem a Biblioteca C do GNU (glibc) 2.11.3 ou superior instalada.

Faça download do aplicativo com a arquitetura apropriada às suas máquinas Linux de origem. O nome do arquivo diferencia maiúsculas de minúsculas.

  • 64 bits: MigrateAgent-x86_64.tar.gz

  • 32 bits: MigrateAgent-x86.tar.gz

Para fazer download e instalar o Utilitário de Agente de Migração para Linux na carga de trabalho de origem:

  1. Efetue login na carga de trabalho de origem do Linux como usuário root.

  2. Use um dos métodos a seguir para obter o o arquivo MigrateAgent-arquitetura.tar.gz.

    Substitua arquitetura pela arquitetura apropriada (x86_64 ou x86).

    • Faça download do arquivo compactado em zip da Interface da Web:

      1. Em um browser da Web, inicie a Interface da Web do PlateSpin Migrate e efetue login.

        https://<Seu_Servidor_do_PlateSpin >/Migrate

        Substitua Seu_Servidor_do_PlateSpin pelo nome DNS ou endereço IP do servidor do PlateSpin Migrate.

      2. Clique na guia Downloads.

      3. Clique no link do aplicativo do Agente de Migração referente à plataforma Linux apropriada (x86_64 ou x86) e grave o arquivo MigrateAgent-arquitetura.tar.gz.

      -OU-

    • Use o comando wget para copiar o arquivo do Servidor do PlateSpin.

      NOTA:Se o sistema operacional no host do Servidor do PlateSpin aceita apenas conexões TLS 1.2, use wget versão 1.16.1 ou posterior na sua carga de trabalho de origem do Linux.

      1. Inicie um terminal e digite

        wget --no-check-certificate --http-user=<username> --http-password=<password> https://<Your_PlateSpin_Server>/Migrate/Downloads/MigrateAgent-<arch>.tar.gpz

        Substitua Seu_Servidor_do_PlateSpin pelo nome DNS ou endereço IP do servidor do PlateSpin Migrate. Substitua arquitetura por x86_64 ou x86.

  3. Abra o arquivo MigrateAgent-arquitetura.tar.gz no Compactador de Arquivos e extraia o diretório MigrateAgent e seu conteúdo no diretório root (/).

    Como alternativa, em um prompt do shell, digite

    tar xvf MigrateAgent-<arch>.tar.gz

    Substitua arquitetura por x86_64 ou x86.

  4. Mude para o diretório /MigrateAgent e liste seu conteúdo. Em um terminal, digite:

    cd MigrateAgent
ls

    O diretório contém um arquivo commands e o arquivo de script MigrateAgent.

  5. Para ver a Ajuda do comando, digite:

    ./MigrateAgent -h

G.3.2 Comandos do Agente de Migração para Linux

A sintaxe de execução do Utilitário de Agente de Migração é:

./MigrateAgent [Command] [-h]

A Tabela G-2 descreve as opções e os argumentos disponíveis para o comando MigrateAgent no Linux.

Tabela G-2 Opções de Comando e Argumentos do Utilitário de Agente de Migração para Linux

Uso

Descrição

Comandos

register <servidor> <usuário> [[-p senha] | [-pf <caminho-do-arquivo-de-senha>]]

Para servidor, especifique o nome DNS ou endereço IP do servidor do PlateSpin Migrate.

Para usuário, especifique o nome de usuário do Servidor do PlateSpin para um usuário no nível de administrador com direitos para adicionar uma carga de trabalho.

Para a senha, proceda de uma das seguintes maneiras:

  • Use a opção -p e digite a senha no comando referente ao nome do usuário especificado do PlateSpin.

    -p mypassword

  • Use a opção -pf para especificar o caminho para um arquivo que contém a senha referente ao nome do usuário especificado do PlateSpin.

    -pf /tmp/jsmith-password-file.txt

  • Não especifique a senha no comando. Você será solicitado a digitar a senha na linha de comando.

Exemplo:

./MigrateAgent register 10.10.10.101 jsmith -p jspwd

Registra esta máquina como uma carga de trabalho no servidor especificado. Ele também verifica se há upgrades de driver do Servidor do PlateSpin especificado.

Permite adicionar cargas de trabalho que não podem ser descobertas. Veja a seguir as diferenças entre as cargas de trabalho registradas e as cargas de trabalho descobertas:

  • As cargas de trabalho de origem registradas não armazenam as credenciais de origem.

  • Você deve usar o Agente de Migração para instalar, fazer upgrade e remover os drivers blkwatch do Linux das cargas de trabalho de origem registradas.

  • Após apagar o contrato referente a uma carga de trabalho de origem registrada, você deverá remover manualmente o OFX Controller da carga de trabalho. Consulte a Seção 42.2.2, Limpando cargas de trabalho do Linux.

status [<servidor>]

Para servidor, especifique o nome DNS ou endereço IP do servidor do PlateSpin Migrate.

Mostra o status de instalação referente aos drivers e à controladora do PlateSpin.

Se você especificar o Servidor do PlateSpin, ele verificará se há upgrades de driver do servidor.

driver-install [<servidor>]

Para servidor, especifique o nome DNS ou endereço IP do servidor do PlateSpin Migrate.

Instala o driver blkwatch apropriado do PlateSpin.

Se você especificar o Servidor do PlateSpin, ele verificará se há upgrades de driver do servidor.

driver-upgrade [<servidor>]

Para servidor, especifique o nome DNS ou endereço IP do servidor do PlateSpin Migrate.

Faz upgrade do driver blkwatch instalado do PlateSpin.

Se você especificar o Servidor do PlateSpin, ele verificará se há upgrades de driver do servidor.

driver-uninstall

Desinstala o driver blkwatch instalado do PlateSpin da carga de trabalho de origem do Linux.

configure <servidor> <novo-servidor>

Para servidor, especifique o nome DNS ou endereço IP do servidor do PlateSpin Migrate.

Para novo-servidor, especifique o novo nome DNS ou endereço IP do servidor do PlateSpin Migrate.

Exemplo:

./MigrateAgent configure 10.10.10.10 10.10.20.20

Interrompe o serviço do OFX Controller (ofxcontroller), modifica o arquivo de configuração do OFX Controller com o novo endereço e reinicia o serviço. Se você modificar o endereço IP público do Servidor do PlateSpin, deverá executar este comando em cada uma das cargas de trabalho de origem configuradas para o servidor.

Opções de Comando

NetWare 6.5

Especifica o nome DNS ou o endereço IP do Servidor do PlateSpin Migrate.

Faz download dos drivers blkwatch do servidor especificado quando você invoca as opções status, driver-install ou driver-upgrade.

user

Especifica o nome de usuário do Servidor do PlateSpin para um usuário no nível de administrador com direitos para adicionar uma carga de trabalho.

Opções

-h, --help

Exibe o uso e as opções para o comando.

-p, --password

-p <senha_do_usuário>

Especifica a senha para o nome de usuário do Servidor do PlateSpin.

Se você excluir a senha da linha de comando, o script vai solicitá-la. A senha fica oculta enquanto você a digita e não aparece na lista de processos.

Não combine essa opção com passwordfile.

-pf, --passwordfile

-pf <caminho_do_arquivodesenha>

Determina o caminho para um arquivo que contém a senha para o nome de usuário do Servidor do PlateSpin especificado.

Não combine essa opção com password.

Registro

logging.json

Contém as definições de configuração de registro no formato JSON para registrar as ações do Utilitário de Agente de Migração.

Para ver as configurações de registro, use o comando cat:

cat MigrateAgent/logging.json

Você pode editar o arquivo em um editor de texto. Defina o nível do registro mudando o valor "level:" de "DEBUG" para "INFO" ou "ERROR". Por exemplo:

"level": "DEBUG"

ou

"level": "INFO"

ou

"level": "ERROR"

Por padrão, as mensagens registradas são gravadas no arquivo MigrateAgent.log no diretório MigrateAgent. Você pode modificar a configuração de nome de arquivo de registro no arquivo logging.json.

MigrateAgent.log

Contém as mensagens registradas para o comando MigrateAgent. Para ver o registro, use o comando cat.

cat MigrateAgent.log