O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Atualize o Apigee Edge 4.16.05.x para a versão 4.16.05 mais recente

Edge para nuvem privada v. 4.16.05

Este documento contém o procedimento usado para atualizar a instalação 4.16.05 para usar os RPMs e arquivos de suporte mais recentes da Apigee. Este procedimento usa o utilitário update.sh para realizar a atualização.

Quais versões do Edge podem ser atualizadas para a versão mais recente 4.16.05

Só é possível atualizar uma instalação atual da versão 4.16.05.x do Apigee Edge para a versão mais recente 4.16.05.

Se você estiver executando a versão 4.16.01.0x ou anterior do Edge, primeiro migre para a versão 4.16.05. Consulte Atualizar o Apigee Edge 4.16.01 para 4.16.05 para saber como migrar para a versão 4.16.05.

Quem pode fazer a atualização

O usuário que executa a atualização precisa ser o mesmo que instalou o Edge originalmente ou um usuário que executa como raiz.

Depois de instalar os RPMs do Edge, qualquer usuário pode configurá-los.

Requisitos de espaço em disco para atualização

Verifique se você tem pelo menos 1 GB de espaço livre em disco antes de realizar a atualização.

Propagação automática de configurações de propriedade da versão 4.16.05.x

Se você tiver definido propriedades editando arquivos .properties em /opt/apigee/customer/application, esses valores serão mantidos pela atualização.

Pré-requisitos de atualização

Antes de fazer upgrade do Apigee Edge, siga estes pré-requisitos:

Fazer backup de todos os nós
Antes de atualizar, é recomendável fazer um backup completo de todos os nós por motivos de segurança. Use o procedimento da sua versão atual do Edge para realizar o backup.

Isso permite que você tenha um plano de backup, caso a atualização para uma nova versão não funcione corretamente. Para mais informações sobre backup, consulte Backup e restauração.
Verifique se o Edge está em execução
Verifique se o Edge está em execução durante o processo de atualização usando o comando:

> /<inst_root>/apigee/apigee-service/bin/apigee-all status

Como lidar com uma falha na atualização

No caso de uma falha na atualização, tente corrigir o problema e execute update.sh novamente. É possível executar a atualização várias vezes, e ela vai continuar de onde parou.

Se a falha exigir que você reverta a atualização para a versão anterior, consulte Processo de reversão da versão 4.16.05.

Informações de atualização do Logging

Por padrão, o utilitário update.sh grava informações de registro em:

/opt/apigee/var/log/apigee-setup/update.log

Se o usuário que executa o utilitário update.sh não tiver acesso a esse diretório, ele gravará o registro no diretório /tmp como um arquivo chamado update_username.log.

Se o usuário não tiver acesso a /tmp, o utilitário update.sh vai falhar.

Atualização sem inatividade

Uma atualização sem inatividade, ou atualização gradual, permite que você atualize a instalação do Edge sem desativar o Edge.

A atualização sem inatividade só é possível com uma configuração de 5 nós ou mais.

A chave para o upgrade sem inatividade é remover cada roteador, um por vez, do balanceador de carga. Em seguida, atualize o roteador e todos os outros componentes na mesma máquina que o roteador e adicione o roteador de volta ao balanceador de carga.

Atualize as máquinas na ordem correta para sua instalação, conforme descrito abaixo em "Ordem de atualização da máquina".
Quando for hora de atualizar os roteadores, selecione um roteador e torne-o inacessível, conforme descrito na próxima seção "Como tornar um roteador e um processador de mensagens inacessíveis".
Atualize o roteador selecionado e todos os outros componentes do Edge na mesma máquina que o roteador. Todas as configurações do Edge mostram um roteador e um processador de mensagens no mesmo nó.
Torne o roteador acessível novamente.
Repita as etapas de 2 a 4 para os roteadores restantes.
Continue a atualização para as máquinas restantes na instalação.

Como tornar um roteador e um processador de mensagens inacessíveis

Em uma configuração de produção, você terá vários roteadores e processadores de mensagens para alcançar o desempenho ideal. É necessário ativar/desativar a acessibilidade desses roteadores e processadores de mensagens antes/depois da atualização.

A chamada de API a seguir configura um nó como acessível ou inacessível:

> curl -u adminEmail:pWord -X POST "http://<ms_IP>:8080/v1/servers/UUID" -d "reachable=true|false"

em que UUID é o UUID do processador de mensagens ou do roteador, e reachable é definido como verdadeiro ou falso.

Se você precisar determinar o UUID do roteador, use o seguinte comando cURL:

> curl http://<routerIP>:8081/v1/servers/self

Se você precisar determinar o UUID do processador de mensagens, use o seguinte comando cURL:

> curl http://<mpIP>:8082/v1/servers/self

Cuide do seguinte antes/depois da atualização:

No nó combinado de roteador e processador de mensagens:
- Antes da atualização, faça o seguinte:
  1. Torne o roteador inacessível usando a chamada de API mostrada acima.
  2. Tornar o processador de mensagens inacessível.
- Após a atualização, faça o seguinte:
  1. Torne o processador de mensagens acessível.
  2. Torne o roteador acessível.
Em um único nó do roteador:
- Antes da atualização, torne o roteador acessível.
- Após a atualização, torne o roteador acessível.
Em um único nó do processador de mensagens:
- Antes da atualização, torne o processador de mensagens inacessível.
- Após a atualização, torne o processador de mensagens acessível.

Como usar um arquivo de configuração silencioso

É necessário transmitir um arquivo de configuração silenciosa para o comando de atualização. O arquivo de configuração silenciosa precisa ser o mesmo usado para instalar o Edge 4.16.05.

Procedimento para atualizar a versão 4.16.05 em um nó com uma conexão de Internet externa

Use o procedimento a seguir para atualizar os componentes do Edge em um nó:

Se houver, desative todos os cron jobs configurados para realizar uma operação de reparo no Cassandra até que a atualização seja concluída.
Faça login no nó como raiz para instalar os RPMs do Edge
Observação: embora a instalação do RPM exija acesso raiz, é possível realizar a configuração do Edge sem acesso raiz.
Desative o SELinux conforme descrito em Instalar o utilitário apigee-setup do Edge.
Limpe todos os caches do Yum:
> sudo yum clean all
Faça o download do arquivo bootstrap_4.16.05.sh mais recente do Edge para /tmp/bootstrap_4.16.05.sh:
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
Atualize o utilitário apigee-service do Edge e as dependências:
> sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord

em que uName:pWord são o nome de usuário e a senha que você recebeu da Apigee. Se você omitir pWord, será necessário inseri-lo.
Use apigee-service para atualizar o utilitário apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

Essa atualização para apigee-service instala o utilitário update.sh em /<inst_dir>/apigee/apigee-setup/bin.
Execute o utilitário de atualização nos nós na ordem descrita abaixo em "Ordem de atualização da máquina":
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

O único requisito no arquivo de configuração é que ele precisa ser acessível ou legível pelo usuário "apigee". Por exemplo, coloque o arquivo no diretório /tmp no nó.

Use a opção "-c" para especificar o componente a ser atualizado. A lista de componentes possíveis inclui:
- ldap = OpenLDAP
- cs = Cassandra
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- edge =todos os componentes do Edge, exceto a IU do Edge: Management Server, processador de mensagens, Router, QPID Server, Postgres Server
- ui = interface do Edge
- all = atualiza todos os componentes na máquina (use apenas para um perfil de instalação do Edge aio ou um perfil de instalação do API BaaS asa)
- e = ElasticSearch
- b = pilha de BaaS da API
- p = Portal da API BaaS
- ebp = ElasticSearch, pilha de API BaaS e portal de API BaaS no mesmo nó
Teste a atualização executando o utilitário apigee-validate, Teste a instalação.

Procedimento para atualizar a versão 4.16.05 de um repositório local

Se os nós do Edge estiverem protegidos por um firewall ou, de alguma outra forma, proibidos de acessar o repositório da Apigee pela Internet, será possível realizar a atualização em um repositório local ou espelho do repositório da Apigee.

Depois de criar um repositório local do Edge, você tem duas opções para atualizar o Edge no repositório local:

Crie um arquivo .tar do repositório, copie o arquivo .tar para um nó e atualize o Edge usando o arquivo .tar.
Instale um servidor da Web no nó com o repositório local para que outros nós possam acessá-lo. Nginx e até mesmo o servidor da Web Apache.

Para atualizar de um repositório local 4.16.05:

Verifique se você tem um repositório local 4.16.05, conforme descrito em Instalar componentes do Edge em um nó.
Atualize o repositório local:
1. Faça o download do arquivo bootstrap_4.16.05.sh mais recente do Edge para /tmp/bootstrap_4.16.05.sh:
  > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
2. Execute a sincronização:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
Para instalar o apigee-service de um arquivo .tar:
1. No nó com o repositório local, use o seguinte comando para empacotar o repositório local em um único arquivo .tar chamado /opt/apigee/data/apigee-mirror/apigee-4.16.05.tar.gz:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
2. Copie o arquivo .tar para o nó em que você quer atualizar o Edge. Por exemplo, copie-o para o diretório /tmp no novo nó.
3. No novo nó, descompacte o arquivo no diretório /tmp:
  > tar -xzf apigee-4.16.05.tar.gz
  
  Esse comando cria um novo diretório, chamado repos, no diretório que contém o arquivo .tar. Por exemplo, /tmp/repos.
4. Faça login no nó como raiz para instalar os RPMs do Edge
  Observação: embora a instalação do RPM exija acesso raiz, é possível realizar a configuração do Edge sem acesso raiz.
5. Desative o SELinux conforme descrito em Instalar o utilitário apigee-setup do Edge.
6. Instale o utilitário apigee-service do Edge e as dependências de /tmp/repos:
  > sudo bash /tmp/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  Observe que você inclui o caminho para o diretório de repositórios neste comando.
Para instalar o apigee-service usando o servidor da Web Nginx:
1. Configure o servidor da Web Nginx conforme descrito em "Instalar do repositório usando o servidor da Web Nginx" em Instalar componentes do Edge em um nó.
2. No nó remoto, faça o download do arquivo bootstrap_4.16.05.sh do Edge para /tmp/bootstrap_4.16.05.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  
  em que uName:pWord são o nome de usuário e a senha que você definiu acima para o repositório, e remoteRepo é o endereço IP ou o nome DNS do nó do repositório.
3. Faça login no nó como raiz para instalar os RPMs do Edge
  Observação: embora a instalação do RPM exija acesso raiz, é possível realizar a configuração do Edge sem acesso raiz.
4. Desative o SELinux conforme descrito em Instalar o utilitário apigee-setup do Edge.
5. No nó remoto, instale o utilitário apigee-service do Edge e as dependências:
  > sudo bash /tmp/bootstrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uNamea pigeepassword=pWord apigeeprotocol=http://
  
  em que uName:pWord são o nome de usuário e a senha do repositório.
Se houver, desative todos os cron jobs configurados para realizar uma operação de reparo no Cassandra até que a atualização seja concluída.
Use apigee-service para atualizar o utilitário apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

Essa atualização para apigee-service instala o utilitário update.sh em <inst_dir>/apigee/apigee-setup/bin.
Execute o utilitário de atualização nos nós na ordem descrita abaixo em "Ordem de atualização da máquina":
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

O único requisito no arquivo de configuração é que ele precisa ser acessível ou legível pelo usuário "apigee". Por exemplo, coloque o arquivo no diretório /tmp no nó.

Use a opção "-c" para especificar o componente a ser atualizado. A lista de componentes possíveis inclui:
- ldap = OpenLDAP
- cs = Cassandra
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- edge =todos os componentes do Edge, exceto a IU do Edge: Management Server, processador de mensagens, Router, QPID Server, Postgres Server
- ui = interface do Edge
- all = atualiza todos os componentes na máquina (use apenas para um perfil de instalação do Edge aio ou um perfil de instalação do API BaaS asa)
- e = ElasticSearch
- b = pilha de BaaS da API
- p = Portal da API BaaS
- ebp = ElasticSearch, pilha de API BaaS e portal de API BaaS no mesmo nó
Teste a atualização executando o utilitário apigee-validate, Teste a instalação.

Ordem de atualização da máquina

A ordem em que você atualiza as máquinas em uma instalação do Edge é importante. As considerações mais importantes para uma atualização são:

Atualize todos os nós do Cassandra e do ZooKeeper antes de atualizar qualquer outro nó.
É necessário atualizar todos os nós qpidd e postgresql antes de atualizar os nós do roteador e do processador de mensagens.
Para qualquer máquina com vários componentes do Edge (servidor de gerenciamento, processador de mensagens, roteador, servidor QPID, servidor Postgres), use a opção "-c edge" para atualizar todos ao mesmo tempo.
Se uma etapa especificar que deve ser realizada em várias máquinas, faça isso na ordem especificada.
Não há uma etapa separada para atualizar a Monetização. Ele é atualizado quando você especifica a opção "-c edge".
Depois de atualizar um nó do roteador, remova todos os arquivos do diretório /opt/nginx/conf.d e reinicie o roteador.