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 Apigee Edge versão 4.16.01.0x e 4.16.05.x para 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 e depois atualize para a versão 4.17.09.
- É possível migrar a versão 4.15.07 da Apigee Edge para a 4.16.01.
- Se você tiver uma versão do Edge anterior à 4.15.07, será necessário migrar primeiro para a
versão 4.15.07 e, em seguida, para a versão 4.16.01.
- Se você estiver migrando da versão 4.14.04 ou mais recente do Edge: migre diretamente para a versão 4.15.07.
- Se você estiver migrando da versão 4.14.01 do Edge: primeiro migre para a versão 4.14.04 e depois para a versão 4.15.07.
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.
Fazer downgrade do Zookeeper se a atualização for feita a partir da 4.16.01
A versão do RPM do Zookeeper no Edge para nuvem privada 4.16.01 é apigee-zookeeper-3.4.5-1.0.905.noarch.rpm. Nas versões posteriores do Edge, a versão do Zookeeper foi alterada de volta para apigee-zookeeper-3.4.5-0.0.94x. Isso impede que o yum faça upgrade do Zookeeper para versões posteriores a partir da versão 4.16.01. Para corrigir essa situação, execute 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 esse comando retornar a versão do Zookeeper:
apigee-zookeeper-3.4.5-1.0.905
Em seguida, faça o downgrade.
Propagação automática de configurações da propriedade
Se você tiver definido alguma propriedade editando os arquivos .properties em /opt/apigee/customer/application, esses valores serã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. 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
Confira se o Edge está em execução durante o processo de atualização usando o comando:
> /opt/apigee/apigee-service/bin/apigee-all status
Como lidar com uma falha na atualização
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 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 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.
Upgrade obrigatório para o Java JDK versão 8
Esta versão do Edge exige a instalação do Java JDK versão 8 em todos os nós de processamento do Edge. É possível instalar o Oracle JDK 8 ou o OpenJDK 8. Se o Java JDK 8 ainda não estiver instalado, o script de atualização poderá fazer isso por 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 conferir a lista completa, consulte a seção "Default Disabled Cipher Suites" em http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.
Necessário para ativar o repositório EPEL
É necessário ativar os Extra Packages for Enterprise Linux (ou EPEL) para instalar ou atualizar o Edge. O comando que você usa depende da sua versão do RedHat/CentOS:
- Para RedHat/CentOS 7.x:
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm - Para RedHat/CentOS 6.x:
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm
Adição obrigatória 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 o API BaaS, é necessário definir SMTPMAILFROM no arquivo de configuração.
Esse parâmetro tem o seguinte formato:
SMTPMAILFROM="My Company <myco@company.com>"
Obrigatório se a atualização for feita ao usar autenticação externa
É possível integrar um serviço de diretório externo a uma instalação de nuvem privada do Apigee Edge. Esse recurso foi projetado para funcionar com qualquer serviço de diretório compatível com LDAP, como o Active Directory, o OpenLDAP e outros. Uma solução LDAP externa permite que os administradores do sistema gerenciem as credenciais do usuário em um serviço de gerenciamento de diretório centralizado, externo a sistemas como o Apigee Edge que as usam.
Consulte Configuração de autenticação externa para saber mais.
Quando a autenticação externa está ativada, a maioria dos clientes usa o campo de nome da conta SAM do Active Directory como o nome de usuário para autenticação, em vez de um endereço de e-mail usado pelo servidor OpenLDAP do Edge.
Se você tiver feito a integração com um serviço de diretório externo, adicione a seguinte linha ao arquivo de configuração ao atualizar o Edge para a versão 4.17.09:
IS_EXTERNAL_AUTH="true"
Essa linha configura o Edge para oferecer suporte a um nome de conta, em vez de um endereço de e-mail, como o nome de usuário.
Upgrade obrigatório para Qpid 1.35
Esta versão contém uma atualização necessária para o Qpid 1.35. Como parte da atualização de um nó Qpid, você precisa:
- Impeça temporariamente que os roteadores e processadores de mensagens gravem no nó Qpid
bloqueando a porta 5672 no nó Qpid. Use o comando a seguir para bloquear essa porta no
nó Qpid:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - Aguarde até que a fila Qpid esteja vazia para garantir que o nó Qpid tenha processado todas as
mensagens antes da atualização. Use o comando a seguir para garantir que a fila de mensagens Qpid esteja
vazia:
> qpid-stat -q - Atualize o nó Qpid.
- Desbloqueie a porta 5672 no nó Qpid para permitir o acesso de roteadores e processadores de mensagens.
Use o comando a seguir para desbloquear a porta:
> sudo iptables -F
Se você estiver usando iptables para outras regras, use a opção -D para reverter a mudança específica:
> sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
Esse processo é descrito em detalhes abaixo para cada topologia do Edge.
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, todos 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 inativos 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 voltam a ficar on-line, os dados de análise são enviados para eles.
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 tornará o nó mestre do Postgres após a reversão. Portanto, ao instalar o novo nó de espera do Postgres, ele precisa estar em um nó que atenda a todos os requisitos de hardware de um servidor do Postgres, conforme definido nos Requisitos de instalação do Edge.
Instalação de um novo nó de standby do Postgres
Este procedimento cria um servidor de reserva do Postgres em um novo nó. Instale um novo servidor de espera do Postgres para a versão atual do Edge (4.16.01 ou 4.16.05), não para a versão 4.17.09.
Para realizar 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 reserva do Postgres:
- No mestre atual do Postgres, edite o arquivo /opt/apigee/customer/application/postgresql.properties
para definir o token a seguir. Se o arquivo não existir, crie-o:
conf_pg_hba_replication.connection=host replica apigee existing_slave_ip/32 trust\ \nhost replication apigee new_slave_ip/32 trust
em que existing_slave_ip é o existente_slave_ip do servidor IP em espera e o endereço IP atual do Postgby standby. - Reinicie o apigee-postgresql
no mestre do Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart - Verifique se o novo nó de espera foi adicionado visualizando o arquivo /opt/apigee/apigee-postgresql/conf/pg_hba.conf (em inglês) no mestre. As linhas a seguir devem aparecer nesse arquivo:
host replication apigee existing_slave_ip/32 trust
host replication apigee new_slave_ip/32 trust - Instale o novo servidor Postgres em espera:
- Edite o arquivo de configuração usado para instalar a versão atual do Edge para especificar o seguinte:
# Endereço IP do mestre atual:
PG_MASTER=192.168.56.103
# Endereço IP do novo nó de reserva
PG_STANDBY=192.168.56.102 - Desative o SELinux conforme descrito em Instalar o utilitário apigee-setup do Edge.
- Faça o download do arquivo bootstrap_4.16.05.sh do Edge para /tmp/bootstrap_4.16.05.sh:
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
Observação: se você estiver atualizando da versão 4.16.01, faça o download do arquivo bootstrap.sh do Edge. - Instale o utilitário e as dependências do Edge apigee-service:
> sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord - Use o apigee-service para instalar o utilitário apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install - Instale o Postgres:
> /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile - No novo nó de reserva, execute o seguinte comando:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Verifique se ele informa que é o standby.
- Edite o arquivo de configuração usado para instalar a versão atual do Edge para especificar o seguinte:
Como descontinuar um nó do Postgres
Após a conclusão da atualização, desative o novo nó reserva:
- 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 - Para conferir o UUID do novo nó de reserva, execute o comando cURL a seguir no novo nó de reserva:
> curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self
Confira o UUID do nó no final da saída, no formato:
"type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75" - Pare o novo nó de espera executando o seguinte comando nele:
> /opt/apigee/apigee-service/bin/apigee-all stop - No nó mestre do Postgres, edite /opt/apigee/customer/application/postgresql.properties
para remover o novo nó reserva de conf_pg_hba_replication.connection:
conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust - Reinicie o apigee-postgresql no mestre do Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart - Verifique se o novo nó reserva foi removido acessando o arquivo /opt/apigee/apigee-postgresql/conf/pg_hba.conf
no mestre. O arquivo precisa conter apenas a seguinte linha:
replicação do host da Apigee existing_slave_ip/32 trust - Exclua o UUID do nó reserva do ZooKeeper fazendo a seguinte chamada de API de gerenciamento do Edge no nó do servidor de gerenciamento:
> curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>
Atualização sem inatividade
Uma atualização sem inatividade, ou atualização gradual, permite atualizar a instalação do Edge sem interromper 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.
- Atualize as máquinas na ordem correta para sua instalação, conforme descrito abaixo em "Ordem de atualização de máquinas".
- Quando chegar a hora de atualizar os roteadores, selecione um e torne-o inacessível, conforme descrito em Ativar/desativar a acessibilidade do servidor (roteador/processador de mensagens).
- 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ó.
- Torne o roteador acessível novamente.
- Repita as etapas 2 a 4 para os outros roteadores.
- Continue a atualização para as máquinas 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:
- Torne o roteador inacessível.
- Deixe o processador de mensagens inacessível.
- Após a atualização, faça o seguinte:
- Deixe o processador de mensagens acessível.
- Torne o roteador acessível.
- Antes da atualização: faça o seguinte:
- 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.
- Depois da atualização, torne o processador de mensagens acessível.
Como usar um arquivo de configuração silenciosa
É necessário transmitir um arquivo de configuração silenciosa para o comando de atualização. O arquivo de configuração silenciosa precisa ser o mesmo usado para instalar o Edge 4.16.01 ou 4.16.05.
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ó:
- Se você estiver usando a replicação mestre-standby do Postgres, instale um novo nó de standby do Postgres, conforme descrito acima em Instalação de um novo nó de standby do Postgres.
- 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.
- Faça login no 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. - Instale yum-utils e yum-plugin-priorities:
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities - Desative o SELinux conforme descrito em Instalar o utilitário apigee-setup do Edge.
- Ative o repositório EPEL conforme descrito acima.
- Se você estiver instalando na AWS, execute o comando yum-configure-manager abaixo:
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional - 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 - Instale o utilitário apigee-service do Edge 4.17.09 e as
dependências:
> sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord
em que uName:pWord são o nome de usuário e a senha que você recebeu da 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. - Use apigee-service para
atualizar o utilitário de configuração da Apigee:
- Se você instalou a versão 4.16.01 fazendo upgrade do Edge para a versão 4.15.07.0x, precisa instalar o utilitário apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
Esse comando instala o utilitário update.sh em /opt/apigee/apigee-setup/bin (links em inglês).
Se você já instalou o utilitário apigee-setup, atualize-o:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update - Se você instalou a versão 4.16.01 diretamente, ou seja, não fez upgrade da
4.15.07.0x, atualize o utilitário apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
Essa atualização do apigee-service instala o utilitário update.sh em /opt/apigee/apigee-setup/bin. - Se você instalou a versão 4.16.05 diretamente ou por atualização, atualize o
utilitário apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
Essa atualização do apigee-service instala o utilitário update.sh em /opt/apigee/apigee-setup/bin.
- Se você instalou a versão 4.16.01 fazendo upgrade do Edge para a versão 4.15.07.0x, precisa instalar o utilitário apigee-setup:
- Dependendo da sua versão atual do Edge, é preciso instalar ou atualizar o utilitário apigee-validate no servidor de gerenciamento.
- Se você estiver usando o Edge 4.16.05: atualize o utilitário apigee-validate no
servidor de gerenciamento:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
- Se você estiver fazendo upgrade da versão 4.16.01: edite o arquivo de configuração transmitido ao
utilitário apigee-validate. Na
versão 4.16.01 do Edge, o arquivo de configuração usado por apigee-validate exigia as seguintes
propriedades:
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
REGION=dc-1
Nesta versão, o arquivo de configuração exige apenas a propriedade APIGEE_ADMINPW. Você pode remover as outras duas propriedades do arquivo.
- Se você estiver usando o Edge 4.16.05: atualize o utilitário apigee-validate no
servidor de gerenciamento:
- Atualize o utilitário apigee-provision:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update - Execute o utilitário de atualização nos nós na ordem descrita abaixo em Ordem de atualização
da máquina:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
O único requisito no arquivo de configuração é que ele precisa ser acessível ou legível pelo 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ó - Para testar a atualização, execute o utilitário apigee-validate no servidor de gerenciamento, conforme descrito em Testar a instalação.
- Se você instalou um novo nó de espera do Postgres, desative-o conforme descrito acima em Como desativar um nó do Postgres.
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 4.17.09 de um repositório local
Se os nós de borda estiverem atrás de um firewall ou de alguma outra forma não puderem acessar o repositório do Apigee pela Internet, será possível realizar a atualização em um repositório local ou espelho do repositório do 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 em um nó e atualize o Edge com ele.
- 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:
- Se você estiver usando a replicação mestre-standby do Postgres, instale um novo nó de standby do Postgres, conforme descrito acima em Instalação de um novo nó de standby do Postgres.
- 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á tem um repositório 4.16.01 ou 4.16.05, adicione o 4.17.09 conforme descrito em "Atualizar um repositório local da Apigee" em Instalar o utilitário apigee-setup do Edge. -
Para instalar o apigee-service em um arquivo .tar:
- No nó com o repositório local, use o comando a seguir 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 - 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ó.
- 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. - Instale o utilitário apigee-service do Edge e as dependências em /tmp/repos:
> sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Inclua o caminho para o diretório repos neste comando.
- No nó com o repositório local, use o comando a seguir para empacotar o repositório local
em um único arquivo .tar chamado /opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz:
-
Para instalar o apigee-service usando o servidor da Web Nginx:
- 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.
- 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. - 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.
- Use apigee-service para
atualizar o utilitário de configuração da Apigee:
- Se você instalou a versão 4.16.01 fazendo upgrade da versão 4.15.07.0x do Edge, instale o utilitário apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
Esse comando instala o utilitário update.sh em /opt/apigee/apigee-setup/bin.
Se você já instalou o utilitário apigee-setup, atualize-o:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update - Se você instalou a versão 4.16.01 diretamente, ou seja, não fez upgrade da versão
4.15.07.0x, atualize o utilitário apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
Essa atualização do apigee-service instala o utilitário update.sh em /opt/apigee/apigee-setup/bin. - Se você instalou a versão 4.16.05 diretamente ou por atualização, atualize o
utilitário apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
Essa atualização para apigee-service instala o utilitário update.sh em /opt/apigee/apigee-setup/bin.
- Se você instalou a versão 4.16.01 fazendo upgrade da versão 4.15.07.0x do Edge, instale o utilitário apigee-setup:
- Dependendo da sua versão atual do Edge, é necessário instalar ou atualizar o utilitário apigee-validate no servidor de gerenciamento.
- Se você estiver usando o Edge 4.16.05: atualize o utilitário apigee-validate no
servidor de gerenciamento:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update - Se você estiver usando o Edge 4.16.01: instale o utilitário apigee-validate
no servidor de gerenciamento:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
Observação: se você instalou o utilitário apigee-validate em um nó do processador de mensagens ao instalar o 4.16.01, atualize-o usando o seguinte comando nesse nó:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
No entanto, a partir da versão 4.16.05 e mais recentes, a Apigee recomenda que você instale e execute o utilitário apigee-validate no servidor de gerenciamento. - Se você estiver fazendo upgrade da versão 4.16.01: edite o arquivo de configuração transmitido ao
utilitário apigee-validate. Na
versão 4.16.01 do Edge, o arquivo de configuração usado por apigee-validate exigia as seguintes
propriedades:
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
REGION=dc-1
Nesta versão, o arquivo de configuração exige apenas a propriedade APIGEE_ADMINPW. Você pode remover as outras duas propriedades do arquivo.
- Se você estiver usando o Edge 4.16.05: atualize o utilitário apigee-validate no
servidor de gerenciamento:
- Atualize o utilitário apigee-provision:
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update - Execute o utilitário de atualização nos nós na ordem descrita abaixo em "Ordem de atualização
da máquina":
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
O único requisito no arquivo de configuração é que ele precisa ser acessível ou legível pelo 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ó - Para testar a atualização, execute o utilitário apigee-validate no servidor de gerenciamento, conforme descrito em Testar a instalação.
- Se você instalou um novo nó de reserva do Postgres, desative o nó conforme descrito acima em Como desativar um nó do Postgres.
Para fazer a reversão da 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, realize-a na ordem especificada.
- 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 autônoma com um host
- Defina SMTPMAILFROM no seu
arquivo de configuração se você tiver ativado o SMTP no Edge. Esse parâmetro tem o formato:
SMTPMAILFROM="My Company <myco@company.com>" - Se você estiver atualizando da versão 4.16.01, faça o downgrade do Zookeeper:
> yum downgrade apigee-zookeeper - Atualize o Cassandra e o ZooKeeper:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - Defina a seguinte regra do iptables:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - Verifique a fila de mensagens do Qpid:
> qpid-stat -q
Continue verificando a fila até que a contagem na coluna "msg" seja 0. Não é possível fazer upgrade do Qpid até que ele processe todas as mensagens. - Atualize o qpidd:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Limpar iptables:
> sudo iptables -F - Atualização do LDAP:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - Pare 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 - Atualize o postgresql:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Atualize o banco de dados do Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Atualize os componentes restantes do Edge:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile - Atualizar a interface do Edge:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
Para uma instalação autônoma com dois hosts
Consulte Topologias de instalação para ver a lista de topologias de borda e números de nó.
- Defina SMTPMAILFROM no seu
arquivo de configuração se você tiver ativado o SMTP no Edge. Esse parâmetro tem o formato:
SMTPMAILFROM="My Company <myco@company.com>" - Se a atualização for da versão 4.16.01, faça o downgrade do Zookeeper na máquina 1:
> yum downgrade apigee-zookeeper - Atualize o Cassandra e o ZooKeeper na máquina 1:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - Defina a seguinte regra iptables na máquina 2:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - Verifique a fila de mensagens Qpid na máquina 2:
> qpid-stat -q
Continue verificando a fila até que a contagem na coluna "msg" seja 0. Não é possível fazer upgrade do Qpid até que ele processe todas as mensagens. - Atualize o qpidd na
máquina 2:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Limpe o iptables na máquina 2:
> sudo iptables -F - Atualize o LDAP na máquina 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - Atualize os componentes do Edge na máquina 1:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Atualize a interface na máquina 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile - Atualize o postgresql na máquina 2:
- Pare 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 - Atualize o postgresql:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Atualize o banco de dados do Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Atualize os componentes do Edge na máquina 2 e na máquina 1:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Pare o servidor Postgres, o servidor Qpid e o postgresql:
- Atualize os componentes do Edge na máquina 2:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Para uma instalação em cluster com cinco hosts
Consulte Topologias de instalação para ver a lista de topologias de borda e números de nó.
- Defina SMTPMAILFROM no seu arquivo de configuração se você tiver ativado o SMTP no Edge. Esse parâmetro tem o formato:
SMTPMAILFROM="My Company <myco@company.com>" - Verifique se você instalou um novo nó de standby do Postgres, conforme descrito acima em Como instalar um novo nó de standby do Postgres.
- Se a atualização for da versão 4.16.01, faça o downgrade do Zookeeper nas máquinas 1, 2 e 3:
> yum downgrade apigee-zookeeper - 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 - Defina a seguinte regra iptables na máquina 4:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - Verifique a fila de mensagens Qpid na máquina 4:
> qpid-stat -q
Continue verificando a fila até que a contagem na coluna "msg" seja 0. Não é possível fazer upgrade do Qpid até que ele processe todas as mensagens. - Atualize o qpidd na
máquina 4:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Limpe o iptables na máquina 4:
> sudo iptables -F - Repita as etapas de 5 a 8 na máquina 5.
- Atualizar o LDAP na máquina 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - Atualize os componentes do Edge na máquina 1, 2, 3:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Atualize a interface na máquina 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile - Atualize as máquinas 4 e 5:
- 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 - Pare 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 - Pare o servidor Postgres e o postgresql no novo nó de reserva que você adicionou para
fazer o rollback:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - Atualize o postgresql nas máquinas 4:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Atualize o banco de dados do Postgres na máquina 4 (somente mestre do Postgres):
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Atualize o postgresql nas máquinas 5:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - 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 - Configure o Postgres como um nó reserva executando os comandos abaixo 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 - Verifique o status da replicação emitindo os scripts a seguir nos dois servidores. O
sistema precisa mostrar resultados idênticos nos dois 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
Verifique se ele diz que é o mestre.
Na máquina 5, o nó de reserva:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Verifique se ele indica que é o standby.
- Pare o servidor Postgres e o servidor Qpid na máquina 4:
- Atualize os componentes do Edge na máquina 4, 5:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Desative o novo nó reserva usando o procedimento acima em Como desativar um nó do Postgres.
Para uma instalação em cluster de 9 hosts
Consulte Topologias de instalação para conferir a lista de topologias e números de nó do Edge.
- Defina SMTPMAILFROM no seu
arquivo de configuração se você tiver ativado o SMTP no Edge. Esse parâmetro tem o formato:
SMTPMAILFROM="My Company <myco@company.com>" - Verifique se você instalou um novo nó de espera do Postgres, conforme descrito acima em Como instalar um novo nó de espera do Postgres.
- Se a atualização for da versão 4.16.01, faça o downgrade do Zookeeper nas máquinas 1, 2 e 3:
> yum downgrade apigee-zookeeper - 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 - Defina a seguinte regra iptables na máquina 6:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - Verifique a fila de mensagens Qpid na máquina 6:
> qpid-stat -q
Continue verificando a fila até que a contagem na coluna "msg" seja 0. Não é possível fazer upgrade do Qpid até que ele processe todas as mensagens. - Atualize o qpidd na
máquina 6:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Limpar iptables na máquina 6:
> sudo iptables -F - Repita as etapas 5 a 8 na máquina 7.
- Atualize o LDAP na máquina 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - Atualize os componentes do Edge nas máquinas 6, 7, 1, 4 e 5 nesta ordem:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Atualize a interface na máquina 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile - Atualize as máquinas 8 e 9:
- Parar o servidor do Postgres na máquina 8:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop - Parar 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 - Pare o servidor Qpid nas máquinas 6 e 7:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop - Interrompa o servidor Postgres e postgresql no novo nó de espera 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 - Atualize o postgresql nas máquinas 8:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Atualize o banco de dados do Postgres na máquina 8 (somente mestre do Postgres):
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Atualize o postgresql em máquinas 9:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Inicie o servidor do Postgres nas máquinas 8 e 9:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start - Inicie o servidor Qpid nas máquinas 6 e 7:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start - Configure o Postgres como um nó de espera executando os seguintes comandos na máquina
9:
> cd /opt/apigee/data/apigee-postgresql/p
configFile - Verifique o status da replicação emitindo os scripts a seguir nos dois servidores. O
sistema precisa mostrar resultados idênticos nos dois 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
Verifique se ele diz que é o mestre.
Na máquina 9, o nó de reserva:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Verifique se ele indica que é o standby.
- Parar o servidor do Postgres na máquina 8:
- Atualize os componentes do Edge na máquina 8 e 9:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Desative o novo nó reserva usando o procedimento acima em Como desativar um nó do Postgres.
Para uma instalação em cluster de 13 hosts
Consulte Topologias de instalação para conferir a lista de topologias e números de nó do Edge.
- Defina SMTPMAILFROM no seu
arquivo de configuração se você tiver ativado o SMTP no Edge. Esse parâmetro tem o formato:
SMTPMAILFROM="My Company <myco@company.com>" - Verifique se você instalou um novo nó de standby do Postgres, conforme descrito acima em Como instalar um novo nó de standby do Postgres.
- Se a atualização for da versão 4.16.01, faça o downgrade do Zookeeper nas máquinas 1, 2 e 3:
> yum downgrade apigee-zookeeper - 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 - Defina a seguinte regra de iptables na máquina 12:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - Verifique a fila de mensagens Qpid na máquina 12:
> qpid-stat -q
Continue verificando a fila até que a contagem na coluna "msg" seja 0. Não é possível fazer upgrade do Qpid até que ele processe todas as mensagens. - Atualize o qpidd na
máquina 12:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Limpar iptables na máquina 12:
> sudo iptables -F - Repita as etapas 5 a 8 na máquina 13.
- Atualize o LDAP nas máquinas 4 e 5:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - Atualize os componentes do Edge nas máquinas 12, 13, 6, 7, 10 e 11 nesta ordem:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile - Atualize a interface nas máquinas 6 e 7:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile - Atualize as máquinas 8 e 9:
- Parar o servidor do Postgres na máquina 8:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop - Parar 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 - Pare o servidor Qpid nas máquinas 12 e 13:
> /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop - Pare o servidor Postgres e o postgresql no novo nó de reserva que você adicionou para
fazer o rollback:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - Atualize o postgresql nas máquinas 8:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Atualize o banco de dados do Postgres na máquina 8 (somente mestre do Postgres):
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Atualize o postgresql em máquinas 9:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Inicie o servidor Postgres nas máquinas 8 e 9:
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start - Inicie o servidor Qpid nas máquinas 12 e 13:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start - Configure o Postgres como um nó reserva executando os comandos abaixo 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 - Verifique o status da replicação emitindo os scripts a seguir nos dois servidores. O
sistema precisa mostrar resultados idênticos nos dois 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
Verifique se ele diz que é o mestre.
Na máquina 9, o nó de reserva:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Verifique se ele indica que é o standby.
- Parar o servidor do Postgres na máquina 8:
- Atualize os componentes do Edge na máquina 8 e 9:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Certifique-se de desativar o novo nó de espera usando o procedimento acima em Como desativar um nó do Postgres.
Para uma instalação em cluster com 12 hosts
Consulte Topologias de instalação para ver a lista de topologias de borda e números de nó.
- Defina SMTPMAILFROM no seu
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>" - Verifique se você instalou um novo nó de standby do Postgres, conforme descrito acima em Como instalar um novo nó de standby do Postgres.
- Atualize o Cassandra e o ZooKeeper:
- Se a atualização for feita a partir da 4.16.01, faça o downgrade do Zookeeper nas máquinas 1, 2 e 3 no
data center 1:
> yum downgrade apigee-zookeeper - Nas máquinas 1, 2 e 3 no data center 1:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - Se estiver atualizando da versão 4.16.01, faça downgrade do Zookeeper no Macine 7, 8 e 9 no
Data Center 2:
> yum faça downgrade do apigee-zookeeper - Nas máquinas 7, 8 e 9 no data center 2
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Se a atualização for feita a partir da 4.16.01, faça o downgrade do Zookeeper nas máquinas 1, 2 e 3 no
data center 1:
- Atualização do qpidd:
- Máquinas 4 e 5 no data center 1
- Defina a seguinte regra iptables na máquina 4:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - Verifique a fila de mensagens Qpid na máquina 4:
> qpid-stat -q
Continue verificando a fila até que a contagem na coluna "msg" seja 0. Não é possível fazer upgrade do Qpid até que ele processe todas as mensagens. - Atualize o qpidd na máquina 4:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Limpar iptables na máquina 4:
> sudo iptables -F - Repita as etapas de 1 a 4 na máquina 5.
- Defina a seguinte regra iptables na máquina 4:
- Máquinas 10 e 11 no data center 2
- Defina a seguinte regra de iptables na máquina 10:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - Verifique a fila de mensagens Qpid na máquina 10:
> qpid-stat -q
Continue verificando a fila até que a contagem na coluna "msg" seja 0. Não é possível fazer upgrade do Qpid até que ele processe todas as mensagens. - Atualize o qpidd na máquina 10:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Limpe o iptables na máquina 10:
> sudo iptables -F - Repita as etapas de 1 a 4 na máquina 11.
- Defina a seguinte regra de iptables na máquina 10:
- Máquinas 4 e 5 no data center 1
- Atualizar o LDAP:
- Máquinas 1 no data center 1
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - Máquinas 7 no data center 2
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Máquinas 1 no data center 1
- Atualize os componentes do Edge:
- Máquinas 4, 5, 1, 2, 3 no data center 1
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Máquinas 10, 11, 7, 8 e 9 no data center 2
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Máquinas 4, 5, 1, 2, 3 no data center 1
- Atualizar a interface:
- Máquina 1 no data center 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile - Máquina 7 no Data Center 2:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- Máquina 1 no data center 1:
- Atualize a máquina 6 nos data centers 1 e 12 no data center 2:
- Parar o servidor Postgres na máquina 6:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop - Interromper o servidor do 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 - Interromper o servidor Qpid nas máquinas 4, 5, 10 e 11:
> /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop - Interrompa o servidor Postgres e postgresql no novo nó de espera 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 - Atualize o postgresql nas máquinas 6:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Atualize o banco de dados do Postgres na máquina 6 (somente mestre do Postgres):
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - Atualize o postgresql em máquinas 12:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Inicie o servidor do servidor Postgres nas máquinas 6 e 12:
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start - Inicie o servidor Qpid nas máquinas 4, 5, 10 e 11:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start - Configure o Postgres como um nó reserva executando os comandos abaixo 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 - Verifique o status da replicação emitindo os scripts a seguir nos dois servidores. O
sistema precisa mostrar resultados idênticos nos dois servidores para garantir uma
replicação bem-sucedida:
Na máquina 6, o nó mestre, execute:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Verifique se ele diz que é o mestre.
Na máquina 12, o nó de reserva:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Verifique se ele indica que é o standby.
- Parar o servidor Postgres na máquina 6:
- Atualize os componentes do Edge nas máquinas 6 e 12:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Desative o novo nó reserva usando o procedimento acima em Como desativar um nó do Postgres.
Para uma instalação de BaaS de API de 7 ou 10 hosts
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:
- ZooKeeper
- Cassandra
- qpidd
- LDAP
- "Edge", ou seja, o perfil "-c edge" em todos os nós na ordem: nós com servidor Qpid, mas não o servidor Postgres, o servidor de gerenciamento, o processador de mensagens e o roteador.
Observação: se o nó tiver o servidor Qpid e o Postgres instalados, execute a etapa de perfil "-c edge" como parte da etapa 8. - Interface do Edge
- postgresql no mestre do Postgres, incluindo upgrade.
- postgresql no modo de espera do Postgres.
- Edge, ou seja, o perfil "-c Edge" em todos os nós combinados do Qpid e do Postgres ou em qualquer nó independente do Postgres.