Atualização do Apigee Edge para 4.16.09

Edge for Private Cloud v. 4.16.09

Quais versões do Edge podem ser atualizadas para a versão 4.16.09

É possível atualizar o Apigee Edge versão 4.16.01.0x e 4.16.05.x para 4.16.09.

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

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.

Upgrade necessário para o Java JDK versão 8

Esta versão do Edge exige que você tenha instalado o Java JDK versão 8 em todo o Edge nós de processamento. É possível instalar o Oracle JDK 8 ou o OpenJDK 8. Se o Java JDK 8 não estiver instalado o script de atualização já pode instalá-lo para você.

Como parte da atualização para o Java 8, algumas criptografias TLS não estão mais disponíveis no Oracle JDK 8. Para a lista completa, consulte a seção "Pacotes de criptografia desativados por padrão". em http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

Fazendo downgrade do Zookeeper se atualizar de 4.16.01

A versão do RPM do Zookeeper no Edge para a nuvem privada 4.16.01 é apigee-zookeeper-3.4.5-1.0.905.noarch.rpm. Nas versões subsequentes do Edge, a versão do Zookeeper foi alterada novamente para apigee-zookeeper-3.4.5-0.0.94x. Isso impede que o yum faça upgrade do Zookeeper para uma versão posterior a partir da versão 4.16.01. O caminho para derrubar Nesse caso, execute o yum downgrade apigee-zookeeper antes de atualizar o Zookeeper.

Verifique sua versão do Zookeeper usando o seguinte comando:

> rpm -qa |grep apigee-zookeeper

Se este comando retornar a versão do Zookeeper:

apigee-zookeeper-3.4.5-1.0.905

Em seguida, é necessário fazer o downgrade.

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 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:

    &gt; /<inst_root>/apigee/apigee-service/bin/apigee-all status

Como lidar com uma atualização com falha

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

Se a falha exigir que você reverta a atualização para a versão anterior, consulte 4.16.09 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á.

Upgrade necessário para o Postgres 9.4

Esta versão do Edge inclui um upgrade para o Postgres 9.4. Como parte desse upgrade, Os dados do Postgres são migrados para o Postgres 9.4.

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 Instalação The Edge Requisitos.

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 a versão atual do Edge (4.16.01 ou 4.16.05), não para a versão 4.16.09.

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 /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ó.
  2. Reinicie o apigee-postgresql no mestre Postgres:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. 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
  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:

      # 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 Edge utilitário apigee-setup.
    3. Faça o download do arquivo Edge bootstrap_4.16.05.sh para /tmp/bootstrap_4.16.05.sh:
      &gt; curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh

      Observação: se você estiver atualizando a partir da versão 4.16.01, faça o download do arquivo bootstrap.sh do Edge.
    4. Instale o utilitário de serviço da Apigee do Edge e as dependências:
      &gt; "sudo bash" /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
    5. Use apigee-service para instalar o utilitário de configuração da Apigee:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    6. Instalar o Postgres:
      &gt; /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    7. No novo nó de espera, execute o seguinte comando:
      &gt; /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:

  1. Verifique se o Postgres está em execução:
    &gt; /opt/apigee/apigee-service/bin/apigee-all status

    Se o Postgres não estiver em execução, inicie-o:
    &gt; /opt/apigee/apigee-service/bin/apigee-all start
  2. Obtenha o UUID do novo nó de espera executando o seguinte comando cURL no novo nó de espera:
    &gt; curl -u sysAdminEmail:password http://&lt;node_IP&gt;: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"
  3. Interrompa o novo nó de espera executando o seguinte comando no novo nó de espera:
    &gt; /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 replicação da Apigee existing_slave_ip/32 trust
  5. Reinicie o apigee-postgresql no mestre do Postgres:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. 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
  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:
    &gt; curl -u sysAdminEmail:password -X EXCLUIR http://&lt;ms_IP&gt;:8080/v1/servers/&lt;new_slave_uuid&gt;

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.

  1. Atualize as máquinas na ordem correta para sua instalação, conforme descrito abaixo em "Fazer o pedido 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 descritas em Ativar/Desativar acessibilidade do servidor (processador de mensagens/roteador).
  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 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.01 ou 4.16.05.

Procedimento para Atualização para a versão 4.16.09 em um nó com uma conexão externa à Internet

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

  1. Se você estiver usando a replicação mestre-em espera do Postgres, instale uma nova como descrito acima em Como instalar um novo nó de espera do Postgres.
  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.
    Observação: embora a instalação do RPM exija acesso raiz, você pode executar o Edge sem acesso à raiz.
  4. Desative o SELinux conforme descrito em Instalar o Edge apigee-setup .
  5. Faça o download do arquivo bootstrap_4.16.09.sh do Edge 4.16.09 para /tmp/bootstrap_4.16.09.sh:
    &gt; curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh (link em inglês)
  6. Instale o utilitário Edge 4.16.09 apigee-service e dependências:
    &gt; "sudo bash" /tmp/bootstrap_4.16.09.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.
  7. Use apigee-service para atualize o utilitário de configuração da Apigee:
    1. Se você instalou a versão 4.16.01 atualizando o Edge para a versão 4.15.07.0x, precisará instalar o utilitário de configuração da Apigee:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

      Esse comando instala o utilitário update.sh em <inst_dir>/apigee/apigee-setup/bin.

      Se você já instalou o utilitário apigee-setup, atualize ele:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    2. Se você instalou a versão 4.16.01 diretamente, ou seja, não fez upgrade do 4.15.07.0x, será preciso atualizar o utilitário de configuração da Apigee:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      Esta atualização do apigee-service instala a Utilitário update.sh na &lt;inst_dir&gt;/apigee/apigee-setup/bin.
    3. Se você instalou a versão 4.16.05 diretamente ou por uma atualização, atualize o utilitário de configuração da Apigee:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      Esta atualização do apigee-service instala a Utilitário update.sh na &lt;inst_dir&gt;/apigee/apigee-setup/bin.
  8. Dependendo da sua versão atual do Edge, é necessário instalar ou atualizar o utilitário apigee-validate na Management Server.
    1. Se você estiver usando o Edge 4.16.05: atualize o utilitário apigee-validate no Servidor de gerenciamento:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    2. Se você estiver usando o Edge 4.16.01: instale o utilitário apigee-validate no Servidor de gerenciamento:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-validate install

      Observação: se você tiver instalado o utilitário apigee-validate em uma mensagem do processador ao instalar a versão 4.16.01, é possível atualizá-lo usando o seguinte comando esse nó:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

      No entanto, a partir da versão 4.16.05 e posteriores, a Apigee recomenda que você instale e execute o O utilitário apigee-validate está no servidor de gerenciamento.
    3. Se você estiver fazendo upgrade da versão 4.16.01: edite o arquivo de configuração transmitido ao utilitário apigee-validate. Em da versão 4.16.01 Edge, o arquivo de configuração usado pelo apigee-validate exigia o seguinte propriedades:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGIÃO=dc-1


      Nesta versão, o arquivo de configuração requer apenas a propriedade APIGEE_ADMINPW. Você pode remover as outras duas propriedades do arquivo.
  9. Atualize o apigee-provision utilitário:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  10. Execute o utilitário de atualização nos nós na ordem descrita abaixo em "Ordem da máquina atualizar" abaixo:
    &gt; /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ó
  11. Teste a atualização executando o utilitário de validação da Apigee no servidor de gerenciamento, conforme descritos em Testar a instalação.
  12. Se você tiver instalado um novo nó de espera do Postgres, desative-o conforme descrito acima em Como desativar um nó do Postgres.

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

Procedimento de atualização de um local para a versão 4.16.09 repositório

Se os nós de borda estiverem protegidos por firewall ou, de alguma outra forma, for proibido acessar repositório da Apigee na Internet, faça a atualização em um repositório local. ou espelho, do repositório da Apigee.

Depois de criar um repositório local do Edge, você tem duas opções para atualizar o Edge pelo repositório local:

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

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

  1. Se você estiver usando a replicação mestre-em espera do Postgres, instale uma nova como descrito acima em Como instalar um novo nó de espera do Postgres.
  2. Crie um repositório 4.16.09 local conforme descrito em "Criar um repositório da Apigee local" em Instalar a configuração da Apigee do Edge .
    Observação: se você já tiver um repositório 4.16.01 ou 4.16.05, adicione o 4.16.09 como descrito em "Atualizar um repositório da Apigee local" em Instalar a configuração da Apigee do Edge utilitário.
  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.16.09.tar.gz:
      &gt; /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:
      &gt; tar -xzf apigee-4.16.09.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:
      &gt; "sudo bash" /tmp/repos/bootstrap_4.16.09.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&quot; em Instalar o Edge utilitário apigee-setup.
    2. No nó remoto, faça o download do arquivo Edge bootstrap_4.16.09.sh para /tmp/bootstrap_4.16.09.sh:
      &gt; /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.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:
      &gt; "sudo bash" /tmp/bootstrap_4.16.09.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.
  5. Use apigee-service para atualize o utilitário de configuração da Apigee:
    1. Se você instalou a versão 4.16.01 atualizando o Edge para a versão 4.15.07.0x, precisará instalar o utilitário de configuração da Apigee:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

      Esse comando instala o utilitário update.sh em <inst_dir>/apigee/apigee-setup/bin.

      Se você já instalou o utilitário apigee-setup, atualize ele:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    2. Se você instalou a versão 4.16.01 diretamente, ou seja, não fez upgrade do 4.15.07.0x, será preciso atualizar o utilitário de configuração da Apigee:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      Esta atualização do apigee-service instala a Utilitário update.sh na &lt;inst_dir&gt;/apigee/apigee-setup/bin.
    3. Se você instalou a versão 4.16.05 diretamente ou por uma atualização, atualize o utilitário de configuração da Apigee:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      Esta atualização do apigee-service instala a Utilitário update.sh na &lt;inst_dir&gt;/apigee/apigee-setup/bin.
  6. Dependendo da sua versão atual do Edge, é necessário instalar ou atualizar o utilitário apigee-validate na Management Server.
    1. Se você estiver usando o Edge 4.16.05: atualize o utilitário apigee-validate no Servidor de gerenciamento:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    2. Se você estiver usando o Edge 4.16.01: instale o comando apigee-validate no servidor de gerenciamento:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-validate install

      Observação: se você tiver instalado o utilitário apigee-validate em uma mensagem do processador ao instalar a versão 4.16.01, é possível atualizá-lo usando o seguinte comando esse nó:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

      No entanto, a partir da versão 4.16.05 e posteriores, a Apigee recomenda que você instale e execute o utilitário de validação da Apigee no servidor de gerenciamento.
    3. Se você estiver fazendo upgrade da versão 4.16.01: edite o arquivo de configuração transmitido ao utilitário apigee-validate. Em da versão 4.16.01 Edge, o arquivo de configuração usado pelo apigee-validate exigia o seguinte propriedades:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGIÃO=dc-1


      Nesta versão, o arquivo de configuração requer apenas a propriedade APIGEE_ADMINPW. Você pode remover as outras duas propriedades do arquivo.
  7. Atualize o apigee-provision utilitário:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  8. Execute o utilitário de atualização nos nós na ordem descrita abaixo em "Ordem da máquina atualizar" abaixo:
    &gt; /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ó
  9. Teste a atualização executando o utilitário de validação da Apigee no servidor de gerenciamento, conforme descritos em Testar a instalação.
  10. Se você tiver instalado um novo nó de espera do Postgres, desative-o conforme descrito acima em Como desativar um nó do Postgres.

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

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.

Para um host independente instalação

  1. Se você estiver atualizando a partir da versão 4.16.01, faça downgrade do Zookeeper:
    &gt; yum, downgrade apigee-zookeeper
  2. Atualize o Cassandra e o ZooKeeper:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Atualizar qpidd:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Atualizar LDAP:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Interrompa o servidor Postgres, o servidor Qpid e o PostgreSQL:
    &gt; /opt/apigee/apigee-service/bin/apigee-service perímetro-postgres-server stop
    &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
  6. Atualize o postgresql:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  7. Atualize o banco de dados do Postgres:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  8. Atualize os componentes restantes do Edge:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  9. Atualizar a interface do Edge:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Para um host independente com dois hosts instalação

Consulte Topologias de instalação. para a lista de topologias de borda e números de nó.

  1. Se você estiver atualizando da versão 4.16.01, faça downgrade do Zookeeper na máquina 1:
    &gt; yum, downgrade apigee-zookeeper
  2. Atualize o Cassandra e o ZooKeeper na máquina 1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Atualize o qpidd na máquina 2:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Atualizar LDAP na máquina 1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Atualizar os componentes do Edge na máquina 1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  6. Atualize a interface na máquina 1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. Atualize o postgresql na máquina 2:
    1. Interrompa o servidor Postgres, o servidor Qpid e o postgresql:
      &gt; /opt/apigee/apigee-service/bin/apigee-service perímetro-postgres-server stop
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    2. Atualize o postgresql:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    3. Atualize o banco de dados do Postgres:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    4. Atualize os componentes do Edge na máquina 2 e na máquina 1:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  8. Atualize os componentes do Edge na máquina 2:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile

Para um cluster com 5 hosts instalação

Consulte Topologias de instalação. para a lista de topologias de borda e números de nó.

  1. Verifique se você instalou um novo nó de espera do Postgres conforme descrito acima em Como instalar um novo Postgres nó de espera.
  2. Se você estiver atualizando a partir da versão 4.16.01, faça downgrade do Zookeeper nas máquinas 1, 2 e 15h
    &gt; yum, downgrade apigee-zookeeper
  3. Atualize o Cassandra e o ZooKeeper na máquina 1, 2 e 3:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Atualize o qpidd nas máquinas 4 e 5:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Atualizar LDAP na máquina 1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Atualize os componentes do Edge na máquina 1, 2, 3:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  7. Atualize a interface na máquina 1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. Atualize as máquinas 4 e 5:
    1. Pare o servidor Postgres e o servidor Qpid na máquina 4:
      &gt; /opt/apigee/apigee-service/bin/apigee-service perímetro-postgres-server stop
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    2. Parar o servidor Postgres, o servidor Qpid e o postgresql na máquina 5:
      &gt; /opt/apigee/apigee-service/bin/apigee-service perímetro-postgres-server stop
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Interrompe o servidor Postgres e postgresql no novo nó de espera que você adicionou para reversão:
      &gt; /opt/apigee/apigee-service/bin/apigee-service perímetro-postgres-server stop
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    4. Atualizar o postgresql nas máquinas 4:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. Atualize o banco de dados do Postgres na máquina 4 (somente o mestre do Postgres):
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    6. Atualizar o postgresql nas máquinas 5:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. Inicie o servidor Postgres e o servidor Qpid nas máquinas 4 e 5:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    8. Configure o Postgres como um nó de espera executando os seguintes comandos na máquina 5h
      &gt; cd /opt/apigee/data/apigee-postgresql/pgdata
      &gt; rm -rf *
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f
      configFile
    9. 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 4, o nó mestre, execute:
      &gt; /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:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Confira se ele diz que é o modo de espera.
  9. Atualize os componentes do Edge na máquina 4, 5:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  10. Não deixe de desativar o novo nó de espera usando o procedimento acima em Como desativar um Postgres nó.

Para um cluster com 9 hosts instalação

Consulte Topologias de instalação. para a lista de topologias de borda e números de nó.

  1. Verifique se você instalou um novo nó de espera do Postgres conforme descrito acima em Como instalar um novo Postgres nó de espera.
  2. Se você estiver atualizando a partir da versão 4.16.01, faça downgrade do Zookeeper nas máquinas 1, 2 e 15h
    &gt; delícia fazer downgrade do apigee-zookeeper
  3. Atualize o Cassandra e o ZooKeeper na máquina 1, 2 e 3:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Atualize o qpidd nas máquinas 6 e 7:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Atualizar LDAP na máquina 1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Atualize os componentes do Edge na máquina 6, 7, 1, 4 e 5 nesta ordem:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  7. Atualize a interface na máquina 1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. Atualize as máquinas 8 e 9:
    1. Pare o servidor do Postgres na máquina 8:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
    2. Interrompa o servidor Postgres e o postgresql na máquina 9:
      &gt; /opt/apigee/apigee-service/bin/apigee-service perímetro-postgres-server stop
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Interrompa o servidor Qpid nas máquinas 6 e 7:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    4. Interrompe o servidor Postgres e postgresql no novo nó de espera que você adicionou para reversão:
      &gt; /opt/apigee/apigee-service/bin/apigee-service perímetro-postgres-server stop
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Atualizar o postgresql nas máquinas 8:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Atualize o banco de dados Postgres na máquina 8 (somente o mestre do Postgres):
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Atualizar o postgresql nas máquinas 9:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Inicie o servidor do servidor Postgres nas máquinas 8 e 9:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
    9. Inicie o servidor Qpid nas máquinas 6 e 7:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    10. Configure o Postgres como um nó de espera executando os seguintes comandos na máquina 9h
      &gt; cd /opt/apigee/data/apigee-postgresql/pgdata
      &gt; rm -rf *
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f
      configFile
    11. 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 8, o nó mestre, execute:
      &gt; /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:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Confira se ele diz que é o modo de espera.
  9. Atualize os componentes do Edge nas máquinas 8 e 9:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  10. Não deixe de desativar o novo nó de espera usando o procedimento acima em Como desativar um Postgres nó.

Para um cluster com 13 hosts instalação

Consulte Topologias de instalação. para a lista de topologias de borda e números de nó.

  1. Verifique se você instalou um novo nó de espera do Postgres conforme descrito acima em Como instalar um novo Postgres nó de espera.
  2. Se você estiver atualizando a partir da versão 4.16.01, faça downgrade do Zookeeper nas máquinas 1, 2 e 15h
    &gt; delícia fazer downgrade do apigee-zookeeper
  3. Atualize o Cassandra e o ZooKeeper na máquina 1, 2 e 3:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. Atualize o qpidd nas máquinas 12 e 13:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Atualizar LDAP nas máquinas 4 e 5:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Atualize os componentes do Edge na máquina 12, 13, 6, 7, 10 e 11 nesta ordem:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  7. Atualize a interface nas máquinas 6 e 7:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. Atualize as máquinas 8 e 9:
    1. Pare o servidor do Postgres na máquina 8:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
    2. Interrompa o servidor Postgres e o postgresql na máquina 9:
      &gt; /opt/apigee/apigee-service/bin/apigee-service perímetro-postgres-server stop
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Pare o servidor Qpid nas máquinas 12 e 13:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    4. Interrompe o servidor Postgres e postgresql no novo nó de espera que você adicionou para reversão:
      &gt; /opt/apigee/apigee-service/bin/apigee-service perímetro-postgres-server stop
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Atualizar o postgresql nas máquinas 8:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Atualize o banco de dados Postgres na máquina 8 (somente o mestre do Postgres):
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Atualizar o postgresql nas máquinas 9:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Inicie o servidor Postgres nas máquinas 8 e 9:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
    9. Inicie o servidor Qpid nas máquinas 12 e 13:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    10. Configure o Postgres como um nó de espera executando os seguintes comandos na máquina 9h
      &gt; cd /opt/apigee/data/apigee-postgresql/pgdata
      &gt; rm -rf *
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f
      configFile
    11. 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 8, o nó mestre, execute:
      &gt; /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:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Confira se ele diz que é o modo de espera.
  9. Atualize os componentes do Edge nas máquinas 8 e 9:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  10. Não deixe de desativar o novo nó de espera usando o procedimento acima em Como desativar um Postgres nó.

Para um cluster em cluster com 12 hosts instalação

Consulte Topologias de instalação. para a lista de topologias de borda e números de nó.

  1. Verifique se você instalou um novo nó de espera do Postgres conforme descrito acima em Como instalar um novo Postgres nó de espera.
  2. Atualize o Cassandra e o ZooKeeper:
    1. Se você estiver atualizando a partir da versão 4.16.01, faça downgrade do Zookeeper na máquina 1, 2, e 3 no data center 1:
      &gt; delícia fazer downgrade do apigee-zookeeper
    2. Nas máquinas 1, 2 e 3 do data center 1:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    3. Se você estiver atualizando a partir da versão 4.16.01, faça downgrade do Zookeeper na máquina 7, 8, e 9 no Data Center 2:
      &gt; delícia fazer downgrade do apigee-zookeeper
    4. Nas máquinas 7, 8 e 9 do data center 2
      &gt; /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
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. Máquinas 10, 11 no data center 2
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Atualizar LDAP:
    1. Máquinas 1 no data center 1
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. Máquinas 7 no data center 2
      &gt; /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
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
    2. Máquinas 10, 11, 7, 8, 9 no data center 2
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  6. Atualizar interface:
    1. Máquina 1 no data center 1:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    2. Máquina 7 no data center 2:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. Atualize a máquina 6 nos data centers 1 e 12 no data center 2:
    1. Pare o servidor Postgres na máquina 6:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
    2. Interrompa o servidor Postgres e o postgresql na máquina 12:
      &gt; /opt/apigee/apigee-service/bin/apigee-service perímetro-postgres-server stop
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Interrompa o servidor Qpid nas máquinas 4, 5, 10 e 11:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    4. Interrompe o servidor Postgres e postgresql no novo nó de espera que você adicionou para reversão:
      &gt; /opt/apigee/apigee-service/bin/apigee-service perímetro-postgres-server stop
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. Atualizar o postgresql nas máquinas 6:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Atualize o banco de dados Postgres na máquina 6 (somente o mestre do Postgres):
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Atualizar postgresql nas máquinas 12:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. Inicie o servidor do servidor Postgres nas máquinas 6 e 12:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
    9. Inicie o servidor Qpid nas máquinas 4, 5, 10 e 11:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    10. Configure o Postgres como um nó de espera executando os seguintes comandos na máquina 12h
      &gt; cd /opt/apigee/data/apigee-postgresql/pgdata
      &gt; rm -rf *
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f
      configFile
    11. 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:
      &gt; /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:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Confira se ele diz que é o modo de espera.
  8. Atualize os componentes do Edge nas máquinas 6 e 12:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  9. Não deixe de desativar o novo nó de espera usando o procedimento acima em Como desativar um Postgres nó.

Para um BaaS de API com 7 hosts instalação

Consulte Topologias de instalação. para a lista de topologias de borda e números de nó.

  1. Atualize o Cassandra nas máquinas 5, 6 e 7:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Atualize o ElasticSearch e a pilha de API BaaS nas máquinas 1, 2 e 3:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile
  3. Atualize o portal de BaaS da API na máquina 4:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Para um BaaS de API de 10 hosts instalação

Consulte Topologias de instalação. para a lista de topologias de borda e números de nó.

  1. Atualize o Cassandra na máquina 8, 9 e 10:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Atualizar o ElasticSearch nas máquinas 1, 2 e 3:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  3. Atualize a pilha de BaaS da API nas máquinas 4, 5 e 6:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  4. Atualize o portal do BaaS da API na máquina 7:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Para uma instalação fora do padrão

Se você tiver uma instalação não padrão, atualize os componentes do Edge nos seguintes locais ordem:

  1. ZooKeeper
  2. Cassandra
  3. qpidd
  4. LDAP
  5. Edge, que significa "borda -c" em todos os nós na ordem: nós com o servidor Qpid, mas não o servidor Postgres, o servidor de gerenciamento, o processador de mensagens nem o roteador.
    Observação: se o nó tiver o servidor Qpid e o Postgres instalados, execute o "-c borda" de perfil como parte da etapa 8.
  6. interface do Edge
  7. postgresql no mestre Postgres, incluindo upgrade.
  8. postgresql no modo de espera do Postgres.
  9. Edge, que significa "borda -c" em todos os nós do Qpid e do Postgres combinados ou em qualquer nós independentes do Postgres.