Esta página foi traduzida pela API Cloud Translation.

Atualização do Apigee Edge 4.16.09 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.16.09.0x para 4.18.01 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 instalou o Edge originalmente 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.

Upgrade necessário para Qpid 1.35

Esta versão contém uma atualização obrigatória para o Qpid 1.35. Como parte da atualização de um nó Qpid, você precisa:

Para impedir temporariamente que roteadores e processadores de mensagens gravem no nó Qpid, faça o seguinte: bloquear a porta 5672 no nó Qpid. Use o seguinte comando para bloquear essa porta o nó Qpid:
> "sudo iptables -A INPUT -p tcp" --destination-port 5672 -s `hostname` -i eth0 -j DROP
Aguarde até que a fila do Qpid fique vazia para garantir que o nó Qpid processou todas antes da atualização. Use o seguinte comando para garantir que a fila de mensagens Qpid seja vazio:
> qpid-stat -q
Atualize o nó Qpid.
Desbloqueie a porta 5672 no nó Qpid para permitir o acesso de roteadores e processadores de mensagens. Use o seguinte comando para desbloquear essa porta:
> "sudo iptables -F"

Se você estiver usando iptables para outras regras, poderá usar a opção -D para reverter a alteração específica:
> "sudo iptables -D INPUT -p tcp" --destination-port 5672 -s `hostname` -i eth0 -j DROP

Esse processo é descrito em detalhes abaixo para cada topologia de borda.

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.

Durante o processo de atualização, enquanto os nós do Postgres estão desativados para atualização, os dados de análise são ainda gravadas nos nós Qpid. Depois que os nós do Postgres são atualizados e voltam a ficar on-line, as análises os dados são enviados para os nós do Postgres.

O nó de espera adicional do Postgres é necessário se você precisar reverter a atualização para algum e por um bom motivo. Se você precisar reverter a atualização, o novo nó de espera do Postgres se tornará o mestre Nó do Postgres após a reversão. Portanto, quando você instala o novo nó de espera do Postgres, ele deve estar em um nó que atenda a todos os requisitos de hardware de um servidor Postgres, conforme definido no Requisitos de instalação do Edge.

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.16.09), 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 /opt/apigee/customer/application/postgresql.properties para definir o seguinte token. Se esse arquivo não existir, crie-o:

conf_pg_hba_replication.connection=host replicação da Apigee existing_slave_ip/32 trust\ \nreplicação do host new_slave_ip da Apigee/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 servidor em espera nó.
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 ao acessar /opt/apigee/apigee-postgresql/conf/pg_hba.conf (em inglês). no arquivo mestre. O arquivo inclui as seguintes linhas:
replicação de host da Apigee existente_slave_ip/32 trust
replicação do host 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:
  
  # endereço IP do endereço IP atual mestre:
  PG_MASTER=192.168.56.103
  # endereço IP do novo nó de espera
  PG_STANDBY=192.168.56.102
2. Desative o SELinux conforme descrito em Instalar o utilitário de configuração do Edge Apigee.
3. Faça o download do arquivo Edge bootstrap_4.16.09.sh para /tmp/bootstrap_4.16.09.sh:
  > curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh (link em inglês)
4. Instale o utilitário apigee-service do Edge e dependências:
  > "sudo bash" /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord
5. Use apigee-service para instale o apigee-setup utilitário:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
6. Instalar o Postgres:
  > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
7. No novo nó de 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>

Necessário para ativar o repositório EPEL

Ative a opção Pacotes extras para Enterprise Linux (ou EPEL) para instalar ou atualizar o Edge. O comando usado depende na sua versão do RedHat/CentOS:

Para RedHat/CentOS/Oracle 7.x:
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
Para RedHat/CentOS/Oracle 6.x:
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

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, você precisa definir SMTPMAILFROM no de configuração do Terraform.

Esse parâmetro tem o seguinte formato:

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

Obrigatório em atualizações ao usar autenticação externa

É possível integrar um serviço de diretório externo a uma nuvem privada do Apigee Edge. e instalação. Esse recurso foi desenvolvido para funcionar com qualquer serviço de diretório compatível com LDAP, como Active Directory, OpenLDAP e outros. Uma solução LDAP externa permite que o sistema administradores gerenciem as credenciais de usuário com um serviço centralizado de gerenciamento de diretórios. externos a sistemas como o Apigee Edge, que os usam.

Consulte Autenticação externa Configuration para saber mais.

Quando a autenticação externa está ativada, a maioria dos clientes usa a conta SAM do Active Directory campo de nome como o nome de usuário para autenticação, em vez de um endereço de e-mail que é usado pelo Servidor OpenLDAP de borda.

Se você fez a integração com um serviço de diretório externo, adicione a linha a seguir ao no arquivo de configuração ao atualizar o Edge para a versão 4.17.09:

IS_EXTERNAL_AUTH="true"

Essa linha configura o Edge para aceitar um nome de conta, em vez de um endereço de e-mail, como nome de usuário

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.

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.16.09.

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ê 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 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;
Ative o repositório EPEL conforme descrito acima.
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 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 o apigee-service para atualizar o apigee-setup (link em inglês) 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ó
Teste a atualização executando o utilitário de validação da Apigee no servidor de gerenciamento, conforme descritos em Testar a instalação.
Se você tiver instalado um novo nó de espera do Postgres, desative-o conforme descrito acima em Como desativar um Postgres nó.

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 novo nó de espera do Postgres, conforme descrito acima em Como instalar um novo nó de espera do Postgres.
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.16.09, adicione o repositório 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ó
Teste a atualização executando o utilitário de validação da Apigee no servidor de gerenciamento, conforme descritos 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.

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.