As atualizações falham quando a pesquisa global está configurada incorretamente

Os OpenSearch volumes têm capacidade de armazenamento insuficiente

Se os OpenSearch volumes tiverem capacidade insuficiente, sua atualização poderá falhar. Para evitar possíveis problemas, certifique-se de que o uso atual de cada volume seja de 50% ou menos.

Você pode ver as informações de capacidade dos OpenSearch volumes na página Monitoramento > Alertas e eventos. Para obter mais informações, consulte Monitoramento da capacidade disponível dos volumes OpenSearch persistentes.

Os OpenSearch volumes foram redimensionados incorretamente

Se você aumentou o tamanho dos OpenSearch volumes editando as reivindicações OpenSearch de volume persistente, sua atualização falhará, a menos que você também edite o recurso common core services personalizado (ccs ccs-cr).

As reivindicações OpenSearch de volume persistentes não podem ser reduzidas. Se você editar as reivindicações de volume persistente sem também editar o recurso personalizado, o OpenSearch operador retornará um erro porque o tamanho das reivindicações de volume persistente é maior do que o tamanho especificado no recurso common core services personalizado.

Verificando o tamanho das reivindicações de volume persistente e o recurso personalizado

Para determinar se as reivindicações de volume persistente são maiores do que o tamanho especificado no recurso common core services personalizado:

1. Execute o seguinte comando para verificar o tamanho das reivindicações OpenSearch de volume persistente:

   oc get pvc \
   --namespace=${PROJECT_CPD_INST_OPERANDS} \
   | grep elastic

   A capacidade padrão de cada solicitação OpenSearch de volume persistente é 30Gi.

   O nome das reivindicações de volume persistente depende da versão do IBM Software Hub que você instalou:

   Versão 5.2.0 ou posterior

   • elasticsearch-master-esnodes-data-0
   • elasticsearch-master-esnodes-data-1
   • elasticsearch-master-esnodes-data-2
   • elasticsearch-master-snapshot-repo

   Versões anteriores

   • elasticsearch-master-elasticsearch-master-0
   • elasticsearch-master-elasticsearch-master-1
   • elasticsearch-master-elasticsearch-master-2
   • elasticsearch-master-backups

2. Execute o seguinte comando para verificar o valor do elasticsearch_persistence_size parâmetro no recurso common core services personalizado:

   oc get ccs ccs-cr \
   -n ${PROJECT_CPD_INST_OPERANDS} \
   -o json | jq '.spec.elasticsearch_persistence_size'

   • Se o comando retornar null, o recurso common core services personalizado está usando o tamanho padrão de 30 Gi.
   • Se o comando retornar um número, o recurso common core services personalizado está usando um tamanho personalizado.
3. Execute o seguinte comando para verificar o valor do elasticsearch_backups_persistence_size parâmetro no recurso common core services personalizado:

   oc get ccs ccs-cr \
   -n ${PROJECT_CPD_INST_OPERANDS} \
   -o json | jq '.spec.elasticsearch_backups_persistence_size'

   • Se o comando retornar null, o recurso common core services personalizado está usando o tamanho padrão de 30 Gi.
   • Se o comando retornar um número, o recurso common core services personalizado está usando um tamanho personalizado.
4. Compare os tamanhos das reivindicações OpenSearch de volume persistente com os tamanhos especificados no recurso common core services personalizado.

   Solicitação de volume persistente	Parâmetro de recurso personalizado equivalente
   Qualquer uma das seguintes reivindicações de volume persistente: elasticsearch-master-esnodes-data-* elasticsearch-master-elasticsearch-master-*	elasticsearch_persistence_size
   Qualquer uma das seguintes reivindicações de volume persistente: elasticsearch-master-snapshot-repo elasticsearch-master-backups	elasticsearch_backups_persistence_size

   • Se os tamanhos forem os mesmos, não é necessário realizar nenhuma ação.
   • Se os tamanhos no recurso common core services personalizado forem maiores do que os tamanhos das reivindicações OpenSearch de volume persistente, nenhuma ação será necessária. Os OpenSearch volumes serão redimensionados durante a atualização.
   • Se os tamanhos das reivindicações OpenSearch de volume persistente forem maiores do que os tamanhos no recurso common core services personalizado, conclua o aumento do tamanho dos volumes OpenSearch persistentes.

Aumentando o tamanho dos volumes OpenSearch persistentes

Decida quanto espaço de armazenamento você deseja adicionar aos volumes OpenSearch persistentes. Os comandos nesta seção utilizam 40Gi. No entanto, você deve ajustar esse valor com base em:

• Com que rapidez você preencheu os volumes persistentes
• O crescimento esperado dos volumes persistentes

Aumente as solicitações OpenSearch de volume persistente atualizando os seguintes parâmetros no recurso common core services personalizado:

1. Atualize o tamanho do armazenamento operacional das reivindicações de volume persistente.

   O comando a seguir aumenta o armazenamento operacional para 40 Gi:

   oc patch ccs ccs-cr \
   --namespace=${PROJECT_CPD_INST_OPERANDS} \
   --type merge \
   --patch '{"spec": {"elasticsearch_persistence_size": "40Gi"}}'

2. Atualize o tamanho do armazenamento de backup das reivindicações de volume persistente.
   O comando a seguir aumenta o armazenamento de backup para 40 Gi:

   oc patch ccs ccs-cr \
   --namespace=${PROJECT_CPD_INST_OPERANDS} \
   --type merge \
   --patch '{"spec": {"elasticsearch_backups_persistence_size": "40Gi"}}'

3. Aguarde até que o recurso common core services personalizado esteja Completed. Esse processo normalmente leva cerca de 10 minutos.

   Para verificar o status do recurso personalizado, execute:

   oc get ccs ccs-cr \
   --namespace=${PROJECT_CPD_INST_OPERANDS}

4. Execute o seguinte comando para confirmar se os CAPACITY valores correspondem aos valores especificados quando você atualizou o recurso common core services personalizado:

   oc get pvc \
   --namespace=${PROJECT_CPD_INST_OPERANDS} \
   | grep elastic

OpenSearch O operador não consegue reconciliar devido a segredos inválidos

Se o seu ambiente incluir um segredo criado automaticamente chamado elasticsearch-master-ibm-elasticsearch-cred-secret, o segredo poderá impedir que o operador faça a reconciliação.

1. Confirme se os segredos necessários, elasticsearch-master-client-secret e elasticsearch-master-server-secret, existem:

   oc get secret \
   --namespace=${PROJECT_CPD_INST_OPERANDS} \
   | grep elasticsearch-master | grep secret

2. Verifique se o elasticsearch-master-ibm-elasticsearch-cred-secret segredo existe:

   oc get secret elasticsearch-master-ibm-elasticsearch-cred-secret \
   --namespace=${PROJECT_CPD_INST_OPERANDS}

3. Se os três segredos existirem, exclua o elasticsearch-master-ibm-elasticsearch-cred-secret segredo:

   oc delete secret elasticsearch-master-ibm-elasticsearch-cred-secret \
   --namespace=${PROJECT_CPD_INST_OPERANDS}

4. Obtenha o nome do ibm-opensearch-operator-controller-manager pod:

   oc get pod --namespace=${PROJECT_CPD_INST_OPERATORS} \
   | grep ibm-opensearch-operator-controller-manager

5. Reinicie o ibm-opensearch-operator-controller-manager pod:

   oc delete pod <ibm-opensearch-operator-pod-name> \
   --namespace=${PROJECT_CPD_INST_OPERATORS}

Os nós do OpenSearch cluster estão fora de sincronia

Se o OpenSearch cluster que sustenta o recurso de pesquisa global não estiver funcionando corretamente, você poderá encontrar erros ao tentar atualizar um serviço com dependência do common core services.

Para confirmar que os OpenSearch nós estão fora de sincronia:

1. Execute o comando a seguir:

   oc get pods -n=${PROJECT_CPD_INST_OPERANDS} \
   | grep -E'elasticsearch-master-esnodes|RESTARTS'

2. Se você perceber que um pod tem várias reinicializações e é muito mais recente do que os outros pods, consulte nós OpenSearch do cluster ficam fora de sincronia para obter orientações sobre como resolver o problema.