Atualização Planning Analytics da versão 5.3.x para uma versão posterior 5.3 atualização

Um administrador de instância pode atualizar Planning Analytics da versão 5.3.x para uma versão posterior 5.3 refresh.

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 IBM Software 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 sejam atendidos:

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 do IBM Software 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.

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

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 o Planning Analytics, padrões de modelagem e relatórios em dados com Planning Analytics.

Observação: após atualizar a instância do serviço, a versão do componente Banco de Dados TM1 permanece a mesma. Para atualizar o componente Banco de Dados TM1 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 Banco de Dados TM1 estiver disponível, clique em Atualizar e, em seguida, clique em Atualizar novamente para confirmar a ação.