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.

Atualização do Apigee Edge 4.17.0x para 4.18.01

Edge para nuvem privada v4.18.01

Quais versões do Edge podem ser atualizadas para a 4.18.01

É possível atualizar a versão 4.17.0x da Apigee Edge usando este procedimento.

Se você tiver uma versão do Edge anterior à 4.16.01, primeiro migre para a versão 4.16.01.x e depois atualize para a versão 4.18.01.

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.

Quais componentes você precisa atualizar

É preciso atualizar todos os componentes do Edge. O Edge não é compatível com uma configuração que contenha componentes de várias versões.

Manter a compatibilidade

Ao fazer upgrade do Apigee Edge para nuvem privada para a versão 4.18.01, é preciso garantir que a implementação resultante faça referência apenas às propriedades compatíveis nos arquivos de configuração.

Propriedade	Local	Descrição
`conf_load_balancing_load.balancing. driver.nginx.server.retry`	`router.properties`	Remova essa propriedade do arquivo `router.properties`. Para definir as opções de repetição na versão 4.18.01, use as propriedades de configuração do host virtual.

Propagação automática das configurações de propriedade

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

Adição obrigatória do parâmetro de configuração SMTPMAILFROM

O Edge 4.17.05 adicionou um novo parâmetro obrigatório ao arquivo de configuração usado quando você ativa um servidor SMTP. Se você estiver atualizando da versão 4.17.01, defina SMTPMAILFROM no arquivo de configuração ao ativar o servidor SMTP.

A versão 4.17.09 da API BaaS também adicionou suporte à propriedade SMTPMAILFROM. Ao atualizar a API BaaS da versão 4.17.01 ou 4.17.05, é preciso definir SMTPMAILFROM no arquivo de configuração.

Esse parâmetro tem o seguinte formato:

SMTPMAILFROM="My Company <myco@company.com>"

Upgrade obrigatório para o Postgres 9.6

Esta versão do Edge inclui um upgrade para o Postgres 9.6. Como parte desse upgrade, todos os dados do Postgres são migrados para o Postgres 9.6.

A maioria dos sistemas de produção do Edge usa dois nós do Postgres configurados para replicação mestre-em espera. Durante o processo de atualização, enquanto os nós do Postgres estão inativos para atualização, os dados de análise ainda são gravados nos nós do Qpid. Depois que os nós do Postgres forem atualizados e estiverem on-line novamente, os dados de análise serão enviados para os nós do Postgres.

A maneira como você realiza a atualização do Postgres depende de como você configurou o repositório de dados para os nós do Postgres:

Se você usa o armazenamento de dados local para os nós do Postgres, é necessário instalar um novo nó de espera do Postgres durante o upgrade. Depois que o upgrade for concluído, será possível desativar o novo nó de espera do Postgres.

O nó de espera extra do Postgres será necessário se você precisar reverter a atualização por qualquer motivo. Se você precisar reverter a atualização, o novo nó de espera do Postgres vai se tornar o nó mestre do Postgres após a reversão. Portanto, ao instalar o novo nó de espera do Postgres, ele precisa estar em um nó que atenda a todos os requisitos de hardware de um servidor Postgres, conforme definido nos Requisitos de instalação do Edge.

Em uma instalação de um e dois nós do Edge, as topologias usadas para prototipagem e teste, você tem apenas um nó do Postgres. É possível atualizar esses nós do Postgres diretamente sem precisar criar um novo nó do Postgres.
Se você usa armazenamento de rede para os nós do Postgres, conforme recomendado pela Apigee, não é necessário instalar um novo nó do Postgres. Nos procedimentos abaixo, é possível pular as etapas que especificam a instalação e a desativação de um novo nó de espera do Postgres.

Antes de iniciar o processo de atualização, tire um snapshot de rede do repositório de dados usado pelo Postgres. Se ocorrerem erros durante a atualização e você precisar fazer uma reversão, será possível restaurar o nó do Postgres usando esse snapshot.

Como instalar um novo nó de espera do Postgres

Esse procedimento cria um servidor em espera do Postgres em um novo nó. Instale um novo servidor de espera do Postgres para sua versão atual do Edge (4.17.0x), não para a versão 4.18.01.

Para realizar a instalação, use o mesmo arquivo de configuração que você usou para instalar a versão atual do Edge.

Para criar um novo nó de espera do Postgres:

No mestre atual do Postgres, edite o arquivo /opt/apigee/customer/application/postgresql.properties para definir o seguinte token:
```
conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32
trust\ \nhost replication apigee new_slave_ip/32 trust
```
Em que existing_slave_ip é o endereço IP do servidor em espera atual do Postgres e new_slave_ip é o endereço IP do novo nó em espera.

Se o arquivo postgresql.properties não existir, crie-o e use chown para conceder ao usuário apigee acesso a ele, como mostra o exemplo a seguir:
```
chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
```

Reinicie apigee-postgresql no mestre do Postgres:

/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

Verifique se o novo nó de espera foi adicionado visualizando o arquivo /opt/apigee/apigee-postgresql/conf/pg_hba.conf no mestre. As seguintes linhas vão aparecer no arquivo:
```
host replication apigee existing_slave_ip/32 trust
host replication apigee new_slave_ip/32 trust
```
Instale o novo servidor em espera do Postgres:
1. Edite o arquivo de configuração usado para instalar a versão atual do Edge para especificar o seguinte:
```
# IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102 
```
2. Desative o SELinux conforme descrito em Instalar o utilitário apigee-setup do Edge.
3. Faça o download do arquivo bootstrap_4.17.0x.sh do Edge (em que 4.17.0x é 4.17.01, 4.17.05 ou 4.17.09) para /tmp/bootstrap_4.17.0x.sh :
```
curl https://software.apigee.com/bootstrap_4.17.0x.sh -o /tmp/bootstrap_4.17.0x.sh
```
4. Instale o utilitário e as dependências do Edge apigee-service:
```
sudo bash /tmp/bootstrap_4.17.0x.sh apigeeuser=uName
  apigeepassword=pWord
```
5. Use apigee-service para instalar o utilitário apigee-setup:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
6. Instale o Postgres:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
```
7. No novo servidor em espera, execute o seguinte comando:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```
  Verifique se ele diz que é o de espera.

Como desativar um nó do Postgres

Depois que a atualização for concluída, desative o novo nó em espera:

Verifique se o Postgres está em execução:
> /opt/apigee/apigee-service/bin/apigee-all status

Se o Postgres não estiver em execução, inicie-o:
> /opt/apigee/apigee-service/bin/apigee-all start
Para receber o UUID do novo nó em espera, execute o seguinte comando cURL no novo nó em espera:
> curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self

O UUID do nó vai aparecer no final da saída, no formato:
"type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
Interrompa o novo nó em espera executando o seguinte comando nele:
> /opt/apigee/apigee-service/bin/apigee-all stop
No nó mestre do Postgres, edite /opt/apigee/customer/application/postgresql.properties para remover o novo nó de espera de conf_pg_hba_replication.connection:
conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust
Reinicie o apigee-postgresql no mestre do Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
Verifique se o novo nó de espera foi removido visualizando o arquivo /opt/apigee/apigee-postgresql/conf/pg_hba.conf no mestre. Você verá apenas a seguinte linha nesse arquivo:
host replication apigee existing_slave_ip/32 trust
Exclua o UUID do nó em espera do ZooKeeper fazendo a seguinte chamada de API de gerenciamento do Edge no nó do servidor de gerenciamento:
> curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

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:

> /opt/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.18.01 para mais informações.

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 em Como ativar/desativar a acessibilidade do servidor (processador de mensagens/roteador).
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.

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.
  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 inacessí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.17.0x.

Procedimento para atualizar para a versão 4.18.01 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 você estiver usando a replicação mestre-em espera do Postgres com armazenamento local, instale um novo nó em espera do Postgres, conforme descrito acima em Como instalar um novo nó em espera do Postgres.

Se você estiver usando o armazenamento de rede, não será necessário instalar o novo nó. Em vez disso, faça um snapshot de rede do repositório de dados usado pelo Postgres. Consulte Upgrade obrigatório para o Postgres 9.6 para saber mais.
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.
Instale yum-utils e yum-plugin-priorities:
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
Desative o SELinux conforme descrito em Instalar o utilitário apigee-setup do Edge.
Se você estiver instalando no Oracle 7.x, execute o seguinte comando:
> sudo yum-config-manager --enable ol7_optional_latest
Se você estiver instalando na AWS, execute os seguintes comandos yum-configure-manager:
> yum update rh-amazon-rhui-client.noarch
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
Faça o download do arquivo bootstrap_4.18.01.sh do Edge 4.18.01 para /tmp/bootstrap_4.18.01.sh:
> curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
Instale o utilitário apigee-service do Edge 4.18.01 e as dependências:
> sudo bash /tmp/bootstrap_4.18.01.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.

Por padrão, o instalador verifica se o Java 1.8 está instalado. Se não tiver, ele será instalado para você. Use a opção JAVA_FIX para especificar como lidar com a instalação do Java. JAVA_FIX usa os seguintes valores:

I = Instalar o OpenJDK 1.8 (padrão)
C = Continuar sem instalar o Java
Q = Sair. Para essa opção, você precisa instalar o Java por conta própria.
Use apigee-service para atualizar o utilitário apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
Atualize o utilitário apigee-validate no servidor de gerenciamento:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Atualize o utilitário apigee-provision:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
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".

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: servidor de gerenciamento, processador de mensagens, roteador, servidor QPID, servidor Postgres
ui = IU 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 API BaaS
p = portal de 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 no servidor de gerenciamento, conforme descrito em Testar a instalação.
Se você instalou um novo nó de espera do Postgres, desative o nó conforme descrito acima em Como desativar um nó do Postgres.

Se você estiver usando o armazenamento de rede, não será necessário instalar o novo nó. Consulte Upgrade obrigatório para o Postgres 9.6 para mais informações.

Para reverter a atualização posteriormente, use o procedimento descrito em Processo de reversão da versão 4.18.01.

Procedimento para atualizar para a versão 4.18.01 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.18.01:

Se você estiver usando a replicação mestre-em espera do Postgres, instale um novo nó em espera do Postgres, conforme descrito acima em Como instalar um novo nó em espera do Postgres.

Se você estiver usando o armazenamento de rede, não será necessário instalar o novo nó. Em vez disso, faça um snapshot de rede do repositório de dados usado pelo Postgres. Consulte Upgrade obrigatório para o Postgres 9.6 para saber mais.
Crie um repositório local 4.18.01, conforme descrito em "Criar um repositório local da Apigee" em Instalar o utilitário apigee-setup do Edge.
Observação: se você já tiver um repositório 4.17.0x, poderá adicionar o repositório 4.18.01 a ele, conforme descrito em "Atualizar um repositório local da Apigee" em Instalar o utilitário apigee-setup do Edge.
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.18.01.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.18.01.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. Instale o utilitário apigee-service do Edge e as dependências de /tmp/repos:
  > sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  Observe que você inclui o caminho para o diretório repos 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 o utilitário apigee-setup do Edge.
2. No nó remoto, faça o download do arquivo bootstrap_4.18.01.sh do Edge para /tmp/bootstrap_4.18.01.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.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. No nó remoto, instale o utilitário apigee-service do Edge e as dependências:
  > sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  
  em que uName:pWord são o nome de usuário e a senha do repositório.
Use apigee-service para atualizar o utilitário apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
Atualize o utilitário apigee-validate no servidor de gerenciamento.
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Atualize o utilitário apigee-provision:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
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".

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: servidor de gerenciamento, processador de mensagens, roteador, servidor QPID, servidor Postgres
ui = IU 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 API BaaS
p = portal de 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 no servidor de gerenciamento, conforme descrito em Testar a instalação.
Se você instalou um novo nó de espera do Postgres, desative o nó conforme descrito acima em Como desativar um nó do Postgres.

Se você estiver usando o armazenamento de rede, não será necessário instalar o novo nó. Consulte Upgrade obrigatório para o Postgres 9.6 para mais informações.

Para reverter a atualização posteriormente, use o procedimento descrito em Processo de reversão da versão 4.18.01.

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ó.
Para qualquer máquina com vários componentes do Edge (servidor de gerenciamento, processador de mensagens, roteador, servidor QPID, mas não 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".