Edge para nuvem privada v. 4.17.05
Quais versões do Edge podem ser atualizadas para a 4.17.05
É possível atualizar a versão 4.16.09.0x do Apigee Edge para a 4.17.05 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, em seguida, atualize para a versão 4.17.05.
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 configurá-los.
Quais componentes você precisa atualizar
É preciso atualizar todos os componentes do Edge. O Edge não é compatível com uma configuração que contenha componentes de várias versões.
Upgrade obrigatório para o Qpid 1.35
Esta versão contém uma atualização obrigatória para o Qpid 1.35. Como parte da atualização de um nó do Qpid, é necessário:
- Impeça temporariamente que roteadores e processadores de mensagens gravem no nó do Qpid
bloqueando a porta 5672 no nó do Qpid. Use o seguinte comando para bloquear essa porta no
nó do Qpid:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - Aguarde até que a fila do Qpid seja esvaziada para garantir que o nó do Qpid tenha processado todas as mensagens antes da atualização. Use o seguinte comando para garantir que a fila de mensagens do Qpid esteja
vazia:
> qpid-stat -q - Atualize o nó do Qpid.
- Desbloqueie a porta 5672 no nó do Qpid para permitir o acesso de roteadores e processadores de mensagens.
Use o seguinte comando para desbloquear essa porta:
> sudo iptables -F
Se você estiver usando iptables para outras regras, 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.
Obrigatório para ativar o repositório EPEL
Ative os Pacotes extras para o Enterprise Linux (ou EPEL) para instalar ou atualizar o Edge. O comando usado depende da 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. Agora é necessário definir SMTPMAILFROM no arquivo de configuração ao ativar o servidor SMTP. Esse parâmetro tem o seguinte formato:
SMTPMAILFROM="My Company <myco@company.com>"
Obrigatório se houver atualização ao usar a autenticação externa
É possível integrar um serviço do diretório externo a uma instalação atual da nuvem privada do Apigee Edge. Esse recurso foi projetado para funcionar com qualquer serviço do diretório compatível com LDAP, como Active Directory, 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 Topologias de instalação para mais informações.
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 integrado um serviço do diretório externo, adicione a seguinte linha ao arquivo de configuração ao atualizar o Edge para a versão 4.17.05:
IS_EXTERNAL_AUTH="true"
Essa linha configura o Edge para aceitar um nome de conta, em vez de um endereço de e-mail, como o nome de usuário.
Propagação automática das configurações de propriedade
Se você tiver definido propriedades editando arquivos .properties em /opt/apigee/customer/application, esses valores serão mantidos pela atualização.
Pré-requisitos de atualização
Antes de fazer upgrade do Apigee Edge, siga estes pré-requisitos:
- Fazer backup de todos os nós
Antes de atualizar, é 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 realizar 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á 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 update.sh novamente. É possível executar a atualização várias vezes, e ela vai continuar de onde parou.
Se a falha exigir que você reverta a atualização para a versão anterior, consulte Processo de reversão da versão 4.17.01 para mais informações.
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 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 que você atualize a instalação do Edge sem desativar o Edge.
A atualização sem inatividade só é possível com uma configuração de 5 nós ou mais.
A chave para o upgrade sem 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 da máquina".
- Quando for hora de atualizar os roteadores, selecione um roteador e torne-o inacessível, conforme descrito em Como ativar/desativar a acessibilidade do servidor (processador de mensagens/roteador).
- Atualize o roteador selecionado e todos os outros componentes do Edge na mesma máquina que o roteador. Todas as configurações do Edge mostram um roteador e um processador de mensagens no mesmo nó.
- Torne o roteador acessível novamente.
- Repita as etapas de 2 a 4 para os roteadores restantes.
- Continue a atualização para as máquinas restantes na instalação.
Cuide do 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.
- Tornar o processador de mensagens inacessível.
- Após a atualização, faça o seguinte:
- Torne 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, torne 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.
Como usar um arquivo de configuração silencioso
É 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.09.
Procedimento para atualizar para a versão 4.17.05 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 houver, desative todos os cron jobs 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. - Desative o SELinux conforme descrito em Instalar o utilitário apigee-setup do Edge.
- Faça o download do arquivo bootstrap_4.17.05.sh do Edge 4.17.05 para /tmp/bootstrap_4.17.05.sh:
> curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh - Instale o utilitário apigee-service do Edge 4.17.05 e as
dependências:
> sudo bash /tmp/bootstrap_4.17.05.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á necessário inseri-lo.
Por padrão, o instalador verifica se o Java 1.8 está instalado. Se não tiver, ele será instalado para você. Use a opção JAVA_FIX para especificar como lidar com a instalação do Java. JAVA_FIX usa 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 por conta própria. - (Somente CentOS-6.x e RedHat-6.x) Em todos os nós do Qpid, execute o
comando a seguir para garantir o download da versão correta do Qpid:
> yum install apigee-qpidd --disablerepo=epel - Use apigee-service para
atualizar o utilitário
apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update - Atualize o utilitário apigee-validate
no servidor de gerenciamento:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update - 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 IU do Edge: servidor de gerenciamento, processador de mensagens, roteador, servidor QPID, servidor Postgres
ui = IU 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 asa)
e = ElasticSearch
b = pilha de API BaaS
p = portal de API BaaS
ebp = ElasticSearch, pilha de API BaaS e portal de API BaaS no mesmo nó - Teste a atualização executando o utilitário apigee-validate no servidor de gerenciamento, conforme descrito em Testar a instalação.
Para reverter a atualização posteriormente, use o procedimento descrito em Processo de reversão da versão 4.17.05.
Procedimento para atualizar para a versão 4.17.05 de um repositório local
Se os nós do Edge estiverem protegidos por um firewall ou, de alguma outra forma, proibidos de acessar o repositório da Apigee pela Internet, será possível realizar 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 no 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. Nginx e até mesmo o servidor da Web Apache.
Para atualizar de um repositório local 4.17.05:
- Crie um repositório local 4.17.05, conforme descrito em "Criar um repositório local da Apigee" em Instalar o utilitário apigee-setup do Edge.
Observação: se você já tiver um repositório 4.16.09, poderá adicionar o repositório 4.17.05 a ele, conforme descrito em "Atualizar um repositório local da Apigee" em Instalar o utilitário apigee-setup do Edge. -
Para instalar o apigee-service de um arquivo .tar:
- 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.17.05.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-o para o diretório /tmp no novo nó.
- No novo nó, descompacte o arquivo no diretório /tmp:
> tar -xzf apigee-4.17.05.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 de /tmp/repos:
> sudo bash /tmp/repos/bootstrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Observe que você inclui o caminho para o diretório de repositórios neste comando.
- 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.17.05.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.05.sh do Edge para
/tmp/bootstrap_4.17.05.sh:
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
em que uName:pWord são o nome de usuário e a senha que você definiu 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 apigee-service do Edge e as dependências:
> sudo bash /tmp/bootstrap_4.17.05.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 apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update - Atualize o utilitário apigee-validate
no servidor de gerenciamento.
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update - 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 IU do Edge: servidor de gerenciamento, processador de mensagens, roteador, servidor QPID, servidor Postgres
ui = IU 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 asa)
e = ElasticSearch
b = pilha de API BaaS
p = portal de API BaaS
ebp = ElasticSearch, pilha de API BaaS e portal de API BaaS no mesmo nó - Teste a atualização executando o utilitário apigee-validate no servidor de gerenciamento, conforme descrito em Testar a instalação.
Para reverter a atualização posteriormente, use o procedimento descrito em Processo de reversão da versão 4.17.05.
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 para uma atualização são:
- Atualize todos os nós do Cassandra e do ZooKeeper antes de atualizar qualquer outro nó.
- Para qualquer máquina com vários componentes do Edge (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 deve ser realizada em várias máquinas, faça isso na ordem especificada.
- Não há uma etapa separada para atualizar a Monetização. Ele é atualizado quando você especifica a opção "-c edge".
- (Somente CentOS-6.x e RedHat-6.x) Em todos os nós do Qpid com uma
conexão de Internet externa, verifique se você executou o seguinte comando para fazer o download da
versão correta do Qpid, conforme mostrado acima:
> yum install apigee-qpidd --disablerepo=epel
Para uma instalação independente de 1 host
- Defina SMTPMAILFROM no
arquivo de configuração se você tiver ativado o SMTP no Edge. Esse parâmetro tem o seguinte formato:
SMTPMAILFROM="My Company <myco@company.com>" - Atualize o Cassandra e o ZooKeeper:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - Defina a seguinte regra de 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 tenha processado todas as mensagens. - Atualize qpidd:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Limpe as iptables:
> sudo iptables -F - Atualize o postgresql:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Inicie o postgresql:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start - Atualize o LDAP:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - Atualize os componentes restantes do Edge:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Atualize a IU do Edge:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
Para uma instalação independente de dois hosts
Consulte Topologias de instalação para ver a lista de topologias do Edge e números de nós.
- Defina SMTPMAILFROM no
arquivo de configuração se você tiver ativado o SMTP no Edge. Esse parâmetro tem o seguinte formato:
SMTPMAILFROM="My Company <myco@company.com>" - 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 de 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 do 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 tenha processado todas as mensagens. - Atualize o qpidd na
máquina 2:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Limpe as iptables na máquina 2:
> sudo iptables -F - Atualize o postgresql na máquina 2:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Inicie o postgresql na máquina 2:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start - 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 2 e 1:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Atualize a IU na máquina 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
Para uma instalação em cluster de 5 hosts
Consulte Topologias de instalação para ver a lista de topologias do Edge e números de nós.
- Defina SMTPMAILFROM no
arquivo de configuração se você tiver ativado o SMTP no Edge. Esse parâmetro tem o seguinte formato:
SMTPMAILFROM="My Company <myco@company.com>" - 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 4:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - Verifique a fila de mensagens do 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 tenha processado todas as mensagens. - Atualize o qpidd na
máquina 4:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Limpe as iptables na máquina 4:
> sudo iptables -F - Repita as etapas de 3 a 6 na máquina 5.
- Atualize o postgresql na máquina 4:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Inicie o postgresql na máquina 4:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start - Repita as etapas 8 e 9 na máquina 5.
- 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 4, 5, 1, 2 e 3:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Atualize a IU 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 do Edge e números de nós.
- Defina SMTPMAILFROM no
arquivo de configuração se você tiver ativado o SMTP no Edge. Esse parâmetro tem o seguinte formato:
SMTPMAILFROM="My Company <myco@company.com>" - 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 6:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP - Verifique a fila de mensagens do 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 tenha processado todas as mensagens. - Atualize o qpidd na
máquina 6:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Limpe as iptables na máquina 6:
> sudo iptables -F - Repita as etapas de 3 a 6 na máquina 7.
- Atualize o postgresql na máquina 6:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Inicie o postgresql na máquina 6:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start - Repita as etapas 8 e 9 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, 8, 9, 1, 4 e 5, nessa ordem:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Atualize a IU 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 do Edge e números de nós.
- Defina SMTPMAILFROM no
arquivo de configuração se você tiver ativado o SMTP no Edge. Esse parâmetro tem o seguinte formato:
SMTPMAILFROM="My Company <myco@company.com>" - 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 do 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 tenha processado todas as mensagens. - Atualize o qpidd na
máquina 12:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Limpe as iptables na máquina 12:
> sudo iptables -F - Repita as etapas de 3 a 6 na máquina 13.
- Atualize o postgresql na máquina 12:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - Inicie o postgresql na máquina 12:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start - Repita as etapas 8 e 9 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, 8, 9, 6, 7, 10 e 11, nessa ordem:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Atualize a IU nas máquinas 6 e 7:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
Para uma instalação em cluster de 12 hosts
Consulte Topologias de instalação para ver a lista de topologias do Edge e números de nós.
- Defina SMTPMAILFROM no
arquivo de configuração se você tiver ativado o SMTP no Edge. Esse parâmetro tem o seguinte formato:
SMTPMAILFROM="My Company <myco@company.com>" - Atualize o Cassandra e o ZooKeeper:
- Nas máquinas 1, 2 e 3 no data center 1:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - Nas máquinas 7, 8 e 9 no Data Center 2
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Nas máquinas 1, 2 e 3 no data center 1:
- Atualize o qpidd:
- Máquinas 4 e 5 no data center 1
- Defina a seguinte regra de 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 do 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 tenha processado todas as mensagens. - Atualize o qpidd na máquina 4:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Limpe as iptables na máquina 4:
> sudo iptables -F - Repita as etapas de 1 a 4 na máquina 5.
- Defina a seguinte regra de 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 do 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 tenha processado todas as mensagens. - Atualize o qpidd na máquina 10:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - Limpe as 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
-
Atualize o postgresql:
-
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 -
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
-
- Atualize 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, 6, 1, 2, 3 no Data Center 1
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - Máquinas 10, 11, 12, 7, 8, 9 no Data Center 2
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Máquinas 4, 5, 6, 1, 2, 3 no Data Center 1
- Atualizar 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:
Para uma instalação de API BaaS com sete hosts
Adicione duas novas propriedades ao arquivo de configuração antes de executar o procedimento de upgrade:
# For a single data center, specify the same value as BAAS_CASS_LOCALDC. BAAS_CASS_DC_LIST="dc-1" # Defines the initial contact points for members of the BaaS cluster. # Specify the IP address of no more than two Stack nodes. BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"
Para ver um exemplo completo de arquivo de configuração, consulte Instalação da API BaaS.
Você também precisa garantir que a porta 2551 esteja aberta em todos os nós do Stack para acesso de todos os outros nós do Stack.
Consulte Topologias de instalação para ver a lista de topologias do Edge e números de nós.
- Atualize o Cassandra nas máquinas 5, 6 e 7:
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile -
Atualize o ElasticSearch e a pilha de API BaaS nas máquinas 1, 2 e 3:
> /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile - Atualize o portal da API BaaS na máquina 4:
> /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
Para uma instalação da API BaaS com 10 hosts
Adicione duas novas propriedades ao arquivo de configuração antes de executar o procedimento de upgrade:
# For a single data center, specify the same value as BAAS_CASS_LOCALDC. BAAS_CASS_DC_LIST="dc-1" # Defines the initial contact points for members of the BaaS cluster. # Specify the IP address of no more than two Stack nodes. BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"
Para ver um exemplo completo de arquivo de configuração, consulte Instalação da API BaaS.
Você também precisa garantir que a porta 2551 esteja aberta em todos os nós do Stack para acesso de todos os outros nós do Stack.
Consulte Topologias de instalação para ver a lista de topologias do Edge e números de nós.
- Atualize o Cassandra nas máquinas 8, 9 e 10:
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile - Atualize o ElasticSearch nas máquinas 1, 2 e 3:
> /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile - Atualize a pilha da API BaaS nas máquinas 4, 5 e 6:
> /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile - Atualize o portal da API BaaS na máquina 7:
> /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
Para uma instalação não padrão
Se você tiver uma instalação não padrão, atualize os componentes do Edge na seguinte ordem:
- ZooKeeper
- Cassandra
- qpidd, ps
- LDAP
- Edge, 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 servidor Postgres instalados, execute a etapa do perfil "-c edge". - IU do Edge