Como fazer upgrade do portal dos serviços para desenvolvedores

Portal de serviços para desenvolvedores v. 4.17.01

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

Diretório de instalação padrão

O processo de upgrade pressupõe que o portal do desenvolvedor foi instalado em /var/www/html. 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.

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

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

http://yourportal.com/buildInfo

Antes de instalar

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. O local de instalação padrão é /var/www/html, mas talvez você o tenha alterado no momento da instalação. Depois de realizar as etapas de instalação descritas abaixo, você poderá restaurar suas personalizações do backup.

Como fazer upgrade dos serviços do canal do desenvolvedor da Apigee para uma nova versão

  1. Backup da instância do MySQL 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 http://community.apigee.com/content/apigee-customer-support e selecione Login to your Support Portal para solicitar o arquivo .tar de upgrade dos serviços de 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.