Edge para nuvem privada v4.18.01
Neste procedimento, descrevemos como fazer upgrade de uma instalação local atual do Apigee Developer Channel Services.
Como determinar o procedimento de atualização correto
O procedimento usado para atualizar o portal é baseado na sua instalação atual:
- Se a instalação usar Nginx/Postgres, use a opção Como fazer upgrade de um portal usando RPMs abaixo.
- Se a instalação usa Apache/MySQL ou Apache/MariaDB, consulte Converter um portal baseado em tar em um portal baseado em RPM.
Como determinar o tipo de instalação atual
Se você não tiver certeza do seu tipo de instalação atual, use o seguinte comando para determinar:
ls /opt
Se você estiver usando o Nginx/Postgres, verá os seguintes diretórios:
/opt/apigee
e/opt/nginx
.Se você estiver usando Apache/MySQL ou Apache/MariaDB, esses diretórios não estarão presentes.
/opt/apigee/apigee-service/bin/apigee-all status
Se você estiver usando Nginx/Postgres, verá a seguinte saída:
+ apigee-service apigee-drupal-devportal status OK: apigee-drupal-devportal is up and running + apigee-service apigee-lb status apigee-service: apigee-lb: OK + apigee-service apigee-postgresql status apigee-service: apigee-postgresql: OK
apachectl -S
Se você estiver usando Apache/MySQL ou Apache/MariaDB, este comando retornará o diretório raiz da Web do portal, no formato:
*:80 192.168.56.102 (/etc/httpd/conf/vhosts/devportal.conf:1)
Diretório de instalação padrão
O processo de upgrade pressupõe que o Portal do desenvolvedor foi instalado em:
- 4.17.05 e mais recentes:
/opt/apigee/apigee-drupal/wwwroot
- Anterior à versão 4.17.05:
/opt/apigee/apigee-drupal
(Nginx) ou/var/www/html
(Apache)
Se você não instalou o portal no diretório padrão, modifique os caminhos no procedimento abaixo para usar o diretório de instalação.
Versões de upgrade compatíveis
Este procedimento de upgrade tem suporte para as seguintes versões do portal:
- OPDK-17-01.x
- OPDK-17-05.x
- OPDK-17-09.x
Para descobrir sua versão do portal, abra o seguinte URL em um navegador:
http://yourportal.com/buildInfo
Antes de atualizar
Nas instalações atuais, se você tiver modificado qualquer código no núcleo Drupal ou em módulos
não personalizados, as modificações vão ser substituídas. Isso inclui, entre outras coisas, qualquer mudança
que você tenha feito em .htaccess
.
Suponha que tudo fora do diretório /sites
seja de propriedade do Drupal. Uma exceção a essa regra é robots.txt
. Se esse arquivo existir na raiz da Web, ele será preservado para você.
Antes de continuar com a instalação, faça um backup de todo o diretório raiz da Web do Drupal. Depois de executar as etapas de instalação descritas abaixo, é possível restaurar as personalizações no backup.
Como fazer upgrade de um portal usando RPMs
Para atualizar a RPM do portal em um nó:
- Mude para o diretório Drupal,
/opt/apigee/apigee-drupal
por padrão:cd /opt/apigee/apigee-drupal
- Faça backup da instância de banco de dados do Drupal. O comando
pg_dump
cria uma cópia do banco de dados:pg_dump --dbname=devportal --host=192.168.56.101 --username=drupaladmin --password --format=c > /tmp/portal.dmp
onde:
dbname
especifica o nome do banco de dados, conforme especificado pela propriedadePG_NAME
no arquivo de configuração de instalação do portal.host
especifica o endereço IP do nó do portal.username
especifica o nome de usuário do Postgres usado pelo portal para acessar o banco de dados, conforme especificado pela propriedadeDRUPAL_PG_USER
no arquivo de configuração de instalação do portal.- A senha do usuário do Postgres será solicitada, conforme definido pela propriedade
DRUPAL_PG_PASS
no arquivo de configuração de instalação do portal.
Se mais tarde você precisar restaurar a partir do backup, use o comando:
pg_restore --clean --dbname=devportal --host=localhost --username=apigee < /tmp/portal.dmp
- Faça um backup de todo o diretório raiz da Web do Drupal. O local de instalação padrão
é
/opt/apigee/apigee-drupal
, mas você pode tê-lo alterado.Se você não souber o local desse diretório, use o comando
drush status
ou a entrada Configuration > Media > File no menu Drupal para determinar o local do sistema de arquivos público e do caminho do sistema de arquivos particular (para a próxima etapa). - Faça um backup dos arquivos em
/opt/apigee/data/apigee-drupal-devportal/private
. - Configure o Drupal para o modo de manutenção:
- Selecione Configuration no menu do Drupal.
- Na página Configuração, selecione Modo de manutenção em Desenvolvimento.
- Marque a caixa Colocar o site em modo de manutenção.
- Digite uma mensagem que os usuários veem durante a manutenção.
- Selecione Salvar configuração.
- Desative o SELinux conforme descrito em Instalar o utilitário de configuração da Apigee do Edge.
- Mude para o diretório
/opt
:> cd /opt
- Para fazer upgrade em um servidor com conexão à Internet:
- Faça o download do arquivo
bootstrap_4.18.01.sh
do Edge 4.18.01 para/tmp/bootstrap_4.18.01.sh
:curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
- Instale o utilitário
apigee-service
e as dependências do Edge 4.18.01:sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord
em que uName:pWord é o nome de usuário e a senha que você recebeu da Apigee. Se você omitir o campo pWord, será necessário inseri-lo.
Por padrão, o instalador verifica se você tem o Java 1.8 instalado. Você pode usar a opção "C" para continuar sem instalar o Java.
- Faça o download do arquivo
- Para fazer upgrade em um servidor sem conexão com a Internet:
- Crie um repositório 4.18.01 local, conforme descrito em "Criar um repositório local da Apigee" em Instalar o utilitário de configuração da Apigee Edge.
-
Para instalar o apigee-service em 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.18.01.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.18.01.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 do/tmp/repos
:sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Observe que você incluiu o caminho para o diretório de repositórios nesse comando.
- No nó com o repositório local, use o seguinte comando para empacotar o repositório
local em um único arquivo .tar chamado
-
Para instalar o serviço da Apigee 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 de configuração da Apigee Edge.
- No nó remoto, faça o download do arquivo
bootstrap_4.18.01.sh
do Edge para/tmp/bootstrap_4.18.01.sh
:/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
em que uName:pWord é o nome de usuário e a senha que você definiu acima para o repositório, e remoteRepo é o endereço IP ou nome DNS do nó do repositório.
- No nó remoto, instale o utilitário
apigee-service
e as dependências do Edge:sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
em que uName:pWord é o nome de usuário e a senha do repositório.
- Use
apigee-service
para atualizar o utilitárioapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- Execute o utilitário de atualização no nó do Postgre:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
em que configFile é o arquivo de configuração usado para instalar o banco de dados do Postgres. O único requisito do arquivo de configuração é que ele precisa estar acessível ou legível pelo usuário "apigee".
- Atualize o banco de dados do Postgres:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
- Execute o utilitário de atualização no seu nó para atualizar o portal:
/opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile
em que configFile é o arquivo de configuração usado para instalar o portal. O único requisito do arquivo de configuração é que ele precisa estar acessível ou legível pelo usuário "apigee".
- Execute o script
update.php
do Drupal abrindo o seguinte URL em uma janela do navegador:http://portalIP_DNS:8079/update.php
- Desative o Drupal para o modo de manutenção:
- Selecione Configuration no menu do Drupal.
- Na página Configuração, selecione Modo de manutenção em Desenvolvimento.
- Desmarque a caixa Colocar o site em modo de manutenção.
- Selecione Salvar configuração.
Observe que o diretório raiz após a atualização é:
/opt/apigee/apigee-drupal/wwwroot
O upgrade foi concluído.