Como fazer upgrade do portal dos serviços para desenvolvedores

Portal de serviços para desenvolvedores v. 4.16.05

Neste procedimento, descrevemos como fazer upgrade de um projeto existente do Apigee Developer Channel Services instalação no local.

Diretório de instalação padrão

O processo de upgrade pressupõe que o Portal do desenvolvedor estava 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 sua instalação diretório.

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-4.24.216
  • pantheon-4.24.246
  • 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

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

http://yourportal.com/buildInfo

Como fazer upgrade do canal de desenvolvedores da Apigee Serviços para uma nova versão

  1. Backup da instância Drupal MySQL.
    Para mais informações, acesse 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 o drush help sql-dump para mais informações.
    2. Opção 2: usar MySQLdump
      Usar o comando mysqldump para criar uma cópia do banco de dados:
      mysqldump -u NOME DE USUÁRIO -p'SENHA' BANCO DE DADOS > /path/to/backup_dir/database-backup.sql

      Não deve haver espaço entre a opção -p e a senha. Solteiro(a) é necessário colocar aspas em torno da senha se ela tiver caracteres especiais.

      Você define 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 é possível foram alterados no momento da instalação.
  3. Faça o download do Developer Channel Services DeveloperServices_x.y.z.tar em que x.y.z corresponde ao número da versão do portal.

    É possível fazer o download de um arquivo pelo link enviado pela Apigee em um navegador ou copiá-lo e e adicione-a ao seguinte comando cURL:
    &gt; curl -kOL <colar link here&gt;

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

    Acesse http://community.apigee.com/content/apigee-customer-support e selecione Fazer login em seu portal de suporte para solicitar o Canal do desenvolvedor Upgrade dos serviços no arquivo .tar. Se você não tiver uma conta no portal de suporte, selecione Faça login no seu Portal de suporte e, na página de login, selecione Em um está com pressa? abra um tíquete de suporte aqui.
  4. Para um upgrade em um servidor com conexão à Internet:
    1. Extraia o arquivo de upgrade do portal:
      &gt; tar -xvf <tar file&gt;

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

      Esse comando cria um diretório chamado drupal-x.y, em que x.y corresponde ao diretório atual mais recente do Drupal.
    4. Execute o script networked-update.sh:
      &gt; ./networked-update.sh

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

      Depois de ativados, é possível ver as atualizações disponíveis usando o menu Relatórios > Disponível Atualizações.

      Use o menu Relatórios > Atualizações disponíveis > Configurações do item de menu para configure o módulo para enviar um e-mail a você quando as atualizações estiverem disponíveis e para definir a frequência para verificar se há atualizações.
  5. Para um 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:
      &gt; tar -xvf <tar file&gt;

      A extração desse comando cria um novo diretório chamado DeveloperServices-4.x.y.z.
    2. Mude para DeveloperServices-4.x.y.z diretório.
    3. Execute o script non-networked-update.sh:
      &gt; ./non-networked-update.sh

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

      Este 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 destino. servidor, aquele que executa o portal.
      Observação: não copie devportal-update.tgz para a raiz da Web do servidor de destino.
    5. Descompacte o arquivo devportal-update.tgz para diretório atual:
      &gt; 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:
      &gt; ./install-update.sh
    8. Responda às solicitações.

O upgrade foi concluído.