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 atual do Apigee Developer Channel Services.

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 conhece o diretório de instalação, pode determiná-lo conforme descrito em Comandos Drush usados com mais frequência.

Versões de upgrade compatíveis

Este procedimento de upgrade tem suporte para 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 descobrir sua versão do portal, abra o seguinte URL em um navegador:

http://yourportal.com/buildInfo

Antes de instalar

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, quaisquer mudanças que você possa ter feito no .lint. Você deve presumir que tudo fora do diretório /sites é de propriedade do Drupal. Uma exceção a essa regra é o robots.txt. Se o arquivo existir na raiz da Web, ele será preservado.

Antes de continuar 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 você pode ter alterado no momento da instalação. Depois de executar as etapas de instalação descritas abaixo, é possível restaurar as personalizações no backup.

Como fazer upgrade do Apigee Developer Channel Services para uma nova versão

  1. Backup da instância do Drupal MySQL.
    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 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 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 deve haver espaço entre a opção -p e a senha. Se a senha tiver caracteres especiais, use aspas simples.

      Você definiu NOME DE USUÁRIO e DATABASENAME quando instalou 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 você pode ter alterado no momento da instalação.
  3. Faça o download do arquivo DeveloperServices_x.y.z.tar do Channel Services para desenvolvedores 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 para você 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 externa de Internet, realize esta etapa em um servidor com acesso.

    Acesse http://community.apigee.com/content/apigee-customer-support e selecione Fazer login no seu portal de suporte para solicitar o upgrade do arquivo .tar do Channel Services para desenvolvedores. 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? Crie um tíquete de suporte aqui.
  4. Para fazer upgrade em um servidor com conexão à 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 ativado, ative-o.

      Depois de ativado, é possível 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 as atualizações estiverem disponíveis e definir a frequência de verificação de atualizações.
  5. Para fazer upgrade em um servidor sem conexão com a 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, 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.