J.2 Antes de usar a ferramenta

Esta seção inclui as seguintes informações:

J.2.1 Pré-configurando os valores do servidor do Migrate para a CLI

Antes de começar a usar o utilitário de linha de comando, você precisa garantir que o Servidor do Migrate esteja configurado apropriadamente. Verifique a configuração no arquivo PlateSpin.Migrate.Console.exe.config, localizado no mesmo caminho que o utilitário de linha de comando. Após a instalação do Migrate, o seguinte arquivo config já deve estar preenchido com os valores.

<?xml version="1.0" encoding="utf-8"?> 
<configuration> 
  <appSettings> 
    <add key="MigrateServerURL" value="https://localhost/PlateSpinMigrate/"/> 
    <add key="ServerDomain" value=""/> 
    <add key="psuser" value="administrator"/> 
    <add key="pspassword" value="encoded_password"/> 
    <add key ="encoded" value="yes"/> 
  </appSettings> 
</configuration>

A ferramenta usa esses valores à medida que executa os comandos. Você precisa reconciliar os valores no arquivo com as configurações referentes ao Servidor do Migrate com o qual deseja se conectar.

Por padrão, o valor para a chave pspassword está em branco, e você deve especificar uma senha codificada como o valor. Para codificar a senha, use o comando encode. Para obter mais informações sobre comandos, consulte a Seção J.2.2, Familiarizando-se com os comandos.

Se você optar por fornecer senhas codificadas para carga de trabalho de origem e plataforma de destino, defina o valor da chave codificada na seguinte linha do arquivo PlateSpin.Migrate.Console.exe.config como yes (sim). Caso contrário, defina o valor como no (não).

J.2.2 Familiarizando-se com os comandos

Você pode exibir os comandos suportados na ferramenta executando-a com a opção Help ou com a opção ? no prompt de comando, da seguinte maneira:

C:\Arquivos de Programas\PlateSpin Migrate Client\CommandLine>PlateSpin.Migrate.Console.exe Help

A ferramenta exibe uma matriz que inclui informações semelhantes às que estão incluídas na tabela a seguir:

Tabela J-1 Comandos disponíveis da ferramenta CLI do Migrate

Comando	Descrição
run	Executa um arquivo .ini configurado como um job programado. Quando você adiciona o parâmetro /wait=no e o job começa a ser executado, o ID do Job é exibido na interface.
query	Executa uma consulta no job (quando você especifica um ID do Job) para exibir o status atual.
discover	Executa uma operação que faz o inventário dos detalhes de uma carga de trabalho ou computador de destino suportado em preparação a um job de migração ou de "conversão".
refresh	Atualiza um servidor descoberto.
unDiscover	Cancela a descoberta de um servidor.
imageserver	Executa operações de criação de imagens em uma carga de trabalho (ou seja, install server, uninstall server, update tools) em um servidor.
abort	Interrompe um job programado.
licenseInfo	Exibe as informações de licença do servidor do Migrate.
serversync	Prepara o servidor para a operação de Server Sync e, em seguida, executa um job de serversync usando o arquivo de configuração.
encode	Codifica a entrada de texto ou os dados no arquivo de texto.
massdiscover	Executa a descoberta em massa de cargas de trabalho de origem e de destinos. As cargas de trabalho e os destinos descobertos são exibidos tanto no Cliente do PlateSpin Migrate quanto na Interface da Web do PlateSpin Migrate Para descobrir cargas de trabalho e destinos em massa, você deve primeiro listar as cargas de trabalho e os destinos que deseja descobrir em um arquivo CSV. Para criar esse arquivo CSV, consulte o arquivo CSV de amostra em \PlateSpin Migrate Client\CommandLine\Sample INI\MassDiscovery.csv.

Ao executar qualquer um desses comandos, você deve incluir o(s) parâmetro(s) necessário(s) na linha de comando. Você também pode incluir alguns parâmetros opcionais, quando necessário. Por exemplo, o parâmetro savejob= grava o job no local padrão.

Para exibir uma lista desses parâmetros no prompt de comando, execute o comando sem nenhum parâmetro. Por exemplo, se você executar o comando discover sem parâmetros, conforme mostrado a seguir:

C:\Arquivos de Programas\PlateSpin Migrate Client\CommandLine>PlateSpin.Migrate.Console.exe discover

a interface de linha de comando exibirá o seguinte:

[discover]                      descobre um servidor
Parâmetros Necessários:  
    /machineAddress=  endereço da máquina que será descoberta 
    /userName=        o nome de usuário a ser usado 
    /password=        a senha a ser usada 
    /type=            tipo como windows, linux,vmware_esx,vmware_vcenter, 
    Parâmetros Opcionais: 
    /network=         nome da rede à qual se conectar 
    /address=         endereço do servidor ao qual se conectar 
    /psuser=          Nome de usuário usado para acessar o servidor do PlateSpin Migrate como usuário diferente do que efetuou login neste computador 
    /pspassword=      Senha usada para acessar o servidor do Platespin Migrate para o usuário diferente do que efetuou login neste computador 
    /wait=            aguardar a conclusão do job [yes,no] 
    /clusterName=     nome do cluster que será descoberto 
    /verbose=         modo verboso para saída [on,off] 
    /output=          o arquivo de saída 
    /format=          o formato de saída da exibição em [text,html,xml] 
    /sslcertificatewarnings=      Se você deseja Ignorar ou Impor Avisos de Certificado SSL [Ignore| Enforce]

NOTA:Você deve se familiarizar com os diversos comandos da CLI e seus respectivos parâmetros obrigatórios e opcionais.

Sintaxe de linha de comando

Se você tivesse que executar o comando de descoberta (que também é um job), usaria uma sintaxe semelhante a este exemplo, no prompt de comando:

C:\Arquivos de Programas\PlateSpin Migrate Client\CommandLine>PlateSpin.Migrate.Console.exe discover /machineaddress=10.10.8.100 /username=administrator /password=password /type=windows /wait=no

Observe que todos os parâmetros obrigatórios e um parâmetro opcional estão incluídos nesse exemplo.

Quando o comando de descoberta (job) é iniciado, a ferramenta CLI exibe o ID do job, semelhante a este exemplo:

8be8d306-7665-4869-9795-a9dbb3ce1471

Você pode aproveitar esse ID para saber o status do job, basta usar o comando query da seguinte forma:

C:\Arquivos de Programas\PlateSpin Migrate Client\CommandLine>PlateSpin.Migrate.Console.exe query /id=8be8d306-7665-4869-9795-a9dbb3ce1471

O comando de consulta gera um relatório de status que inclui todos os detalhes do job. Trata-se do mesmo tipo de informação que você pode ver na tela Jobs do Cliente do Migrate.