Esta página foi traduzida pela API Cloud Translation.

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 o Apigee Edge versão 4.17.01.0x/4.17.05.0x para 4.17.09 usando este procedimento.

Se você tiver uma versão do Edge anterior à 4.16.01, será necessário migrar primeiro versão 4.16.01.x e atualizar para 4.17.09.

Quem pode realizar a atualização

O usuário que está executando a atualização deve ser o mesmo que originalmente instalou o Edge ou um usuário sendo executado como raiz.

Depois de instalar os RPMs do Edge, qualquer usuário pode configurá-los.

Quais componentes você precisa atualizar

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

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

Se você tiver definido alguma propriedade editando os arquivos .properties em /opt/apigee/customer/application, estes serão são retidos pela atualização.

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

O Edge 4.17.05 adicionou um novo parâmetro obrigatório ao arquivo de configuração usado ao ativar 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 para a propriedade SMTPMAILFROM. Ao atualizar o BaaS da API da versão 4.17.01 ou 4.17.05, é necessário definir SMTPMAILFROM no de configuração do Terraform.

Esse parâmetro tem o seguinte formato:

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

Atualizar pré-requisitos

Cumpra os seguintes pré-requisitos antes de fazer upgrade do Apigee Edge:

Fazer backup de todos os nós
Antes da atualização, é recomendável fazer um backup completo de todos os nós por motivos de segurança motivos. Use o procedimento da sua versão atual do Edge para fazer o backup.

Isso permite que você tenha um plano de backup, caso a atualização para uma nova versão não para funcionar corretamente. Para mais informações sobre backup, consulte Backup e restauração.
Verifique se o Edge está em execução
Verifique se o Edge está em execução durante o processo de atualização usando o comando:

> /opt/apigee/apigee-service/bin/apigee-all status

Como lidar com uma atualização com falha

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

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

Informações de atualização do Logging

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

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

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

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

Atualização sem inatividade

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

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

O segredo para fazer upgrade com zero inatividade é remover cada roteador do sistema de carga, um de cada vez. de carga. Depois, você atualiza o roteador e outros componentes na mesma máquina que ele. e adicione o roteador de volta ao balanceador de carga.

Atualize as máquinas na ordem correta para sua instalação, conforme descrito abaixo em "Fazer o pedido de atualização da máquina".
Quando chegar a hora de atualizar os roteadores, selecione qualquer um deles e torne-o inacessível, conforme descritas em Ativar/Desativar acessibilidade do servidor (processador de mensagens/roteador).
Atualize o roteador selecionado e todos os outros componentes de Edge na mesma máquina que ele. Todas as configurações do Edge mostram um roteador e um processador de mensagens no mesmo nó.
Torne o roteador acessível novamente.
Repita as etapas 2 a 4 para os outros roteadores.
Continue a atualização para os computadores restantes na instalação.

Tome cuidado com o seguinte antes/depois da atualização:

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

Usar um arquivo de configuração silencioso

Você precisa passar um arquivo de configuração silencioso para o comando de atualização. O arquivo de configuração silenciosa deve ser o mesmo usado para instalar o Edge 4.17.01.

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

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

Se estiver presente, desative todas as tarefas do CRON configuradas para executar uma operação de reparo no Cassandra até que a atualização seja concluída.
Faça login no seu nó como raiz para instalar os RPMs do Edge.
Observação: embora a instalação do RPM exija acesso raiz, você pode executar o Edge sem acesso à raiz.
Instale o 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 Edge apigee-setup .
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
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 (link em inglês)
Instale o utilitário Edge 4.17.09 apigee-service e 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 a Apigee. Se você omitir o pWord, será necessário digitá-lo.

Por padrão, o instalador verifica se você tem o Java 1.8 instalado. Caso contrário, o instala para você. Use a opção JAVA_FIX para especificar o processamento Instalação do Java. JAVA_FIX assume os seguintes valores:

I = Instalar o OpenJDK 1.8 (padrão)
C = continuar sem instalar o Java
P = Sair. Para essa opção, você precisa instalar o Java por conta própria.
Use apigee-service para atualize o apigee-setup utilitário:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
Atualize o apigee-validate no servidor de gerenciamento:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Atualize o apigee-provision utilitário:
> /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 da máquina atualizar" 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 por "apigee" usuário.

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

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

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

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

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

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

Para atualizar de um repositório local 4.17.09:

Crie um repositório 4.17.09 local conforme descrito em "Criar um repositório da Apigee local" em Instalar a configuração da Apigee do Edge .
Observação: se você já tiver um repositório 4.17.01/4.17.05, adicione o 4.17.09 como descrito em "Atualizar um repositório da Apigee local" em Instalar a configuração da Apigee do Edge utilitário.
Para instalar o apigee-service usando um arquivo .tar:
1. No nó com o repositório local, use o seguinte comando para empacotar o repositório local em um único arquivo .tar chamado /opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz:
  > /opt/apigee/apigee-service/bin/apigee-service pacote apigee-mirror
2. Copie o arquivo .tar para o nó em que você quer atualizar o Edge. Por exemplo, copie-o para no diretório /tmp na um novo nó.
3. No novo nó, descompacte o arquivo para o diretório /tmp:
  > 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 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 nesse comando.
Para instalar o apigee-service usando o servidor da Web Nginx:
1. Configure o servidor da Web Nginx conforme descrito em "Instalar a partir do repositório usando a linguagem Nginx" webserver" em Instalar o Edge utilitário apigee-setup.
2. No nó remoto, faça o download do arquivo bootstrap_4.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 que você definiu acima para repositório, e remoteRepo é o endereço IP ou nome DNS do nó de repositório.
3. No nó remoto, instale o utilitário Edge Apigee-service e as dependências:
  > "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 atualize o utilitário de configuração da Apigee:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
Atualize o apigee-validate no servidor de gerenciamento.
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Atualize o apigee-provision utilitário:
> /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 da máquina atualizar" 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 por "apigee" usuário.

Use a opção “-c” para especificar o componente a ser atualizado. A lista de possíveis de componentes inclui:
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =todos os componentes do Edge exceto a UI de borda: servidor de gerenciamento, processador de mensagens, roteador, servidor QPID, servidor do Postgres
ui = interface do Edge
all = atualizar todos os componentes em máquina (use apenas para um perfil de instalação Edge aio ou uma instalação de API BaaS asa) perfil)
e = ElasticSearch
b = pilha BaaS de API
p = portal de API BaaS
ebp = ElasticSearch, API BaaS Stack e portal de API BaaS no mesmo nó
Teste a atualização executando o utilitário de validação da Apigee no servidor de gerenciamento, conforme descritos 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. A maior considerações importantes para uma atualização são:

É necessário atualizar todos os nós do Cassandra e do ZooKeeper antes de atualizar outros nós.
Para qualquer máquina com vários componentes de borda (servidor de gerenciamento, processador de mensagens, roteador, o servidor QPID, mas não o servidor Postgres), use o "-c borda". de atualizar todas ao mesmo tempo.
Se uma etapa especificar que ela deve ser realizada em várias máquinas, realize-a no ordem de máquina especificada.
Não há uma etapa separada para atualizar a monetização. Ela é atualizada quando você especifica "-c" borda" é a melhor opção.