Esta página foi traduzida pela API Cloud Translation.

Atualização do Apigee Edge 4.16.01 para 4.16.05

Edge for Private Cloud v. 4.16.05

Quais versões do Edge podem ser atualizadas para a 4.16.05

Só é possível atualizar o Apigee Edge versão 4.16.01.x para 4.16.05.

Se você tiver uma versão do Edge anterior à 4.16.01.x, primeiro migre para o versão 4.16.01.x e atualizar para 4.16.05.

Quem pode realizar a atualização

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

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

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

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

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

Aviso: esta versão do Edge não é compatível com o JDK 7. Se você está atualmente usando o JDK 7, é necessário fazer upgrade para o JDK 8. Se você reverter a instalação do Edge 4.16.05, poderá reconfigure o Edge para usar o Java JDK 7.

Fazendo downgrade do Zookeeper

A versão do RPM do Zookeeper no Edge para a nuvem privada 4.16.01 é apigee-zookeeper-3.4.5-1.0.905.noarch.rpm. Em versões subsequentes do Edge, a versão do Zookeeper foi alterada novamente para apigee-zookeeper-3.4.5-0.0.948. Isso evita yum.Do upgrade do Zookeeper para uma versão posterior do 4.16.01, A maneira de contornar essa situação é executar o yum downgrade apigee-zookeeper antes de atualizar o Zookeeper.

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

> rpm -qa |grep apigee-zookeeper

Se este comando retornar a versão do Zookeeper:

apigee-zookeeper-3.4.5-1.0.905

Em seguida, é necessário fazer o downgrade.

Requisitos de espaço em disco para atualização

Verifique se você tem pelo menos 1 GB de espaço livre em disco antes de realizar a atualizar.

Propagação automática da propriedade da versão 4.16.01.x

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

Como atualizar o utilitário apigee-validate

Na versão 4.16.01, você instalou e executou o utilitário apigee-validate em uma instância Message Processador. Na versão 4.16.05, o utilitário apigee-validate foi atualizado para execução no nó do Servidor de gerenciamento.

Ao atualizar para a versão 4.16.05, você terá duas opções para atualizar o utilitário apigee-validate:

Recomendamos a Apigee: instale e execute o utilitário apigee-validate na Nó do servidor de gerenciamento.

Se quiser, desinstale o utilitário apigee-validate do nós do processador de mensagens. Se você deixá-lo no nó "Processador de mensagens", precisará atualizá-lo até 4.16.05.
Outra opção é atualizar o utilitário apigee-validate na do processador de mensagens e executá-lo de lá. No entanto, a Apigee recomenda que você instale e executá-lo no servidor de gerenciamento.

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:

> /<inst_root>/apigee/apigee-service/bin/apigee-all status

Como lidar com uma atualização com falha

No caso de uma falha na atualização, tente corrigir o problema e executar update.sh novamente. É possível executar a atualização várias vezes e continua a atualização de onde parou.

Se a falha exigir que você reverta a atualização para a versão anterior, consulte 4.16.05 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 descritos em Ativar/Desativar o servidor (Processador/Roteador de mensagens) Acessibilidade.
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.16.01.

Procedimento para atualizando para 4.16.05 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.
Desative o SELinux conforme descrito em Instalar o Edge apigee-setup .
Faça o download do arquivo bootstrap_4.16.05.sh do Edge 4.16.05 para /tmp/bootstrap_4.16.05.sh:
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh (link em inglês)
Instale o utilitário Edge 4.16.05 apigee-service e dependências:
> "sudo bash" /tmp/bootstrap_4.16.05.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:
1. Se você instalou a versão 4.16.01 atualizando o Edge para a versão 4.15.07.0x, será necessário Instale o utilitário apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service instalação de configuração da apigee
  Esse comando instala o utilitário update.sh em <inst_dir>/apigee/apigee-setup/bin.
  
  Se você já instalou o utilitário apigee-setup, atualize ele:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. Se você instalou a versão 4.16.01 diretamente, ou seja, não fez upgrade do 4.15.07.0x, será preciso atualizar o utilitário apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  Esta atualização do apigee-service instala Utilitário update.sh em <inst_dir>/apigee/apigee-setup/bin.
Instale o comando 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 uma nó Processador de mensagens, é possível atualizá-lo usando o seguinte comando nesse nó:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
No entanto, para a versão 4.16.05, a Apigee recomenda que você instale e execute o utilitário de validação da Apigee no no servidor de gerenciamento.
Edite o arquivo de configuração transmitido para o utilitário apigee-validate. Na versão anterior do Edge, o arquivo de configuração usado pelo apigee-validate exigia o seguintes propriedades:
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
REGION=dc-1
Nesta versão, o arquivo de configuração requer apenas a propriedade APIGEE_ADMINPW. Você pode remover outras duas propriedades do arquivo.
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. Por exemplo, coloque o arquivo no diretório /tmp no nó.
Use a opção “-c” para especificar o componente a ser atualizado. A lista de possíveis componentes incluem:
- ldap = OpenLDAP
- cs = Cassandra
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- edge =Toda a borda exceto a interface de usuário de borda: o servidor de gerenciamento, o processador de mensagens, o roteador, o servidor QPID, Servidor Postgres
- ui = interface do Edge
- all = atualizar todos Componentes na máquina (use apenas para um perfil de instalação do Edge Aio ou um Asa de API BaaS) perfil de instalação)
- e = ElasticSearch
- b = pilha BaaS de API
- p = BaaS da API Portal
- ebp = ElasticSearch, Pilha de APIs BaaS e API BaaS Portal 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 4.16.05 Processo de reversão.

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

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

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

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

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

Crie um repositório local 4.16.05 conforme descrito em "Criar um repositório da Apigee local" em Instalar a configuração da Apigee do Edge .
Observação: se você já tem um repositório 4.16.01, adicione o repositório 4.16.05 repositório a ele.
Para instalar o apigee-service usando um arquivo .tar:
1. No nó com o repositório local, use o seguinte comando para empacotar o repositório local em um único arquivo .tar chamado /opt/apigee/data/apigee-mirror/apigee-4.16.05.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.16.05.tar.gz
  Esse comando cria um novo diretório, "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.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  Você incluiu o caminho o diretório repos neste 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 Edge bootstrap_4.16.05.sh para /tmp/bootstrap_4.16.05.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  onde uName:pWord são o nome de usuário e a senha que você definiu acima para a repo, e remoteRepo é o endereço IP ou nome DNS do repo nó.
3. No nó remoto, instale o utilitário Edge Apigee-service e as dependências:
  > "sudo bash" /tmp/bootstrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  onde uName:pWord são o nome de usuário do repositório e senha.
Use apigee-service para Atualize o utilitário apigee-setup:
1. Se você instalou a versão 4.16.01 atualizando o Edge para a versão 4.15.07.0x, será necessário Instale o utilitário apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service instalação de configuração da Apigee
  Esse comando instala o utilitário update.sh. em <inst_dir>/apigee/apigee-setup/bin.
  
  Se você já instalou o utilitário apigee-setup, atualize ele:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. Se você instalou a versão 4.16.01 diretamente, ou seja, não fez upgrade do 4.15.07.0x, será preciso atualizar o utilitário apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  Esta atualização das instalações do apigee-service o utilitário update.sh em <inst_dir>/apigee/apigee-setup/bin.
Instale o utilitário apigee-validate no nó do Servidor de gerenciamento:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
Observação: se você instalou o utilitário apigee-validate em uma nó Processador de mensagens, é possível atualizá-lo usando o seguinte comando nesse nó:

> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
No entanto, para a versão 4.16.05, a Apigee recomenda que você instale e execute o comando apigee-validate no servidor de gerenciamento.
Edite o arquivo de configuração transmitido para o utilitário apigee-validate. Em na versão anterior do Edge, o arquivo de configuração usado pelo apigee-validate exigia o seguintes propriedades:
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
REGIÃO=dc-1
Nesta versão, o arquivo de configuração requer apenas a propriedade APIGEE_ADMINPW. Você pode remover outras duas propriedades do arquivo.
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. Por exemplo, coloque o arquivo no diretório /tmp no nó.
Use a opção “-c” para especificar o componente a ser atualizado. A lista de possíveis componentes incluem:
- ldap = OpenLDAP
- cs = Cassandra
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- edge =Toda a borda exceto a interface de usuário de borda: o servidor de gerenciamento, o processador de mensagens, o roteador, o servidor QPID, Servidor Postgres
- ui = interface do Edge
- all = atualizar todos Componentes na máquina (use apenas para um perfil de instalação do Edge Aio ou um Asa de API BaaS) perfil de instalação)
- e = ElasticSearch
- b = pilha BaaS de API
- p = BaaS da API Portal
- ebp = ElasticSearch, Pilha de APIs BaaS e API BaaS Portal 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 4.16.05 Processo de reversão.

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.
É necessário atualizar todos os nós qpidd e postgresql antes de atualizar Roteador e processador de mensagens.
Para qualquer máquina com vários componentes de borda (servidor de gerenciamento, processador de mensagens, roteador, servidor QPID, servidor Postgres), use "-c Edge" de atualizar todas ao mesmo tempo tempo de resposta.
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.
Depois de atualizar um nó do roteador, é preciso remover todos os arquivos do diretório /opt/nginx/conf.d e depois reinicie o roteador.