Portal de serviços para desenvolvedores v. 4.17.05
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:
- Se a instalação usa Apache/MySQL ou Apache/MariaDB por um sistema atualizado para 4.17.01, use Como fazer upgrade portal usando um arquivo .tar.
- Se sua instalação usa o Nginx/Postgres de uma nova versão 4.17.01 instalação, depois acesse Como fazer upgrade de um portal usando RPMs.
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, a seguinte saída será exibida:
+ apigee-service status apigee-drupal-devportal
OK: o apigee-drupal-devportal está em execução
+ status apigee-service apigee-lb
apigee-service: apigee-lb: OK
+ apigee-service status apigee-postgresql
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 segundos 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 tiver instalado o portal no diretório padrão, modifique os caminhos no procedimento abaixo para usar o diretório de instalação.
Se não souber o diretório de instalação, você poderá identificá-lo conforme descrito nos Comandos Drush mais usados.
Novo Diretório de instalação padrão após a atualização do Nginx/Postgres de uma nova versão 4.17.01 instalação
Após atualizar uma nova instalação do 4.17.01 que usa Nginx/Postgres, o diretório raiz alterado de:
/opt/apigee/apigee-drupal
para:
/opt/apigee/apigee-drupal/wwwroot
Versões de upgrade compatíveis
Este procedimento de upgrade é compatível com 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 determinar a versão do portal, abra o seguinte URL em um navegador:
http://yourportal.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 é o 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.
Como fazer upgrade do portal usando um arquivo .tar
- Faça backup da sua instância Drupal MySQL/MariaDB.
Para mais informações, acesse http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/- 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. - 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.
- Opção 1: usar o Drush
- 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.
- Faça o download do Developer Channel Services DeveloperServices_x.y.z.tar
em ftp.apigee.com, em que x.y.z
corresponde ao número da versão do portal. Quando solicitado, digite as credenciais que você recebeu
da Apigee.
É 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:
> curl -kOL <colar link here>
Observação: se o portal estiver em um servidor sem conexão externa de Internet, execute essa etapa em um servidor com acesso.
Acesse Suporte do Apigee Edge 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. -
Para um upgrade em um servidor com conexão à Internet:
- Extraia o arquivo de upgrade do portal:
> tar -xvf <tar file>
A extração desse comando cria um novo diretório chamado DeveloperServices-4.x.y.z. - Mude para DeveloperServices-4.x.y.z diretório.
- 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 ao diretório atual mais recente do Drupal. - Execute o script networked-update.sh:
> ./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. - 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.
- Extraia o arquivo de upgrade do portal:
-
Para um upgrade em um servidor sem conexão com a Internet:
- 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>
A extração desse comando cria um novo diretório chamado DeveloperServices-4.x.y.z. - Mude para DeveloperServices-4.x.y.z diretório.
- Execute o script non-networked-update.sh:
> ./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. - 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. - Descompacte o arquivo devportal-update.tgz para
diretório atual:
> tar -xzf /path/to/devportal-update.tgz - Mude para o diretório developer-update.
- Execute o seguinte comando para instalar a atualização:
> ./install-update.sh - Responda às solicitações.
- 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:
O upgrade foi concluído.
Atualização 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 sua instância de banco de dados 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 portal de configuração da instalação.
- host especifica o IP endereço do nó do portal.
- username especifica; o nome de usuário do Postgres usado pelo portal para acessar o banco de dados conforme especificado pelo 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 pela propriedade DRUPAL_PG_PASS na do 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 você pode ter mudado.
Se você não tiver certeza do local deste diretório, use o comando drush status ou o 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.
- Desative o SELinux conforme descrito em Instalar o utilitário de configuração da Apigee do Edge;
-
Para um upgrade em um servidor com conexão à Internet:
- 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 (link em inglês) - Instale o utilitário Edge 4.17.05 apigee-service e
dependências:
> "sudo bash" /tmp/bootstrap_4.17.05.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 o pWord, será necessário digitá-lo.
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.
- Faça o download do arquivo bootstrap_4.17.05.sh do Edge 4.17.05 para
/tmp/bootstrap_4.17.05.sh:
-
Para um upgrade em um servidor sem conexão com a Internet:
- Crie um repositório 4.17.05 local conforme descrito em "Criar um repositório da Apigee local" em
Instalar a configuração da Apigee do Edge
.
Observação: se você já tem um repositório 4.17.01, adicione o 4.17.05 como descrito em "Atualizar um repositório da Apigee local" em Instalar o utilitário de configuração da Apigee Apigee. -
Para instalar o apigee-service usando um arquivo .tar:
- No nó com o repositório local, use o seguinte comando para empacotar o repositório local
repositório 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 - 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ó.
- No novo nó, descompacte 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. - Instale o utilitário apigee-service do Edge e
dependências de /tmp/repos:
> "sudo bash" /tmp/repos/bootstrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Inclua o caminho para o diretório repos nesse comando.
- No nó com o repositório local, use o seguinte comando para empacotar o repositório local
repositório em um único arquivo .tar chamado /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz:
-
Para instalar o apigee-service usando o servidor da Web Nginx:
- 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.
- No nó remoto, faça o download do arquivo bootstrap_4.17.05.sh do Edge para
/tmp/bootstrap_4.17.05.sh:
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.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. - No nó remoto, instale o utilitário apigee-service do Edge e
dependências:
> "sudo bash" /tmp/bootstrap_4.17.05.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.
- Crie um repositório 4.17.05 local conforme descrito em "Criar um repositório da Apigee local" em
Instalar a configuração da Apigee do Edge
.
- Use apigee-service para
atualize o apigee-setup
utilitário:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update - 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 usado 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. - Iniciar Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start - 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 usado 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.
Observe que o diretório raiz depois da atualização é:
/opt/apigee/apigee-drupal/wwwroot
O upgrade foi concluído.