G.2 Utilitário de Agente de Migração para Windows

Seção G.2.1, Fazendo download e instalando o Agente de Migração em uma carga de trabalho de origem do Windows
Seção G.2.2, Comandos do Agente de Migração para Windows

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

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

Efetue login na máquina Windows de origem como usuário Administrador.
Em um browser da Web, inicie a Interface da Web do PlateSpin Migrate e efetue login.
Clique na guia Downloads.
Clique no link do aplicativo Agente de Migração para a plataforma de destino Windows e grave o arquivo MigrateAgent.cli.exe compactado.
Extraia o conteúdo do arquivo para acessar o arquivo executável.
(Opcional) Para ver a Ajuda do Agente de Migração, digite
```
MigrateAgent.cli.exe -h
```

G.2.2 Comandos do Agente de Migração para Windows

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

MigrateAgent.cli.exe {command} [command_option] [/psserver=%IP%]

A Tabela G-1 descreve os comandos, as opções de comando e o switch disponíveis para o comando MigrateAgent.cli.exe no Windows.

Tabela G-1 Comandos, Opções de Comando e Switch do Utilitário de Agente de Migração para Windows

Uso	Descrição
Comandos
h \| ? \| help	Exibe o uso e as opções para o comando.
logs \| view-logs	Abre o diretório de registro do aplicativo.
reg \| register /reg /psserver=%IP% /username=<nomedeusuário> [[ /password=<senha>] \| [/pwdfile=<caminho-para-arquivo-de-senha>]] Se você não especificar a senha ou um caminho para um arquivo que contém a senha, será solicitado a fornecê-la. A senha fica oculta enquanto você a digita e não aparece na lista de processos. Exemplo: MigrateAgent.cli.exe /register /psserver=10.10.10.101 /username=jsmith /password=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 BBT (Block-based Transfer – Transferência com Base em Blocos) 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. Para remover o OFX Controller da carga de trabalho, consulte o Artigo da Base de Dados de Conhecimento.
status /status [/psserver=%IP%]	Mostra o status de instalação referente aos drivers e à controladora do PlateSpin nesta carga de trabalho. Se você especificar o Servidor do PlateSpin, ele verificará se há upgrades de driver do servidor.
din \| driver-install /din [/psserver=%IP%]	Instala os drivers do PlateSpin. NOTA:Antes de instalar drivers de transferência com base em blocos em cargas de trabalho de origem do Windows, verifique se você aplicou as atualizações mais recentes do Windows à carga de trabalho. Se você especificar o Servidor do PlateSpin, ele verificará se há upgrades de driver do servidor.
dup \| driver-upgrade /dup [/psserver=%IP%]	Atualiza os drivers do PlateSpin. Se você especificar o Servidor do PlateSpin, ele verificará se há upgrades de driver do servidor.
dun \| driver-uninstall [/dun /psserver=%IP%]	Desinstala os drivers do PlateSpin.
con \| config /con /setting=<nome_da_configuração>:<valor> Exemplo: migrateagent.cli.exe /config /setting=psserver:10.10.10.202	Especifica o nome da configuração e o valor para mudar no arquivo de configuração nesta carga de trabalho. A opção psserver interrompe o serviço do OFX Controller (ofxcontroller), modifica o arquivo OfxController.exe.config com o novo endereço IP 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.
Switch
/psserver=%IP%	Especifica o endereço IPv4 do Servidor do PlateSpin. Faz download dos drivers de transferência com base em blocos do servidor especificado quando você invoca as opções status, driver-install ou driver-upgrade.
Opções de Comando
nome de usuário /username=value	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.
password \| pwd \| p /password= value	Determina a senha para o nome de usuário do Servidor do PlateSpin especificado. 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 pwdfile.
pwdfile \| pf /pwdfile=value	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.
setting /setting=<nome_da_configuração>:<valor>	Especifica o nome e o valor da configuração que será modificada. Os nomes de configuração suportados são: psserver altAddress heartbeat

Uso

Descrição

Comandos

h | ? | help

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

logs | view-logs

Abre o diretório de registro do aplicativo.

reg | register

/reg /psserver=%IP% /username=<nomedeusuário> [[ /password=<senha>] | [/pwdfile=<caminho-para-arquivo-de-senha>]]

Se você não especificar a senha ou um caminho para um arquivo que contém a senha, será solicitado a fornecê-la. A senha fica oculta enquanto você a digita e não aparece na lista de processos.

Exemplo:

MigrateAgent.cli.exe /register /psserver=10.10.10.101 /username=jsmith /password=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 BBT (Block-based Transfer – Transferência com Base em Blocos) 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. Para remover o OFX Controller da carga de trabalho, consulte o Artigo da Base de Dados de Conhecimento.

status

/status [/psserver=%IP%]

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

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

din | driver-install

/din [/psserver=%IP%]

Instala os drivers do PlateSpin.

NOTA:Antes de instalar drivers de transferência com base em blocos em cargas de trabalho de origem do Windows, verifique se você aplicou as atualizações mais recentes do Windows à carga de trabalho.

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

dup | driver-upgrade

/dup [/psserver=%IP%]

Atualiza os drivers do PlateSpin.

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

dun | driver-uninstall

[/dun /psserver=%IP%]

Desinstala os drivers do PlateSpin.

con | config

/con /setting=<nome_da_configuração>:<valor>

Exemplo:

migrateagent.cli.exe /config /setting=psserver:10.10.10.202

Especifica o nome da configuração e o valor para mudar no arquivo de configuração nesta carga de trabalho.

A opção psserver interrompe o serviço do OFX Controller (ofxcontroller), modifica o arquivo OfxController.exe.config com o novo endereço IP 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.

Switch

/psserver=%IP%

Especifica o endereço IPv4 do Servidor do PlateSpin.

Faz download dos drivers de transferência com base em blocos do servidor especificado quando você invoca as opções status, driver-install ou driver-upgrade.

Opções de Comando

nome de usuário

/username=value

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.

password | pwd | p

/password= value

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

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

pwdfile | pf

/pwdfile=value

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.

setting

/setting=<nome_da_configuração>:<valor>

Especifica o nome e o valor da configuração que será modificada.

Os nomes de configuração suportados são:

psserver
altAddress
heartbeat