Atualizar o portal

Edge para nuvem privada v4.18.05

Este procedimento descreve como fazer upgrade de uma instalação local do portal de serviços para desenvolvedores da Apigee (ou simplesmente o portal) existente.

Como determinar o procedimento de atualização correto

O procedimento usado para atualizar o portal é baseado na sua instalação atual:

Como determinar seu tipo de instalação atual

Se você não tiver certeza do tipo de instalação atual, use o seguinte comando para determinar isso:

  • ls /opt

    Se você estiver usando o Nginx/Postgres, os diretórios a seguir serão exibidos: /opt/apigee e /opt/nginx.

    Se você estiver usando o Apache/MySQL ou o Apache/MariaDB, esses diretórios não estarão presentes.

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

    Se você estiver usando o Nginx/Postgres, a saída será a seguinte:

    + 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 o Apache/MySQL ou o Apache/MariaDB, esse 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 foi instalado em:

  • 4.17.05 e versões mais recentes: /opt/apigee/apigee-drupal/wwwroot
  • Antes de 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 seu diretório de instalação.

Versões de upgrade compatíveis

Este procedimento de upgrade é compatível com as seguintes versões do portal:

  • OPDK-17-01.x
  • OPDK-17-05.x
  • OPDK-17-09.x
  • OPDK-18-01.x

Para determinar a versão do portal, abra o seguinte URL em um navegador:

http://yourportal.com/buildInfo

Antes da atualização

Para instalações atuais, se você tiver modificado algum código no núcleo do Drupal ou em módulos não personalizados, suas modificações serão substituídas. Isso inclui, entre outras coisas, todas as mudanças que você fez em .htaccess. Considere que tudo fora do diretório /sites é 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 prosseguir 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 o RPM do portal em um nó:

  1. Mude para o diretório Drupal, /opt/apigee/apigee-drupal por padrão: 
    cd /opt/apigee/apigee-drupal
  2. Faça backup da sua instância do banco de dados do Drupal. O comando pg_dump cria uma cópia do banco de dados: 
    pg_dump --dbname=devportal --host=host_IP_address --username=drupaladmin
  --password --format=c > /tmp/portal.dmp

    em que:

    • devportal é o nome do banco de dados conforme especificado pela propriedade PG_NAME no arquivo de configuração de instalação do portal.
    • host_IP_address é o endereço IP do nó do portal.
    • drupaladmin é o nome de usuário do Postgres usado pelo portal para acessar o banco de dados, conforme especificado pela propriedade DRUPAL_PG_USER no arquivo de configuração de instalação do portal.
    • Você vai receber uma solicitação para a senha do usuário do Postgres, conforme definido pela propriedade DRUPAL_PG_PASS no arquivo de configuração da instalação do portal.

    Se precisar restaurar o backup mais tarde, use o comando:

    pg_restore --clean --dbname=devportal --host=localhost  --username=apigee < /tmp/portal.dmp
  3. 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 ter mudado.

    Se você não tiver certeza do local desse diretório, use o comando drush status ou a entrada Configuration > Media > File no menu do Drupal para determinar o local do sistema de arquivos público e do caminho do sistema de arquivos particular (para a próxima etapa).

  4. Faça um backup dos arquivos em /opt/apigee/data/apigee-drupal-devportal/private.
  5. Definir o Drupal para o modo de manutenção:
    1. Selecione Configuração no menu do Drupal.
    2. Na página Configuration, selecione Maintenance mode em Development.
    3. Selecione a caixa Colocar o site no modo de manutenção.
    4. Insira a mensagem que os usuários verão durante a manutenção.
    5. Selecione Salvar configuração.
  6. Desative o SELinux conforme descrito em Instalar o utilitário apigee-setup do Edge.
  7. Mude para o diretório /opt: 
    cd /opt
  8. Para fazer upgrade em um servidor com conexão à Internet:
    1. Faça o download do arquivo bootstrap_4.18.05.sh do Edge 4.18.05 para /tmp/bootstrap_4.18.05.sh: 
      curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
    2. Instale o utilitário apigee-service e as dependências do Edge 4.18.05: 
      sudo bash /tmp/bootstrap_4.18.05.sh apigeeuser=uName apigeepassword=pWord

      Em que uName e 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. Use a opção "C" para continuar sem instalar o Java.

  9. Para fazer um upgrade em um servidor sem conexão de Internet:
    1. Crie um repositório local 4.18.05 conforme descrito em Criar um repositório local da Apigee.
    2. Para instalar o apigee-service em um arquivo .tar:
      1. No nó com o repositório local, use o comando abaixo para empacotar o repositório local em um único arquivo .tar chamado /opt/apigee/data/apigee-mirror/apigee-4.18.05.tar.gz: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
      2. 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ó.
      3. No novo nó, descompacte o arquivo para o diretório /tmp: 
        tar -xzf apigee-4.18.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.

      4. Instale o utilitário apigee-service e as dependências do Edge em /tmp/repos: 
        sudo bash /tmp/repos/bootstrap_4.18.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

        Observe que você inclui o caminho para o diretório de repositórios neste comando.

    3. 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 o servidor da Web Nginx" em Instalar o utilitário de configuração da Apigee no Edge.
      2. No nó remoto, faça o download do arquivo bootstrap_4.18.05.sh do Edge para /tmp/bootstrap_4.18.05.sh: 
        /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.05.sh
  -o /tmp/bootstrap_4.18.05.sh

        Em que uName e pWord são o nome de usuário e a senha que você definiu acima para o repo, e remoteRepo é o endereço IP ou nome DNS do nó do repo.

      3. No nó remoto, instale o utilitário Edge apigee-service e as dependências: 
        sudo bash /tmp/bootstrap_4.18.05.sh apigeerepohost=remoteRepo:3939
  apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

        Em que uName e pWord são o nome de usuário e a senha do repositório.

  10. Use apigee-service para atualizar o utilitário apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  11. Execute o utilitário de atualização no seu 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 Postgres. O único requisito no arquivo de configuração é que ele seja acessível ou legível pelo usuário "apigee".

  12. Atualize o banco de dados do Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  13. 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 seja acessível ou legível pelo usuário "apigee".

  14. Execute o script update.php do Drupal abrindo o seguinte URL em uma janela do navegador: 
    http://portal_IP_DNS:8079/update.php
  15. Desative o Drupal para o modo de manutenção:
    1. Selecione Configuração no menu do Drupal.
    2. Na página Configuração, selecione Modo de manutenção em Desenvolvimento.
    3. Desmarque a caixa Colocar o site no modo de manutenção.
    4. Selecione Salvar configuração.

O diretório raiz após a atualização é:

/opt/apigee/apigee-drupal/wwwroot

O upgrade foi concluído.