Esta página foi traduzida pela API Cloud Translation.

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 o Apigee Edge versão 4.17.0x usando este procedimento.

Se você tiver uma versão do Edge anterior à 4.16.01, será necessário migrar primeiro versão 4.16.01.x e atualizar para 4.18.01.

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.

Quais componentes você precisa atualizar

É necessário atualizar todos os componentes do Edge. O Edge não oferece suporte a uma configuração que contém componentes de várias versões.

Manter compatibilidade

Ao fazer upgrade do Apigee Edge para nuvem privada para a versão 4.18.01, garanta que o resultado implementação faz referência apenas às propriedades com suporte nos arquivos de configuração.

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

Propagação automática da propriedade configurações

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

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

O Edge 4.17.05 adicionou um novo parâmetro obrigatório ao arquivo de configuração usado ao ativar um servidor SMTP. Se você estiver atualizando a partir 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 para a propriedade SMTPMAILFROM. Ao atualizar o BaaS da API da versão 4.17.01 ou 4.17.05, é necessário definir SMTPMAILFROM no de configuração do Terraform.

Esse parâmetro tem o seguinte formato:

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

Upgrade necessário para o Postgres 9.6

Esta versão do Edge inclui um upgrade para o Postgres 9.6. Como parte desse upgrade, 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 do mestre-em espera. Durante o processo de atualização, enquanto os nós do Postgres estão desativados para atualização, os dados de análise ainda são gravados nos nós Qpid. Depois que os nós do Postgres são atualizados e ficam on-line novamente, os dados de análise é enviada para os nós do Postgres.

A maneira de fazer a atualização do Postgres depende de como você configurou o armazenamento de dados para seu Nós do Postgres:

Se você usa o armazenamento de dados local para seus nós do Postgres, é necessário instalar um novo nó de espera do Postgres durante o upgrade. Após o o upgrade for concluído, desative o novo nó de espera do Postgres.

O nó de espera adicional 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 se torna o nó mestre do Postgres após a reversão. Portanto, quando você instala novo nó de espera do Postgres, ele precisa estar em um nó que atenda a todos os requisitos de um servidor Postgres, conforme definido no Requisitos de instalação.

Em uma instalação de um e dois nós do Edge, as topologias usadas para prototipagem e testes, você ter apenas um nó do Postgres. É possível atualizar esses nós do Postgres diretamente sem precisar para criar um novo nó do Postgres.
Se você usa armazenamento de rede para os nós do Postgres, siga as instruções abaixo. recomendado pela Apigee, não será preciso instalar um novo nó do Postgres. Na procedimentos abaixo, ignore as etapas que especificam a instalação e desativação posterior Nó de espera do Postgres.

Antes de iniciar o processo de atualização, faça um snapshot da rede do repositório de dados usado pelo Postgres Então, se ocorrer algum erro durante a atualização e você for forçado a executar uma reversão, é possível restaurar o nó do Postgres a partir desse snapshot.

Como instalar um novo Postgres nó de espera

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

Para executar a instalação, use o mesmo arquivo de configuração usado para instalar a versão atual do Edge.

Para criar um novo nó de espera do Postgres:

No mestre Postgres atual, edite o /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 Postgres atual. servidor em espera e new_slave_ip é o endereço IP do novo nó de espera.

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

Reinicie o apigee-postgresql no mestre Postgres:

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

Verifique se o novo nó de espera foi adicionado visualizando o /opt/apigee/apigee-postgresql/conf/pg_hba.conf no arquivo mestre. Você vai encontrar as seguintes linhas nesse arquivo:
```
host replication apigee existing_slave_ip/32 trust
host replication apigee new_slave_ip/32 trust
```
Instale o novo servidor Postgres em espera:
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 de configuração da Apigee Edge.
3. Faça o download do arquivo Edge bootstrap_4.17.0x.sh (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 Edge apigee-service e dependências:
```
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
```
  Confira se ele diz que é o modo de espera.

Como desativar um Postgres nó

Após a conclusão da atualização, desative o novo nó de 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
Obtenha o UUID do novo nó de espera executando o seguinte comando cURL no novo nó de espera:
> curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self

Você vai encontrar o UUID do nó no final da saída, no formato:
"tipo" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
Interrompa o novo nó de espera executando o seguinte comando no novo nó de espera:
> /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 replicação da 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 /opt/apigee/apigee-postgresql/conf/pg_hba.conf (em inglês). no arquivo mestre. O arquivo vai mostrar apenas a seguinte linha:
replicação de host da Apigee existing_slave_ip/32 confiança
Exclua o UUID do nó de espera do ZooKeeper tornando o seguinte gerenciamento do Edge Chamada de API no nó do servidor de gerenciamento:
> curl -u sysAdminEmail:password -X EXCLUIR http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

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 restaurar.
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 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.18.01 Processo de reversão para saber mais.

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 descritos em Ativar/Desativar o servidor (Processador/Roteador de mensagens) Acessibilidade.
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.

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

Procedimento para atualizando para 4.18.01 em um nó com uma conexão externa à Internet

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

Se você usa a replicação mestre em espera do Postgres com armazenamento local, instale um novo nó do Postgres em espera, conforme descrito acima em Como instalar um novo Postgres nó de espera.

Se você estiver usando armazenamento de rede, não será necessário instalar o novo nó. Em vez disso, snapshot da rede do repositório de dados usado pelo Postgres. Consulte Upgrade obrigatório para o Postgres 9.6 para saber mais.
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.
Instale o 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 de configuração da Apigee 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:
> atualização de delícia 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 em /tmp/bootstrap_4.18.01.sh:
> curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh (link em inglês)
Instale o utilitário Edge 4.18.01 apigee-service e 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 a Apigee. Se você omitir o pWord, será necessário digitá-lo.

Por padrão, o instalador verifica se você tem o Java 1.8 instalado. Caso contrário, o instala para você. Use a opção JAVA_FIX para especificar o processamento Instalação do Java. JAVA_FIX assume os seguintes valores:

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

Use a opção “-c” para especificar o componente a ser atualizado. A lista de possíveis de componentes inclui:
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =todos os componentes do Edge exceto a UI de borda: servidor de gerenciamento, processador de mensagens, roteador, servidor QPID, servidor do Postgres
ui = interface do Edge
all = atualizar todos os componentes em máquina (use apenas para um perfil de instalação Edge aio ou uma instalação de API BaaS asa) perfil)
e = ElasticSearch
b = pilha BaaS de API
p = portal de API BaaS
ebp = ElasticSearch, API BaaS Stack e portal de API BaaS no mesmo nó
Execute o utilitário apigee-validate na página "Gerenciamento" para testar a atualização. Server, conforme descrito em Testar a instalação.
Se você instalou um novo nó de espera do Postgres, desative-o conforme descrito acima. em Como desativar um Nó do Postgres.

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

Para reverter a atualização mais tarde, use o procedimento descrito em 4.18.01 Processo de reversão.

Procedimento de atualização de um local para a versão 4.18.01 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.18.01 local:

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

Se você estiver usando armazenamento de rede, não será necessário instalar o novo nó. Em vez disso, snapshot da 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 4.18.01 local conforme descrito em "Criar um repositório da Apigee local" em Instalar o utilitário de configuração da Apigee Apigee.
Observação: se você já tem um repositório 4.17.0x, adicione o 4.18.01 como descrito em "Atualizar um repositório da Apigee local" em Instalar o utilitário de configuração da Apigee Apigee.
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.18.01.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.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 em /tmp/repos:
  > "sudo bash" /tmp/repos/bootstrap_4.18.01.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 o Edge utilitário apigee-setup.
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 repositório, e remoteRepo é o endereço IP ou nome DNS do nó de repositório.
3. No nó remoto, instale o utilitário Edge Apigee-service 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 atualize o utilitário de configuração da Apigee:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
Atualize o apigee-validate no servidor de gerenciamento.
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Atualize o apigee-provision utilitário:
> /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 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.

Use a opção “-c” para especificar o componente a ser atualizado. A lista de possíveis de componentes inclui:
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =todos os componentes do Edge exceto a UI de borda: servidor de gerenciamento, processador de mensagens, roteador, servidor QPID, servidor do Postgres
ui = interface do Edge
all = atualizar todos os componentes em máquina (use apenas para um perfil de instalação Edge aio ou uma instalação de API BaaS asa) perfil)
e = ElasticSearch
b = pilha BaaS de API
p = portal de API BaaS
ebp = ElasticSearch, API BaaS Stack e portal de API BaaS no mesmo nó
Execute o utilitário apigee-validate no painel "Gerenciamento" para testar a atualização. Server, conforme descrito em Testar a instalação.
Se você instalou um novo nó de espera do Postgres, desative-o conforme descrito acima, em Desativação um nó do Postgres.

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

Para reverter a atualização mais tarde, use o procedimento descrito em 4.18.01 Processo de reversã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.
Para qualquer máquina com vários componentes de borda (servidor de gerenciamento, processador de mensagens, roteador, o servidor QPID, mas não o servidor Postgres), use o "-c borda". de atualizar todas ao mesmo tempo.
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.