Esta página foi traduzida pela API Cloud Translation.

Como fazer upgrade do portal dos serviços para desenvolvedores

Portal de serviços para desenvolvedores v. 4.17.05

Neste procedimento, descrevemos como fazer upgrade de uma instalação local atual do Apigee Developer Channel Services.

Observação:todas as novas instalações do portal para a versão 4.17.01 usaram o Postgres como banco de dados e o Nginx como o servidor da Web. No entanto, o upgrade de uma versão anterior do portal para a versão 4.17.01 manteve o banco de dados e o servidor da Web Apache usados na versão anterior. Isso significa que seu portal 4.17.1 atual pode usar qualquer uma das seguintes configurações:

Nginx/Postgres para todas as novas instalações 4.17.01
Apache/MySQL 5.0.15 ou posterior para todos os sistemas operacionais 6.x atualizados para 4.17.01
Apache/MariaDB 5.1.38 ou posterior para todos os sistemas operacionais 7.x atualizados para 4.17.01

Antes de iniciar o processo de atualização, você precisa determinar sua configuração atual e, em seguida, executar o procedimento de atualização correto.

Como determinar o procedimento de atualização correto

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

Se a instalação usar Apache/MySQL ou Apache/MariaDB de um sistema atualizado para 4.17.01, use Como fazer upgrade do portal usando um arquivo .tar.
Se a instalação usar o Nginx/Postgres de uma nova instalação 4.17.01, use Como fazer upgrade de um portal usando RPMs.

Como determinar o tipo de instalação atual

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

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

Se você estiver usando Apache/MySQL ou Apache/MariaDB, esses diretórios não estarão presentes.
/opt/apigee/apigee-service/bin/apigee-all status
Se estiver usando o Nginx/Postgres, você 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-lbstatus apigee-apigee-sql-apigee (apigee-Apigee, Apigee-service, como apigee-service, como Apigee-service, Apigee-service
apigee-sql-service, como apigee-service e Apigee-service
apigee-sql,
apachectl -S
Se você estiver usando Apache/MySQL ou Apache/MariaDB, esse comando retornará o diretório raiz da Web 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:

/opt/apigee/apigee-drupal (Nginx)
/var/www/html (Apache)

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.

Novo diretório de instalação padrão após a atualização do Nginx/Postgres de uma nova instalação 4.17.01

Depois de atualizar uma nova instalação da 4.17.01 que usa o Nginx/Postgres, o diretório raiz foi alterado de:

/opt/apigee/apigee-drupal

entre outras:

/opt/apigee/apigee-drupal/wwwroot

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
OPDK-17-01.x

Para descobrir sua versão do portal, abra o seguinte URL em um navegador:

http://yourportal.com/buildInfo

Observação:se você tiver removido o arquivo buildInfo por algum motivo, poderá determinar a versão no arquivo buildInfo. O local de instalação padrão é /var/www/html/profiles/apigee/apigee.info, mas você poderá alterá-lo durante a instalação se tiver instalado o portal em um diretório diferente de /var/www/html. O arquivo apigee.info contém uma linha no formulário abaixo com a versão:

version = "OPDK-4.16.05"

Antes de atualizar

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. Depois de executar as etapas de instalação descritas abaixo, é possível restaurar as personalizações no backup.

Como fazer upgrade do portal usando um arquivo .tar

Faça backup da instância do Drupal MySQL/MariaDB.
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.
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.
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 o Suporte da Apigee Edge e selecione Fazer login no portal de suporte para solicitar o arquivo .tar de upgrade do Developer Channel Services. 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.
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.
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.

Como fazer upgrade de um portal usando RPMs

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

Mude para o diretório Drupal, /opt/apigee/apigee-drupal por padrão:
> cd /opt/apigee/apigee-drupal
Faça backup da instância de banco de dados do Drupal. O comando pg_dump cria uma cópia do banco de dados:

pg_dump --dbname=devportal --host=192.168.56.101 --username=drupaladmin --password --format=c > /tmp/portal.dmp
- dbname especifica o nome do banco de dados, conforme especificado pela propriedade 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 arquivo de configuração de instalação do portal.
- A senha de usuário do Postgres será solicitada, conforme definido pela propriedade DRUPAL_PG_PASS no arquivo de configuração de instalação do portal.
Se mais tarde você precisar restaurar usando o backup, use o comando:
pg_restore --clean --dbname=devportal --host=localhost --username=apigee < /tmp/portal.dmp
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 talvez você tenha alterado.

Se você não tiver certeza do local desse diretório, use o comando drush status ou a entrada Configuration > Media > File no menu Drupal para determinar o local do sistema de arquivos público e do caminho do sistema de arquivos particular (para a próxima etapa).
Faça um backup dos arquivos em /opt/apigee/data/apigee-drupal-devportal/private.
Desative o SELinux conforme descrito em Instalar o utilitário de configuração da Apigee do Edge.
Para fazer upgrade em um servidor com conexão à Internet:
1. Faça o download do arquivo bootstrap_4.17.05.sh do Edge 4.17.05 para /tmp/bootstrap_4.17.05.sh:
  > curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
2. Instale o utilitário e as dependências apigee-service do Edge 4.17.05:
  > sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord
  
  em que uName:pWord é o nome de usuário e a senha que você recebeu da Apigee. Se você omitir o pWord, será solicitado que o insira.
  
  Por padrão, o instalador verifica se você tem o Java 1.8 instalado. Você pode usar a opção "C" para continuar sem instalar o Java.
Para fazer upgrade em um servidor sem conexão com a Internet:
1. Crie um repositório 4.17.05 local, conforme descrito em "Criar um repositório local da Apigee" em Instalar o utilitário de configuração da Apigee Edge.
  Observação: se você já tiver um repositório 4.17.01, poderá adicionar o 4.17.05 a ele, conforme descrito em "Atualizar um repositório local da Apigee" em Instalar o utilitário de configuração da Apigee do Edge.
2. Para instalar o apigee-service em um arquivo .tar:
  1. No nó com o repositório local, use o comando a seguir para empacotar o repositório local em um único arquivo .tar chamado /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz:
    > /opt/apigee/apigee-service/bin/apigee-service pacote apigee-mirror
  2. Copie o arquivo .tar para o nó em que você quer atualizar o Edge. Por exemplo, copie-o para o diretório /tmp no novo nó.
  3. No novo nó, remova o arquivo para o diretório /tmp:
    > tar -xzf apigee-4.17.05.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 apigee-service do Edge e as dependências de /tmp/repos:
    > sudo bash /tmp/repos/bootstrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
    
    Observe que você inclui o caminho para o diretório de repositórios neste comando.
3. Para instalar o serviço da Apigee usando o servidor da Web Nginx:
  1. Configure o servidor da Web Nginx conforme descrito em "Instalar do repositório usando o servidor da Web Nginx" em Instalar o utilitário de configuração da Apigee Edge.
  2. No nó remoto, faça o download do arquivo bootstrap_4.17.05.sh do Edge do nome de usuário /tmp/bootstrap_4.17.05.sh:
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05
  3. No nó remoto, instale o utilitário apigee-service do Edge e as dependências:
    > sudo bash /tmp/bootstrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeepassword=pWord apigeeprotocol=http://Nome e senha
    , em que o nome de usuário e senha, em que o nome de usuário e senha
    apigeeuser=remoteRepo.

Use apigee-service para atualizar o utilitário apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup atualização.

Execute o utilitário de atualização no seu 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 o banco de dados do Postgres. O único requisito do arquivo de configuração é que ele precisa estar acessível ou legível pelo usuário "apigee".

Inicie o Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start

Execute o utilitário de atualização no seu 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 o portal. O único requisito do arquivo de configuração é que ele precisa estar acessível ou legível pelo usuário "apigee".

O diretório raiz depois da atualização é:

/opt/apigee/apigee-drupal/wwwroot

O upgrade foi concluído.