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 instância dentro do prazo, o upgrade da instância será feito automaticamente.

1. Na console do Oracle Cloud Infrastructure, em Serviços ao Desenvolvedor, selecione Blockchain Platform.
2. Selecione o compartimento correto e clique na instância da qual deseja fazer upgrade.
   Uma mensagem é exibida indicando que uma nova versão está disponível.
3. Clique em Fazer Upgrade da Instância da Plataforma e, em seguida, clique em Fazer Upgrade para confirmar.

   Observação:

   O Oracle Blockchain Platform é reiniciado como parte do processo de upgrade. O sistema permanece disponível durante a maior parte do processo de upgrade, mas não está disponível enquanto é reiniciado, o que geralmente pode levar até dez minutos.
   A Mensagem de Estado muda 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 informando que é possível 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 de plataforma, consulte O que é uma Versão de Plataforma?.

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

Caso queira fazer upgrade do Hyperledger Fabric v2.2.4 para o Hyperledger Fabric v2.5.3, a Oracle auxiliará você na atualização.

Atualizando 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 está disponível somente para instâncias fundadoras 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 ajudará você na atualização. 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 os 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. Ao fazer upgrade da versão da plataforma, talvez seja necessário fazer alterações nos aplicativos existentes e nas 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 nos aplicativos existentes, consulte Atualizando Aplicativos para o Hyperledger Fabric v2.2.4.
• Como as versões do SDK do cliente precisam ser atualizadas para funcionar com o Hyperledger Fabric v2.2.4, para aplicativos que usam SDKs do cliente geralmente você faz o upgrade primeiro e verifica-os 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 atualizada usa as definições de serviço de pedido existentes da instância do Hyperledger Fabric v1.4.7, não as definições padrão para uma nova instância do Hyperledger Fabric v2.2.4. Para obter mais informações sobre o serviço de solicitação, consulte Gerenciar Serviço de Solicitação.
• O tempo de inatividade típico para um upgrade de plataforma é de 60 minutos para uma única instância fundadora.
• Depois que o upgrade for iniciado, todo o tráfego para a instância será 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, execute as etapas a seguir.

1. Verifique o impacto nos aplicativos clientes existentes e nas chamadas de API REST e planeje as atualizações necessárias. Para obter mais informações, consulte Atualizando Aplicativos para Hyperledger Fabric v2.2.4.
2. Na console do Oracle Cloud Infrastructure, em Serviços ao Desenvolvedor, selecione Blockchain Platform.
3. Selecione o compartimento correto e clique na instância da qual deseja fazer upgrade.
   Uma mensagem é exibida indicando que uma nova versão da plataforma está disponível.
4. Clique em Fazer Upgrade da Instância da Plataforma e, em seguida, clique em Fazer Upgrade 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 muda 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 é alterado 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 chaincodes do Hyperledger Fabric v1.4.7 instanciados anteriormente são exibidos na lista Chaincodes Implantados para cada página de canal específica na guia Canais, com as configurações Sequência, ID do Pacote, Aprovado e Confirmado, todas mostradas como N/D.
• Onde a guia Chaincode da plataforma Hyperledger Fabric v1.4.7 exibe os campos ID do Chaincode, Versões, Caminho do Chaincode, 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 chaincodes existentes do Hyperledger Fabric v1.4.7 não estão listados conforme instalados na guia Chaincodes. Quando pacotes de chaincode forem instalados novamente, eles serão listados na guia Chaincodes. Após a atualização, 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 os existentes.

Após o upgrade da instância, execute as seguintes etapas:

• Atualize seu aplicativo cliente, se necessário. Para obter mais informações, consulte Atualizando Aplicativos para Hyperledger Fabric v2.2.4.
• Verifique se seu aplicativo cliente funciona na instância submetida a upgrade.

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

Se sua rede do Oracle Blockchain Platform contiver várias instâncias (fundador e participantes), a Oracle ajudará você na atualização da plataforma.

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

A atualização da plataforma inclui as seguintes etapas de alto nível:

• Você analisa o impacto nos chaincodes existentes, nos aplicativos cliente e nas chamadas de API REST e faz as atualizações necessárias. Para obter mais informações, consulte Atualizando Aplicativos para Hyperledger Fabric v2.2.4. Devido ao possível impacto nos aplicativos existentes, geralmente você agendará com a equipe DevOps da Oracle o upgrade do ambiente de teste ou do ambiente de teste antes de fazer upgrade do 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 SR (solicitação de serviço) 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.
  • Depois que o upgrade é iniciado, todo o tráfego para as 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 é concluído.
• Após o upgrade das instâncias, 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 Hyperledger Fabric v2.2.4.