Migração de CLI de uma instalação do vCenter Server de Windows para um dispositivo

Você pode usar o instalador da CLI para migrar automaticamente um vCenter Server ou Platform Services Controller de Windows para um dispositivo do.

O arquivo ISO do instalador contém modelos de exemplo de arquivos JSON que contêm os parâmetros de configuração mínimos necessários para migrar uma instância vCenter Server ou Platform Services Controller de Windows para um dispositivo. Os modelos de exemplo estão localizados no diretório vcsa-cli-installer/templates/migrate.

Observação: Antes de migrar uma implantação do vCenter Server com um Platform Services Controller externo, você deve primeiro convergir o Platform Services Controller externo para um Platform Services Controller incorporado e, em seguida, realizar a migração. Consulte o artigo da Base de conhecimento KB 68137.

Tarefas da CLI para migrar sua instalação do vCenter Server de Windows para um dispositivo do:

1. Baixar e montar o instalador do vCenter Server.
2. Baixar e executar VMware Migration Assistant na máquina de origem Windows.
3. Preparar arquivos de configuração JSON para migração de CLI.
4. Execute a pré-verificação antes de realizar a migração.
5. Realizar uma migração de CLI de vCenter Server de Windows para um dispositivo.

Você pode executar o instalador da CLI várias vezes com diferentes arquivos JSON para realizar várias migrações da CLI ou pode executar as migrações da CLI simultaneamente em um modo de lote.

Importante: O nome de usuário que você usa para fazer login na máquina a partir da qual deseja executar o instalador da CLI, o caminho para o instalador do appliance do vCenter Server, o caminho para o arquivo de configuração JSON e os valores de string no arquivo de configuração JSON, incluindo as senhas, deve conter apenas caracteres ASCII. Caracteres ASCII estendidos e não ASCII não são suportados.

Preparar arquivos de configuração JSON para migração de CLI

Ao usar a CLI para migrar uma instalação de origem vCenter Server para um destino vCenter Server Appliance, você deve preparar um modelo JSON com os valores de configuração para o novo dispositivo.

Você pode migrar instâncias vCenter Server ou Platform Services Controller de Windows para um vCenter Server Appliance definindo valores para os parâmetros de configuração nos modelos que estão disponíveis no arquivo ISO do instalador. Os parâmetros de configuração que não estão incluídos nos modelos são definidos com seus valores padrão. Você pode adicionar parâmetros de configuração nos modelos para definir seus valores para sua especificação de migração.

O diretório vcsa-cli-installer/templates/migrate contém modelos de migração de exemplo para a migração da CLI do vCenter Server 6.7 para um dispositivo.

Para obter uma lista completa dos parâmetros de configuração e suas descrições, navegue até o subdiretório do instalador do seu sistema operacional e execute o comando vcsa-deploy migrate --template-help.

Importante: O nome de usuário que você usa para fazer login na máquina a partir da qual deseja executar o instalador da CLI, o caminho para o instalador vCenter Server Appliance, o caminho para o arquivo de configuração JSON e os valores de string no arquivo de configuração JSON, incluindo as senhas, devem conter apenas caracteres ASCII. Caracteres ASCII estendidos e não ASCII não são suportados.

Para realizar a migração em lote, coloque os modelos JSON que definem sua implantação em um único diretório. Quando invocado, o instalador da CLI migra sua implantação existente para a nova versão vCenter Server usando a topologia definida nos modelos JSON.

Pré-requisitos

Verifique se o seu ambiente atende aos requisitos de migração. Consulte Requisitos do sistema para migrar implantações de vCenter Server para implantações de dispositivo de vCenter Server,

Prepare seu ambiente para migração. Consulte Preparação para a migração.

Procedimento

1. Abra a subpasta migrate no diretório vcsa-cli-installer/templates.
2. Copie o modelo de migração da subpasta migrar para o seu workspace. Para o vCenter Server 6.7, use a pasta migrate/winvc6.7/.
3. Abra o arquivo de modelo para seu caso de uso em um editor de texto.
   Para garantir a sintaxe correta do seu arquivo de configuração JSON, use um editor JSON.
4. Preencha os valores para os parâmetros de configuração necessários e, opcionalmente, insira parâmetros adicionais e seus valores.
   Importante: Para definir um valor que contenha o caractere de barra invertida (\) ou aspas ("), você deve preceder o caractere com o caractere de barra invertida (\). Por exemplo, "password":"my\"password" define a senha my"password, "image":"C:\\vmware\\vcsa" define o caminho C:\vmware\vcsa.

   Os valores booleanos devem conter apenas caracteres minúsculos. Pode ser true ou false. Por exemplo, "ssh_enable":false

5. Salve no formato UTF-8 e feche o arquivo.

Resultados

Seu arquivo está pronto para uso na migração.

O que Fazer Depois

Você pode criar e salvar quantos modelos forem necessários para seu ambiente específico. Quando o modelo estiver pronto, execute a pré-verificação antes de usá-lo para executar a migração. Consulte Executar uma pré-verificação antes de uma migração de CLI para vCenter Server Appliance.

Modelos JSON para migração de CLI de vCenter Server para Windows

O instalador do vCenter Server contém modelos JSON que estão localizados no diretório vcsa-cli-installer/templates. Na subpasta migrar, você pode encontrar os modelos JSON com os parâmetros de configuração mínimos para todos os tipos de migração.

Tabela 1. Modelos JSON de migração incluídos no instalador do vCenter Server

Localização	Modelo	Descrição
vcsa-cli-installer\templates\migrate\vcsa\winvc6.7	embedded_win_vc_to_embedded_vCSA_on_ESXi.json	Contém os parâmetros de configuração mínimos necessários para migrar o vCenter Server 6.7 em Windows com um Platform Services Controller incorporado para o dispositivo vCenter Server 8.0 em um host ESXi.
	embedded_win_vc_to_embedded_vCSA_on_VC.json	Contém os parâmetros de configuração mínimos necessários para migrar o vCenter Server 6.7 no Windows com um Platform Services Controller incorporado para o vCenter Server Appliance8.0 em uma instância do vCenter Server.
	win_vc_to_vCSA_on_ESXi.json	Contém os parâmetros de configuração mínimos necessários para migrar o vCenter Server 6.7 em Windows com um Platform Services Controller externo para o dispositivo vCenter Server 8.0 em um host ESXi.
	win_vc_to_vCSA_on_VC.json.json	Contém os parâmetros de configuração mínimos necessários para migrar o vCenter Server 6.7 em Windows com um Platform Services Controller externo para o dispositivo vCenter Server 8.0 em uma instância do vCenter Server.

Sobre a migração de um vCenter Server para Windows com um Platform Services Controller externo usando a CLI

Ao migrar um vCenter Server para Windows que usa um Platform Services Controller externo, ele é convertido em uma instância de vCenter Server com esses serviços incorporados no dispositivo do. Por esse motivo, você deve especificar os parâmetros do parceiro de replicação nos modelos de migração JSON.

Ao migrar um vCenter Server para Windows que usa um Platform Services Controller externo, você deve especificar os parâmetros do parceiro de replicação no modelo de migração JSON. Esses parâmetros indicam se a migração é para um dos seguintes cenários de migração vCenter Server e Platform Services Controller.

• Uma única instância vCenter Server e uma única Platform Services Controller em um domínio SSO.
• A primeira instância vCenter Server e Platform Services Controller em um domínio SSO que contém mais de um vCenter Server.
• Replicando instâncias do vCenter Server e do Platform Services Controller em um domínio de SSO, que você deve apontar para uma instância do vCenter Server 7.0 existente como o parceiro de replicação.

Importante: Antes de migrar uma implantação do vCenter Server usando um Platform Services Controller externo, você deve primeiro convergir o Platform Services Controller externo para um Platform Services Controller incorporado e, em seguida, realizar a migração. Para obter mais informações, consulte Remoção de Platform Services Controller.

As implantações que usam um Platform Services Controller externo geralmente são chamadas de MxNimplantação, em que M representa o vCenter Server e N representa o Platform Services Controller externo. Ao representar várias instâncias de Platform Services Controller e M em um domínio, isso é expresso como nxNn, em que nvCenter Server é o número de instâncias. Por exemplo, M2xN2 indica duas instâncias vCenter Server e duas instâncias Platform Services Controller dentro do mesmo domínio. Ao migrar essa implantação, migre primeiro uma instância para a versão 8.0 e, em seguida, migre a segunda instância para 8.0, especificando a primeira das duas instâncias como o parceiro de replicação.

Os parâmetros de replicação no modelo de migração JSON estão localizados na seção sso do modelo e são first_instance e replication_partner_hostname.

Nome do parâmetro	Descrição
first_instance	O parâmetro first_instance identifica o vCenter Server como a primeira instância no seu domínio de SSO do vCenter Server ou como um parceiro de replicação. Se for a primeira instância de vCenter Server, defina first_instance como true Para instâncias adicionais de vCenter Server no mesmo domínio de SSO, defina first_instance como false.
replication_partner_hostname*	Se você definir first_instance como false, deverá especificar o FQDN ou o endereço IP de um vCenter Server que já foi migrado para a versão 8.0 e cujo PSC externo foi convergido para o dispositivo vCenter Server.

Quando você executa a migração da CLI de uma única instância vCenter Server para Windows que usa um Platform Services Controller externo, o processo é o seguinte:

1. Migre o vCenter Server em sua topologia usando o modelo win_vc_to_vCSA_on_ESXi.json ao migrar em ESXi ou o modelo win_vc_to_vCSA_on_VC.json ao migrar em uma implantação de vCenter Server.

2. Para uma topologia de implantação que consiste em um único vCenter Server e um Platform Services Controller (uma implantação de M1xN1), edite a seção sso do modelo de forma que o parâmetro first_instance seja definido como true e remova o parâmetro replication_partner_hostname.

   "sso": {
   "__comments": [ This is the first instance (M1) vCenter Server management node, with "first_instance" set to "true" and "replication_partner_hostname" removed.
   ],
   "first_instance": true
   }

3. Especifique os parâmetros de configuração restantes no modelo JSON e migre vCenter Server para a versão 8.0 usando a CLI. Consulte Realizar uma migração de CLI de vCenter Server de Windows para um dispositivo.
4. Após a migração bem-sucedida de vCenter Server, descomissione o Platform Services Controller. Consulte Encerrar o Platform Services Controller.
   Importante: Descomissione as instâncias Platform Services Controller somente após migrar e convergir todas as instâncias vCenter Server em sua topologia.

Para uma implantação que consiste em duas ou mais instâncias vCenter Server e Platform Services Controller (uma implantação M2xN2), migre primeiro a instância M1 vCenter Server para a versão 8.0 e, em seguida, migre a segunda, replicando vCenter Server } instância.

1. Migre o vCenter Server em sua topologia usando o modelo win_vc_to_vCSA_on_ESXi.json ao migrar em ESXi ou o modelo win_vc_to_vCSA_on_VC.json ao migrar em uma implantação de vCenter Server.

2. Para a primeira instância de vCenter Server ( M1), edite a seção sso do modelo de forma que o parâmetro first_instance seja definido como true e remova o parâmetro replication_partner_hostname.

   "sso": {
   "__comments": [ This is the first instance (M1) vCenter Server management node, with "first_instance" set to "true" and "replication_partner_hostname" removed.
   ],
   "first_instance": true
   }

3. Para a instância vCenter Server restante ( M2), edite a seção sso do modelo de forma que o parâmetro first_instance seja definido como false e forneça o FQDN ou o endereço IP da instância vCenter Server para no qual você deseja replicar o segundo nó. O parceiro de replicação é a primeira instância vCenter Server ( M1) que você migrou para a versão 8.0, que convergiu com sua instância Platform Services Controller.

   "sso": {
   "__comments": [ This is the second instance (M2) vCenter Server management node, with "first_instance" set to "false" and "replication_partner_hostname" set to the hostname of the replication partner.],
   "first_instance": false,
   "replication_partner_hostname": "FQDN_or_IP_address"

4. Especifique os parâmetros de configuração restantes nos modelos JSON e migre vCenter Server para a versão 8.0 usando a CLI. Consulte Realizar uma migração de CLI de vCenter Server de Windows para um dispositivo.
5. Depois de migrar com êxito todas as instâncias vCenter Server na topologia, descomissione as instâncias Platform Services Controller. Consulte Encerrar o Platform Services Controller.
   Importante: Descomissione as instâncias Platform Services Controller somente após migrar e convergir todas as instâncias vCenter Server em sua topologia.

Parâmetros de configuração da migração

Ao usar o instalador da CLI para migrar sua instalação do vCenter Server para um dispositivo, você deve fornecer os parâmetros com valores para sua especificação de migração.

A tabela lista os parâmetros de configuração que você usa para fornecer dados de entrada para a origem vCenter Server.

Importante: O caminho para o instalador do appliance do vCenter Server, o caminho para o arquivo de configuração JSON e os valores de string no arquivo de configuração JSON, incluindo senhas, devem conter apenas caracteres ASCII. Caracteres ASCII estendidos e não ASCII não são suportados.

Para definir um valor que contenha o caractere de barra invertida (\) ou aspas ("), você deve preceder o caractere com o caractere de barra invertida (\). Por exemplo, "password":"my\"password" define a senha my"password, "image":"C:\\vmware\\vcsa" define o caminho C:\vmware\vcsa.

Os valores booleanos devem conter apenas caracteres minúsculos. Pode ser true ou false. Por exemplo, "ssh_enable":false.

Seções e subseções de parâmetros de configuração nos modelos de migração JSON

Os parâmetros de configuração nos modelos de migração JSON são organizados em seções e subseções.

Tabela 2. Seções e subseções de parâmetros de configuração nos modelos de migração JSON

Seção	Subseção	Descrição
new_vcsa - descreve o appliance de destino para o qual você deseja migrar	esxi	Use apenas se você quiser implantar o dispositivo diretamente em um host ESXi. Contém os parâmetros de configuração que descrevem o host ESXi de destino. Observação: Você deve preencher a subseção esxi ou vc.
	vc	Use somente se você quiser implantar o dispositivo no inventário de uma instância vCenter Server. Contém os parâmetros de configuração que descrevem o host ESXi de destino ou o cluster DRS do inventário vCenter Server. Observação: Você deve preencher a subseção vc ou esxi.
	appliance	Contém os parâmetros de configuração que descrevem o dispositivo do.
	os	Contém os parâmetros de configuração que descrevem as configurações do sistema operacional para o dispositivo do.
	ovftool_arguments	Subseção opcional para adicionar argumentos arbitrários e seus valores ao comando da Ferramenta OVF que o instalador gera. Importante: O instalador do appliance do vCenter Server não valida os parâmetros de configuração na subseção ovftool_arguments. Se você definir argumentos que a ferramenta OVF não reconhece, a implantação poderá falhar.
	temporary_network	Contém os parâmetros de configuração que descrevem a rede temporária para migrar os dados da origem para o novo dispositivo de destino.
	user-options	Use somente quando a origem for uma instância vCenter Server. Contém os parâmetros de configuração que permitem controlar aspectos do processo de migração para componentes específicos.
source_vc - descreve a origem vCenter Server, vCenter Single Sign-On ou Platform Services Controller	vc_win	Contém os parâmetros de configuração que descrevem a instalação de origem Windows de vCenter Server ou Platform Services Controller
	run_migration_assistant	Use somente se a instalação de origem do Windows estiver em execução como uma máquina virtual e você quiser automatizar a chamada do Assistente de Migração. Para uma instalação de origem Windows em execução em uma máquina física, ou se você estiver executando o Assistente de Migração manualmente na máquina Windows de origem, copie e cole o valor da impressão digital da saída do console do Assistente de Migração na máquina de origem para o arquivo migration_ssl_thumbprint key na subseção vc_win e remova a seção run_migration_assistant.
ceip - descreve a participação no VMware Programa de Aperfeiçoamento da Experiência do Cliente (CEIP)	settings	Contém apenas o parâmetro de configuração ceip_enabled para ingressar ou não no VMware Programa de Aperfeiçoamento da Experiência do Usuário (CEIP). Obrigatório apenas se você estiver implantando um dispositivo vCenter Server. Observação: Se definido como true, você deverá executar o comando de implantação da CLI com o argumento --acknowledge-ceip. Para obter informações sobre o CEIP, consulte a seção Configurando o Programa de Aperfeiçoamento da Experiência do Usuário em vCenter Server e gerenciamento de host.

Parâmetros de configuração na seção new_vcsa

Tabela 3. Parâmetros de configuração na seção new_vcsa, subseção esxi

Nome	Tipo	Descrição
hostname	seqüência de caracteres	O endereço IP ou FQDN do host ESXi de destino no qual você deseja implantar o dispositivo do.
username	seqüência de caracteres	Um nome de usuário com privilégios administrativos no host ESXi de destino, por exemplo, root.
password	seqüência de caracteres	A senha do usuário com privilégios administrativos no host ESXi de destino.
deployment_network	seqüência de caracteres	O nome da rede à qual o dispositivo deve ser conectado. Observação: A rede deve estar acessível a partir do host ESXi de destino. Ignorado se o host de destino ESXi tiver apenas uma rede.
datastore	seqüência de caracteres	O nome do datastore no qual você deseja armazenar todos os arquivos de configuração da máquina virtual e os discos virtuais do dispositivo do. Observação: O armazenamento de dados deve estar acessível a partir do host ESXi. O armazenamento de dados deve ter espaço livre suficiente.
port	inteiro	O número da porta do host ESXi. A porta padrão é 443.
ssl_certificate_verification	seqüência de caracteres	A CLI verifica se o certificado de segurança de um servidor foi assinado por uma Autoridade de Certificação (CA) e estabelece uma conexão segura. Se o certificado for autoassinado, a CLI interromperá o upgrade, a menos que você especifique uma das seguintes opções de configuração de certificado SSL. Especifique a impressão digital do certificado Secure Hash Algorithm 1 (SHA-1). Uma impressão digital de certificado é uma cadeia de caracteres hexadecimal que identifica exclusivamente um certificado. A impressão digital é calculada a partir do conteúdo do certificado usando um algoritmo de impressão digital. "thumbprint": "certificate SHA-1 thumbprint" Defina verification_mode como NONE. "verification_mode": "NONE" Se você estiver se conectando a um servidor com um certificado autoassinado e não conseguir especificar a impressão digital do certificado SHA-1 ou definir o modo de verificação como NONE, a CLI exibirá a impressão digital do certificado autoassinado do servidor e solicitará que você aceite ou rejeite a impressão digital do certificado. Você também pode especificar que a CLI ignore o autoassinado usando o parâmetro de comando vcsa-deploy upgrade --no-ssl-certificate-validation. Consulte Sintaxe do comando de migração da CLI .

Tabela 4. Parâmetros de configuração na seção new_vcsa, subseção vc

Nome	Tipo	Descrição
hostname	seqüência de caracteres	O endereço IP ou FQDN da instância vCenter Server de destino na qual você deseja implantar o dispositivo do.
username	seqüência de caracteres	vCenter Single Sign-On nome de usuário administrador na instância vCenter Server de destino, por exemplo, [email protected].
password	seqüência de caracteres	A senha do usuário administrador vCenter Single Sign-On na instância vCenter Server de destino.
deployment_network	seqüência de caracteres	O nome da rede à qual o dispositivo deve ser conectado. Observação: A rede deve estar acessível a partir do host ESXi de destino ou do cluster DRS no qual você deseja implantar o dispositivo do. Ignorado se o host ESXi ou cluster DRS de destino tiver apenas uma rede.
datacenter	string ou array	O centro de dados vCenter Server que contém o host ESXi de destino ou o cluster DRS no qual você deseja implantar o dispositivo do. Se o centro de dados estiver localizado em uma pasta ou em uma estrutura de pastas, o valor deverá ser uma lista de cadeias de caracteres separadas por vírgula ou uma lista separada por vírgulas como uma única cadeia de caracteres. Por exemplo, ["parent_folder", "child_folder", "datacenter_name"] ou "parent_folder, child_folder, datacenter_name" Se não houver um caminho de pasta no centro de dados, use apenas o nome do centro de dados. Por exemplo, ["datacenter_name"] ou "datacenter_name" Observação: O valor faz distinção entre maiúsculas e minúsculas.
datastore	seqüência de caracteres	O nome do datastore no qual você deseja armazenar todos os arquivos de configuração da máquina virtual e os discos virtuais do dispositivo do. Observação: O armazenamento de dados deve estar acessível a partir do host ESXi de destino ou do cluster DRS. O armazenamento de dados deve ter pelo menos 25 GB de espaço livre.
port	inteiro	O número da porta do vCenter Server. A porta padrão é 443.
target	string ou array	O cluster de destino, o host ESXi ou o pool de recursos no qual você deseja implantar o novo dispositivo. Esse é o destino que você especificou com o parâmetro datacenter. Esse caminho deve terminar com um nome de cluster, nome de host ESXi ou nome de pool de recursos. Importante: Você deve fornecer o nome que é exibido no inventário vCenter Server. Por exemplo, se o nome do host ESXi de destino for um endereço IP no inventário vCenter Server, você não poderá fornecer um FQDN. Observação: Todos os valores fazem distinção entre maiúsculas e minúsculas. Se você quiser que o dispositivo implantado seja listado em um local diferente na hierarquia do centro de dados, use o parâmetro vm_folder descrito posteriormente nesta seção. Se o cluster de destino, o host ESXi ou o pool de recursos estiver localizado em uma pasta ou estrutura de pastas, o valor deverá ser uma lista de cadeias de caracteres separadas por vírgula ou uma lista separada por vírgulas como uma única cadeia de caracteres. Por exemplo, ["parent_folder", "child_folder", "esxi-host.domain.com"] ou "parent_folder, child_folder, esxi-host.domain.com" Se o host ESXi de destino fizer parte de um cluster, use uma lista de cadeias de caracteres separadas por vírgula ou uma lista separada por vírgulas como uma única cadeia de caracteres para fornecer o caminho. Por exemplo, ["cluster_name", "esxi-host.domain.com"] ou "cluster_name, esxi-host.domain.com" Se você estiver implantando em um pool de recursos, inclua o rótulo Resources antes do nome do pool de recursos. Por exemplo: ["cluster_name", "Resources", "resource_pool_name"] Observação: As pré-verificações verificam apenas a memória do pool de recursos.
vm_folder	seqüência de caracteres	Opcional. O nome da pasta da máquina virtual (VM) à qual adicionar o dispositivo do.

Tabela 5. Parâmetros de configuração na seção new_vcsa, subseção appliance

Nome	Tipo	Descrição
thin_disk_mode	Booleano	Defina como true para implantar o appliance do com discos virtuais thin.
deployment_option	seqüência de caracteres	O tamanho do dispositivo. Defina como tiny se você quiser implantar um dispositivo vCenter Server para até 10 hosts e 100 máquinas virtuais com o tamanho de armazenamento padrão. Implementa um dispositivo com 2 CPUs, 10 GB de memória e 300 GB de armazenamento. Defina como tiny-lstorage se você quiser implantar um dispositivo vCenter Server para até 10 hosts e 100 máquinas virtuais com o tamanho de armazenamento grande. Implementa um dispositivo com 2 CPUs, 10 GB de memória e 825 GB de armazenamento. Defina como tiny-xlstorage se você quiser implantar um dispositivo vCenter Server para até 10 hosts e 100 máquinas virtuais com o tamanho de armazenamento extragrande. Implementa um dispositivo com 2 CPUs, 10 GB de memória e 1.700 GB de armazenamento. Defina como small se você quiser implantar um dispositivo vCenter Server para até 100 hosts e 1.000 máquinas virtuais com o tamanho de armazenamento padrão. Implementa um dispositivo com 4 CPUs, 16 GB de memória e 340 GB de armazenamento. Defina como small-lstorage se você quiser implantar um dispositivo vCenter Server para até 100 hosts e 1.000 máquinas virtuais com o tamanho de armazenamento grande. Implementa um dispositivo com 4 CPUs, 16 GB de memória e 870 GB de armazenamento. Defina como small-xlstorage se você quiser implantar um dispositivo vCenter Server para até 100 hosts e 1.000 máquinas virtuais com o tamanho de armazenamento extra grande. Implementa um dispositivo com 4 CPUs, 16 GB de memória e 1.750 GB de armazenamento. Defina como medium se você quiser implantar um dispositivo vCenter Server para até 400 hosts e 4.000 máquinas virtuais com o tamanho de armazenamento padrão. Implementa um dispositivo com 8 CPUs, 24 GB de memória e 525 GB de armazenamento. Defina como medium-lstorage se você quiser implantar um dispositivo vCenter Server para até 400 hosts e 4.000 máquinas virtuais com o tamanho de armazenamento grande. Implementa um dispositivo com 8 CPUs, 24 GB de memória e 1.025 GB de armazenamento. Defina como medium-xlstorage se você quiser implantar um dispositivo vCenter Server para até 400 hosts e 4.000 máquinas virtuais com o tamanho de armazenamento extra grande. Implementa um dispositivo com 8 CPUs, 24 GB de memória e 1.905 GB de armazenamento. Defina como large se você quiser implantar um dispositivo vCenter Server para até 1.000 hosts e 10.000 máquinas virtuais com o tamanho de armazenamento padrão. Implementa um dispositivo com 16 CPUs, 32 GB de memória e 740 GB de armazenamento. Defina como large-lstorage se você quiser implantar umvCenter Server appliance do para até 1.000 hosts e 10.000 máquinas virtuais com o tamanho de armazenamento grande. Implementa um dispositivo com 16 CPUs, 32 GB de memória e 1.090 GB de armazenamento. Defina como large-xlstorage se você quiser implantar um dispositivo vCenter Server para até 1.000 hosts e 10.000 máquinas virtuais com o tamanho de armazenamento extragrande. Implementa um dispositivo com 16 CPUs, 32 GB de memória e 1.970 GB de armazenamento. Defina como xlarge se você quiser implantar um dispositivo vCenter Server para até 2.000 hosts e 35.000 máquinas virtuais com o tamanho de armazenamento padrão. Implementa um dispositivo com 24 CPUs, 48 GB de memória e 1.180 GB de armazenamento. Defina como xlarge-lstorage se você quiser implantar um dispositivo vCenter Server para até 2.000 hosts e 35.000 máquinas virtuais com o tamanho de armazenamento grande. Implementa um dispositivo com 24 CPUs, 48 GB de memória e 1.230 GB de armazenamento. Defina como xlarge-xlstorage se você quiser implantar um dispositivo vCenter Server para até 2.000 hosts e 35.000 máquinas virtuais com o tamanho de armazenamento extragrande. Implementa um dispositivo com 24 CPUs, 48 GB de memória e 2.110 GB de armazenamento.
image	seqüência de caracteres	Opcional. Um caminho de arquivo local ou URL para o pacote de instalação do appliance do vCenter Server. Por padrão, o instalador usa o pacote de instalação incluído no arquivo ISO, na pasta vcsa.
name	seqüência de caracteres	O nome da VM para o dispositivo do. Deve conter apenas caracteres ASCII, exceto um sinal de porcentagem (%), barra invertida (\) ou barra (/) e não deve ter mais de 80 caracteres.
ovftool_path	seqüência de caracteres	Opcional. Um caminho de arquivo local para o arquivo executável da Ferramenta OVF. Por padrão, o instalador usa a instância da Ferramenta OVF incluída no arquivo ISO, na pasta vcsa/ovftool.

Tabela 6. Parâmetros de configuração na seção new_vcsa, subseção os

Nome	Tipo	Descrição
password	seqüência de caracteres	A senha do usuário raiz do sistema operacional do appliance do. A senha deve conter entre 8 e 20 caracteres, pelo menos uma letra maiúscula, pelo menos uma letra minúscula, pelo menos um número e pelo menos um caractere especial, por exemplo, um cifrão ($), chave de hash (#), arroba (@), ponto (.) ou ponto de exclamação (!). Todos os caracteres devem ser caracteres ASCII inferiores, sem espaços.
ssh_enable	Booleano	Defina como true para ativar o login do administrador SSH no dispositivo do.

Tabela 7. Parâmetros de configuração na seção new_vcsa, subseção temporary_network

Nome	Tipo	Descrição
ip_family	seqüência de caracteres	Versão IP para a rede do dispositivo do. Defina como ipv4 ou ipv6.
mode	seqüência de caracteres	Atribuição de IP para a rede do dispositivo do. Defina como static ou dhcp.
ip	seqüência de caracteres	Endereço IP do dispositivo. Obrigatório apenas se você usar uma atribuição estática, ou seja, se você definir o parâmetro mode como static. Você deve definir um endereço IPv4 ou IPv6 que corresponda à versão do IP da rede, ou seja, ao valor do parâmetro ip_family. Um endereço IPv4 deve estar em conformidade com as diretrizes da RFC 790. Um endereço IPv6 deve estar em conformidade com as diretrizes da RFC 2373.
dns_servers	string ou array	Endereços IP de um ou mais servidores DNS. Para definir mais de um servidor DNS, use uma lista de cadeias de caracteres separadas por vírgula ou uma lista separada por vírgulas como uma única cadeia de caracteres para fornecer o caminho. Por exemplo, ["x.y.z.a", "x.y.z.b"] ou "x.y.z.a, x.y.z.b" Obrigatório apenas se você usar uma atribuição estática, ou seja, se você definir o parâmetro mode como static.
prefix	seqüência de caracteres	Comprimento do prefixo de rede. Obrigatório apenas se você usar a atribuição, ou seja, se você definir o parâmetro mode como static. Para a versão IPv4, o valor deve estar entre 0 e 32. Para a versão IPv6, o valor deve estar entre 0 e 128.
gateway	seqüência de caracteres	Endereço IP do gateway padrão. Para a versão IPv6, o valor pode ser default.

Tabela 8. Parâmetros de configuração na seção new_vcsa, subseção user_options

Nome	Tipo	Descrição
vcdb_migrateSet	seqüência de caracteres	Selecione os tipos de dados a serem migrados do dispositivo antigo para o novo. Os dados são copiados da origem vCenter Server para o servidor de destino. A fonte original dos dados permanece inalterada. Defina como core se quiser transferir apenas os dados de configuração. Isso fornece a migração de dados mais rápida, mantendo o tempo de inatividade do sistema no mínimo. Defina como core_events_tasks se você quiser transferir a configuração e os dados históricos (eventos e tarefas) imediatamente. vCenter Server não será iniciado até que todos os dados tenham sido migrados da origem vCenter Server para Windows. Defina como all se você quiser transferir os dados de configuração, histórico e métricas de desempenho imediatamente. vCenter Server não será iniciado até que todos os dados tenham sido migrados da origem vCenter Server para Windows. Essa opção transfere a maior quantidade de dados e requer mais tempo de inatividade do que outras opções de migração de dados. Defina como transfer_events_tasks_after_upgrade se você quiser transferir os dados históricos (eventos e tarefas) em segundo plano após a conclusão do upgrade. Durante esse tempo, o desempenho do vCenter Server pode não ser o ideal. Defina como transfer_stats_events_tasks_after_upgrade se você quiser transferir dados históricos e dados de métricas de desempenho em segundo plano após a conclusão do upgrade. Durante esse tempo, o desempenho do vCenter Server pode não ser o ideal. Observação: Para minimizar o tempo de migração e a quantidade de armazenamento necessária para o novo dispositivo vCenter Server, use o valor core. Para obter mais informações sobre os tipos de dados que você pode transferir do seu vCenter Server existente para o novo vCenter Server atualizado, consulte Transferindo dados de um dispositivo vCenter Server existente.

Tabela 9. Parâmetros de configuração na seção new_vcsa, subseção sso

Nome	Tipo	Descrição
first_instance	seqüência de caracteres	Defina first_instance como true se esta for a primeira operação de migração de convergência em seu domínio de SSO vCenter Server ou se você não quiser definir o parceiro de replicação para este nó. Se você quiser definir o parceiro de replicação para esse nó, defina first_instance como false e forneça o valor de replication_partner_hostname como o FQDN de um nó convergido anteriormente que está atualmente em uma topologia vCenter Server incorporada. Para obter mais informações sobre como especificar os parâmetros first_instance e replication_partner_hostname, consulte Sobre a migração de um vCenter Server para Windows com um Platform Services Controller externo usando a CLI.
replication_partner_hostname	seqüência de caracteres	Nome do host do parceiro de replicação. Remover se for o first_instance

Requisitos para a chamada automática do Assistente de Migração

Use a subseção run_migration_assistant para automatizar a chamada do Assistente de Migração. A chamada automática funcionará somente se a instalação de origem Windows estiver em execução como uma máquina virtual.

A conta de usuário que você especifica nos parâmetros os_username ou vum_os_username precisa de uma elevação de privilégio para Administrador. Por exemplo:

• A conta de administrador Windows interna.
• Uma conta de usuário com um nome de usuário diferente de Administrador que é membro do grupo local Windows Administradores.
• A conta de Administrador de Domínio com o nome de usuário Administrador que é membro do grupo local Windows Administradores.
• A ID do nome de usuário deve estar no formato your_domain_name\\\}user_ID ou user_ID@your_domain_name.

Restrição: A invocação automática do Assistente de Migração não funciona com uma conta Windows que requer uma elevação de privilégio para Administrador. Em vez disso, execute o Assistente de Migração manualmente na máquina Windows de origem. Copie e cole o valor da impressão digital da saída do console do Assistente de Migração na máquina de origem na chave migration_ssl_thumbprint na subseção vc_win e remova a seção run_migration_assistant.

Parâmetros de configuração na seção source_vc

Tabela 10. Parâmetros de configuração na seção source_vc, subseção vc_win

Nome	Tipo	Descrição
hostname	seqüência de caracteres	O nome do host ou o endereço IP da instalação de origem Windows de vCenter Server ou Platform Services Controller que você deseja migrar.
username	seqüência de caracteres	Um nome de usuário vCenter Single Sign-On com privilégios administrativos para a instância vCenter Server, vCenter Single Sign-On ou Platform Services Controller que você deseja migrar.
password	seqüência de caracteres	A senha da instância vCenter Server ou Platform Services Controller que você deseja migrar.
migration_port	seqüência de caracteres	Número da porta do Assistente de Migração mostrado no console do Assistente de Migração. A porta padrão é 9123.
active_directory_domain	seqüência de caracteres	O nome do domínio Active Directory ao qual a instância vCenter Server de origem está associada.
active_directory_username	seqüência de caracteres	Nome de usuário do administrador do domínio Active Directory ao qual a instância vCenter Server de origem está associada.
active_directory_password	seqüência de caracteres	Senha do administrador do domínio Active Directory ao qual a instância vCenter Server de origem está associada. Observação: O instalador verifica as credenciais inseridas, mas não verifica os privilégios necessários para adicionar a máquina de destino ao domínio Active Directory. Verifique se as credenciais do usuário têm todas as permissões necessárias para adicionar uma máquina ao domínio Active Directory.
migration_ssl_thumbprint	seqüência de caracteres	A impressão digital SSL do Assistente de Migração.

Tabela 11. Parâmetros de configuração na seção source_vc, subseção run_migration_assistant

Nome	Tipo	Descrição
esxi_hostname	seqüência de caracteres	FQDN ou endereço IP de ESXi no qual a instância de origem vCenter Server, vCenter Single Sign-On ou Platform Services Controller reside.
esxi_username	seqüência de caracteres	Nome de usuário de um usuário com privilégios administrativos no host ESXi.
esxi_password	seqüência de caracteres	A senha do usuário do host ESXi. Se omitido, você será solicitado a digitar a senha no console de comando durante a verificação do modelo.
esxi_port	seqüência de caracteres	O número da porta do host ESXi. A porta padrão é 443.
os_username	seqüência de caracteres	Nome de usuário do administrador para a máquina de origem Windows.
os_password	seqüência de caracteres	Senha do usuário administrador para a máquina de origem Windows. Se omitido, você será solicitado a inseri-lo no console de comando durante a verificação do modelo.
migration_ip	seqüência de caracteres	O endereço IP do adaptador de rede a ser migrado.
migration_port	seqüência de caracteres	Número da porta do Assistente de Migração mostrado no console do Assistente de Migração. A porta padrão é 9123.
export_dir	seqüência de caracteres	Diretório para exportar a configuração e os dados de origem.
sa_password	seqüência de caracteres	O endereço IP da senha de usuário da conta de serviço da rede vCenter Server. Essa opção só será necessária se o serviço vCenter Server estiver sendo executado em uma conta que não seja LocalSystem. Se omitido, você será solicitado a inseri-lo no console de comando durante a verificação do modelo.

Tabela 12. Parâmetros de configuração na seção source_vum, subseção run_migration_assistant

Nome	Tipo	Descrição
esxi_hostname	seqüência de caracteres	FQDN ou endereço IP de ESXi no qual a instância de origem vCenter Server, vCenter Single Sign-On ou Platform Services Controller reside.
esxi_username	seqüência de caracteres	Nome de usuário de um usuário com privilégios administrativos no host ESXi.
esxi_password	seqüência de caracteres	A senha do usuário do host ESXi. Se omitido, você será solicitado a digitar a senha no console de comando durante a verificação do modelo.
esxi_port	seqüência de caracteres	O número da porta do host ESXi. A porta padrão é 443.
vum_hostname	seqüência de caracteres	FQDN ou endereço IP de ESXi no qual a instância de origem Update Manager reside.
vum_os_username	seqüência de caracteres	Nome de usuário do administrador para a máquina de origem Windows.
vum_os_password	seqüência de caracteres	Senha do usuário administrador para a máquina de origem Update Manager Windows. Se omitido, você será solicitado a inseri-lo no console de comando durante a verificação do modelo.
migration_port	seqüência de caracteres	Número da porta do Assistente de Migração mostrado no console do Assistente de Migração. A porta padrão é 9123.
export_dir	seqüência de caracteres	Diretório para exportar a configuração e os dados de origem.

Parâmetros de configuração na seção ceip

Tabela 13. Parâmetros de configuração na seção ceip, subseção settings

Nome	Tipo	Descrição
ceip_enabled	Booleano	Defina como true para ingressar no CEIP para este dispositivo.

Executar uma pré-verificação antes de uma migração de CLI para vCenter Server Appliance

Você pode executar uma pré-verificação para verificar se os requisitos de migração foram atendidos e resolver quaisquer problemas antes da migração da sua implantação do vCenter Server.

Antes de migrar sua implantação do vCenter Server para um dispositivo do, você pode executar uma pré-verificação para descobrir o requisito de espaço em disco, o tempo estimado de atualização e as extensões registradas no dispositivo do vCenter Server. A execução da pré-atualização é uma etapa opcional, mas altamente recomendada ao planejar a atualização.

Pré-requisitos

Preparar arquivos de configuração JSON para migração de CLI usando os modelos de exemplo e os parâmetros de configuração.

Procedimento

1. Verifique seu modelo sem implantar o dispositivo do, digitando o comando: vcsa-deploy migrate --verify-template-only path_to_json_file.
2. Execute CLI Migrate usando a opção --precheck-only.
   Você pode ajustar seus planos de migração usando os requisitos de espaço em disco e o tempo estimado de migração. Se você receber um erro, poderá solucionar e resolver o problema antes da migração real.
3. Depois de resolver quaisquer erros, execute o comando CLI Migrate usando a opção --verify-template-only novamente até que todos os erros sejam resolvidos.

Resultados

Agora você está preparado para um processo de migração da CLI sem erros.

O que Fazer Depois

Realizar uma migração de CLI de vCenter Server de Windows para um dispositivo.

Realizar uma migração de CLI de vCenter Server de Windows para um dispositivo

Você pode migrar o vCenter Server para um appliance do de uma máquina que está em sua rede do vSphere.

Pré-requisitos

• Consulte Pré-requisitos para migração vCenter Server
• Crie um snapshot da implantação que você deseja migrar como precaução em caso de falha durante o processo de migração.
• Baixe o arquivo ISO do instalador do site VMware para uma máquina que esteja na sua rede vSphere. O nome do arquivo ISO do instalador é VMware-VCSA-all-8.0.0-yyyyyy.iso, em que yyyyyy é o número da compilação. Consulte Baixar e montar o instalador do vCenter Server.
• Preparar arquivos de configuração JSON para migração de CLI.
• Executar uma pré-verificação antes de uma migração de CLI para vCenter Server Appliance para identificar problemas e refinar seu plano de migração.
• Revise os argumentos opcionais para executar a migração. Consulte Sintaxe do comando de migração da CLI.

Procedimento

1. Navegue até o diretório do instalador da CLI do software para o seu sistema operacional.
   • Se você estiver implantando o dispositivo de uma máquina com o SO Windows, navegue até o diretório vcsa-cli-installer\win32.
   • Se você estiver implantando o dispositivo de uma máquina com sistema operacional Linux, navegue até o diretório vcsa-cli-installer/lin64.
   • Se você estiver implantando o dispositivo de uma máquina com o SO Mac, navegue até o diretório vcsa-cli-installer/mac.
2. Selecione o instalador da CLI: vcsa-deploy.exe.
3. Execute o comando de migração.

   vcsa-deploy migrate --accept-eula optional_arguments path_to_the_json_file

   A variável optional_arguments é uma lista separada por espaços de argumentos opcionais para definir configurações adicionais.
   Por exemplo, você pode definir o local do log e de outros arquivos de saída que o instalador gera.

   vcsa-deploy migrate --accept-eula --log-dir=path_to_the_location path_to_the_json_file

Resultados

O modelo de migração é implantado. Você pode Verificar se o upgrade ou a migração do vCenter Server foi bem-sucedido.

Sintaxe do comando de migração da CLI

Você pode usar um ou mais argumentos de comando para definir os parâmetros de execução do comando migrate.

Você pode adicionar uma lista de argumentos separada por espaços ao comando upgrade da CLI.

vcsa-deploy migrate list_of_arguments path_to_the_json_file

O argumento template necessário fornece o caminho de um arquivo JSON que descreve o procedimento de implantação do dispositivo vCenter Server. Você pode colocar vários arquivos JASON em um diretório, e a CLI migrará todas as implantações no modo de lote. Para obter mais informações sobre como realizar migrações simultâneas, consulte Preparar arquivos de configuração JSON para migração de CLI.

Importante: Os valores de cadeia de caracteres, incluindo as senhas, devem conter apenas caracteres ASCII. Caracteres ASCII estendidos e não ASCII não são suportados.

Para definir um valor que contenha o caractere de barra invertida (\) ou aspas ("), você deve preceder o caractere com o caractere de barra invertida (\). Por exemplo, "password":"my\"password" define a senha my"password, "image":"C:\\vmware\\vcsa" define o caminho C:\vmware\vcsa.

Os valores booleanos devem conter apenas caracteres minúsculos. Pode ser true ou false. Por exemplo, "ssh.enable":false.

Argumento opcional	Descrição
--accept-eula	Aceita o contrato de licença de usuário final. Obrigatório para executar o comando de implantação.
-h, --help	Exibe a mensagem de ajuda para o comando.
--template-help	Exibe a mensagem de ajuda para os parâmetros de configuração no arquivo de implantação JSON. Você pode usar vcsa-deploy [subcommand] --help para obter uma lista de argumentos específicos do subcomando.
-v, --verbose	Adiciona informações de depuração à saída do console.
-t, --terse	Oculta a saída do console. Exibe apenas mensagens de aviso e erro.
--log-dir, LOG_DIR	Especifica o local do log e de outros arquivos de saída que o instalador gera.
--skip-ovftool-verification	Executa a verificação básica dos parâmetros de configuração e implanta o appliance do vCenter Server, mas não valida os parâmetros da Ferramenta OVF na subseção ovftool_arguments do modelo JSON. Se você definir argumentos que a ferramenta OVF não reconhece, a implantação poderá falhar.
--no-ssl-certificate-verification	Proíbe a verificação SSL de ESXi conexões. A CLI verifica se o certificado de segurança de um servidor foi assinado por uma Autoridade de Certificação (CA) e estabelece uma conexão segura. Se o certificado for autoassinado, a CLI interromperá o upgrade, a menos que você especifique que a CLI ignore o certificado autoassinado usando o parâmetro de comando --no-ssl-certificate-validation. Se você estiver se conectando a um servidor com um certificado autoassinado e não conseguir especificar que a CLI o aceite, a CLI exibirá a impressão digital do certificado autoassinado do servidor e solicitará que você a aceite ou rejeite. Você também pode especificar que a CLI ignore certificados autoassinados usando o parâmetro de configuração ssl_certificate_verification no modelo JSON. Consulte Atualizar parâmetros de configuração para CLI Atualização do dispositivo vCenter Server. Importante: Evite usar essa opção, pois ela pode causar problemas durante ou após a atualização devido a uma identidade não validada do host de destino.
--operation-id	Permite que você forneça um identificador para rastrear a instalação, migração ou atualização simultânea de várias instâncias vCenter Server. Se não fornecer um ID de operação, a CLI gerará um identificador exclusivo universal (UUID) que você poderá usar para identificar as diferentes instâncias de vCenter Server e seu status de instalação ou upgrade.
--verify-template-only	Executa a verificação básica do modelo sem instalar o Upgrade Runner, executar pré-verificações e atualizar ou migrar o appliance do vCenter Server.
--precheck-only	Instala o Assistente de Migração na máquina virtual vCenter Server de origem e executa um conjunto completo de pré-verificações sem realizar a migração.
--acknowledge-ceip	Confirma o reconhecimento de sua participação no VMware Programa de Aperfeiçoamento da Experiência do Cliente (CEIP). Esse argumento será necessário se ceip.enabled estiver definido como true no modelo de upgrade.

Código de saída	Descrição
0	Comando executado com êxito
1	Erro de tempo de execução
2	Erro de validação
3	Erro de modelo