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.09

Este procedimento descreve como fazer upgrade de uma instalação local do Apigee Developer Channel Services.

Observação:todas as novas instalações do portal a partir da versão 4.17.01 usaram o Postgres como banco de dados e o Nginx como servidor da Web. No entanto, as versões anteriores do portal usam o MySQL/MariaDB como o banco de dados e o servidor da Web do Apache. Isso significa que seu portal atual pode usar qualquer uma das seguintes configurações:

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

Antes de iniciar o processo de atualização, determine sua configuração atual e execute 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 usa Nginx/Postgres, consulte Como fazer upgrade de um portal usando RPMs abaixo.
Se a instalação usa o Apache/MySQL ou o Apache/MariaDB, consulte Converter um portal baseado em tar em um portal baseado em RPM.

Como determinar seu tipo de instalação atual

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

```
ls /opt
```
Se você estiver usando o Nginx/Postgres, os diretórios a seguir serão exibidos: /opt/apigee e /opt/nginx.
Se você estiver usando o Apache/MySQL ou o Apache/MariaDB, esses diretórios não estarão presentes.

/opt/apigee/apigee-service/bin/apigee-all status

Se você estiver usando o Nginx/Postgres, a saída será a seguinte:

+ 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 o Apache/MySQL ou o 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:

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 instalou o portal no diretório padrão, modifique os caminhos no procedimento abaixo para usar seu 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

Observação:se por algum motivo você removeu o arquivo buildInfo, é possível determinar a versão do arquivo profiles/apigee/apigee.info. O local de instalação padrão é /var/www/html/profiles/apigee/apigee.info, mas você pode ter alterado-o no momento da 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 contendo a versão:

version = "OPDK-4.17.05"

Antes de atualizar

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 em .htaccess. Considere que tudo fora do diretório /sites é de propriedade do Drupal. Uma exceção a essa regra é robots.txt. Se esse arquivo existir na raiz da Web, ele será preservado para você.

Antes de continuar com a instalação, faça um backup de todo o diretório raiz da Web do Drupal. Depois de seguir as etapas de instalação descritas abaixo, você pode restaurar suas personalizações do backup.

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. 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 da sua versão do produto.
Faça backup da sua instância do 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
```
em que:
- 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.
- Você vai receber uma solicitação para a senha do usuário do Postgres, conforme definido pela propriedade DRUPAL_PG_PASS no arquivo de configuração da instalação do portal.
Se precisar restaurar o backup mais tarde, 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ê o 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 do 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.
Definir o Drupal para o modo de manutenção:
1. Selecione Configuração no menu do Drupal.
2. Na página Configuração, selecione Modo de 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.
Desative o SELinux conforme descrito em Instalar o utilitário apigee-setup do Edge.
Mude para o diretório /opt:
```
cd /opt
```
Para fazer upgrade em um servidor com conexão à Internet:
1. Faça o download do arquivo bootstrap_4.17.09.sh do Edge 4.17.09 em /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 da Apigee. Se você omitir pWord, será solicitado que você 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 de Internet:
1. Crie um repositório local 4.17.09 conforme descrito em "Criar um repositório local da Apigee" em Instalar o utilitário apigee-setup do Edge.
  Observação: se você já tem um repositório 4.17.05, adicione o 4.17.09 a ele, conforme descrito em "Atualizar um repositório local da Apigee" em Instalar o utilitário "apigee-setup" 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.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 para o diretório /tmp no novo nó.
  3. No novo nó, descompacte o arquivo no 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 as 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 utilitário de configuração da Apigee no Edge.
  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 o nome DNS do nó do repositório.
  3. No nó remoto, instale o utilitário apigee-service do Edge e as dependências: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.

Use apigee-service para atualizar o utilitário apigee-setup:

/opt/apigee/apigee-service/bin/apigee-service apigee-setup update

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 usado para instalar o banco de dados do Postgres. O único requisito no arquivo de configuração é que ele seja 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 usado para instalar o portal. O único requisito no arquivo de configuração é que ele precisa estar acessível ou legível para o usuário da "apigee".
Execute o script update.php do Drupal abrindo o seguinte URL em uma janela do navegador:
```
http://portalIP_DNS:8079/update.php
```
Desative o Drupal para o modo de manutenção:
1. Selecione Configuration no menu Drupal.
2. Na página Configuration, selecione Maintenance mode em Development.
3. Desmarque a caixa Colocar site no modo de manutenção.
4. Selecione Salvar configuração.

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

/opt/apigee/apigee-drupal/wwwroot

O upgrade foi concluído.