Atualizar o portal

Edge para nuvem privada v4.19.01

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.

Determinar o procedimento de atualização correto

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

Determinar seu tipo de instalação atual

Se você não tiver certeza sobre seu tipo de instalação atual, use o seguinte comando para determiná-lo:

  • 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 da 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 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
  • OPDK-18-05.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, qualquer mudança que você tenha feito 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 seguir as etapas de instalação descritas abaixo, você pode restaurar suas personalizações do backup.

Fazer upgrade de um portal usando RPMs

Para atualizar a 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 de banco de dados 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 quiser restaurar o backup mais tarde, use o seguinte 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. Configure o Drupal no modo de manutenção:
    1. Selecione Configuração no menu do Drupal.
    2. Na página Configuration, selecione Maintenance mode em Development.
    3. Marque a caixa Colocar site no modo de manutenção.
    4. Insira uma mensagem que os usuários vão ver 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 um upgrade em um servidor com conexão à Internet:
    1. Faça o download do arquivo bootstrap_4.19.01.sh do Edge 4.19.01 para /tmp/bootstrap_4.19.01.sh: 
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
    2. Instale o utilitário apigee-service e as dependências do Edge 4.19.01: 
      sudo bash /tmp/bootstrap_4.19.01.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 você tem o Java 1.8 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.19.01 conforme descrito em Criar um repositório local da Apigee.
    2. 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.19.01.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.19.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.

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

        Inclua o caminho para o diretório repos nesse comando.

    3. Para instalar o apigee-service usando o servidor da Web Nginx:
      1. Configure o servidor da Web Nginx conforme descrito em "Instalar do repositório usando o Nginx Webserver" em Instalar o utilitário apigee-setup do Edge.
      2. No nó remoto, faça o download do arquivo bootstrap_4.19.01.sh do Edge para /tmp/bootstrap_4.19.01.sh: 
        /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.01.sh
  -o /tmp/bootstrap_4.19.01.sh

        Em que uName e 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.

      3. No nó remoto, instale o utilitário apigee-service e as dependências do Edge: 
        sudo bash /tmp/bootstrap_4.19.01.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 nó do Postgres: 
    /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 no arquivo de configuração é que ele seja acessível ou legível pelo usuário "apigee".

  12. Execute o utilitário de atualização no 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".

  13. Execute o script update.php do Drupal abrindo o seguinte URL em uma janela do navegador: 
    http://portal_IP_DNS:8079/update.php
  14. Desative 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. Se o utilitário de atualização da Apigee fizer downgrade da sua versão do Drupal, talvez seja necessário executar novamente o utilitário de upgrade do Drupal. Para mais informações, consulte Executar novamente o upgrade do Drupal.

Executar novamente o upgrade do Drupal

Se a execução do utilitário de atualização do Apigee para atualizar o Edge para nuvem privada resultar em um downgrade da sua versão do Drupal, reinstale o upgrade do Drupal. Isso pode acontecer se você atualizar apenas o Drupal entre as atualizações da Nuvem particular.

Exemplo:

  1. Você estava executando a versão 4.18.05 do Edge for Private Cloud, que incluía o Drupal 7.59.
  2. Você fez upgrade do Drupal para a versão 7.64 devido a uma atualização de segurança necessária.
  3. Você está fazendo upgrade da nuvem privada para a versão 4.19.01, que inclui o Drupal 7.61.

Como este caso ilustra, a versão do Drupal usada pelo utilitário de atualização do Apigee pode não fazer referência à versão mais recente do Drupal. Como resultado, agora você precisa executar novamente o upgrade do Drupal para retornar a instalação do Drupal à versão mais recente.