Requisitos do portal de serviços para desenvolvedores

Portal de serviços para desenvolvedores v. 4.16.05

Veja a seguir os requisitos de hardware e software para instalação.

Requisitos do banco de dados MySQL

Se você optar por instalar o servidor MySQL na mesma máquina que os serviços do canal do desenvolvedor, a topologia de máquina única, o instalador dos serviços do canal do desenvolvedor solicitará que você insira o nome e o usuário do banco de dados e, em seguida, instalará o servidor MySQL e criará o esquema do banco de dados para você. A versão instalada é a versão mais recente disponível para seu SO.

Se você quiser que o servidor MySQL seja instalado em um sistema separado, instale o servidor MySQL nesse sistema antes de iniciar o instalador do Developer Channel Services. É necessário ter instalado o MySQL 5.0.15 ou posterior.

O instalador do Developer Channel Services exige que o servidor MySQL contenha um banco de dados com um esquema de banco de dados vazio. O instalador do Developer Channel Services solicita o nome do host, o nome e o usuário do banco de dados. Em seguida, o instalador se conecta ao banco de dados para criar as tabelas e os dados padrão.

O usuário do banco de dados é usado pelo Developer Channel Services para se conectar ao banco de dados e precisa ter os seguintes privilégios: SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, CREATE TEMPORARY TABLES, LOCK TABLES.

Por exemplo, para criar um banco de dados chamado devportal e um nome de usuário chamado devportal:

1. Instale o servidor MySQL no sistema.
2. Faça login no MySQL como usuário raiz usando o comando:
   > mysql -u root -p
3. Digite a senha raiz quando solicitado.
4. No prompt mysql>, digite o seguinte para criar o usuário devportal:
   mysql>create user 'devportal'@'localhost' identified by 'devportal';
   mysql> grant all privileges on *.* to 'devportal'@'localhost';
   mysql> flush privileges;
   mysql> quit
5. No prompt do sistema, crie o banco de dados devportal:
   > mysqladmin -u devportal -p create devportal
   
   Digite a senha do devportal.
6. Faça login no MySQL e conceda acesso ao devportal pelo IP do servidor do portal:
   mysql> GRANT ALL ON devportal.* TO devportal@'portalIP' IDENTIFIED BY 'devportalPW';
   
   em que portalIP é o endereço IP do servidor do portal e devportalPW é a senha do usuário devportal.
7. Edite /etc/my.cnf para definir bind-address como o endereço IP do servidor MySQL.
8. Reinicie o MySQL:
   > /etc/init.d/mysqld restart
9. Verifique se a porta 3306 está aberta no servidor MySQL. Esse procedimento se baseia no seu sistema operacional. Por exemplo, para Linux, use o comando:
   > /sbin/iptables -A INPUT -i eth0 -p tcp --destination-port 3306 -j ACCEPT

Ao instalar o Developer Channel Services, especifique que o servidor MySQL não deve ser instalado localmente. Em seguida, você precisará inserir o endereço IP, o nome de usuário e o nome do banco de dados remoto.

Requisitos do Red Hat Enterprise Linux (RHEL)

O RHEL tem requisitos extras devido a uma assinatura necessária para acessar downloads de software da Red Hat. O servidor precisa se conectar à Internet para fazer o download de RPMs via yum. Se você estiver usando o RHEL, o servidor precisará estar registrado na Red Hat Network (RHN) e no canal opcional do servidor.

Os requisitos do Red Hat são verificados durante a instalação, e o instalador do portal solicita que você registre o RHEL, caso ainda não tenha feito isso. Se você já tiver credenciais de login do Red Hat, use o comando a seguir para registrar o RHEL antes de iniciar o processo de instalação:

> subscription-manager register --username=my_username --password=my_password --auto-attach 

Substitua my_username e my_password pelas suas credenciais da Red Hat.

Se você tiver uma versão de teste do RHEL, poderá receber uma licença de teste de 30 dias. Consulte https://access.redhat.com/solutions/32790 para mais informações.

Requisitos de SMTP

Por padrão, o portal envia e-mails usando a função mail() do PHP. O PHP tenta enviar e-mails usando o sendmail no sistema local, que pode ser configurado no arquivo php.ini do PHP.

Em um ambiente de produção, a Apigee exige que você configure um servidor SMTP para enviar mensagens de e-mail do portal. Portanto, é preciso garantir que o Drupal possa acessar a porta necessária no servidor SMTP. Para SMTP não TLS, o número da porta geralmente é 25. Para SMTP com TLS, geralmente é 465, mas verifique com seu provedor de SMTP.

Requisitos adicionais

Para realizar a instalação, o usuário que instala o software precisa ter acesso raiz.

Requisitos de arquitetura de implantação

O Developer Channel Services tem uma única interface com o servidor de gerenciamento da Apigee por meio de uma API REST para armazenar e recuperar informações sobre os aplicativos de um usuário. Os serviços de canal do desenvolvedor precisam se conectar ao servidor de gerenciamento por HTTP ou HTTPS, dependendo da instalação.

Informações necessárias antes de iniciar a instalação

Antes de iniciar a instalação, você precisa ter as seguintes informações disponíveis:

1. Qual plataforma você está configurando: Red Hat ou CentOS? Se for uma instalação do Red Hat, a máquina precisará ser registrada na Red Hat Network para fazer o download de RPMs.
2. Você planeja instalar o MySQL na máquina local? Algumas instalações de alta disponibilidade exigem que o MySQL esteja em uma máquina diferente daquela que exibe as páginas da Web do portal. Se esse for o caso, não instale o MySQL localmente. Se você quiser uma instalação simples com tudo na mesma máquina, instale o MySQL localmente.
3. Se você pretende acessar um servidor MySQL remoto, o nome do host, a porta, o nome do banco de dados, o nome de usuário e a senha do servidor MySQL remoto. O servidor MySQL remoto já precisa estar configurado antes de iniciar a instalação.
4. Qual é o nome de domínio totalmente qualificado do servidor da Web? Essas informações serão adicionadas a /etc/hosts. Deve ser um endereço IP ou nome do host, como portalserver.example.com. O valor padrão é localhost.
5. Você quer usar a configuração padrão da Apigee para o host virtual do Apache? Um host virtual é criado com o nome do host especificado na Etapa 7 acima.
6. Há três informações que permitem que seu portal se comunique com o servidor de gerenciamento do Apigee Edge. As informações são as seguintes:
   1. URL do endpoint da API Management da Apigee: será um nome de host ou um endereço IP. Esse é o endpoint REST para o qual todas as chamadas são feitas para criar apps e registrar desenvolvedores para chaves de app. O endpoint padrão é https://api.enterprise.apigee.com/v1.
      
      Para uma instalação do Edge para nuvem privada, o URL está no formato:
      http://EdgeIp:8080/v1
      
      ou:
      https://EdgeIp:SSLport/v1
      
      Em que EdgeIp é o endereço IP do servidor de gerenciamento do Edge e SSLport é a porta SSL da API de gerenciamento do Edge. Por exemplo, 8443.
   2. Nome da organização da Apigee: há uma relação entre os portais e as organizações da Apigee Edge. Você vai configurar a organização padrão ao configurar o endpoint de API Management. O valor padrão é my-org.
   3. Nome de usuário e senha do endpoint de API Management: as chamadas do portal para o Edge precisam ser realizadas por um administrador da sua organização.
      
      Esse nome de usuário/senha é de um administrador da sua organização e deve ser usado apenas para se conectar ao Edge pelo portal. Por exemplo, se você especificar as credenciais de um usuário e ele for excluído no Edge, o portal não poderá mais se conectar ao Edge. Portanto, crie um administrador na sua organização apenas para essa conexão.
      
      Por exemplo:
      dc_devportal+ORGNAME@apigee.com:MyP@ssw0rd