Atualização do Apigee Edge 4.17.09 para 4.19.01

Edge para nuvem privada v4.19.01

Nesta seção, descrevemos como realizar as seguintes atualizações:

  • De 17/04/09 a 19/04

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.19.01, garanta que os implementação resultante só faz referência à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 em 4.19.01, use a ferramenta propriedades de configuração do host.

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

Se você definiu propriedades editando os arquivos .properties no /opt/apigee/customer/application, esses valores serão retidos pela atualização.

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 configuraçã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 Servidor em espera Postgres para sua versão atual do Edge (4.17.09), não para a versão 4.19.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:

  1. No mestre Postgres atual, edite o /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 replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust

    Em que existing_standby_ip é o endereço IP do Postgres atual. servidor em espera e new_standby_ip é o endereço IP do novo nó de espera.

  2. Reinicie o apigee-postgresql no mestre do Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. Verifique se o novo nó de espera foi adicionado visualizando o /opt/apigee/apigee-postgresql/conf/pg_hba.conf no mestre. Aparecerá as seguintes linhas nesse arquivo: 
    host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
  4. 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 Instale o utilitário de configuração da Apigee Apigee.
    3. Baixe o arquivo Edge bootstrap_4.17.09.sh para /tmp/bootstrap_4.17.09.sh : 
      curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
    4. Instale o utilitário Edge apigee-service e as dependências: 
      sudo bash /tmp/bootstrap_4.17.09.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 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 nó do Postgres

Após a conclusão da atualização, desative o novo nó de espera:

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

  2. Receba 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ê verá o UUID do nó no final da saída, no formato: 

    "type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"

  3. Interrompa o novo nó de espera executando o seguinte comando nele: 
    /opt/apigee/apigee-service/bin/apigee-all stop
  4. 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_standby_ip/32 trust
  5. Reinicie o apigee-postgresql no mestre do Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. Verifique se o novo nó de espera foi removido visualizando o /opt/apigee/apigee-postgresql/conf/pg_hba.conf no mestre. Aparecerá somente a seguinte linha nesse arquivo: 
    host replication apigee existing_standby_ip/32 trust
  7. 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 DELETE http://ms_IP:8080/v1/servers/new_standby_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á funcionando 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 Reverta a versão 4.19.01 para saber mais.

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 estiver executando o utilitário update.sh não tiver acesso a 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 ao /tmp, o utilitário update.sh falhar.

Atualização sem inatividade

Uma atualização sem inatividade, ou atualização gradual, permite atualizar a configuraçã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.

  1. Atualize as máquinas na ordem correta para sua configuração, conforme descrito em Ordem de atualização da máquina.
  2. 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.
  3. 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ó.
  4. Torne o roteador acessível novamente.
  5. Repita as etapas 2 a 4 para os outros roteadores.
  6. Continue a atualização para as máquinas restantes na configuraçã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.09.

Atualizar para 4.19.01 em um nó com uma conexão externa de Internet

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

  1. Se você usa a replicação mestre em espera do Postgres com armazenamento local, instale um novo nó do Postgres em espera, conforme descrito 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.

  2. 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.
  3. Faça login no seu nó como raiz para instalar os RPMs do Edge.
  4. Instale yum-utils e yum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  5. Desative o SELinux conforme descrito em Instalar o utilitário de configuração da Apigee do Edge;
  6. Se você estiver instalando no Oracle 7.x, execute o seguinte comando: 
    sudo yum-config-manager --enable ol7_optional_latest
  7. Se você estiver instalando na AWS, execute o seguinte 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
  8. Baixe o arquivo bootstrap_4.19.01.sh do Edge 4.19.01 para /tmp/bootstrap_4.19.01.sh: 
    curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
  9. Instale o utilitário apigee-service e as dependências do Edge 4.19.01: 
    sudo bash /tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord

    Em que uName:pWord é o nome de usuário e a senha que você recebeu da Apigee. Se você omitir pWord, você será solicitado a inseri-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 como lidar com Java e instalação. 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.
  10. Use apigee-service para atualizar o utilitário apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  11. Atualize o utilitário apigee-validate no servidor de gerenciamento: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  12. Atualize o utilitário apigee-provision: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  13. Execute o utilitário de atualização nos nós na ordem descrita em Ordem de atualização da máquina: 
    /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 pode ser lido pelo usuário.

    Use a opção -c para especificar o componente a ser atualizado. A lista de possíveis componentes incluem:

    • "cs" = Cassandra
    • "borda" =Todos os componentes do Edge, exceto a interface do Edge. A "borda" o componente inclui Servidor de gerenciamento, processador de mensagens, roteador, servidor QPID, servidor do Edge Postgres.
    • "ldap" = OpenLDAP
    • "ps" = postgresql
    • “qpid” = qpidd.
    • "sso" = SSO de borda
    • "iu" = interface de borda
    • "zk" = Zoológico

    Para executar update.sh em todos os componentes, defina component. como "todos", mas apenas se você tiver um perfil de configuração Edge all-in-one (AIO). Exemplo:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  14. Reinicie o componente de IU do Edge em todas as máquinas que o executam, caso ainda não tenha feito isso: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  15. Teste a atualização executando o utilitário apigee-validate no console do Cloud Server, conforme descrito em Testar a instalação.
  16. Se você instalou um novo nó de espera do Postgres, desative-o conforme descrito 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 mais informações.

Para reverter a atualização posteriormente, use o procedimento descrito em Reverter para a versão 4.19.01.

Atualização de um repositório local para a versão 4.19.01

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.19.01 local:

  1. Se você estiver usando a replicação mestre-em espera do Postgres, instale uma nova nó de espera, conforme descrito 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.

  2. Crie um repositório 4.19.01 local conforme descrito em "Criar um repositório da Apigee local" em Instale o utilitário de configuração da Apigee Apigee.
  3. 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.19.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 diretório /tmp no novo nó.
    3. No novo nó, descompacte o arquivo no diretório /tmp: 
      tar -xzf apigee-4.19.01tar.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.19.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Inclua o caminho para o diretório repos nesse comando.

  4. 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.19.01.sh do Edge para /tmp/bootstrap_4.19.01.sh: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh

      Em que uName:pWord são o nome de usuário e a senha que você definiu anteriormente para o repositório, e remoteRepo é o endereço IP ou nome DNS do nó do repo.

    3. No nó remoto, instale o utilitário Edge apigee-service e dependências: 
      sudo bash /tmp/bootstrap_4.19.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      Em que uName:pWord é o nome de usuário e a senha do repositório.

  5. Use apigee-service para atualizar o utilitário apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  6. Atualize o utilitário apigee-validate no servidor de gerenciamento: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  7. Atualize o utilitário apigee-provision: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  8. Execute o utilitário update nos nós na ordem descrita em Ordem de atualização da máquina: 
    /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 componentes incluem:

    • "cs" = Cassandra
    • "borda" =Todos os componentes do Edge, exceto a interface do Edge. A "borda" o componente inclui Servidor de gerenciamento, processador de mensagens, roteador, servidor QPID, servidor do Edge Postgres.
    • "ldap" = OpenLDAP
    • "ps" = postgresql
    • “qpid” = qpidd.
    • "sso" = SSO de borda
    • "iu" = interface de borda
    • "zk" = Zoológico

    Para executar update.sh em todos os componentes, defina component. como "todos", mas apenas se você tiver um perfil de configuração Edge all-in-one (AIO). Exemplo:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  9. Reinicie o componente de IU do Edge em todas as máquinas que o executam, caso ainda não tenha feito isso: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  10. Teste a atualização executando o utilitário apigee-validate no console do Cloud Server, conforme descrito em Testar a instalação.
  11. Se você instalou um novo nó de espera do Postgres, desative-o conforme descrito 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 Reverter 4.19.01.

Ordem de atualização da máquina

A ordem em que você atualiza as máquinas em uma configuração de 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.
.

Upgrade independente de um nó

  1. Atualize o Cassandra e o ZooKeeper: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Atualizar Qpid: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Atualizar LDAP: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Interrompa o servidor Postgres, o servidor Qpid e o PostgreSQL: 
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
  5. Atualize o postgresql: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  6. Atualize os componentes restantes do Edge: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Atualize a interface do Edge: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. (Se você instalou o apigee-adminapi) O utilitário apigee-adminapi foi atualizado: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Se você instalou o SSO do Edge) Atualize o SSO do Edge: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Em que sso_config_file é o arquivo de configuração que você criou ao instalado o SSO.

  10. Reinicie o componente Edge UI: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Upgrade independente de dois nós

Consulte Topologias de instalação para ver a lista de configurações do Edge topologias e números de nós.

  1. Atualize o Cassandra e o ZooKeeper na máquina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Atualize o Qpid na máquina 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Atualize o LDAP na máquina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Atualize os componentes do Edge na máquina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. Atualize a interface na máquina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  6. (Se você instalou o apigee-adminapi) O utilitário apigee-adminapi foi atualizado na máquina 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  7. (Se você instalou o SSO do Edge) Atualize o SSO do Edge na máquina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Em que sso_config_file é o arquivo de configuração que você criou ao instalado o SSO.

  8. Atualize o postgresql na máquina 2:
    1. Interrompa o servidor Postgres, o servidor Qpid e o postgresql:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    2. Atualize o postgresql: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    3. Atualize os componentes do Edge na máquina 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  9. Reinicie o componente Edge UI na máquina 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Upgrade de cinco nós

Consulte Topologias de instalação para ver a lista de configurações do Edge topologias e números de nós.

  1. Verifique se você instalou um novo nó de espera do Postgres conforme descrito em Como instalar um novo nó de espera do Postgres.

    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.

  2. Atualize o Cassandra e o ZooKeeper nas máquinas 1, 2 e 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Atualize o Qpid nas máquinas 4 e 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Atualize o LDAP na máquina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Atualize os componentes do Edge nas máquinas 1, 2, 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Atualize a interface na máquina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (Se você instalou o apigee-adminapi) O utilitário apigee-adminapi foi atualizado na máquina 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Se você instalou o SSO do Edge) Atualize o SSO do Edge na máquina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Em que sso_config_file é o arquivo de configuração que você criou ao instalado o SSO.

  9. Atualize as máquinas 4 e 5:
    1. Pare o servidor Postgres e o servidor Qpid na máquina 4:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    2. Interrompa o servidor Postgres, o servidor Qpid e o postgresql na máquina 5: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Se instalado, interrompa o servidor Postgres e o postgresql no novo modo de espera nó adicionado para reversão: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    4. Atualize o postgresql nas máquinas 4: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. Atualize o postgresql nas máquinas 5: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Inicie o servidor Postgres e o servidor Qpid nas máquinas 4 e 5: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    7. Configure o Postgres como um nó de espera executando os seguintes comandos na máquina 5: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    8. Verifique o status da replicação emitindo os scripts a seguir nos dois servidores. A sistema deve exibir resultados idênticos em ambos os servidores para garantir uma replicação bem-sucedida:
      • Na máquina 4, o nó mestre, execute: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        Confira se ele diz que é o mestre.

      • Na máquina 5, o nó de espera: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        Confira se ele diz que é o modo de espera.

  10. Atualize os componentes do Edge na máquina 4, 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. Verifique se você desativou o novo nó de espera conforme descrito 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.

  12. Reinicie o componente Edge UI na máquina 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Upgrade em cluster de nove nós

Consulte Topologias de instalação para ver a lista de configurações do Edge topologias e números de nós.

  1. Verifique se você instalou um novo nó de espera do Postgres, conforme descrito em Como instalar um novo nó de espera do Postgres.

    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.

  2. Atualize o Cassandra e o ZooKeeper nas máquinas 1, 2 e 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Atualize o Qpid nas máquinas 6 e 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Atualize o LDAP na máquina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Atualize os componentes do Edge na máquina 6, 7, 1, 4 e 5 nesta ordem: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Atualize a interface na máquina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (Se você instalou o apigee-adminapi) O utilitário apigee-adminapi foi atualizado na máquina 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Se você instalou o SSO do Edge) Atualize o SSO do Edge na máquina 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Em que sso_config_file é o arquivo de configuração que você criou ao instalado o SSO.

  9. Atualize as máquinas 8 e 9:
    1. Pare o servidor Postgres na máquina 8: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Interrompa o servidor Postgres e o postgresql na máquina 9: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Interrompa o servidor Qpid nas máquinas 6 e 7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Se instalado, interrompa o servidor Postgres e o postgresql no novo modo de espera nó adicionado para reversão: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Atualize o postgresql nas máquinas 8: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Atualize o postgresql nas máquinas 9: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. Inicie o servidor do servidor Postgres nas máquinas 8 e 9: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    8. Inicie o servidor do servidor Qpid nas máquinas 6 e 7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    9. Configure o Postgres como um nó de espera executando os seguintes comandos na máquina 9: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    10. Verifique o status da replicação emitindo os scripts a seguir nos dois servidores. A sistema deve exibir resultados idênticos em ambos os servidores para garantir uma replicação bem-sucedida:
      • Na máquina 8, o nó mestre, execute: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        Confira se ele diz que é o mestre.

      • Na máquina 9, o nó de espera: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        Confira se ele diz que é o modo de espera.

  10. Atualize os componentes do Edge nas máquinas 8 e 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. Verifique se você desativou o novo nó de espera conforme descrito 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.

  12. Reinicie o componente Edge UI na máquina 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Upgrade em cluster de 13 nós

Consulte Topologias de instalação para ver a lista de configurações do Edge topologias e números de nós.

  1. Verifique se você instalou um novo nó de espera do Postgres, conforme descrito em Como instalar um novo nó de espera do Postgres.

    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.

  2. Atualize o Cassandra e o ZooKeeper nas máquinas 1, 2 e 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Atualize o Qpid nas máquinas 12 e 13: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Atualize o LDAP nas máquinas 4 e 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Atualize os componentes do Edge na máquina 12, 13, 6, 7, 10 e 11 nesta ordem: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Atualize a interface nas máquinas 6 e 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (Se você instalou o apigee-adminapi) Atualização do utilitário apigee-adminapi nas máquinas 6 e 7: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Se você instalou o SSO do Edge) Atualize o SSO do Edge nas máquinas 6 e 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Em que sso_config_file é o arquivo de configuração que você criou ao instalado o SSO.

  9. Atualize as máquinas 8 e 9:
    1. Pare o servidor Postgres na máquina 8: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Interrompa o servidor Postgres e o postgresql na máquina 9: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Pare o servidor Qpid nas máquinas 12 e 13: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Se instalado, interrompa o servidor Postgres e o postgresql no novo modo de espera nó adicionado para reversão: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Atualize o postgresql nas máquinas 8: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Atualize o postgresql nas máquinas 9: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. Inicie o servidor Postgres nas máquinas 8 e 9: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    8. Inicie o servidor do servidor Qpid nas máquinas 12 e 13: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    9. Configure o Postgres como um nó de espera executando os seguintes comandos na máquina 9: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    10. Verifique o status da replicação emitindo os scripts a seguir nos dois servidores. A sistema deve exibir resultados idênticos em ambos os servidores para garantir uma replicação bem-sucedida:
      • Na máquina 8, o nó mestre, execute: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        Confira se ele diz que é o mestre.

      • Na máquina 9, o nó de espera: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        Confira se ele diz que é o modo de espera.

  10. Atualize os componentes do Edge nas máquinas 8 e 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. Verifique se você desativou o novo nó de espera conforme descrito 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.

  12. Reinicie o componente Edge UI nas máquinas 6 e 7: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Upgrade em cluster de 12 nós

Consulte Topologias de instalação para ver a lista de configurações do Edge topologias e números de nós.

  1. Verifique se você instalou um novo nó de espera do Postgres, conforme descrito em Como instalar um novo nó de espera do Postgres.

    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 mais informações.

  2. Atualize o Cassandra e o ZooKeeper:
    1. Nas máquinas 1, 2 e 3 do data center 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. Nas máquinas 7, 8 e 9 no data center 2 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Atualize o qpidd:
    1. Máquinas 4, 5 no data center 1
      1. Atualize qpidd na máquina 4: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Repita a etapa 1 na máquina 5.
    2. Máquinas 10, 11 no data center 2
      1. Atualize qpidd na máquina 10: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Repita a etapa 1 na máquina 11.
  4. Atualizar LDAP:
    1. Máquinas 1 no data center 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. Máquinas 7 no data center 2 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Atualize os componentes do Edge:
    1. Máquinas 4, 5, 1, 2, 3 no data center 1 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. Máquinas 10, 11, 7, 8, 9 no data center 2 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Atualizar interface:
    1. Máquina 1 no Data center 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    2. Máquina 7 no data center 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (Se você instalou o apigee-adminapi) O utilitário apigee-adminapi foi atualizado:
    1. Máquina 1 no Data center 1: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
    2. Máquina 7 no data center 2: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Se você instalou o SSO do Edge) Atualize o SSO do Edge:
    1. Máquina 1 no Data center 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. Máquina 7 no data center 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

      3. Em que sso_config_file é o arquivo de configuração que você criou ao instalado o SSO.

  9. Atualize a máquina 6 no data center 1 e 12 no data center 2:
    1. Pare o servidor Postgres na máquina 6: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Interrompa o servidor Postgres e o postgresql na máquina 12: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Interrompa o servidor Qpid nas máquinas 4, 5, 10 e 11: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. Se instalado, interrompa o servidor Postgres e o postgresql no novo modo de espera nó adicionado para reversão: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Atualize o postgresql nas máquinas 6: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Atualize o postgresql nas máquinas 12: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. Inicie o servidor do servidor Postgres nas máquinas 6 e 12: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    8. Inicie o servidor do servidor Qpid nas máquinas 4, 5, 10 e 11: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    9. Configure o Postgres como um nó de espera executando os seguintes comandos na máquina 12: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    10. Verifique o status da replicação emitindo os scripts a seguir nos dois servidores. A sistema deve exibir resultados idênticos em ambos os servidores para garantir uma conexão replicação:

      Na máquina 6, o nó mestre, execute:

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      Confira se ele diz que é o mestre.

      Na máquina 12, o nó de espera:

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Confira se ele diz que é o modo de espera.

  10. Atualize os componentes do Edge nas máquinas 6 e 12: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. Certifique-se de desativar o novo nó de espera conforme descrito em Como desativar um Postgres nó.

    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 mais informações.

  12. Reinicie o componente Edge UI nas máquinas 1 e 7: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Para um upgrade fora do padrão

Se você tiver uma configuração que não é padrão, atualize os componentes do Edge da seguinte maneira: ordem:

  1. ZooKeeper
  2. Cassandra
  3. qpidd, ps
  4. LDAP
  5. Edge, que significa "borda -c" em todos os nós na ordem: nós com o servidor Qpid, Servidor do Edge Postgres, servidor de gerenciamento, processador de mensagens e roteador.
  6. interface do Edge
  7. apigee-adminapi
  8. SSO de borda

Depois de concluir a atualização, reinicie o componente de IU do Edge em todas as máquinas em execução reimplantá-lo.