1. Administrando o Oracle Blockchain Platform no Oracle Cloud Infrastructure (Gen 2)
  2. Gerenciar o Ciclo de Vida de uma Instância
  3. Fazer Upgrade de uma Instância

Fazer Upgrade de uma Instância

Quando uma nova release estiver disponível, você poderá fazer upgrade de uma instância usando a console do Oracle Cloud Infrastructure ou as APIs REST.

Quando uma nova release estiver disponível, você receberá uma notificação do serviço Oracle Cloud Infrastructure Notifications. Para fazer upgrade da sua instância antes do prazo especificado, conclua as etapas a seguir. Se você não fizer upgrade da ocorrência dentro do prazo, a instância será submetida a upgrade automaticamente.
  1. Na console do Oracle Cloud Infrastructure, em Serviços do Desenvolvedor, selecione Blockchain Platform.
  2. Selecione o compartimento correto e clique na instância que deseja fazer upgrade.
    Uma mensagem é exibida indicando que uma nova versão está disponível.
  3. Clique em Atualizar Instância da Plataforma e, em seguida, clique em Atualizar para confirmar.

    Observação:

    O Oracle Blockchain Platform é reiniciado como parte do processo de upgrade. O sistema permanece disponível para a maioria do processo de upgrade, mas não fica disponível enquanto é reiniciado, o que normalmente pode levar até dez minutos.
    A Mensagem de Estado é alterada para Fazendo Upgrade e uma entrada do tipo Fazer Upgrade do Blockchain Platform é exibida na tabela Solicitações de Serviço.

Fazer Upgrade da Versão da Plataforma de uma Instância

Quando uma nova versão da plataforma estiver disponível, você poderá fazer upgrade de uma instância usando a console do Oracle Cloud Infrastructure.

A versão da plataforma é a versão do Hyperledger Fabric na qual o Oracle Blockchain Platform se baseia. Quando uma nova versão estiver disponível, você receberá uma notificação do serviço Oracle Cloud Infrastructure Notifications. Por exemplo, você receberá uma notificação de que pode fazer upgrade de uma instância baseada no Hyperledger Fabric v1.4.7 para o Hyperledger Fabric v2.2.4. Para saber mais sobre versões da plataforma, consulte O que é uma Versão da Plataforma?.

Upgrade do Hyperledger Fabric v2.2.4 para o Hyperledger Fabric v2.5.3

Se você quiser fazer upgrade do Hyperledger Fabric v2.2.4 para o Hyperledger Fabric v2.5.3, a Oracle o ajudará.

Upgrade do Hyperledger Fabric v1.4.7 para o Hyperledger Fabric v2.2.4

  • A função de upgrade da plataforma para o Hyperledger Fabric v2.2.4 só está disponível para instâncias do fundador sem instâncias do participante na mesma rede. Se sua rede do Oracle Blockchain Platform contiver várias instâncias (fundador e participantes), a Oracle o ajudará com o upgrade. Para obter mais informações, consulte Solicitar um Upgrade de Plataforma para Várias Instâncias.
  • A atualização para o Hyperledger Fabric v2.2.4 significa que você usará um novo ciclo de vida de chaincode e um novo modelo que separa pacotes de chaincode das definições de chaincode. Para saber mais sobre os novos recursos, consulte Implantar e Gerenciar Chaincodes no Hyperledger Fabric v2.2.4. Quando você faz upgrade da versão da plataforma, talvez seja necessário fazer alterações em seus aplicativos existentes e chamadas de API REST para que eles funcionem com a nova versão do Hyperledger Fabric. Para saber mais sobre o impacto de uma nova versão do Hyperledger Fabric em aplicativos existentes, consulte Atualizando aplicativos para o Hyperledger Fabric v2.2.4.
  • Como as versões do SDK cliente precisam ser atualizadas para funcionar com o Hyperledger Fabric v2.2.4, para aplicativos que usam SDKs clientes, geralmente você faz upgrade primeiro e as verifica em um ambiente de teste antes de fazer upgrade do ambiente de produção.
  • Quando você faz upgrade de uma instância do Hyperledger Fabric v1.4.7 para o Hyperledger Fabric v2.2.4, as definições do serviço de solicitação não são atualizadas. Em outras palavras, uma instância submetida a upgrade usa as definições de serviço de solicitação existentes da instância do Hyperledger Fabric v1.4.7, não as definições padrão de uma nova instância do Hyperledger Fabric v2.2.4. Para obter mais informações sobre o serviço de pedidos, consulte Gerenciar Serviço de Pedidos.
  • O tempo de inatividade típico para um upgrade de plataforma é de 60 minutos para uma única instância do fundador.
  • Quando o upgrade é iniciado, todo o tráfego da instância é rejeitado até que o upgrade seja concluído. Em outras palavras, nenhuma operação administrativa ou transação pode ser processada durante o processo de atualização da plataforma.

Para fazer upgrade da versão da plataforma de uma instância, conclua as etapas a seguir.

  1. Verifique o impacto nas aplicações clientes existentes e nas chamadas de API REST e planeje as atualizações necessárias. Para obter mais informações, consulte Atualizando aplicativos para o Hyperledger Fabric v2.2.4.
  2. Na console do Oracle Cloud Infrastructure, em Serviços do Desenvolvedor, selecione Blockchain Platform.
  3. Selecione o compartimento correto e clique na instância que deseja fazer upgrade.
    Uma mensagem é exibida indicando que uma nova versão da plataforma está disponível.
  4. Clique em Atualizar Instância da Plataforma e, em seguida, clique em Atualizar para confirmar.

    Observação:

    O Oracle Blockchain Platform não estará disponível durante o processo de upgrade, que normalmente leva 60 minutos ou menos para uma única instância.
    A Mensagem de Estado é alterada para Fazendo Upgrade e uma entrada do tipo Fazer Upgrade do Blockchain Platform é exibida na tabela Solicitações de Serviço.
Quando o upgrade estiver concluído:
  • O estado da solicitação de serviço Fazer Upgrade do Blockchain Platform muda para Bem-sucedido e a Versão da Plataforma exibe a nova versão do Hyperledger Fabric.
  • Na console do Oracle Blockchain Platform, todos os códigos de cadeia do Hyperledger Fabric v1.4.7 instanciados anteriormente são exibidos na lista Chaincodes Implantados de cada página de canal específica na guia Canais, com as definições Sequência, ID do Pacote, Aprovado e Confirmado, todas mostradas como N/A.
  • Onde a guia Chaincode da plataforma Hyperledger Fabric v1.4.7 exibiu os campos ID do Código de Custo, Versões, Caminho do Código de Custo, Instalado em Pares e Instanciado em Canais, a guia Chaincodes da plataforma Hyperledger Fabric v2.2.4 exibe os campos ID do Pacote, Instalado em Pares e Implantado em Canais.
  • Os códigos de cadeia existentes do Hyperledger Fabric v1.4.7 não são listados como instalados na guia Chaincodes. Quando os pacotes de chaincode forem instalados novamente, eles serão listados na guia Chaincodes. Após o upgrade, você deverá usar as operações do ciclo de vida do Hyperledger Fabric v2.2.4 para implantar códigos de cadeia novos ou atualizar existentes.
Após o upgrade da instância, conclua as seguintes etapas:

Solicitar um Upgrade de Plataforma para Várias Instâncias

Se sua rede do Oracle Blockchain Platform contiver várias instâncias (fundador e participantes), a Oracle o ajudará com o upgrade da plataforma.

O upgrade do Hyperledger Fabric v1.4.7 para o Hyperledger Fabric v2.2.4 deve ser coordenado entre todas as instâncias da sua rede. A equipe do Oracle DevOps usa ferramentas e processos internos para concluir o upgrade. O tempo de inatividade para o processo de upgrade da plataforma é uma função do número de instâncias e geralmente está na faixa de 4 a 10 horas.

O upgrade da plataforma inclui as seguintes etapas de alto nível:

  • Você revisa o impacto em códigos de cadeia existentes, aplicativos clientes e chamadas de API REST e faz as atualizações necessárias. Para obter mais informações, consulte Atualizando aplicativos para o Hyperledger Fabric v2.2.4. Devido ao impacto potencial nos aplicativos existentes, geralmente você programará com a equipe Oracle DevOps para atualizar seu ambiente de teste ou prepará-lo primeiro antes de fazer upgrade do seu ambiente de produção.
  • Você envia uma solicitação de serviço à Oracle para fazer upgrade de um conjunto especificado de instâncias que pertence a uma ou mais redes do Oracle Blockchain Platform e fornece um contato para coordenar o upgrade. Para solicitar um upgrade, abra uma solicitação de serviço (SR) no My Oracle Support. Para saber mais sobre Solicitações de Serviço, consulte a documentação disponível em My Oracle Support. Incluir as seguintes informações na Solicitação de Serviço:
    • Região do Oracle Cloud Infrastructure
    • Nome da tenancy
    • Nomes de instância do Oracle Blockchain Platform
  • A equipe do Oracle DevOps coordena a programação de upgrade com você.
    • Todas as instâncias em uma rede do Oracle Blockchain Platform devem ser submetidas a upgrade no mesmo período.
    • Quando o upgrade é iniciado, todo o tráfego das instâncias é rejeitado até que o upgrade seja concluído. Em outras palavras, nenhuma operação administrativa ou transação pode ser processada durante o processo de atualização da plataforma.
  • A equipe do Oracle DevOps executa o processo de upgrade da plataforma e, em seguida, notifica o contato do cliente especificado quando o upgrade for concluído.
  • Depois que as instâncias forem submetidas a upgrade, atualize o aplicativo cliente, se necessário, e verifique se o aplicativo cliente funciona nas instâncias submetidas a upgrade. Para obter mais informações, consulte Atualizando aplicativos para o Hyperledger Fabric v2.2.4.