Hiperflex do UCS: Como alterar o cluster do vCenter, os nomes do datacenter e o nome do cluster hiperflex

Introduction

Este documento descreve os problemas que ocorrem quando você altera os nomes Hyperflex vCenter Cluster e Datacenter.

Problema: Alterar o nome do cluster do vCenter

Assim, se você renomear o cluster no vCenter, haverá uma incompatibilidade na entrada que o stmgr tem e no nome real do cluster do vCenter, e devido a essa incompatibilidade, você verá problemas como modo de manutenção HX e snapshots HX falhando. Porque quando você coloca um nó HX no modo de manutenção HX ou faz um snapshot, o stmgr tenta encontrar o nó no vCenter sob o nome do cluster do vCenter que você vê neste comando.

Na captura de tela abaixo, o nome do cluster foi alterado de BGL-HX-1 para HX-1.

Mas o gerente ainda tem a entrada antiga para o nome do cluster.

root@SpringpathControllerPZTMTRSH7K:~# stcli cluster info | grep -i vc
vCluster:
    vCenterClusterId: domain-c276
    vCenterDatacenter: BGL-HX-DC
    vCenterURL: 10.197.252.125
    vCenterDatacenterId: datacenter-195
    vCenterClusterName: BGL-HX-1        <----- Mismatch in vCenter Cluster name
root@SpringpathControllerPZTMTRSH7K:~#

Solução: Procedimento para alterar o nome do vCenter

1. Clique com o botão direito do mouse no nome do cluster e renomeie o cluster do vCenter no VC depois de selecionar a opção Renomear.

2. Digite o novo nome do cluster e clique em OK.

3. Depois de renomear o cluster no vCenter, atualize também a entrada do nome do cluster do vCenter para o stmgr. Para fazer isso, você terá que fazer um novo registro.

Antes de registrar novamente:

root@SpringpathControllerPZTMTRSH7K:~# stcli cluster info | grep -i vc
vCluster:
    vCenterClusterId: domain-c276
    vCenterDatacenter: BGL-HX-DC
    vCenterURL: 10.197.252.125
    vCenterDatacenterId: datacenter-195
    vCenterClusterName: BGL-HX-1        <----- Has the old entry
root@SpringpathControllerPZTMTRSH7K:~#

Processo de registro novamente:

root@SpringpathControllerPZTMTRSH7K:~# stcli cluster reregister --vcenter-datacenter BGL-HX-DC --vcenter-cluster HX-1 --vcenter-url 10.197.252.125 --vcenter-user administrator@vsphere.local
Reregister StorFS cluster with a new vCenter ...
Enter NEW vCenter Administrator password:
Cluster reregistration with new vCenter succeeded
root@SpringpathControllerPZTMTRSH7K:~#

Após registrar novamente:

root@SpringpathControllerPZTMTRSH7K:~# stcli cluster info | grep -i vc
vCluster:
    vCenterClusterId: domain-c276
    vCenterDatacenter: BGL-HX-DC
    vCenterURL: 10.197.252.125
    vCenterDatacenterId: datacenter-195
    vCenterClusterName:  HX-1          <------ New entry updated after reregister
root@SpringpathControllerPZTMTRSH7K:~#

Problema: Alterar o nome do datacenter do vCenter

Agora, se quiser renomear o nome do datacenter ou mover seu cluster do HX vCenter para um novo datacenter, você terá que executar um novo registro para atualizar as entradas do stmgr. Se você não conseguir fazer isso, o stmgr continuará procurando o cluster do HX vCenter sob o nome antigo do datacenter. Assim, você vê falhas em operações HX, como modo de manutenção HX e snapshots HX.

Na captura de tela abaixo, o nome do datacenter HX foi alterado de BGL-HX-DC para HX-DC.

Mas o gerente ainda tinha o nome antigo do data center.

oot@SpringpathControllerPZTMTRSH7K:~# stcli cluster info | grep -i vc
vCluster:
    vCenterClusterId: domain-c276
    vCenterDatacenter: BGL-HX-DC       <----- Mismatch in vCenter Datacenter name
    vCenterURL: 10.197.252.125
    vCenterDatacenterId: datacenter-195
    vCenterClusterName: BGL-HX-1        
root@SpringpathControllerPZTMTRSH7K:~#

Solução: Procedimento para alterar o nome do datacenter

1. Renomeie o vCenter Datacenter (ou crie um novo Datacenter e mova o cluster e os hosts do HX vCenter para o novo Datacenter) do VC. Clique com o botão direito do mouse no nome do datacenter e selecione a opção Renomear conforme mostrado na imagem.

2. Digite o novo nome do datacenter e clique em OK.

3. Depois de renomear o Datacenter no vCenter, atualize a entrada de nome do vCenter Datacenter para o stmgr também, para fazer isso, você terá que fazer novamente um novo registro.

Antes de registrar novamente:

root@SpringpathControllerPZTMTRSH7K:~# stcli cluster info | grep -i vc
vCluster:
    vCenterClusterId: domain-c276
    vCenterDatacenter: BGL-HX-DC   <------- Has the old entry
    vCenterURL: 10.197.252.125
    vCenterDatacenterId: datacenter-195
    vCenterClusterName: HX-1
root@SpringpathControllerPZTMTRSH7K:~#

Processo de registro novamente:

root@SpringpathControllerPZTMTRSH7K:~# stcli cluster reregister --vcenter-datacenter HX-DC --vcenter-cluster HX-1 --vcenter-url 10.197.252.125 --vcenter-user administrator@vsphere.local
Reregister StorFS cluster with a new vCenter ...
Enter NEW vCenter Administrator password:
Cluster reregistration with new vCenter succeeded
root@SpringpathControllerPZTMTRSH7K:~#

Depois de registrar novamente:

root@SpringpathControllerPZTMTRSH7K:~# stcli cluster info | grep -i vc
vCluster:
    vCenterClusterId: domain-c276
    vCenterDatacenter: HX-DC     <------- New entry after reregister
    vCenterURL: 10.197.252.125
    vCenterDatacenterId: datacenter-195
    vCenterClusterName: HX-1
root@SpringpathControllerPZTMTRSH7K:~#

Problema: Alteração do nome do cluster HX

Nem sempre é verdade que o Nome do Cluster Hyperflex visto no título da IU HX e o nome do Cluster VC são os mesmos.  Você pode nomear o cluster HX e o Cluster VC separadamente. Nas etapas acima, vimos como podemos alterar o cluster VC e o nome do datacenter. As etapas abaixo são para alterar o nome do cluster HX.

título da IU HX

Solução: Procedimento para alterar o nome do cluster HX

Essa alteração não exige o registro novamente nem causa interrupções no cluster, pois permanece saudável durante e após a renomeação.

1.  Renomeie a entrada do nome do cluster no painel esquerdo da lista de inventário do vCenter "Renomear cluster" conforme mostrado abaixo na captura de tela. Em seguida, atualize a página do VC na WebUI do VC para verificar a alteração 

2. Observe que isso mudará o título da IU HX de acordo com o cluster, como você pode ver abaixo

Nova "manchete" da IU HX

3. Após renomear, você pode verificar a alteração na IU do VC ou no Hyperflex com os comandos abaixo, garantindo também que o cluster permanecesse saudável

root@bsv-hxaf220-sc-2-2:~# stcli cluster info | grep -ie "vc\|name\|state"
    name: HyperFlex StorageController
    locale: English (United States)
    fullName:  HyperFlex StorageController 3.5.1a
vCluster:
    state: online
        name: HX-2-cluster
    vCenterUrl: https://10.48.76.149
upgradeState: ok
    healthState: healthy
    state: online
        state: 1
        name: 192.168.20.102
        name: 192.168.20.103
        name: 192.168.20.101
state: online
    name: bsv-hxaf220-hv-2-1
    name: localhost
    name: localhost
    name: HX-2-cluster							<---
    vCenterClusterId: domain-c402
    vCenterDatacenter: HX-1-datacenter
    vCenterURL: 10.48.76.149
    vCenterDatacenterId: datacenter-61
    vCenterClusterName: HX-2-cluster
    ucsmHostName: 10.48.76.132
    name: HX-2-cluster							<---

root@bsv-hxaf220-sc-2-2:~# stcli cluster info | grep -i -B3 "hx-2-cluster"
    entityRef:
        type: virtcluster
        id: domain-c402
        name: HX-2-cluster
--
entityRef:
    type: cluster
    id: 4498191323471460155:8678800572152099082
    name: HX-2-cluster							<---
--
    vCenterDatacenter: HX-1-datacenter
    clusterType: default_cluster
    dataReplicationFactor: 2
    ucsmOrg: hx-2-cluster
--
            subnetMask: 255.255.255.128
            method: dhcp
            ----------------------------------------
    vCenterClusterName: HX-2-cluster
    ucsmHostName: 10.48.76.132
    clusterAccessPolicy: lenient
    name: HX-2-cluster							<---