Como fazer upgrade do portal dos serviços para desenvolvedores

Portal de serviços para desenvolvedores v. 4.17.09

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

.

Como determinar o procedimento de atualização correto

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

Determinar seu tipo de instalação atual

Se você não tiver certeza sobre seu tipo de instalação atual, use o seguinte comando para determinar ele:

  • ls /opt

    Se estiver usando o Nginx/Postgres, você verá os seguintes diretórios: /opt/apigee e /opt/nginx.

    Se você usa Apache/MySQL ou Apache/MariaDB, esses diretórios não devem ser presente.

  • /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 retornará o arquivo diretório raiz 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:

  • 4.17.05 e mais recentes: /opt/apigee/apigee-drupal/wwwroot
  • Antes da versão 4.17.05: /opt/apigee/apigee-drupal (Nginx) ou /var/www/html (Apache)

Se você não tiver instalado o portal no diretório padrão, modifique os caminhos no procedimento abaixo para usar o diretório de instalação.

Versões de upgrade compatíveis

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

  • OPDK-17-01.x
  • OPDK-17-05.x

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

http://your_portal.com/buildInfo

Antes de atualizar

Para instalações atuais, se você modificou qualquer código no Drupal Core ou em qualquer módulos, suas modificações serão substituídas. Isso inclui, entre outras coisas, as alterações que você fez para .htaccess. Suponha que tudo fora do diretório /sites seja de propriedade do Drupal. Um exceção a essa regra é robots.txt; se o arquivo existe na Web raiz, ele será preservado para você.

Antes de continuar com a instalação, faça um backup de toda a raiz da Web do Drupal diretório. Após executar as etapas de instalação descritas abaixo, você pode restaurar os personalizações do backup.

Atualização de um portal usando RPMs

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

  1. Mude para o diretório Drupal. Por exemplo, /opt/apigee/apigee-drupal/wwwroot. 

    cd /opt/apigee/apigee-drupal/wwwroot

    Consulte Diretório de instalação padrão para o diretório padrão de a versão do produto.

  2. Faça backup da sua instância de banco de dados Drupal. O comando pg_dump cria uma cópia 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 pelo 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 do arquivo de configuração de instalação do portal.
    • A senha do usuário do Postgres é solicitada, conforme definido pelo DRUPAL_PG_PASS no arquivo de configuração de instalação do portal.

    Se mais tarde você precisar restaurar pelo 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 você pode ter mudado.
    Se você não tiver certeza sobre a localização desse diretório, use o comando drush status ou a Configuração > Mídia > Entrada File no menu Drupal para determinar a localização do sistema de arquivos público e o caminho do sistema de arquivos particular (para o próximo etapa).
  4. Faça um backup dos arquivos em /opt/apigee/data/apigee-drupal-devportal/private.
  5. Configure o Drupal no modo de manutenção:
    1. Selecione Configuration no menu Drupal.
    2. Na página Configuração, selecione Manutenção em Desenvolvimento.
    3. Marque a caixa Colocar site no modo de manutenção.
    4. Insira a mensagem que os usuários verão durante a manutenção.
    5. Selecione Salvar configuração.
  6. Desative o SELinux conforme descrito em Instale o utilitário de configuração da Apigee Apigee.
  7. Use o diretório /opt: 
    cd /opt
  8. Para um upgrade em um servidor com conexão à Internet:
    1. Baixe o arquivo bootstrap_4.17.09.sh do Edge 4.17.09 para /tmp/bootstrap_4.17.09.sh: 
      curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
    2. Instale o utilitário apigee-service e as dependências do Edge 4.17.09: 
      sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName
  apigeepassword=pWord

      em que uName:pWord são o nome de usuário e a senha que você recebeu a Apigee. Se você omitir pWord, será solicitado que a insira.

      Por padrão, o instalador verifica se você tem o Java 1.8 instalado. Você pode usar o “C” para continuar sem instalar o Java.

  9. Para um upgrade em um servidor sem conexão com a Internet:
    1. Crie um repositório 4.17.09 local conforme descrito em "Criar um repositório da Apigee local" em Instalar o Edge utilitário apigee-setup.
    2. Para instalar o apigee-service usando 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.09.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 ao diretório /tmp no novo nó.
      3. No novo nó, descompacte o arquivo para o diretório /tmp:
        tar -xzf apigee-4.17.09.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 Edge apigee-service e dependências de /tmp/repos: 
        sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

        Inclua o caminho para o diretório repos nesse comando.

    3. Para instalar o apigee-service usando o servidor da Web Nginx:
      1. Configure o servidor da Web Nginx conforme descrito em "Instalar a partir do repositório usando o Servidor da Web Nginx" em Instalar o Edge utilitário apigee-setup.
      2. No nó remoto, faça o download do arquivo bootstrap_4.17.09.sh do Edge para /tmp/bootstrap_4.17.09.sh: 
        /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh
  -o /tmp/bootstrap_4.17.09.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 nome DNS do nó de repositório.

      3. No nó remoto, instale o utilitário Edge apigee-service e dependencies:code 
        sudo bash /tmp/bootstrap_4.17.09.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.

  10. Use apigee-service para atualizar o utilitário apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  11. 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 que você usou para instalar. no banco de dados Postgres. O único requisito desse arquivo é que a configuração O arquivo precisa ser acessível ou legível para o ambiente do Apigee usuário.

  12. Iniciar Postgres:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  13. 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 que você usou para instalar. no portal. O único requisito desse arquivo é que ele precisa ser acessível ou legível para o ambiente do Apigee usuário.

  14. Execute o script update.php do Drupal abrindo o seguinte URL em uma janela do navegador: 
    http://portalIP_DNS:8079/update.php
  15. Desative o Drupal para o modo de manutenção:
    1. Selecione Configuration no menu Drupal.
    2. Na página Configuração, selecione Manutenção em Desenvolvimento.
    3. Desmarque a caixa Colocar site no modo de manutenção.
    4. Selecione Salvar configuração.

Observe que o diretório raiz após a atualização é:

/opt/apigee/apigee-drupal/wwwroot

O upgrade foi concluído.