Esta página foi traduzida pela API Cloud Translation.

Como fazer upgrade do portal dos serviços para desenvolvedores

Edge para nuvem privada v4.18.01

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

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 Nginx/Postgres, use Como fazer upgrade de um portal usando RPMs abaixo.
Se a instalação usa Apache/MySQL ou Apache/MariaDB, consulte Converter um de um portal baseado em tar para um portal baseado em RPM.

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 você estiver usando o Nginx/Postgres, os diretórios a seguir serão exibidos: /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, 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 versões 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
OPDK-17-09.x

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

http://yourportal.com/buildInfo

Observação:se por algum motivo você tiver removido o arquivo buildInfo, será possível determinar o versão do arquivo profiles/apigee/apigee.info. O o local de instalação padrão é /var/www/html/profiles/apigee/apigee.info, mas você pode ter feito a alteraçã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 da atualização

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, 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 este arquivo existir na raiz da web, ele será preservados 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

Para atualizar a RPM do portal em um nó:

Mude para o diretório Drupal, /opt/apigee/apigee-drupal, padrão:
```
cd /opt/apigee/apigee-drupal
```
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 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 a base de dados, conforme especificado pela propriedade DRUPAL_PG_USER no 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
```
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 pode ter sido alterado.
Se você não tiver certeza sobre a localização do diretório, use o comando drush status ou 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).
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 Configuration no menu Drupal.
2. Na página Configuração, selecione Manutenção em Desenvolvimento.
3. Selecione a caixa Colocar o site no modo de manutenção.
4. Insira uma mensagem que os usuários vão ver durante a manutenção.
5. Selecione Salvar configuração.
Desative o SELinux conforme descrito em Instale o utilitário de configuração da Apigee Apigee.
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.18.01.sh do Edge 4.18.01 para /tmp/bootstrap_4.18.01.sh:
```
curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
```
2. Instale o utilitário apigee-service e as dependências do Edge 4.18.01:
```
sudo bash /tmp/bootstrap_4.18.01.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 você o insira.
  
  Por padrão, o instalador verifica se o Java 1.8 está instalado. Você pode usar o “C” para continuar sem instalar o Java.
Para um upgrade em um servidor sem conexão com a Internet:
1. Crie um repositório local 4.18.01 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 repositório 4.18.01 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 usando um arquivo .tar:
  1. No nó com o repositório local, use o seguinte comando para empacotar o repositório local repo em um único arquivo .tar chamado /opt/apigee/data/apigee-mirror/apigee-4.18.01.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.18.01.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 Edge e as dependências da /tmp/repos:
```
sudo bash /tmp/repos/bootstrap_4.18.01.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 apigee-service usando o servidor da Web Nginx:
  1. Configure o servidor da Web Nginx conforme descrito em "Instalar do repositório usando o Nginx Webserver" em Instalar o utilitário apigee-setup do Edge.
  2. No nó remoto, faça o download do arquivo bootstrap_4.18.01.sh do Edge para /tmp/bootstrap_4.18.01.sh:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh
  -o /tmp/bootstrap_4.18.01.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:
```
sudo bash /tmp/bootstrap_4.18.01.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 nó do Postgre:
```
/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 no arquivo de configuração é que ele seja acessível ou legível pelo usuário "apigee".

Atualize o banco de dados do Postgres:

/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade

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 desse arquivo é que ele precisa ser acessível ou legível para o ambiente do Apigee usuário.
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 Configuração no menu do Drupal.
2. Na página Configuração, selecione Manutenção em Desenvolvimento.
3. Desmarque a caixa Colocar o 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.