Atualizando Planning Analytics da versão 5.1 para a versão 5.3

Um administrador de instância pode atualizar Planning Analytics da versão 5.1 para a versão 5.3.

Quem precisa concluir esta tarefa?

Administrador da instância Para atualizar Planning Analytics, você deve ser um administrador da instância. Um administrador de instância tem permissão para gerenciar software nos seguintes projetos:

O projeto dos operadores para a instância

Os operadores para esta instância do Planning Analytics estão instalados no projeto operadores. Nos comandos de atualização, a variável ${PROJECT_CPD_INST_OPERATORS} de ambiente refere-se ao projeto dos operadores.

O projeto de operandos para a instância

Os recursos personalizados para o control plane e Planning Analytics são instalados no projeto operandos. Nos comandos de atualização, a variável ${PROJECT_CPD_INST_OPERANDS} de ambiente se refere ao projeto dos operandos.

Os projetos vinculados à instância
Se algum projeto estiver vinculado ao projeto operandos, você tem permissão para gerenciar o software nos projetos vinculados.
Quando você precisa concluir essa tarefa?

Analise as seguintes opções para determinar se você precisa concluir esta tarefa:

  • Se você deseja atualizar o IBM Software Hubcontrol plane e um ou mais serviços ao mesmo tempo, siga o processo em Atualizando uma instância do IBMSoftware Hub.
  • Se você não atualizou Planning Analytics ao atualizar o IBM Software Hubcontrol plane , conclua esta tarefa para atualizar Planning Analytics.

    Repita conforme necessário. Se você for responsável por várias instâncias do IBM Software Hub, poderá repetir esta tarefa para atualizar mais instâncias do Planning Analytics no cluster.

Informações necessárias para concluir esta tarefa

Analise as seguintes informações antes de atualizar Planning Analytics :

Requisitos de Versão

Todos os componentes associados a uma instância do IBM Software Hub devem ser instalados na mesma versão. Por exemplo, se o IBM Software Hubcontrol plane estiver na versão 5.3.1, você deve atualizar Planning Analytics para a versão 5.3.1.

Variáveis de ambiente
Os comandos nesta tarefa utilizam variáveis de ambiente para que você possa executá-los exatamente como estão escritos.
  • Se você não tiver o script que define as variáveis de ambiente, consulte Configurando as variáveis de ambiente de instalação.
  • Para usar as variáveis de ambiente do script, você deve obter as variáveis de ambiente antes de executar os comandos nesta tarefa. Por exemplo, execute:
    source ./cpd_vars.sh

Antes de iniciar

Esta tarefa pressupõe que os seguintes pré-requisitos estejam cumpridos:

Requisitos do sistema
Esta tarefa pressupõe que o cluster atende aos requisitos mínimos para Planning Analytics.
Onde Localizar Mais Informações
Se essa tarefa não estiver concluída, consulte Requisitos do sistema.
Estação de trabalho
Esta tarefa pressupõe que a estação de trabalho a partir da qual você executará a atualização está configurada como uma estação de trabalho cliente e possui as seguintes interfaces de linha de comando:
  • IBM Software Hub CLI: cpd-cli
  • OpenShift® CLI: oc
  • Helm CLI: oc
Onde Localizar Mais Informações
Se essa tarefa não estiver concluída, consulte Atualizando estações de trabalho do cliente.
Plano de controle
Esta tarefa pressupõe que o IBM Software Hubcontrol plane foi atualizado.
Onde Localizar Mais Informações
Se essa tarefa não estiver concluída, consulte Atualizando uma instância de IBMSoftware Hub.
Registro de contêiner privado
Se o seu ambiente usa um registro de contêiner privado (por exemplo, seu cluster é isolado), esta tarefa pressupõe que as seguintes tarefas estejam concluídas:
  1. As imagens do Planning Analytics software são espelhadas para o registro de contêiner privado.
    Onde Localizar Mais Informações
    Se essa tarefa não estiver concluída, consulte Espelhando imagens para um registro de contêiner privado.
  2. O cpd-cli está configurado para extrair a olm-utils-v4 imagem do registro de contêiner privado.
    Onde Localizar Mais Informações
    Se essa tarefa não estiver concluída, consulte Obtendo a imagem olm-utils-v4 do registro de contêiner privado.
Recursos com escopo de cluster
Esta tarefa pressupõe que os recursos no âmbito do cluster, tais como definições de recursos personalizados, funções do cluster e ligações de funções do cluster, foram atualizados.
Onde Localizar Mais Informações
Se essa tarefa não estiver concluída, consulte Atualizando os recursos do escopo do cluster para a plataforma e os serviços.
Imagem atrai segredos
Esta tarefa pressupõe que os segredos que contêm as credenciais de obtenção de imagens para a instância existem.
Onde Localizar Mais Informações
Se essa tarefa não estiver concluída, consulte Criando segredos de extração de imagem para uma instância de IBMSoftware Hub.

Procedimento

Conclua as seguintes tarefas para atualizar Planning Analytics :

  1. Atualização do serviço
  2. Validando a atualização
  3. Atualização das instâncias de serviço existentes
  4. O que fazer a seguir

Fazendo upgrade do serviço

Para atualizar Planning Analytics :

  1. Faça cpd-cli login no Red Hat® OpenShift Container Platform cluster:
    ${CPDM_OC_LOGIN}
    Lembre-se: CPDM_OC_LOGIN é um alias para o cpd-cli manage login-to-ocp comando.
  2. Atualize o operador e o recurso personalizado para Planning Analytics.
    cpd-cli manage install-components \
    --license_acceptance=true \
    --components=planning_analytics \
    --release=${VERSION} \
    --operator_ns=${PROJECT_CPD_INST_OPERATORS} \
    --instance_ns=${PROJECT_CPD_INST_OPERANDS} \
    --image_pull_prefix=${IMAGE_PULL_PREFIX} \
    --image_pull_secret=${IMAGE_PULL_SECRET} \
    --upgrade=true
Importante: A aplicação do apply-cr comando pode fazer com que a instância do serviço fique indisponível por cerca de 5 minutos. Após esse tempo, o serviço estará pronto para uso. Se você atualizar tanto o serviço quanto a instância do serviço, não será necessário esperar. Passe para a próxima etapa.

Validando a atualização

Planning Analytics é atualizado quando o install-components comando retorna:
[SUCCESS]... The install-components command ran successfully

Se você deseja confirmar que o status do recurso personalizado é Completed, execute o cpd-cli manage get-cr-status comando:

cpd-cli manage get-cr-status \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=planning_analytics

Fazendo upgrade de instâncias de serviço existentes

As instâncias do serviço são atualizadas automaticamente quando você faz a atualização Planning Analytics.

O quê fazer em seguida

A atualização do serviço pode causar uma interrupção na instância do serviço por pelo menos 5 minutos. Após esse tempo, o serviço estará pronto para uso. Para verificar o status da instância Planning Analytics do serviço, execute um dos seguintes comandos:

  • oc get PAServiceInstance ${INSTANCE_NAME} -n ${INSTANCE_PROJECT} -w

    O serviço está pronto para uso quando a saída do comando mostra que a instância estáCompletednoSTATUScoluna.

  • cpd-cli service-instance status ${INSTANCE_NAME} \
    --profile=${CPD_PROFILE_NAME} \
    --service-type=pa

    O serviço está pronto para uso quando a saída do comando mostra que a instância estáRUNNINGnoService statuscoluna.

Para obter mais informações sobre como usar Planning Analytics, modelar e relatar padrões em dados com Planning Analytics.

Observação: após atualizar a instância do serviço, a versão do componente TM1 Banco de dados permanece a mesma. Para atualizar o TM1 componente Banco de dados para a versão mais recente, você deve fazê-lo a partir da página Planning Analytics Workspace inicial:
  1. Na página Planning Analytics Workspace inicial, clique em Administração.

    A guia Detalhes exibe a versão do banco de dados instalado e quaisquer réplicas.

  2. Se uma versão mais recente do componente TM1 Banco de dados estiver disponível, clique em Atualizar e, em seguida, clique em Atualizar novamente para confirmar a ação.