Instalación del portal de servicios para desarrolladores

Portal de Servicios para desarrolladores v. 4.16.09

Antes de instalar la etiqueta, asegúrate de lo siguiente:

  • Estás realizando la instalación en la versión de 64 bits de una versión compatible de Red Hat Enterprise Linux, Oracle o CentOS. Consulta la lista de versiones compatibles aquí.
  • Yum está instalado.
  • Creas copias de seguridad de las instalaciones existentes. Si modificaste algún código en el núcleo de Drupal o en los módulos no personalizados, tus modificaciones se reemplazarán. Esto incluye, entre otras cosas, cualquier cambio que hayas realizado en .htaccess. Debes suponer que todo lo que está fuera del directorio /sites pertenece a Drupal. Una excepción a esta regla es robots.txt. Si este archivo existe en la raíz web, se conservará para ti. Antes de continuar con la instalación, crea una copia de seguridad de todo el directorio raíz web de Drupal. La ubicación de instalación predeterminada es /var/www/html, pero es posible que la hayas cambiado en el momento de la instalación. Después de realizar los pasos de instalación que se describen a continuación, puedes restablecer las personalizaciones desde la copia de seguridad.

Sigue estos pasos para instalar el portal de servicios de canal para desarrolladores.

1. Obtén el paquete de servicios de canal para desarrolladores

Ve a http://community.apigee.com/content/apigee-customer-support y selecciona Acceder a tu Portal de asistencia para solicitar el archivo .tar de los servicios de canal para desarrolladores de una de estas dos maneras:

  • Solicita acceso al directorio de descarga de Edge para nube privada.
  • Solicita una URL para el archivo .tar de los servicios de canal para desarrolladores.

2. Prueba tu conexión a Apigee Edge

Prueba la conexión con el servidor de administración de Edge mediante la ejecución del siguiente comando cURL desde un símbolo del sistema en el servidor del portal:
> curl -u {EMAIL}:{PASSWORD} https://{hostname}:8080/v1/organizations/{ORGNAME}

donde EMAIL. y EMAILNAME son la dirección de correo electrónico del administrador

Asegúrate de especificar el nombre de host y el número de puerto específicos de tu instalación de Edge. El puerto 8080 es el predeterminado que usa Edge. “En la r














3. Quita las versiones de PHP anteriores a la 7.0

La secuencia de comandos de instalación comprueba si hay versiones anteriores a 7.0 de PHP en el sistema antes de comenzar la instalación. Si existen versiones de PHP anteriores a la 7.0, se mostrará el siguiente mensaje de advertencia:

The following packages present on your system conflict with software we are
about to install. You will need to manually remove each one, then re-run this install script.
php
php-cli
php-common
php-gd
php-mbstring
php-mysql
php-pdo
php-pear
php-pecl-apc
php-process
php-xml

Para CentOS y Red Hat Enterprise Linux (RHEL), quita los paquetes PHP mediante el siguiente comando:

yum remove <package-name>

4. Instala los servicios de canal para desarrolladores con la secuencia de comandos de instalación automática

Usa uno de los siguientes procedimientos para instalar el portal en función de si realizas la instalación en un servidor con o sin conexión a Internet.

En un servidor con conexión a Internet:

Para instalar servicios de canal para desarrolladores en un servidor con conexión a Internet, haz lo siguiente:

  1. Accede al servidor como raíz o superusuario.
  2. Crea un directorio para los archivos de instalación, como el portal.
  3. CD al nuevo directorio del portal y descarga el archivo DeveloperServices_x.y.z.tar de los servicios de canal de desarrollador, en el que x.y.z corresponde al número de versión del portal.

    Puedes descargar un archivo desde el vínculo que te envió Apigee en un navegador o copiarlo y agregarlo al siguiente comando cURL:
    > curl -kOL <paste link here>
  4. Extrae el contenido del archivo .tar de los servicios de canal para desarrolladores mediante el comando:
    > tar -xvf <tar file>
  5. de CD a DeveloperServices-4.x.y.z.
  6. Ejecuta la secuencia de comandos de instalación con el siguiente comando:
    > ./networked-install.sh
  7. Responde los mensajes.

En un servidor sin conexión a Internet:

Primero, crea una secuencia de comandos de instalación que no esté conectada a la red en un sistema que tenga conexión a Internet:

  1. Accede a un sistema con conexión a Internet como raíz o como superusuario.
  2. Crea un directorio para los archivos de instalación, como portal_tar.
  3. CD al directorio portal_tar y descarga el archivo DeveloperServices_x.y.z.tar de los servicios de canal para desarrolladores, en el que x.y.z corresponde al número de versión del portal.
  4. Extrae el contenido del archivo .tar de los servicios de canal para desarrolladores con el comando:
    > tar -xvf <tar file>
  5. de CD a DeveloperServices-4.x.y.z.
  6. Crea el archivo .tar.gz del portal con el siguiente comando:
    > ./non-networked-install.sh

Se crea un archivo .tar.gz nuevo para la instalación no conectada a la red.

Para instalar servicios de canal para desarrolladores en un servidor sin conexión a Internet, haz lo siguiente:

      1. Accede al servidor como raíz o superusuario.
      2. Crea un directorio para los archivos de instalación, como el portal.
      3. CD al directorio del portal.
      4. Copia el archivo .tar.gz que creaste para la instalación sin conexión en red (en el procedimiento anterior) en el directorio del portal.
      5. Extrae el contenido del archivo .tar.gz con el siguiente comando:
        > tar -xvf <tar file>
      6. CD al directorio que creó el comando "tar".
      7. Configura los permisos en la secuencia de comandos install-from-rpm-bundle.sh:
        > chmod 755 install-from-rpm-bundle.sh
      8. Ejecuta la secuencia de comandos install-from-rpm-bundle.sh con el siguiente comando:
        > ./install-from-rpm-bundle.sh
      9. Responde los mensajes.

      5. Configura tu portal para desarrolladores

      Gran parte de la configuración del portal se realiza sin requerir interacción de tu parte, como la instalación del módulo de Drupal y la creación de contenido predeterminado. Se te solicitará que configures la base de datos, el extremo de Edge y un usuario administrador nuevo.

      Si deseas configurar tu portal para desarrolladores, haz lo siguiente:

      1. Navega a la URL del servidor en un navegador, por ejemplo:
        http://localhost. O bien, si tienes una IP o un DNS específicos configurados, ve a http://IP_address o http://DNS_name.

        Se te redireccionará a la página de configuración de la base de datos del perfil de Apigee.

        Nota: Por lo general, ya habrás configurado un nombre de host y lo registraste en tu servidor DNS para que no tengas que usar http://localhost.
      2. Configurar la conexión a la base de datos Si la base de datos se encuentra en una máquina remota, expande la sección Opciones avanzadas, ingresa la información de conexión a esa máquina y, luego, selecciona Guardar y continuar.
      3. Configura la conexión con el extremo de Apigee. Para ello, ingresa la siguiente información y, luego, selecciona Guardar.
        Para obtener más información sobre estos valores, consulta "Información necesaria antes de comenzar la instalación" en Requisitos del portal de Servicios para desarrolladores.
        1. Organización de la API de Management
        2. URL del extremo de la API de Management
        3. Usuario autenticado del extremo
        4. Contraseña de los usuarios autenticados
      4. Para configurar el usuario administrador, ingresa la siguiente información y, luego, selecciona Guardar. Ten en cuenta que Drupal crea un usuario administrador llamado “admin” de forma predeterminada, por lo que no debes usar “admin” como nombre de usuario.
        Si omites este paso, igualmente puedes usar Drush para crear un administrador, como se describe a continuación en 4. Crea un usuario administrador.
        1. Nombre y apellido del desarrollador
        2. Nombre de usuario del portal del desarrollador
        3. Contraseña
        4. Dirección de correo electrónico
      5. Una vez finalizada la instalación, configura los permisos en el archivo settings.php:
        > chmod 640 /var/www/html/sites/default/settings.php
      6. Navega a la página principal del portal en http://localhost/ o al nombre de DNS de tu portal.
      7. Accede al portal con las credenciales de administrador.

      6. Crea un usuario administrador (opcional)

      Usa Drush para crear un usuario administrador para la instalación de los servicios de canal para desarrolladores. Drupal crea automáticamente un usuario administrador llamado “admin” de forma predeterminada, por lo que no debes usar “admin” como nombre de usuario.

      1. CD a tu directorio drupal_root/sites/default. La ubicación estándar del directorio raíz de Drupal es /var/www/html:
        > cd <drupal_root>/sites/default
      2. Asegúrate de tener permisos de escritura en los archivos privados de Drupal:
        > drush vget file_private_path

        Este comando muestra la ruta de acceso a los archivos privados de Drupal, por ejemplo:
        file_private_path: 'sites/default/private'

        Corresponde a /var/www/html/sites/default/private/. Usa el siguiente comando para asegurarte de que el propietario y el grupo puedan escribir en este directorio:
        chmod -R g+w dirPathAndName
        chmod -R o+r dirPathAndName
      3. Ingresa los siguientes comandos para crear un usuario administrador y reemplaza los comandos de “< >” por tus valores:
        > drush user-create <username> --mail="<email-address>" --password="<password>"
        > drush user-add-role Administrator <username>
      4. Accede al portal para desarrolladores como administrador con el nombre de usuario y la contraseña especificados anteriormente.

      5. Establece la contraseña raíz de MySQL

      Si instalaste MySQL como parte de la instalación del portal, la secuencia de comandos de instalación deja la contraseña raíz de MySQL establecida en su valor predeterminado, que está en blanco.

      Usa el siguiente comando para configurar la contraseña raíz:

      > mysqladmin -u root password NEWPASSWORD
      

      Si ya configuraste la contraseña raíz y deseas cambiarla, usa el siguiente comando:

      > mysqladmin -u root -p'OLDPASSWORD' password NEWPASSWORD
      

      También debes actualizar la contraseña en el archivo /var/www/html/sites/default/settings.php.

      6. Asegúrate de que el módulo del Administrador de actualizaciones esté habilitado.

      Para recibir notificaciones de las actualizaciones de Drupal, asegúrate de que el módulo del administrador de actualizaciones de Drupal esté habilitado. En el menú de Drupal, selecciona Modules y desplázate hacia abajo hasta el módulo Update Manager. Si no está habilitada, habilítala.

      Una vez habilitada, puedes ver las actualizaciones disponibles en el elemento de menú Informes > Actualizaciones disponibles. También puedes usar el siguiente comando Drush:

      > drush pm-info update
      

      Usa el elemento de menú Informes > Actualizaciones disponibles > Configuración para configurar el módulo a fin de que te envíe un correo electrónico cuando haya actualizaciones disponibles y para establecer la frecuencia de búsqueda de actualizaciones.

      7. Implementa en un servidor de producción (opcional)

      Si implementas el portal en un servidor de producción, debes realizar los siguientes pasos de seguridad adicionales:

      1. Ejecuta la siguiente secuencia de comandos para proteger la instalación de MySQL:
        > /usr/bin/mysql_secure_installation

        Esta secuencia de comandos establece la contraseña raíz y te brinda la opción de restringir el acceso raíz solo al localhost y quitar las bases de datos de prueba y los usuarios anónimos creados de forma predeterminada. Recomendamos enfáticamente ejecutar esta secuencia de comandos para los servidores de producción.
      2. Si tus políticas corporativas lo requieren, habilita y configura SELinux.

      8. Configura el motor de búsqueda de Apache Solr (opcional)

      De forma predeterminada, los módulos de Drupal que se conectan al motor de búsqueda de Apache Solr se inhabilitan cuando instalas el portal. La mayoría de los portales usan el motor de búsqueda interno de Drupal y, por lo tanto, no requieren los módulos de Solr de Drupal.

      Si decides usar Solr como motor de búsqueda, debes instalarlo de forma local en tu servidor y, luego, habilitar y configurar los módulos de Solr de Drupal en el portal.

      Para habilitar los módulos de Solr de Drupal, haz lo siguiente:

      1. Accede a tu portal como un usuario con privilegios de administrador o de creación de contenido.
      2. Selecciona Modules en el menú de Drupal.
      3. Habilita el módulo del framework de Apache Solr y el módulo de búsqueda de Apache Solr.
      4. Guarda los cambios.
      5. Configura Solr como se describe en https://drupal.org/node/1999280.

      9. Instala mod_ssl para admitir HTTPS (opcional)

      El servidor HTTP Apache usa el módulo mod_ssl para entregar páginas web a través de HTTPS. Si quieres usar HTTPS, usa el siguiente comando para instalar mod_ssl:

      > yum install mod_ssl
      

      Si deseas obtener más información sobre cómo configurar el portal para usar SSL, consulta http://apigee.com/docs/developer-services/content/using-ssl-portal.

      10. Instalar SmartDocs (opcional)

      SmartDocs te permite documentar tus API en el portal de servicios para desarrolladores de manera que la documentación de la API sea completamente interactiva. Sin embargo, para usar SmartDocs con el portal, primero debes instalar SmartDocs en Edge.

      • Si quieres conectar el portal a una instalación de Edge Cloud, SmartDocs ya está instalado y no es necesario configurar nada más.
      • Si quieres conectar el portal a una instalación de Edge para la nube privada, debes asegurarte de que SmartDocs esté instalado en Edge. Si quieres obtener más información para instalar Edge y SmartDocs, consulta Cómo instalar SmartDocs.

      Si deseas obtener más información sobre SmartDocs, consulta Cómo usar SmartDocs para documentar las API.

      11. ¿Qué debes hacer a continuación?

      Los siguientes pasos después de instalar el portal de Developer Services son configurarlo y personalizarlo según tus requisitos específicos. La documentación del sitio web de Apigee contiene toda la información sobre la configuración, el diseño y la administración de un portal. Acceda a la documentación en http://apigee.com/docs/developer-services/content/what-developer-portal.

      En la siguiente tabla, se enumeran algunas de las tareas más comunes que realizas después de la instalación y, además, se incluyen vínculos a la documentación de Apigee en la que puedes encontrar más información:

      Tarea

      Descripción

      Cómo personalizar el tema

      El tema define la apariencia del portal, incluidos los colores, el estilo y otros aspectos visuales.

      Cómo personalizar el aspecto

      La página principal incluye el menú principal, el mensaje de bienvenida, el encabezado, el pie de página y el título.

      Cómo agregar y administrar cuentas de usuario

      El proceso de registro controla cómo los desarrolladores nuevos registran una cuenta en el portal. Por ejemplo, ¿los desarrolladores nuevos obtienen acceso inmediato al portal o deben contar con la verificación de un administrador? Este proceso también controla cómo se notifica a un administrador del portal cuando se crea una cuenta nueva.

      Configura el correo electrónico

      El portal envía correos electrónicos en respuesta a ciertos eventos. Por ejemplo, cuando un desarrollador nuevo se registra en el portal y cuando pierde su contraseña.

      Cómo agregar y administrar cuentas de usuario

      Agrega una página de Términos y Condiciones que los desarrolladores deban aceptar para poder acceder al portal.

      Cómo agregar y administrar cuentas de usuario

      El portal implementa un modelo de autorización basado en funciones. Antes de permitir que los desarrolladores se registren, define los permisos y roles que usa el portal.

      Cómo agregar entradas de blog y foros

      El portal tiene soporte integrado para blogs y foros de múltiples conversaciones. Define los permisos necesarios para ver, agregar, editar y borrar entradas de blog y foros.

      Asegúrate de realizar copias de seguridad de bases de datos

      Asegúrate de crear una copia de seguridad de la base de datos de Drupal. Ten en cuenta que, debido a que cada instalación es diferente, depende de ti determinar la mejor manera de crear una copia de seguridad de la base de datos.

      Configura un nombre de host

      Si no configuras un nombre de host en tu servidor DNS, siempre podrás acceder al sitio a través de la dirección IP del servidor. Si deseas usar un nombre de host, puedes configurar el DNS del servidor, que debería funcionar correctamente sin ninguna otra configuración en una configuración básica.

      Si configuras un balanceador de cargas o recibes URL incorrectas en tu sitio por algún otro motivo, puedes configurar $base_url en el archivo settings.php del portal para desarrolladores, que se encuentra de forma predeterminada en el directorio /var/www/html/sites/default.