Portal de serviços para desenvolvedores v. 4.16.05
Veja a seguir os requisitos de hardware e software para instalação.
Hardware |
Requisito |
Sistema operacional |
Estas instruções de instalação e os arquivos de instalação fornecidos foram testados nos sistemas operacionais listados aqui: https://apigee.com/docs/api-services/reference/supported-software |
RAM |
1 GB |
Disco rígido |
10 GB |
Interface de rede |
É necessário ter uma conexão de Internet ativa. Como parte do processo de instalação, o instalador faz o download de recursos da Web. Se o ambiente estiver configurado para solicitações HTTP e HTTPS de saída de proxy, então o proxy precisará ser configurado para processar corretamente as solicitações redirecionadas que podem ocorrer durante um download. Por exemplo, uma solicitação para https://drupal.org/ retorna um código de status HTTP 301 e redireciona para https://www.drupal.org/. É necessário configurar o proxy para retornar um código de status HTTP 200 com o conteúdo solicitado do redirecionamento. Para instalações do SAP, se o ambiente estiver configurado para solicitações HTTPS de saída de proxy, o proxy precisará oferecer suporte a TLSv1.0. O OpenSSL 0.9.8 não é compatível com TLSv1.1 ou TLSv1.2, apenas com TLSv1.0. |
Requisitos do banco de dados MySQL
Se você optar por instalar o servidor MySQL na mesma máquina que o Developer Channel Services, a topologia de máquina única, o instalador do Developer Channel Services solicitará que você digite o nome do banco de dados e o usuário do banco de dados e, em seguida, instalará o MySQL Server e criará o esquema do banco de dados para você. A versão instalada é a mais recente disponível para seu SO.
Se você quer que o MySQL Server seja instalado em um sistema separado, é necessário já ter instalado o MySQL Server no 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 MySQL Server contenha um banco de dados com um esquema 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 do banco de dados.
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 usuário chamado devportal:
- Instalar o MySQL Server no sistema.
- Faça login no MySQL como usuário raiz usando este comando:
> mysql -u root -p - Digite a senha raiz quando solicitado.
- No prompt mysql>, digite o seguinte para criar o usuário do devportal:
mysql>create user 'devportal'@'localhost' identificado por "devportal';
mysql> concede todos os privilégios em *.* a "devportal'@'localhost';
mysql> esvazie os privilégios;
mysql> quit - No prompt do sistema, crie o banco de dados devportal:
> mysqladmin -u devportal -p create devportal
Digite a senha devportal. - 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. - Edite /etc/my.cnf para definir bind-address como endereço IP do servidor MySQL.
- Reinicie o MySQL:
> /etc/init.d/mysqld restart - Verifique se a porta 3306 está aberta no servidor do MySQL. Este procedimento é baseado 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 para não instalar o MySQL Server localmente. Em seguida, você será solicitado a inserir o endereço IP, o nome de usuário e o nome do banco de dados remoto.
Requisitos do Red Hat Enterprise Linux (Ela )
O AOSP tem requisitos extras devido à necessidade de uma assinatura para acessar os downloads de software da Red Hat. O servidor precisa ser capaz de se conectar à Internet para fazer o download de RPMs com o yum. Se você estiver usando o php, 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ê se o AOSP ainda não estiver registrado. Se você já tiver credenciais de login do Red Hat, poderá usar o seguinte comando para registrar o AOSP 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 do Red Hat.
Se você tiver uma versão de teste do AOSP, poderá adquirir uma licença de avaliação de 30 dias. Consulte https://access.redhat.com/solutions/32790 para mais informações.
Requisitos do 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 pelo portal. Portanto, você precisa garantir que o Drupal possa acessar a porta necessária no servidor SMTP. Para SMTP sem TLS, o número da porta geralmente é 25. Para o SMTP com TLS ativado, ele geralmente é 465, mas verifique com o provedor SMTP.
Outros requisitos
Para executar a instalação, o usuário que instala o software precisa ter acesso raiz.
Requisitos da arquitetura de implantação
O Developer Channel Services tem uma interface única 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. O Developer Channel Services terá que se conectar ao servidor de gerenciamento via 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:
- Qual plataforma você está configurando: Red Hat ou CentOS? No caso de uma instalação da Red Hat, a máquina precisa estar registrada na Red Hat Network para fazer o download de RPMs.
- 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 veicula as páginas da Web do portal. Nesse caso, não instale o MySQL localmente. Se você quiser uma instalação simples com tudo na mesma máquina, instale o MySQL localmente.
- Se você pretende acessar um servidor MySQL remoto, informe o nome do host, a porta, o nome do banco de dados, o nome de usuário e a senha desse servidor. O servidor MySQL remoto já deve estar configurado antes de você iniciar a instalação.
- Qual é o nome de domínio totalmente qualificado do servidor da Web? Essas informações serão adicionadas a /etc/hosts. Precisa ser um endereço IP ou nome do host, como portalserver.example.com. O valor padrão é localhost.
- 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 que você especificou acima na etapa 7.
- Há três informações que permitem que seu portal se comunique com o servidor de gerenciamento
do Apigee Edge. Essas informações são as seguintes:
- URL do endpoint da API Apigee Management: será um nome do host ou um endereço IP. Esse é o endpoint REST em que todas as chamadas são feitas para criar apps e registrar desenvolvedores para chaves de apps. O endpoint padrão é https://api.enterprise.apigee.com/v1.
Para uma instalação do Edge para nuvem privada, o URL tem o formato:
http://EdgeIp:8080/v1
ou:
https://EdgeIp:SSLport/v1
Em que a porta EdgeIp é o endereço IP do servidor de gerenciamento de borda e SSLport Por exemplo, 8443. - Nome da organização da Apigee: há uma relação entre portais e organizações do Apigee Edge. Você definirá a organização padrão ao configurar o endpoint da API Management. O valor padrão é my-org.
- Nome de usuário e senha do endpoint da API de gerenciamento: as chamadas do
portal para o Edge precisam ser realizadas por um administrador da sua organização.
Esse nome de usuário e senha são de um administrador na sua organização e devem ser usados 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 organização apenas para essa conexão.
Por exemplo:
dc_devportal+ORGNAME@apigee.com:MyP@ssw0rd
- URL do endpoint da API Apigee Management: será um nome do host ou um endereço IP. Esse é o endpoint REST em que todas as chamadas são feitas para criar apps e registrar desenvolvedores para chaves de apps. O endpoint padrão é https://api.enterprise.apigee.com/v1.