Ao preparar seus arquivos de configuração JSON para atualização da CLI, você deve definir parâmetros e valores para fornecer dados de entrada para a atualização de um dispositivo do vCenter Server.
Seções e subseções de parâmetros de configuração nos arquivos de atualização JSON
Os parâmetros de configuração nos arquivos de configuração JSON para atualização da CLI são organizados em seções e subseções.
Seção | Subseção | Descrição |
---|---|---|
new_vcsa - descreve o novo dispositivo que você deseja implantar. |
esxi |
Use somente se quiser implantar o novo appliance diretamente em um host ESXi.
Contém os parâmetros de configuração que descrevem o host
ESXi de destino. Consulte
Parâmetros de configuração na seção new_vcsa , subseção esxi .
Observação: Você deve preencher esta subseção ou a subseção
vc .
|
vc |
Use somente se você quiser implantar o novo dispositivo no inventário de uma instância do vCenter Server. Contém os parâmetros de configuração que descrevem o host ESXi de destino ou o cluster DRS do inventário do vCenter Server. Consulte Parâmetros de configuração na seção
Observação: Você deve preencher esta subseção ou a subseção
esxi .
A instância de destino vCenter Server não pode ser a vCenter Server Appliance que você deseja atualizar. Nesses casos, use a subseção |
|
appliance |
Contém os parâmetros de configuração que descrevem o novo dispositivo. Consulte Parâmetros de configuração na seção new_vcsa , subseção appliance |
|
os |
Contém apenas o parâmetro de configuração ssh_enable para definir o login de administrador SSH para o novo dispositivo. |
|
ovftool_arguments |
Opcional. Use esta subseção 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 pode falhar.
|
|
temporary_network |
Contém os parâmetros de configuração que descrevem as configurações de rede temporárias para o novo dispositivo. Consulte Parâmetros de configuração na seção new_vcsa , subseção temporary_network |
|
user_options |
Contém apenas o parâmetro de configuração vcdb_migrateSet para definir os tipos de dados que você deseja transferir do dispositivo antigo para o novo dispositivo. Consulte Parâmetros de configuração na seção new_vcsa , subseção user_options |
|
source_vc - descreve o dispositivo existente que você deseja atualizar. |
managing_esxi_or_vc |
Contém os parâmetros de configuração que descrevem o host ESXi de origem ou a instância do appliance do vCenter Server na qual reside o appliance que você deseja atualizar. Consulte Parâmetros de configuração na seção source_vc , subseção managing_esxi_or_vc . |
vc_vcsa |
Contém os parâmetros de configuração que descrevem o dispositivo de origem que você deseja atualizar. Consulte Parâmetros de configuração na seção source_vc , subseção vc_vcsa . |
|
source_vum - descreve a instância de origem do VMware Update Manager. Use se quiser executar automaticamente o Assistente de Migração na instância do VMware Update Manager. |
run_migration_assistant |
Opcional se o appliance de origem do vCenter Server que você deseja atualizar estiver conectado a uma instância do Update Manager do VMware que é executada em uma máquina virtual do Windows. Use esta subseção se quiser executar automaticamente o Assistente de Migração na instância de origem do VMware Update Manager. Contém os parâmetros de configuração que descrevem a instância de origem do VMware Update Manager, que será migrada para o novo dispositivo vCenter Server atualizado. Consulte Parâmetros de configuração na seção
Observação: O
Migration Assistant usa a porta 9123 por padrão. Se a porta 9123 for usada por outro serviço na máquina
Update Manager,
Migration Assistant encontrará automaticamente outra porta livre. Você não pode definir uma porta personalizada para
Migration Assistant.
|
ceip - descreve como ingressar no VMware Programa de Aperfeiçoamento da Experiência do Cliente (CEIP). |
settings |
Contém apenas o parâmetro de configuração Necessário somente se você estiver atualizando um dispositivo do vCenter Server com um dispositivo do Platform Services Controller ou Platform Services Controller incorporado.
Observação: Se o parâmetro de configuração
ceip_enabled estiver 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 Cliente em vCenter Server e Gerenciamento de Host . |
Para definir um valor que contém um 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 minha "senha, "image":"G:\\vcsa\\VMware-vCenter-Server-Appliance-7.0.0. XXXX - YYYYYYY _OVF10.ova"
define o caminho G: \ vcsa \VMware\} -vCenter-Server-Appliance-7.0.0. XXXX - YYYYYYY _OVF10.ova .
Os valores booleanos devem conter apenas caracteres minúsculos. Pode ser true
ou false
. Por exemplo, "ssh_enable":false
.
Parâmetros de configuração na seção new_vcsa
Nome | Tipo | Descrição |
---|---|---|
hostname |
cadeia de caracteres | O endereço IP ou FQDN do host ESXi de destino no qual você deseja implantar o novo dispositivo. |
username |
cadeia de caracteres | Um nome de usuário com privilégios administrativos no host ESXi de destino, por exemplo, raiz. |
password |
cadeia de caracteres | A senha do usuário com privilégios administrativos no host ESXi de destino. |
deployment_network |
cadeia de caracteres | O nome da rede à qual conectar o novo dispositivo. A rede deve fazer parte da configuração de rede do host de destino ESXi ou da instância do appliance do vCenter Server (conforme identificado pelo parâmetro de configuração
Observação: A rede deve estar acessível a partir do host
ESXi de origem ou da instância do dispositivo do
vCenter Server (conforme identificado pelo parâmetro de configuração
managing_esxi_or_vc ) no qual reside o dispositivo que você deseja atualizar. A rede também deve estar acessível na máquina cliente da qual você está realizando a atualização.
Ignorado se o host ESXi de destino tiver apenas uma rede. |
datastore |
cadeia de caracteres | O nome do datastore no qual armazenar os arquivos de configuração da máquina virtual e os discos virtuais do novo dispositivo. O datastore deve estar disponível para o host ESXi de destino.
Observação: O armazenamento de dados deve ter pelo menos 25 GB de espaço livre.
|
port |
número inteiro | A porta do proxy reverso HTTPS do host ESXi de destino. A porta padrão é 443. Use somente se o host ESXi de destino usar uma porta de proxy reverso HTTPS personalizada. |
ssl_certificate_verification |
cadeia de caracteres | A CLI verifica se o certificado de segurança do servidor está assinado por uma Autoridade de Certificação (CA) e estabelece uma conexão segura. Se o certificado for autoassinado, a CLI interromperá a atualização, a menos que você especifique uma das seguintes opções de configuração de certificado SSL: Especifique a impressão digital do certificado do 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": "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 Você também pode especificar que a CLI ignore a autoassinada usando o parâmetro de comando vcsa-deploy upgrade |
Nome | Tipo | Descrição |
---|---|---|
hostname |
cadeia de caracteres | O endereço IP ou FQDN da instância do vCenter Server de destino na qual você deseja implantar o novo dispositivo. |
username |
cadeia de caracteres | Nome de usuário administrador do vCenter Single Sign-On na instância do vCenter Server de destino, por exemplo, [email protected]. |
password |
cadeia de caracteres | A senha do usuário administrador do vCenter Single Sign-On na instância do vCenter Server de destino. |
deployment_network |
cadeia de caracteres | O nome da rede à qual conectar o novo dispositivo. A rede deve fazer parte do host ESXi de destino ou da configuração de rede do cluster DRS.
Observação: A rede deve estar acessível a partir do host
ESXi de origem no qual reside o dispositivo que você deseja atualizar. A rede também deve estar acessível na máquina cliente da qual você está realizando a atualização.
Ignorado se o host ESXi de destino ou o cluster DRS tiver apenas uma rede. |
datacenter |
matriz | O centro de dados do vCenter Server que contém o host ESXi de destino ou o cluster DRS no qual você deseja implantar o novo dispositivo.
Se o centro de dados estiver localizado em uma pasta ou em uma estrutura de pastas, especifique o como uma lista de cadeias de caracteres separada por vírgulas. Por exemplo,
["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 diferencia maiúsculas de minúsculas.
|
datastore |
cadeia 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 novo dispositivo.
Observação: O datastore deve estar disponível para o host
ESXi de destino ou para o cluster DRS.
O armazenamento de dados deve ter pelo menos 25 GB de espaço livre. |
port |
número inteiro | A porta do proxy reverso HTTPS da instância do vCenter Server de destino. A porta padrão é 443. Use somente se a instância do vCenter Server de destino usar uma porta de proxy reverso HTTPS personalizada. |
target |
matriz | O cluster de destino, o host ESXi ou o pool de recursos no qual você deseja implantar o novo dispositivo. Este é o destino que você especificou com o parâmetro
Importante: Você deve fornecer o nome que é exibido no inventário do
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 diferenciam maiúsculas de 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 mais adiante nesta seção.
Se o cluster de destino, o host
ESXi ou o pool de recursos estiver localizado em uma pasta ou uma estrutura de pastas, especifique o valor como uma lista de cadeias de caracteres separada por vírgulas. Por exemplo,
["parent_folder", "child_folder", "esxi-host.domain.com"]
Se o host
ESXi de destino fizer parte de um cluster, especifique o caminho como uma lista de cadeias de caracteres separada por vírgulas. Por exemplo,
["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 verificações prévias verificam apenas a memória do pool de recursos.
|
vm_folder |
cadeia de caracteres | Opcional. O nome da pasta da máquina virtual (VM) à qual adicionar o novo dispositivo. |
Nome | Tipo | Descrição |
---|---|---|
thin_disk_mode |
Booliano | Defina como true para implantar o novo appliance com discos virtuais dinâmicos. |
deployment_option |
cadeia de caracteres | O tamanho do novo dispositivo.
Observação: Você deve considerar o tamanho do banco de dados do dispositivo que deseja atualizar. Para um banco de dados externo, consulte
Determine o tamanho do banco de dados Oracle e o tamanho do armazenamento para o novo dispositivo.
|
image |
cadeia 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 que está incluído no arquivo ISO, na pasta vcsa . |
name |
cadeia de caracteres | O nome da VM para o novo dispositivo. Deve conter apenas caracteres ASCII, exceto um sinal de porcentagem (%), barra invertida (\) ou barra (/) e não deve ter mais de 80 caracteres de comprimento. |
ovftool_path |
cadeia 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 que está incluída no arquivo ISO, na pasta vcsa / ovftool . |
Nome | Tipo | Descrição |
---|---|---|
ip_family |
cadeia de caracteres | Versão do IP para a rede temporária do novo dispositivo. Defina como |
mode |
cadeia de caracteres | Atribuição de IP para a rede temporária do novo dispositivo. Defina como |
ip |
cadeia de caracteres | Endereço IP temporário para o novo dispositivo. Necessário somente se você usar uma atribuição estática, ou seja, se você definir o parâmetro Você deve definir um endereço IPv4 ou IPv6 que corresponda à versão de IP da rede temporária, ou seja, ao valor do parâmetro Um endereço IPv4 deve estar em conformidade com as diretrizes RFC 790. Um endereço IPv6 deve estar em conformidade com as diretrizes RFC 2373. |
dns_servers |
cadeia de caracteres ou matriz | Endereços IP de um ou mais servidores DNS para a rede temporária do novo dispositivo.
Para definir mais de um servidor DNS, use uma lista separada por vírgulas de cadeias de caracteres 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" Necessário apenas se você usar o modo de rede estática para a alocação de endereço IP temporária, ou seja, se você definir o parâmetro |
prefix |
cadeia de caracteres | Comprimento do prefixo de rede para a rede temporária do novo dispositivo. Use somente se o parâmetro O comprimento do prefixo de rede é o número de bits que são definidos na máscara de sub-rede. Por exemplo, se a máscara de sub-rede for 255.255.255.0, há 24 bits na versão binária do comprimento do prefixo, portanto, o comprimento do prefixo de rede é 24. Para a versão IPv4, o valor deve estar entre Para a versão IPv6, o valor deve estar entre |
gateway |
cadeia de caracteres | Endereço IP do gateway padrão para a rede temporária do novo dispositivo. Para a versão IPv6, o valor pode ser |
Nome | Tipo | Descrição |
---|---|---|
vcdb_migrateSet |
cadeia de caracteres | Selecione os tipos de dados a serem migrados do dispositivo antigo para o novo. Os dados são copiados do vCenter Server de origem para o servidor de destino. A fonte original dos dados permanece inalterada.
Observação: Para minimizar o tempo de atualizaçã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. |
Nome | Tipo | Descrição |
---|---|---|
first_instance |
cadeia de caracteres | Defina Se você quiser definir o parceiro de replicação para este nó, defina Para obter mais informações sobre como especificar os parâmetros |
replication_partner_hostname |
cadeia de caracteres | Nome do host do parceiro de replicação. Remova se for o first_instance . |
Parâmetros de configuração na seção source_vc
Nome | Tipo | Descrição |
---|---|---|
hostname |
cadeia de caracteres | O endereço IP ou FQDN do host ESXi ou vCenter Server de origem no qual reside o dispositivo que você deseja atualizar. |
username |
cadeia de caracteres | Um nome de usuário com privilégios administrativos no host ESXi de origem, por exemplo, raiz. |
password |
cadeia de caracteres | A senha do usuário com privilégios administrativos no host ESXi de origem. |
port |
número inteiro | A porta de proxy reverso HTTPS do host ESXi de origem. A porta padrão é 443. Use somente se o host ESXi de origem usar uma porta de proxy reverso HTTPS personalizada. |
Nome | Tipo | Descrição |
---|---|---|
hostname |
cadeia de caracteres | O endereço IP ou FQDN do dispositivo de origem que você deseja atualizar. |
username |
cadeia de caracteres | Usuário administrador do vCenter Single Sign-On no appliance de origem, por exemplo, [email protected].
Importante: O usuário deve ser administrator @
your_domain_name .
|
password |
cadeia de caracteres | A senha do usuário administrador do vCenter Single Sign-On no appliance de origem. |
root_password |
cadeia de caracteres | A senha para o usuário raiz do sistema operacional do dispositivo de origem. |
export_dir |
cadeia de caracteres | Diretório para exportar a configuração de origem e os dados. |
Parâmetros de configuração na seção source.vum
Nome | Tipo | Descrição |
---|---|---|
esxi_hostname |
cadeia de caracteres | O endereço IP ou FQDN do host ESXi no qual reside a instância do Update Manager de origem do VMware. Se um FQDN for fornecido, ele deverá ser resolvido na máquina cliente da qual você executa a atualização. |
esxi_username |
cadeia de caracteres | Um nome de usuário com privilégios administrativos no host ESXi, por exemplo, raiz. |
esxi_password |
cadeia de caracteres | A senha do usuário com privilégios administrativos no host ESXi. |
esxi_port |
cadeia de caracteres | A porta do proxy reverso HTTPS do host ESXi. A porta padrão é 443. Use somente se o host ESXi usar uma porta de proxy reverso HTTPS personalizada. |
vum_hostname |
cadeia de caracteres | O endereço IP ou FQDN da máquina virtual do Windows na qual a instância de origem do VMware Update Manager é executada. Se um FQDN for fornecido, ele deverá ser resolvido na máquina cliente da qual você executa a atualização. |
vum_os_username |
cadeia de caracteres | O nome de usuário administrador da máquina virtual do Windows na qual a instância de origem do VMware Update Manager é executada. |
vum_os_password |
cadeia de caracteres | A senha do administrador da máquina virtual Windows na qual a instância de origem do VMware Update Manager é executada. Se não for fornecida, você será solicitado a digitar a senha no console de comando durante a verificação do modelo. |
export_dir |
cadeia de caracteres | Diretório para exportar a configuração de origem e os dados. |
Parâmetros de configuração na seção ceip
Nome | Tipo | Descrição |
---|---|---|
ceip_enabled |
Booliano | Defina como true para ingressar no CEIP para o novo dispositivo atualizado. |