Atualização do Apigee Edge 4.17.01/4.17.05 para 4.17.09

Edge for Private Cloud v. 4.17.09

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

É possível atualizar a versão 4.17.01.0x/4.17.05.0x da Apigee Edge para a 4.17.09 usando este procedimento.

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

Quem pode fazer a atualização

O usuário que executa a atualização precisa ser o mesmo que instalou o Edge originalmente ou um usuário que executa como raiz.

Depois de instalar os RPMs do Edge, qualquer usuário pode fazer a configuração.

Quais componentes você precisa atualizar

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

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

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

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

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

Esse parâmetro tem a seguinte forma:

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

Atualizar pré-requisitos

Antes de fazer upgrade do Apigee Edge, siga os pré-requisitos abaixo:

  • 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. 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 funcione corretamente. Para mais informações sobre backup, consulte Backup e restauração.
  • Verifique se o Edge está em execução
    Verifique se o Edge está 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 o update.sh novamente. Você pode executar a atualização várias vezes, e ela continua de onde parou.

Se a falha exigir que você reverta a atualização para a versão anterior, consulte 4.17.09 Processo de reversão para saber mais.

Informações de atualização de registro

Por padrão, o utilitário update.sh grava informações de registro em:

/opt/apigee/var/log/apigee-setup/update.log

Se o usuário que executa o utilitário update.sh não tiver acesso a esse diretório, ele vai gravar o registro no diretório /tmp como um arquivo chamado update_username.log.

Se o usuário não tiver acesso a /tmp, o utilitário update.sh vai falhar.

Atualização sem inatividade

Uma atualização sem inatividade, ou atualização gradual, permite atualizar a instalação do Edge sem desativar o Edge.

A atualização sem inatividade só é possível com uma configuração de cinco nós ou mais.

A chave para upgrade sem tempo de inatividade é remover cada roteador, um por vez, do balanceador de carga. Em seguida, atualize o roteador e todos os outros componentes na mesma máquina que o roteador e adicione o roteador de volta ao balanceador de carga.

  1. Atualize as máquinas na ordem correta para sua instalação, conforme descrito abaixo 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 descrito em Como ativar/desativar a acessibilidade do servidor (processador de mensagens/roteador).
  3. Atualiza o roteador selecionado e todos os outros componentes do Edge na mesma máquina que o roteador. Todas as configurações de borda 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 instalação.

Antes e depois da atualização, faça o seguinte:

  • No nó combinado de roteador e processador de mensagens:
    • Antes da atualização: faça o seguinte:
      1. Tornar o roteador inacessível.
      2. Deixe o processador de mensagens inacessível.
    • Após a atualização, faça o seguinte:
      1. Deixe o processador de mensagens acessível.
      2. Torne o roteador acessível.
  • Em um único nó do roteador:
    • Antes da atualização, deixe o roteador inacessível.
    • Após a atualização, torne o roteador acessível.
  • Em um único nó do processador de mensagens:
    • Antes da atualização, torne o processador de mensagens inacessível.
    • Após a atualização, torne o processador de mensagens acessível.

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 precisa ser o mesmo usado para instalar o Edge 4.17.01.

Procedimento para atualizar para a versão 4.17.09 em um nó com uma conexão de Internet externa

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

  1. Se houver, desative todos os jobs CRON configurados para realizar uma operação de reparo no Cassandra até que a atualização seja concluída.
  2. 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, é possível realizar a configuração do Edge sem acesso raiz.
  3. Instale yum-utils e yum-plugin-priorities:
    > sudo yum install yum-utils
    > sudo yum install yum-plugin-priorities
  4. Desative o SELinux conforme descrito em Instalar o utilitário apigee-setup do Edge.
  5. Se você estiver instalando na AWS, execute o seguinte comando yum-configure-manager:
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  6. Faça o download do arquivo bootstrap_4.17.09.sh do Edge 4.17.09 para /tmp/bootstrap_4.17.09.sh:
    > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
  7. Instale o utilitário apigee-service e as dependências do Edge 4.17.09:
    > sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord

    onde uName:pWord são o nome de usuário e a senha que você recebeu do Apigee. Se você omitir pWord, será solicitado que você o insira.

    Por padrão, o instalador verifica se o Java 1.8 está instalado. Caso contrário, ele será instalado para você. Use a opção JAVA_FIX para especificar como processar a instalação do Java. JAVA_FIX recebe os seguintes valores:

    I = Instalar o OpenJDK 1.8 (padrão)
    C = Continuar sem instalar o Java
    Q = Sair. Para essa opção, você precisa instalar o Java.
  8. Use apigee-service para atualizar o utilitário apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  9. Atualize o utilitário apigee-validate no servidor de gerenciamento:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  10. Atualize o utilitário apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  11. Execute o utilitário de atualização nos nós na ordem descrita abaixo em "Ordem de atualização da máquina" abaixo:
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    O único requisito do arquivo de configuração é que o arquivo de configuração precisa estar acessível ou legível para o usuário "apigee".

    Use a opção "-c" para especificar o componente a ser atualizado. A lista de componentes possíveis inclui:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =todos os componentes do Edge, exceto a interface do Edge: servidor de gerenciamento, processador de mensagens, roteador, servidor QPID, servidor Postgres
    ui = interface do Edge
    all = atualiza todos os componentes na máquina (use apenas para um perfil de instalação do Edge aio ou um perfil de instalação do API BaaS)
    e = ElasticSearch
    b = pilha API BaaS
    p = portal da API BaaS
    ebp = ElasticSearch, pilha API BaaS e portal da API BaaS no mesmo nó
  12. Para testar a atualização, execute o utilitário apigee-validate no servidor de gerenciamento, conforme descrito em Testar a instalação.

Para fazer a reversão da atualização mais tarde, use o procedimento descrito em Processo de reversão 4.17.09.

Procedimento para atualizar para a versão 4.17.09 de um repositório local

Se os nós do Edge estiverem protegidos por firewall ou, de alguma outra forma, forem proibidos de acessar o repositório da Apigee pela Internet, será possível executar a atualização de 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 do repositório local:

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

Para atualizar de um repositório local 4.17.09:

  1. Crie um repositório local 4.17.09 conforme descrito em "Criar um repositório local da Apigee" em Instalar o utilitário apigee-setup da Apigee Edge.
    Observação: se você já tiver um repositório 4.17.01/4.17.05, adicione-o a ele, conforme descrito em "Atualizar um repositório da Apigee local" em Instalar o utilitário de configuração da Apigee Edge.
  2. Para instalar o apigee-service usando um arquivo .tar:
    1. No nó com o repositório local, use o comando abaixo para empacotar o repositório local em um único arquivo .tar chamado /opt/apigee/data/apigee-mirror/apigee-4.17.09.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 para o diretório /tmp no novo nó.
    3. No novo nó, descompacte o arquivo no diretório /tmp:
      > tar -xzf apigee-4.17.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 e as dependências do Edge em /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Inclua o caminho para o diretório de repositórios nesse comando.
  3. Para instalar o apigee-service usando o servidor da Web Nginx:
    1. Configure o servidor da Web Nginx conforme descrito em "Instalar do repositório usando o servidor da Web Nginx" em Instalar o utilitário apigee-setup do Edge.
    2. No nó remoto, faça o download do arquivo bootstrap_4.17.09.sh do Edge para /tmp/bootstrap_4.17.09.sh:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh

      em que uName:pWord são o nome de usuário e a senha definidos acima para o repositório, e remoteRepo é o endereço IP ou o nome DNS do nó do repositório.
    3. No nó remoto, instale o utilitário e as dependências do apigee-service do Edge:
      > sudo bash /tmp/bootstrap_4.17.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.
  4. Use apigee-service para atualizar o utilitário apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. Atualize o utilitário apigee-validate no servidor de gerenciamento.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. Atualize o utilitário apigee-provision:
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. Execute o utilitário de atualização nos nós na ordem descrita abaixo em "Ordem de atualização da máquina" 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 para o usuário da "apigee".

    Use a opção "-c" para especificar o componente a ser atualizado. A lista de componentes possíveis inclui:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =todos os componentes do Edge, exceto a interface do Edge: servidor de gerenciamento, processador de mensagens, roteador, servidor QPID, servidor Postgres
    ui = interface do Edge
    all = atualiza todos os componentes na máquina (use apenas para um perfil de instalação do Edge aio ou um perfil de instalação do API BaaS)
    e = ElasticSearch
    b = pilha API BaaS
    p = portal da API BaaS
    ebp = ElasticSearch, pilha API BaaS e portal da API BaaS no mesmo nó
  8. Teste a atualização executando o utilitário de validação da Apigee no servidor de gerenciamento, conforme descrito em Testar a instalação.

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

Ordem de atualização da máquina

A ordem em que você atualiza as máquinas em uma instalação do Edge é importante. As considerações mais importantes sobre 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, servidor QPID, mas não servidor Postgres), use a opção "-c edge" para atualizar todos ao mesmo tempo.
  • Se uma etapa especificar que ela precisa ser realizada em várias máquinas, faça isso na ordem especificada da máquina.
  • Não há uma etapa separada para atualizar a monetização. Ele é atualizado quando você especifica a opção "-c Edge".

Para uma instalação independente de 1 host

  1. Se você estiver atualizando da versão 4.17.01, defina SMTPMAILFROM no arquivo de configuração se você tiver ativado o SMTP no Edge. Esse parâmetro tem o formato:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. Atualize o Cassandra e o ZooKeeper:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Atualize o Qpid e o Postgres:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. Inicie o postgresql:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. Atualizar LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Atualize os componentes restantes do Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  7. Atualizar a interface do Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Para uma instalação autônoma de dois hosts

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

  1. Se você estiver atualizando da versão 4.17.01, defina SMTPMAILFROM no arquivo de configuração se você tiver ativado o SMTP no Edge. Esse parâmetro tem o seguinte formato:
    SMTPMAILFROM="Minha empresa <myco@company.com>"
  2. Atualize o Cassandra e o ZooKeeper na máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Atualize o Qpid e o Postgres na máquina 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. Inicie o postgresql na máquina 2:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. Atualize o LDAP na máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Atualize os componentes do Edge na máquina 2 e 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Atualize a interface na máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Para uma instalação de cluster de 5 hosts

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

  1. Se você estiver atualizando da versão 4.17.01, defina SMTPMAILFROM no arquivo de configuração se você tiver ativado o SMTP no Edge. Esse parâmetro tem o formato:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. Atualize o Cassandra e o ZooKeeper na máquina 1, 2 e 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Atualize o Qpid e o Postgres na máquina 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. Inicie o postgresql na máquina 4:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. Repita as etapas 3 e 4 na máquina 5.
  6. Atualize o LDAP na máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  7. Atualize os componentes do Edge nas máquinas 4, 5, 1, 2 e 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. Atualize a interface na máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Para uma instalação em cluster de 9 hosts

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

  1. Se você estiver atualizando da versão 4.17.01, defina SMTPMAILFROM no arquivo de configuração se você tiver ativado o SMTP no Edge. Esse parâmetro tem o formato:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. Atualize o Cassandra e o ZooKeeper na máquina 1, 2 e 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Atualize o Qpid e o Postgres na máquina 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. Inicie o postgresql na máquina 6:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. Repita as etapas 3 e 4 na máquina 7.
  6. Atualize o LDAP na máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  7. Atualize os componentes do Edge nas máquinas 6, 7, 8, 9, 1, 4 e 5 nesta ordem:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. Atualize a interface na máquina 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Para uma instalação em cluster de 13 hosts

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

  1. Se você estiver atualizando da versão 4.17.01, defina SMTPMAILFROM no arquivo de configuração se você tiver ativado o SMTP no Edge. Esse parâmetro tem o seguinte formato:
    SMTPMAILFROM="Minha empresa <myco@company.com>"
  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 e o Postgres na máquina 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. Inicie o postgresql na máquina 12:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. Repita as etapas 3 e 4 na máquina 13.
  6. Atualize o LDAP nas máquinas 4 e 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  7. Atualize os componentes do Edge nas máquinas 12, 13, 8, 9, 6, 7, 10 e 11 nesta ordem:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. Atualize a interface nas máquinas 6 e 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Para uma instalação em cluster com 12 hosts

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

  1. Se você estiver atualizando da versão 4.17.01, defina SMTPMAILFROM no arquivo de configuração se você tiver ativado o SMTP no Edge. Esse parâmetro tem o seguinte formato:
    SMTPMAILFROM="Minha empresa <myco@company.com>"
  2. Atualize o Cassandra e o ZooKeeper:
    1. Nas máquinas 1, 2 e 3 no 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. Atualização do qpidd:
    1. Máquinas 4 e 5 no data center 1
      1. Atualize o 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 e 11 no data center 2
      1. Atualize o 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. Atualize o postgresql:
    1. Máquinas 6 no data center 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
    2. Máquinas 12 no data center 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. Atualizar o 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
  6. Atualize os componentes do Edge:
    1. Máquinas 4, 5, 6, 1, 2, 3 no data center 1
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. Máquinas 10, 11, 12, 7, 8 e 9 no data center 2
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Atualizar a 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

Para uma instalação de BaaS de API de 7 hosts

  1. Defina SMTPMAILFROM no arquivo de configuração. Esse parâmetro tem o formato:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. Atualize o Cassandra nas máquinas 5, 6 e 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

  3. Atualize o ElasticSearch e a pilha API BaaS na máquina 1, 2 e 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile

  4. Atualize o Portal do API BaaS na máquina 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

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

  1. Defina SMTPMAILFROM no seu arquivo de configuração. Esse parâmetro tem o formato:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. Atualize o Cassandra nas máquinas 8, 9 e 10:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  3. Atualize o ElasticSearch nas máquinas 1, 2 e 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  4. Atualize a pilha API BaaS nas máquinas 4, 5 e 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  5. Atualização do Portal do API BaaS na máquina 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Para uma instalação de BaaS de API de dois data centers

Esse procedimento exige que você atualize os nós do Cassandra nos dois data centers. Se você estiver compartilhando esses nós do Cassandra com o Edge, normalmente atualizará esses nós como parte da atualização do Edge.

  1. Defina SMTPMAILFROM nos seus arquivos de configuração. Esse parâmetro tem o formato:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. Atualizar os keyspaces do Cassandra com o fator de replicação correto nos dois data centers. Você só precisa executar essa etapa uma vez em qualquer servidor do Cassandra em qualquer um dos data centers:

    Observação: os comandos abaixo de todos definem o fator de replicação como "3", indicando três nós do Cassandra no cluster. Modifique esse valor conforme necessário para sua instalação.
    1. Inicie o utilitário cqlsh do Cassandra:
      > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
    2. Execute os seguintes comandos CQL no prompt "cqlsh>" para definir os níveis de replicação dos keyspaces do Cassandra:
      1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      2. cqlsh> ALTER KEYSPACE "Apigee_Baas" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      3. cqlsh> ALTER KEYSPACE "Apigee_Baas_Locks" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      4. cqlsh> ALTER KEYSPACE "system_traces" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      5. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      6. Confira os keyspaces usando o comando:
        cqlsh> select * from system.schema_keyspaces;
      7. Saia de cqlsh:
        cqlsh> exit
  3. (Somente se você não atualizou o Cassandra como parte da atualização do Edge) Atualize os nós do Cassandra no data center 1, uma máquina por vez:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  4. (Somente se você não atualizou o Cassandra como parte da atualização do Edge) Atualize os nós do Cassandra no data center 2, uma máquina por vez:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  5. Atualize o ElasticSearch nas máquinas do data center 1, uma máquina por vez:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  6. Atualize o ElasticSearch nas máquinas do data center 2, uma por vez:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  7. Atualize a pilha API BaaS nas máquinas do data center 1, uma por vez:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  8. Atualize a pilha API BaaS nas máquinas do data center 2, uma por vez:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  9. Atualize o Portal do API BaaS nas máquinas do data center 1, uma por vez:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
  10. Atualize o Portal do API BaaS nas máquinas do data center 2, uma por vez:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
  11. Atualizar valores de keyspace de BaaS. Esse keyspace precisa ser definido para replicação no momento da instalação, mas não precisa ser no momento da execução. A remoção da replicação também economiza memória do Cassandra.

    Você só precisa executar esta etapa uma vez em qualquer servidor do Cassandra em qualquer data center:
    1. Inicie o utilitário cqlsh do Cassandra:
      > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
    2. Execute os comandos CQL abaixo para definir os níveis de replicação dos keyspaces do Cassandra:
      1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3' };
      2. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-2': '3' };
      3. Use o comando para conferir os espaços de chaves:
        cqlsh> select * from system.schema_keyspaces;
      4. Sair do cqlsh:
        cqlsh> exit

Para uma instalação não padrão

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

  1. ZooKeeper
  2. Cassandra
  3. qpidd, ps
  4. LDAP
  5. Borda, ou seja, o perfil "-c edge" em todos os nós na ordem: nós com servidor Qpid, servidor Postgres, servidor de gerenciamento, processador de mensagens e roteador.
    Observação: se o nó tiver o servidor Qpid e o Postgres instalados, execute a etapa de perfil "-c Edge".
  6. interface do Edge