Esta página foi traduzida pela API Cloud Translation.

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

Edge for Private Cloud v. 4.16.05

Este documento contém o procedimento que você usa para atualizar sua instalação 4.16.05 para usar as RPMs mais recentes e oferecer suporte aos arquivos 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 do Apigee Edge versão 4.16.05.x para a mais recente versão 4.16.05.

Se você estiver usando o Edge versão 4.16.01.0x ou anterior, primeiro migre para 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 realizar a atualização

O usuário que está executando a atualização deve ser o mesmo que originalmente instalou o Edge ou um usuário sendo executado 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 atualizar.

Propagação automática da propriedade da versão 4.16.05.x

Se você tiver definido alguma propriedade editando os arquivos .properties em /opt/apigee/customer/application, estes serão são retidos pela atualização.

Atualizar pré-requisitos

Cumpra os seguintes pré-requisitos antes de fazer upgrade do Apigee Edge:

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

Isso permite que você tenha um plano de backup, caso a atualização para uma nova versão não para funcionar 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 atualização com falha

No caso de uma falha na atualização, tente corrigir o problema e execute update.sh de novo. Você pode executar a atualização várias vezes e ela continuará de onde parou

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

Informações de atualização do Logging

Por padrão, o arquivo update.sh o utilitário 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 ao nesse diretório, ele grava 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 falhar.

Atualização sem inatividade

Uma atualização sem inatividade, ou atualização gradual, permite atualizar a instalação do Edge sem derrubando o Edge.

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

O segredo para fazer upgrade com zero inatividade é remover cada roteador do sistema de carga, um de cada vez. de carga. Depois, você atualiza o roteador e outros componentes na mesma máquina que ele. 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 "Fazer o pedido de atualização da máquina".
Quando chegar a hora de atualizar os roteadores, selecione qualquer um deles 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 de Edge na mesma máquina que ele. 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 2 a 4 para os outros roteadores.
Continue a atualização para os computadores restantes na instalação.

Criar um roteador e Processador de mensagens inacessível

Em uma configuração de produção, você terá vários roteadores e processadores de mensagens desempenho ideal e você precisa ativar/desativar a acessibilidade desses roteadores e dispositivos Processadores 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 roteador e alcançar é 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 cURL comando:

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

Tome cuidado com o 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.
No nó único do roteador:
- Antes da atualização, torne o roteador acessível.
- Após a atualização, torne o roteador acessível.
No nó único 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.

Usar um arquivo de configuração silencioso

Você precisa passar um arquivo de configuração silencioso para o comando de atualização. O arquivo de configuração silenciosa deve ser o mesmo usado para instalar o Edge 4.16.05.

Procedimento de atualização 4.16.05 em um nó com uma conexão externa de Internet

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

Se estiver presente, desative todas as tarefas do CRON configuradas para executar uma operação de reparo no Cassandra até que a atualização seja concluída.
Faça login no seu nó como raiz para instalar os RPMs do Edge
Observação: embora a instalação do RPM exija acesso raiz, você pode executar o Edge sem acesso à raiz.
Desative o SELinux conforme descrito em Instalar o Edge apigee-setup .
Limpar todos os caches do Yum:
> "sudo yum clean all"
Faça o download do arquivo Edge bootstrap_4.16.05.sh mais recente para /tmp/bootstrap_4.16.05.sh:
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh (link em inglês)
Atualize o utilitário de serviço da Apigee do Edge e as dependências:
> "sudo bash" /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord

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

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 da máquina atualizar" abaixo:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

O único requisito do arquivo de configuração é que ele esteja acessível ou legível por "apigee" usuário. 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 possíveis componentes incluem:
- ldap = OpenLDAP
- cs = Cassandr
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- borda =todos os componentes de borda, exceto a interface de usuário de borda: servidor de gerenciamento, processador de mensagens, roteador, Servidor QPID, Servidor Postgres
- interface = interface do usuário do Edge
- all = atualizar todos os componentes na máquina (use apenas para um perfil de instalação do Edge Aio) ou um perfil de instalação de API BaaS ASa)
- e = ElasticSearch
- b = pilha BaaS de API
- p = Portal BaaS da API
- ebp = ElasticSearch, pilha de API BaaS e portal de API BaaS no mesmo nó
Execute o utilitário apigee-validate para testar a atualização e Testar a instalação.

Procedimento para atualização 4.16.05 de um local repositório

Se os nós de borda estiverem protegidos por firewall ou, de alguma outra forma, for proibido acessar repositório da Apigee na Internet, faça 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 pelo repositório local:

Crie um arquivo .tar do repositório, copie o arquivo .tar em um nó e atualize o Edge pelo arquivo .tar.
Instale um servidor da Web no nó com o repositório local para que outros nós possam acessá-lo. A Apigee fornece o servidor da Web Nginx, ou você pode usar seu próprio servidor da Web.

Para atualizar a partir de um repositório 4.16.05 local:

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. Baixe o 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 (link em inglês)
2. Faça a sincronização:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
Para instalar o apigee-service usando 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 pacote apigee-mirror
2. Copie o arquivo .tar para o nó em que você quer atualizar o Edge. Por exemplo, copie-o para no diretório /tmp na um novo nó.
3. No novo nó, descompacte o arquivo para o 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 seu nó como raiz para instalar os RPMs do Edge
  Observação: embora a instalação do RPM exija acesso raiz, você pode executar o Edge sem acesso à raiz.
5. Desative o SELinux conforme descrito em Instalar o Edge utilitário apigee-setup.
6. Instale o utilitário apigee-service do Edge e as dependências em /tmp/repos:
  > "sudo bash" /tmp/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  Inclua o caminho para o diretório repos nesse comando.
Para instalar o apigee-service usando o servidor da Web Nginx:
1. Configure o servidor da Web Nginx conforme descrito em "Instalar a partir do repositório usando a linguagem Nginx" webserver" em Instalar Componentes de borda em um nó.
2. No nó remoto, faça o download do arquivo Edge bootstrap_4.16.05.sh 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 repositório, e remoteRepo é o endereço IP ou nome DNS do nó de repositório.
3. Faça login no seu nó como raiz para instalar os RPMs do Edge
  Observação: embora a instalação do RPM exija acesso raiz, você pode executar o Edge sem acesso à raiz.
4. Desative o SELinux conforme descrito em Instalar o Edge utilitário apigee-setup.
5. No nó remoto, instale o utilitário Edge Apigee-service 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 estiver presente, desative todas as tarefas do CRON configuradas para executar uma operação de reparo no Cassandra até que a atualização seja concluída.
Use apigee-service para atualizar o utilitário de configuração da Apigee:
> /opt/apigee/apigee-service/bin/apigee-service atualização de configuração da Apigee

Essa atualização do 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 da máquina atualizar" abaixo:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

O único requisito do arquivo de configuração é que ele esteja acessível ou legível por "apigee" usuário. 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 possíveis componentes incluem:
- ldap = OpenLDAP
- cs = Cassandr
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- borda =todos os componentes de borda, exceto a interface de usuário de borda: servidor de gerenciamento, processador de mensagens, roteador, Servidor QPID, Servidor Postgres
- interface = interface do usuário do Edge
- all = atualizar todos os componentes na máquina (use apenas para um perfil de instalação do Edge Aio) ou um perfil de instalação de API BaaS ASa)
- e = ElasticSearch
- b = pilha BaaS de API
- p = Portal BaaS da API
- ebp = ElasticSearch, pilha de API BaaS e portal de API BaaS no mesmo nó
Teste a atualização executando o utilitário apigee-validate, Testar 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. A maior considerações importantes para uma atualização são:

É necessário atualizar todos os nós do Cassandra e do ZooKeeper antes de atualizar outros nós.
É necessário atualizar todos os nós qpidd e postgresql antes de atualizar Roteador e processador de mensagens.
Para qualquer máquina com vários componentes de borda (servidor de gerenciamento, processador de mensagens, roteador, servidor QPID, servidor Postgres), use "-c Edge" de atualizar todas ao mesmo tempo tempo de resposta.
Se uma etapa especificar que ela deve ser realizada em várias máquinas, realize-a no ordem de máquina especificada.
Não há uma etapa separada para atualizar a monetização. Ela é atualizada quando você especifica "-c" borda" é a melhor opção.
Depois de atualizar um nó do roteador, é preciso remover todos os arquivos do diretório /opt/nginx/conf.d, e reinicie o roteador.