Como fazer upgrade do portal dos serviços para desenvolvedores

Portal de serviços para desenvolvedores v. 4.17.05

Neste procedimento, descrevemos como fazer upgrade de uma instalação local dos serviços do canal do desenvolvedor da Apigee.

Como determinar o procedimento de atualização correto

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

Como determinar seu tipo de instalação atual

Se você não tiver certeza sobre o 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 devem estar presentes.
  • /opt/apigee/apigee-service/bin/apigee-all status
    Se você estiver usando o 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, esse comando vai 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:

  • /opt/apigee/apigee-drupal (Nginx)
  • /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.

Se você não souber o diretório de instalação, determine-o conforme descrito em Comandos Drush usados com frequência.

Novo diretório de instalação padrão após a atualização do Nginx/Postgres de uma nova instalação do 4.17.01

Depois de atualizar uma nova instalação da versão 4.17.01 que usa Nginx/Postgres, o diretório raiz mudou de:

/opt/apigee/apigee-drupal

para:

/opt/apigee/apigee-drupal/wwwroot

Versões de upgrade compatíveis

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

  • pantheon-14.02.x
  • pantheon-14.03.x
  • pantheon-14.04.x
  • pantheon-14.07.x
  • pantheon-15-01.x
  • OPDK-15-04.x
  • OPDK-15-07.x
  • OPDK-16-01.x
  • OPDK-16-05.x
  • OPDK-16-09.x
  • OPDK-17-01.x

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

http://yourportal.com/buildInfo

Antes de atualizar

Para instalações atuais, se você tiver modificado algum código no núcleo do Drupal ou em qualquer módulo não personalizado, suas modificações serão substituídas. Isso inclui, entre outras coisas, as mudanças que você fez no .htaccess. Presuma que tudo fora do diretório /sites pertence ao Drupal. Uma exceção a essa regra é o robots.txt. Se esse arquivo existir na raiz da Web, ele será preservado.

Antes de prosseguir com a instalação, faça um backup de todo o diretório raiz da Web do Drupal. Depois de realizar as etapas de instalação descritas abaixo, você poderá restaurar suas personalizações do backup.

Como fazer upgrade do portal usando um arquivo .tar

  1. Faça backup da instância do MySQL/MariaDB do Drupal.
    Para mais informações, consulte http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/
    1. Opção 1: usar o Drush

      O comando Drush sql-dump cria uma cópia do banco de dados. No diretório do Drupal, /var/www/html por padrão, execute o comando:
      > drush sql-dump > /path/to/backup_dir/database-backup.sql

      Use drush help sql-dump para mais informações.
    2. Opção 2: usar o MySQLdump
      Use o comando mysqldump para criar uma cópia do banco de dados:
      mysqldump -u USERNAME -p'PASSWORD' DATABASENAME > /path/to/backup_dir/database-backup.sql

      Não pode haver espaço entre a opção -p e a senha. As aspas simples ao redor da senha são necessárias se ela tiver caracteres especiais.

      Você definiu USERNAME e DATABASENAME ao instalar o portal. Por padrão, ambos são devportal.
  2. Faça um backup de todo o diretório raiz da Web do Drupal. O local de instalação padrão é /var/www/html, mas talvez você tenha mudado isso no momento da instalação.
  3. Faça o download do arquivo DeveloperServices_x.y.z.tar dos serviços do canal do desenvolvedor em ftp.apigee.com, em que x.y.z corresponde ao número da versão do portal. Quando solicitado, insira as credenciais que você recebeu da Apigee.

    É possível fazer o download de um arquivo do link enviado pela Apigee em um navegador ou copiando-o e adicionando-o ao seguinte comando cURL:
    > curl -kOL <paste link here>

    Observação: se o portal estiver em um servidor sem conexão de internet externa, execute esta etapa em um servidor com acesso.

    Acesse o suporte da Apigee Edge e selecione Fazer login no portal de suporte para solicitar o arquivo .tar de upgrade dos serviços do canal do desenvolvedor. Se você não tiver uma conta no Portal de Suporte, selecione Fazer login no Portal de Suporte e, na página de login, selecione Está com pressa? Abra um tíquete de suporte aqui.
  4. Para um upgrade em um servidor com conexão de Internet:
    1. Extraia o arquivo de upgrade do portal:
      > tar -xvf <tar file>

      Essa extração de comando cria um novo diretório chamado DeveloperServices-4.x.y.z.
    2. Mude para o diretório DeveloperServices-4.x.y.z.
    3. Faça o download da versão mais recente do Drupal usando o seguinte comando:
      > drush dl drupal

      Esse comando cria um diretório chamado drupal-x.y, em que x.y corresponde à versão atual do Drupal.
    4. Execute o script networked-update.sh:
      > ./networked-update.sh

      Dependendo das permissões do arquivo, talvez seja necessário usar sudo para executar esse comando ou executá-lo como administrador.
    5. Para receber notificações de atualizações do Drupal, verifique se o módulo do gerenciador de atualizações do Drupal está ativado. No menu do Drupal, selecione Modules e role para baixo até o módulo Update manager. Se não estiver ativada, ative-a.

      Depois de ativá-lo, você pode ver as atualizações disponíveis usando o item de menu Relatórios > Atualizações disponíveis.

      Use o item de menu Relatórios > Atualizações disponíveis > Configurações para configurar o módulo para enviar um e-mail quando houver atualizações disponíveis e definir a frequência de verificação de atualizações.
  5. Para fazer upgrade em um servidor sem conexão de Internet:
    1. No servidor em que você fez o download do arquivo DeveloperServices_x.y.z.tar do Developer Channel Services, extraia o arquivo de upgrade do portal:
      > tar -xvf <tar file>

      Essa extração de comando cria um novo diretório chamado DeveloperServices-4.x.y.z.
    2. Mude para o diretório DeveloperServices-4.x.y.z.
    3. Execute o script non-networked-update.sh:
      > ./non-networked-update.sh

      Dependendo das permissões do arquivo, talvez seja necessário usar sudo para executar esse comando ou executá-lo como administrador.

      Esse comando faz o download de todos os arquivos de atualização necessários e os empacota em um único arquivo chamado devportal-update.tgz e grava o arquivo em um local de sua escolha.
    4. Copie devportal-update.tgz para o servidor de destino, aquele que executa o portal.
      Observação: não copie o devportal-update.tgz para a raiz da Web do servidor de destino.
    5. Descompacte o arquivo devportal-update.tgz no diretório atual:
      > tar -xzf /path/to/devportal-update.tgz
    6. Mude para o diretório developer-update.
    7. Execute o seguinte comando para instalar a atualização:
      > ./install-update.sh
    8. Responda às solicitações.

O upgrade foi concluído.

Como fazer upgrade de um portal usando RPMs

Use o procedimento a seguir para atualizar o RPM do portal em um nó:

  1. Altere para o diretório do Drupal, /opt/apigee/apigee-drupal por padrão:
    > cd /opt/apigee/apigee-drupal
  2. Faça backup da 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=192.168.56.101 --username=drupaladmin --password --format=c > /tmp/portal.dmp

    em que:
    • dbname especifica o nome do banco de dados, conforme especificado pela propriedade PG_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 propriedade DRUPAL_PG_USER no arquivo de configuração de instalação do portal.
    • Será solicitada a senha do usuário do Postgres, conforme definido pela propriedade DRUPAL_PG_PASS no arquivo de configuração de instalação do portal.

    Se você precisar restaurar o backup, 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 talvez você o tenha alterado.

    Se você não tiver certeza do local desse diretório, use o comando drush status ou a entrada Configuração > Mídia > Arquivo no menu do Drupal para determinar o local do sistema de arquivos público e o caminho do sistema de arquivos privado (para a próxima etapa).
  4. Faça um backup dos arquivos em /opt/apigee/data/apigee-drupal-devportal/private.
  5. Desative o SELinux conforme descrito em Instalar o utilitário apigee-setup do Edge.
  6. Para um upgrade em um servidor com conexão de Internet:
    1. Faça o download do arquivo bootstrap_4.17.05.sh do Edge 4.17.05 para /tmp/bootstrap_4.17.05.sh:
      > curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
    2. Instale o utilitário apigee-service do Edge 4.17.05 e as dependências:
      > sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord

      em que uName:pWord são o nome de usuário e a senha que você recebeu da Apigee. Se você omitir pWord, será necessário inseri-lo.

      Por padrão, o instalador verifica se o Java 1.8 está instalado. Use a opção "C" para continuar sem instalar o Java.
  7. Para um upgrade em um servidor sem conexão de internet:
    1. Crie um repositório local 4.17.05, conforme descrito em "Criar um repositório local da Apigee" em Instalar o utilitário apigee-setup do Edge.
      Observação: se você já tiver um repositório 4.17.01, poderá adicionar o repositório 4.17.05 a ele, conforme descrito em "Atualizar um repositório local da Apigee" em Instalar o utilitário apigee-setup do Edge.
    2. Para instalar o apigee-service de 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.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 no diretório /tmp:
        > tar -xzf apigee-4.17.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 do Edge e as dependências de /tmp/repos:
        > sudo bash /tmp/repos/bootstrap_4.17.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 do repositório usando o servidor da Web Nginx" em Instalar o utilitário apigee-setup do Edge.
      2. No nó remoto, faça o download do arquivo bootstrap_4.17.05.sh do Edge para /tmp/bootstrap_4.17.05.sh:
        > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh

        em que uName: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 do Edge e as dependências:
        > sudo bash /tmp/bootstrap_4.17.05.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.
  8. Use apigee-service para atualizar o utilitário apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  9. Execute o utilitário de atualização no nó para atualizar o banco de dados 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 do arquivo de configuração é que ele precisa ser acessível ou legível pelo usuário "apigee".
  10. Inicie o Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  11. 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 precisa ser acessível ou legível pelo usuário "apigee".

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

/opt/apigee/apigee-drupal/wwwroot

O upgrade foi concluído.