Portal de servicios para desarrolladores v. 4.16.09
A continuación, se describen 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 indican aquí: https://apigee.com/docs/api-services/reference/supported-software |
RAM |
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 usar un proxy para las solicitudes HTTP y HTTPS salientes, el proxy debe estar configurado para controlar correctamente 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. En el caso de las instalaciones de SAP, si tu entorno está configurado para usar un proxy de solicitudes HTTPS salientes, el proxy debe admitir TLSv1.0. OpenSSL 0.9.8 no admite TLSv1.1 ni TLSv1.2, solo TLSv1.0. |
Requisitos de la base de datos de MySQL
Si eliges instalar el servidor MySQL en la misma máquina que los servicios de canal del desarrollador, la topología de una sola máquina, el instalador de servicios de canal para desarrolladores te solicita que ingreses el nombre y el usuario de la base de datos y, luego, instala MySQL Server y crea el esquema de la base de datos por ti. La versión instalada es la más reciente disponible para tu SO.
Si quieres que el servidor MySQL se instale en un sistema independiente, debes haber instalado el servidor MySQL en ese sistema antes de iniciar el instalador de los servicios del Canal para desarrolladores. Debes haber instalado MySQL 5.0.15 o una versión posterior.
El instalador de los servicios de canales para desarrolladores requiere que el servidor MySQL 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 del Canal para desarrolladores usan el usuario de la base de datos para conectarse a ella y deben 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:
- Instala el servidor MySQL en el sistema.
- Accede a MySQL como usuario raíz con el comando:
> mysql -u root -p - Ingresa la contraseña raíz cuando se te solicite.
- En el mensaje mysql>, ingresa lo siguiente para crear el usuario devportal:
mysql>create user 'devportal'@'localhost' identified by 'devportal';
mysql> grant all privileges on *.* to 'devportal'@'localhost';
mysql> flush privileges;
mysql> quit - En el símbolo del sistema, crea la base de datos devportal:
> mysqladmin -u devportal -p create devportal
Ingresa la contraseña del devportal. - 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';
donde portalIP es la dirección IP del servidor del portal y devportalPW es la contraseña del usuario devportal. - Edita /etc/my.cnf para establecer bind-address en la dirección IP del servidor MySQL.
- Reinicia MySQL:
> /etc/init.d/mysqld restart - Asegúrate de que el puerto 3306 esté abierto en el servidor de 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 ACCEPT
Cuando instales los servicios del Canal para desarrolladores, especifica que no se instale el servidor MySQL 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 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 de Red Hat. El servidor debe poder conectarse a Internet para descargar RPM a través de 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 solicita que lo hagas 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, consulta https://access.redhat.com/solutions/32790.
Requisitos de SMTP
De forma predeterminada, el portal envía correos electrónicos con 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 por correo electrónico desde el portal. Por lo tanto, debes asegurarte de que Drupal pueda acceder al puerto necesario en el servidor SMTP. Para el SMTP sin TLS, el número de puerto suele ser 25. Para el SMTP habilitado para TLS, 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 a la raíz.
Requisitos de la arquitectura de implementación
Los servicios de canal para desarrolladores tienen una sola interfaz con el servidor de administración de Apigee a través de una API de REST para almacenar y recuperar información sobre las aplicaciones de un usuario. Los servicios del 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 disponible la siguiente información:
- ¿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.
- ¿Planeas instalar MySQL en la máquina local? Algunas instalaciones de HA 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 sencilla con todo en la misma máquina, instala MySQL de forma local.
- 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 debería estar configurado antes de comenzar la instalación.
- ¿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.
- ¿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 en el paso 7.
- Hay tres datos de información que permiten que tu portal se comunique con el servidor de administración de Apigee Edge. Esta información es la siguiente:
- URL del extremo de la API de Apigee Management: Será un nombre de host o una dirección IP. Este es el extremo REST al que se realizan todas las llamadas para crear apps y registrar desarrolladores para 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 SSLport es el puerto SSL de la API de administración de Edge. Por ejemplo, 8443. - 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 mi-org.
- Nombre de usuario y contraseña para el extremo de la API de administración: Un administrador de tu organización debe realizar las llamadas desde
el portal a Edge.
Este nombre de usuario y contraseña son para un administrador de tu organización y solo deben usarse 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
- URL del extremo de la API de Apigee Management: Será un nombre de host o una dirección IP. Este es el extremo REST al que se realizan todas las llamadas para crear apps y registrar desarrolladores para claves de apps. El extremo predeterminado es https://api.enterprise.apigee.com/v1.