Como fazer upgrade do portal dos serviços para desenvolvedores

Portal de serviços para desenvolvedores v. 4.16.09

Este procedimento descreve como fazer upgrade de uma instalação local 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 não souber o diretório de instalação, você poderá identificá-lo conforme descrito nos Comandos Drush mais usados.

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

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 módulos não personalizados, suas modificações serão substituídas. Isso inclui, entre outras coisas, todas as mudanças que você fez no .htaccess. Considere que tudo fora do diretório /sites é de propriedade do 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 você pode ter mudado durante a instalação. Depois de executar as etapas de instalação descritas abaixo, é possível restaurar as personalizações no backup.

Como atualizar os serviços do canal de desenvolvedores da Apigee para uma nova versão

  1. Backup da sua 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 sql-dump do Drush 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 NOME DE USUÁRIO -p'SENHA' DATABASENAME > /path/to/backup_dir/database-backup.sql

      Não deve haver espaço entre a opção -p e a senha. Aspas simples são necessárias se a senha tiver caracteres especiais.

      Você definiu USERNAME 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 mudado isso durante a instalação.
  3. Faça o download do arquivo DeveloperServices_x.y.z.tar dos serviços do canal do desenvolvedor, em que x.y.z corresponde ao número da versão do portal.

    Você pode fazer o download de um arquivo pelo link enviado pela Apigee em um navegador ou copiando 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 à 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 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 seu portal de suporte e, na página de login, selecione Com pressa? Abra 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>

      Esse comando extrai 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 o 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 Drupal, selecione Modules e role para baixo até o módulo Update manager. Se não estiver, ative.

      Depois da ativação, confira as atualizações disponíveis no item de menu Relatórios > Atualizações disponíveis.

      Use o item de menu Reports > Available Updates > Settings 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 de Internet:
    1. No servidor em que você fez o download do arquivo DeveloperServices_x.y.z.tar dos serviços do canal para desenvolvedores, extraia o arquivo de upgrade do portal:
      > tar -xvf <tar file>

      Esse comando de extração 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 o 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 comando a seguir para instalar a atualização:
      > ./install-update.sh
    8. Responda às solicitações.

O upgrade foi concluído.