Requisitos del portal de servicios para desarrolladores

Portal de Servicios para desarrolladores v. 4.16.05

A continuación, se indican los requisitos de hardware y software para la instalación.

Hardware

Requisito

Sistema operativo

Estas instrucciones de instalación y los archivos de instalación proporcionados se probaron en los sistemas operativos que se enumeran aquí: https://apigee.com/docs/api-services/reference/supported-software

de memoria

1 GB

Disco duro

10 GB

Interfaz de red

Se requiere una conexión a Internet activa.

Como parte del proceso de instalación, el instalador descarga recursos de la Web. Si tu entorno está configurado para enviar solicitudes HTTP y HTTPS salientes por proxy, el proxy debe estar configurado a fin de controlar de forma correcta las solicitudes redireccionadas que puedan ocurrir durante una descarga.

Por ejemplo, una solicitud a https://drupal.org/ muestra un código de estado HTTP 301 y redirecciona a https://www.drupal.org/.

Tu proxy debe estar configurado para mostrar un código de estado HTTP 200 con el contenido solicitado del redireccionamiento.

Para las instalaciones de SAP, si tu entorno está configurado para usar un proxy en las solicitudes HTTPS salientes, el proxy debe ser compatible con TLSv1.0. OpenSSL 0.9.8 no es compatible con TLSv1.1 ni TLSv1.2, solo TLSv1.0.

Requisitos de la base de datos de MySQL

Si eliges instalar MySQL Server en la misma máquina que los servicios de canal para desarrolladores (la topología de una sola máquina), el instalador de servicios de canal para desarrolladores te solicitará que ingreses el nombre y el usuario de la base de datos y, luego, instalará MySQL Server y creará el esquema de la base de datos por ti. La versión instalada es la más reciente disponible para tu SO.

Si deseas instalar MySQL Server en un sistema separado, debes haber instalado MySQL Server en ese sistema antes de iniciar el instalador de los servicios de canal para desarrolladores. Debes tener instalado MySQL 5.0.15 o una versión posterior.

El instalador de servicios de canal para desarrolladores requiere que MySQL Server contenga una base de datos con un esquema de base de datos vacío. El instalador de servicios de canal para desarrolladores te solicita el nombre de host y el nombre de la base de datos, y el usuario de la base de datos. Luego, el instalador se conecta a la base de datos para crear las tablas y los datos predeterminados de la base de datos.

Los servicios de canal para desarrolladores usan el usuario de la base de datos para conectarse a la base de datos, este debe tener los siguientes privilegios: SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, CREATE TEMPORARY TABLES, Lock TABLES.

Por ejemplo, para crear una base de datos llamada devportal y un usuario llamado devportal, haz lo siguiente:

  1. Instalar MySQL Server en el sistema
  2. Accede a MySQL como usuario raíz con el siguiente comando:
    > mysql -u root -p
  3. Cuando se te solicite, ingresa la contraseña raíz.
  4. Cuando aparezca el símbolo del sistema mysql>, ingresa lo siguiente para crear el usuario del portal devportal:
    mysql>create user 'devportal'@'localhost' identificado por 'devportal';
    mysql> otorga todos los privilegios de *.* a 'devportal'@'localhost';
    mysql> requisito vaci;
    mysql> quit
  5. En el mensaje del sistema, crea la base de datos devportal:
    > mysqladmin -u devportal -p create devportal

    Ingresa la contraseña del devportal.
  6. Accede a MySQL y otorga acceso a devportal desde la IP del servidor del portal:
    mysql> GRANT ALL ON devportal.* TO devportal@'portalIP' IDENTIFIED BY “devportalPW”;

    en el que portalIP es la dirección IP del servidor del portal y devportalPW es la contraseña del usuario del devportal.
  7. Edita /etc/my.cnf para establecer la dirección de enlace en la dirección IP del servidor MySQL.
  8. Reinicia MySQL:
    > /etc/init.d/mysqld restart
  9. Asegúrate de que el puerto 3306 esté abierto en el servidor MySQL. Este procedimiento se basa en tu sistema operativo. Por ejemplo, para Linux, usa el comando:
    > /sbin/iptables -A INPUT -i eth0 -p tcp --destination-port 3306 -j ACEPTAR

Cuando instales los servicios de canal para desarrolladores, especifica que no se instale MySQL Server de forma local. Luego, se te pedirá que ingreses la dirección IP, el nombre de usuario y el nombre de la base de datos de la base de datos remota.

Requisitos de Red Hat Enterprise Linux (RHEL)

RHEL tiene requisitos adicionales debido a que se necesita una suscripción para acceder a las descargas de software desde Red Hat. El servidor debe poder conectarse a Internet para descargar RPM mediante yum. Si usas RHEL, el servidor debe estar registrado en Red Hat Network (RHN) y registrado en el canal opcional del servidor.

Los requisitos de Red Hat se verifican durante la instalación y el instalador del portal te pregunta si RHEL aún no está registrado. Si ya tienes credenciales de acceso de Red Hat, puedes usar el siguiente comando para registrar RHEL antes de comenzar el proceso de instalación:

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

Reemplaza my_username y my_password por tus credenciales de Red Hat.

Si tienes una versión de prueba de RHEL, puedes obtener una licencia de prueba de 30 días. Para obtener más información, visita https://access.redhat.com/solutions/32790.

Requisitos de SMTP

De forma predeterminada, el portal envía correos electrónicos mediante la función mail() de PHP. PHP intenta enviar correos electrónicos con sendmail en el sistema local, que se puede configurar en el archivo php.ini de PHP.

En un entorno de producción, Apigee requiere que configures un servidor SMTP para enviar mensajes de correo electrónico desde el portal. Por lo tanto, debes asegurarte de que Drupal pueda acceder al puerto necesario en el servidor SMTP. En el caso de un SMTP sin TLS, el número de puerto suele ser 25. En el caso de SMTP con TLS habilitada, el error suele ser 465, pero consulta con tu proveedor de SMTP.

Requisitos adicionales

Para realizar la instalación, el usuario que instala el software debe tener acceso raíz.

Requisitos de la arquitectura de implementación

Developer Channel Services tiene una sola interfaz con Apigee Management Server mediante una API de REST para almacenar y recuperar información sobre las aplicaciones de un usuario. Los servicios de canal para desarrolladores deberán poder conectarse al servidor de administración a través de HTTP o HTTPS, según tu instalación.

Información necesaria antes de comenzar la instalación

Antes de comenzar la instalación, debes tener la siguiente información disponible:

  1. ¿Qué plataforma estás configurando: Red Hat o CentOS? Si se trata de una instalación de Red Hat, la máquina debe estar registrada en Red Hat Network para descargar RPM.
  2. ¿Planeas instalar MySQL en la máquina local? Algunas instalaciones de alta disponibilidad requieren que MySQL esté en una máquina diferente a la que entrega las páginas web del portal. Si este es el caso, no instales MySQL de forma local. Si deseas una instalación simple con todo en la misma máquina, instala MySQL de forma local.
  3. Si deseas acceder a un servidor MySQL remoto, el nombre de host, el puerto, el nombre de la base de datos, el nombre de usuario y la contraseña del servidor MySQL remoto. El servidor MySQL remoto ya debe estar configurado antes de comenzar la instalación.
  4. ¿Cuál es el nombre de dominio completamente calificado del servidor web? (Esta información se agregará a /etc/hosts). Debe ser una dirección IP o un nombre de host, como portalserver.example.com. El valor predeterminado es localhost.
  5. ¿Quieres usar la configuración predeterminada de Apigee para el host virtual de Apache? Se crea un host virtual con el nombre de host que especificaste anteriormente en el paso 7.
  6. Existen tres datos que permiten que tu portal se comunique con el servidor de administración de Apigee Edge. Esta información es la siguiente:
    1. URL del extremo de la API de Apigee Management: Será un nombre de host o una dirección IP. Este es el extremo de REST al que se realizan todas las llamadas para crear apps y registrar desarrolladores para las claves de apps. El extremo predeterminado es https://api.enterprise.apigee.com/v1.

      Para una instalación de Edge para la nube privada, la URL tiene el siguiente formato:
      http://EdgeIp:8080/v1

      o:
      https://EdgeIp:SSLport/v1

      Donde EdgeIp es la dirección IP del servidor de administración de Edge y EdgeIp Por ejemplo, 8443.
    2. Nombre de la organización de Apigee: Existe una relación entre los portales y las organizaciones de Apigee Edge. Configurarás la organización predeterminada cuando configures el extremo de la API de Management. El valor predeterminado es my-org.
    3. Nombre de usuario y contraseña para el extremo de la API de Management: Un administrador de tu organización debe realizar las llamadas del portal a Edge.

      Este nombre de usuario y contraseña son para un administrador de tu organización y se deben usar solo para conectarse a Edge desde el portal. Por ejemplo, si especificas las credenciales de un usuario, y ese usuario se borra en Edge, el portal ya no podrá conectarse a Edge. Por lo tanto, crea un administrador en tu organización solo para esta conexión.

      Por ejemplo:
      dc_devportal+ORGNAME@apigee.com:MyP@ssw0rd