Instalación de MobileFirst Server en un servidor de aplicaciones

improve this page | report issue

Visión general

La instalación de los componentes se puede realizar utilizando Tareas Ant, la Herramienta de configuración del servidor, o manualmente. Descubra el requisito previo y los detalles sobre el proceso de instalación para que pueda instalar los componentes en el servidor de aplicaciones satisfactoriamente.

Antes de continuar con la instalación de los componentes en el servidor de aplicaciones, asegúrese de que las bases de datos y las tablas de los componentes estén preparados y listos para su uso. Para obtener más información, consulte Configuración de bases de datos.

También se debe definir la topología del servidor para instalar los componentes. Consulte Flujos de red y topologías.

Ir a

Requisitos previos del servidor de aplicaciones

En función de su elección del servidor de aplicaciones, seleccione uno de los siguientes temas para averiguar los requisitos previos que debe cumplir antes de instalar los componentes de MobileFirst Server.

Requisitos previos de Apache Tomcat

MobileFirst Server tiene algunos requisitos para la configuración de Apache Tomcat que están detallados en los temas siguientes.
Asegúrese de que cumple los criterios siguientes:

  • Utilice una versión soportada de Apache Tomcat. Consulte Requisitos del sistema.
  • Apache Tomcat se debe ejecutar con JRE 7.0 o posterior.
  • La configuración de JMX debe estar habilitada para permitir la comunicación entre el servicio de administración y el componente de tiempo de ejecución. La comunicación utiliza RMI como se describe en Configuración de la conexión de JMX para Apache Tomcat a continuación.

Debe configurar una conexión JMX segura para el servidor de aplicaciones de Apache Tomcat.

La Herramienta de configuración del servidor y las tareas Ant pueden configurar una conexión JMX segura predeterminada, que incluya la definición de un puerto remoto JMX, y la definición de propiedades de autenticación. Modifican tomcat_install_dir/bin/setenv.bat y tomcat_install_dir/bin/setenv.sh para añadir estas opciones a CATALINA_OPTS:

-Djava.rmi.server.hostname=localhost
-Dcom.sun.management.jmxremote.port=8686
-Dcom.sun.management.jmxremote.authenticate=false
-Dcom.sun.management.jmxremote.ssl=false

Nota: 8686 es un valor predeterminado. El valor para este puerto puede cambiarse si el puerto no está disponible en el sistema.

  • El archivo setenv.bat se utiliza si inicia Apache Tomcat con tomcat_install_dir/bin/startup.bat, o tomcat_install_dir/bin/catalina.bat.
  • El archivo setenv.sh se utiliza si inicia Apache Tomcat con tomcatInstallDir/bin/startup.sh, o tomcat_install_dir/bin/catalina.sh.

Este archivo podría no utilizarse si inicia Apache Tomcat con otro mandato. Si ha instalado Apache Tomcat Windows Service Installer, el lanzador del servicio no utiliza setenv.bat.

Importante: Esta configuración no es segura de forma predeterminada. Para proteger la configuración, debe completar manualmente los pasos 2 y 3 del procedimiento siguiente.

Configuración manual de Apache Tomcat:

  1. Para una configuración simple, añada las opciones siguientes a CATALINA_OPTS:
    -Djava.rmi.server.hostname=localhost
    -Dcom.sun.management.jmxremote.port=8686
    -Dcom.sun.management.jmxremote.authenticate=false
    -Dcom.sun.management.jmxremote.ssl=false
  2. Para activar la autenticación, consulte la documentación de usuario de Apache Tomcat SSL Support - BIO and NIO y SSL Configuration HOW-TO.
  3. For a JMX configuration with SSL enabled, add the following options:
    -Dcom.sun.management.jmxremote=true
    -Dcom.sun.management.jmxremote.port=8686
    -Dcom.sun.management.jmxremote.ssl=true
    -Dcom.sun.management.jmxremote.authenticate=false
    -Djava.rmi.server.hostname=localhost  
    -Djavax.net.ssl.trustStore=<key store location>
    -Djavax.net.ssl.trustStorePassword=<key store password>
    -Djavax.net.ssl.trustStoreType=<key store type>
    -Djavax.net.ssl.keyStore=<key store location>
    -Djavax.net.ssl.keyStorePassword=<key store password>
    -Djavax.net.ssl.keyStoreType=<key store type>
    Nota: El puerto 8686 se puede modificar.
  4. Si la instancia de Tomcat se está ejecutando detrás de un cortafuegos, se debe configurar el JMX Remote Lifecycle Listener. Consulte la documentación de Apache Tomcat para JMX Remote Lifecycle Listener.

    También se deben añadir las siguientes propiedades del entorno a la sección Contexto de la aplicación del servicio de administración en el archivo server.xml, como por ejemplo en el ejemplo siguiente:

    <Context docBase="mfpadmin" path="/mfpadmin ">
        <Environment name="mfp.admin.rmi.registryPort" value="registryPort" type="java.lang.String" override="false"/>
        <Environment name="mfp.admin.rmi.serverPort" value="serverPort" type="java.lang.String" override="false"/>
    </Context>
    En el ejemplo anterior:
    • registryPort debe tener el mismo valor que el atributo rmiRegistryPortPlatform del JMX Remote Lifecycle Listener.
    • serverPort debe tener el mismo valor que el atributo rmiServerPortPlatform del JMX Remote Lifecycle Listener.
  5. Si ha instalado Apache Tomcat con el Apache Tomcat Windows Service Installer en lugar de añadir las opciones a CATALINA_OPTS, ejecute tomcat_install_dir/bin/Tomcat7w.exe, y añada las opciones del separador Java de la ventana Propiedades. Propiedades de Apache Tomcat 7

Requisitos previos de WebSphere Application Server Liberty

IBM Mobile Foundationtiene algunos requisitos para la configuración del servidor de Liberty que están detallados en los temas siguientes.

Asegúrese de que cumple los criterios siguientes:

  • Utilice una versión soportada de Liberty. Consulte Requisitos del sistema.
  • Liberty se debe ejecutar con JRE 7.0 o posterior. JRE 6.0 no está soportado.
  • Algunas versiones de Liberty dan soporte a las características de Java EE 6 y Java EE 7. Por ejemplo, la característica de Liberty jdbc-4.0 forma parte de Java EE 6, mientras que la característica de Liberty jdbc-4.1 forma parte de Java EE 7. MobileFirst Server V8.0.0 se puede instalar con las características Java EE 6 o Java EE 7. Sin embargo, si desea ejecutar una versión anterior de MobileFirst Server en el mismo servidor de Liberty, debe utilizar las características de Java EE 6. MobileFirst Server V7.1.0 y anteriores, no da soporte a las características de Java EE 7.
  • JMX debe estar configurado tal como se describe en Configuración de la conexión JMX para el perfil de Liberty de WebSphere Application Server a continuación.
  • Para una instalación en un entorno de producción, es posible que desee iniciar el servidor de Liberty como un servicio en sistemas Windows, Linux o UNIX, por lo que: Los componentes de MobileFirst Server se inician automáticamente cuando se inicia el sistema. El proceso que ejecuta el servidor de Liberty no se detiene cuando el usuario, que ha iniciado el proceso, cierra sesión.
  • MobileFirst Server V8.0.0 no se puede desplegar en un servidor Liberty que contiene los componentes desplegados de MobileFirst Server de las versiones anteriores.
  • Para una instalación en un entorno colectivo de Liberty, el controlador colectivo de Liberty y los miembros del clúster colectivo de Liberty deben configurarse como se documenta en Configuración de un colectivo de Liberty.

MobileFirst Server requiere que se configure la conexión JMX segura.

  • La Herramienta de configuración del servidor y las tareas Ant pueden configurar una conexión JMX segura predeterminada, que incluye la generación de un certificado SSL firmado automáticamente con un periodo de validez de 365 días. Esta configuración no está pensada para el uso de producción.
  • Para configurar la conexión JMX segura para el uso de producción, siga las instrucciones tal como se describen en Configuración de la conexión JMX segura en el perfil de Liberty.
  • Rest-connector está disponible para WebSphere Application Server, Liberty Core, y otras ediciones de Liberty, pero se puede empaquetar un servidor de Liberty con un subconjunto de las características disponibles. Para verificar que la característica rest-connector esté disponible en la instalación de Liberty, escriba el siguiente mandato:
                        
    liberty_install_dir/bin/productInfo featureInfo
    Nota: Verifique que la salida de este mandato contenga restConnector-1.0.

Requisitos previos de WebSphere Application Server y WebSphere Application Server Network Deployment

MobileFirst Server tiene algunos requisitos para la configuración de WebSphere Application Server y WebSphere Application Server Network Deployment detallados en los temas siguientes.
Asegúrese de que cumple los criterios siguientes:

  • Utilice una versión soportada de WebSphere Application Server. Consulte Requisitos del sistema.
  • El servidor de aplicaciones debe ejecutarse con JRE 7.0. De forma predeterminada, WebSphere Application Server utiliza Java 6.0 SDK. Para conmutar a Java 7.0 SDK, consulte Conmutación a Java 7.0 SDK en WebSphere Application Server.
  • La seguridad administrativa debe estar activa. MobileFirst Operations Console, el servicio de administración de MobileFirst Server y el servicio de configuración de MobileFirst Server están protegidos por roles de seguridad. Para obtener más información, consulte Habilitación de seguridad.
  • La configuración de JMX debe estar habilitada para permitir la comunicación entre el servicio de administración y el componente de tiempo de ejecución. La comunicación utiliza SOAP. Para WebSphere Application Server Network Deployment, se puede utilizar RMI. Para obtener más información, consulte Configuración de la conexión JMX para WebSphere Application Server y WebSphere Application Server Network Deployment a continuación.

MobileFirst Server requiere que se configure la conexión JMX segura.

  • MobileFirst Server requiere acceso al puerto SOAP, o el puerto RMI para realizar operaciones JMX. De forma predeterminada, el puerto SOAP está activo en un WebSphere Application Server. MobileFirst Server utiliza el puerto SOAP de forma predeterminada. Si los puertos SOAP y RMI están desactivados, MobileFirst Server no se ejecutará.
  • RMI sólo está soportado por WebSphere Application Server Network Deployment. RMI no está soportado por un perfil autónomo, o una granja de servidores de WebSphere Application Server.
  • Debe activar Administrative and Application Security.

Requisitos previos del sistema de archivos

Para instalar MobileFirst Server en un servidor de aplicaciones, las herramientas de instalación de MobileFirst deben ejecutarlas un usuario que tenga privilegios del sistema de archivos específicos.
Entre las herramientas de instalación se incluye:

  • IBM Installation Manager
  • La Herramienta de configuración del servidor
  • Las tareas Ant para desplegar MobileFirst Server

Para el perfil de WebSphere Application Server Liberty, debe tener el permiso necesario para realizar las acciones siguientes:

  • Leer los archivos en el directorio de instalación de Liberty.
  • Crear archivos en el directorio de configuración del servidor de Liberty, que es normalmente usr/servers/server-name, para crear copias de seguridad y modificar server.xml y jvm.options.
  • Crear archivos y directorios en el directorio de recursos compartidos de Liberty, que es normalmente usr/shared.
  • Crear archivos en el directorio de aplicaciones del servidor de Liberty, que es normalmente usr/servers/server-name/apps.

Para el perfil completo de WebSphere Application Server y WebSphere Application Server Network Deployment, debe tener el permiso necesario para realizar las acciones siguientes:

  • Leer los archivos del directorio de instalación de WebSphere Application Server.
  • Leer el archivo de configuración del perfil completo de WebSphere Application Server seleccionado o del perfil de Deployment Manager.
  • Ejecutar el mandato wsadmin.
  • Crear archivos en el directorio de configuración de perfiles. Las herramientas de instalación ponen recursos como, por ejemplo, bibliotecas compartidas o controladores JDBC en dicho directorio.

Para Apache Tomcat, debe tener el permiso necesario para realizar las acciones siguientes:

  • Leer el directorio de configuración.
  • Crear archivos de copia de seguridad y modificar archivos en el directorio de configuración, como por ejemplo server.xml y tomcat-users.xml.
  • Crear archivos de copia de seguridad y modificar archivos en el directorio bin, como por ejemplo setenv.bat.
  • Crear archivos en el directorio lib.
  • Crear archivos en el directorio webapps.

Para todos estos servidores de aplicaciones, el usuario que ejecuta el servidor de aplicaciones debe poder leer los archivos creados por el usuario que ha ejecutado las herramientas de instalación de MobileFirst.

Instalación con la Herramienta de configuración del servidor

Utilice la Herramienta de configuración del servidor para instalar los componentes de MobileFirst Server en su servidor de aplicaciones.

La Herramienta de configuración del servidor puede configurar la base de datos e instalar los componentes en un servidor de aplicaciones. Esta herramienta está pensada para un único usuario. Los archivos de configuración se almacenan en el disco. El directorio donde se almacenan se puede modificar con el menú Archivo → Preferencias. Los archivos sólo debe utilizarlos una instancia de la Herramienta de configuración del servidor a la vez. La herramienta no gestiona el acceso simultáneo al mismo archivo. Si tiene varias instancias de la herramienta que acceden al mismo archivo, es posible que se pierdan los datos. Para obtener más información sobre cómo crea y configura la herramienta las bases de datos, consulte Crear las tablas de base de datos con la Herramienta de configuración del servidor. Si las bases de datos existen, la herramienta puede detectarlas probando la presencia y el contenido de algunas tablas de prueba y no modifica estas tablas de base de datos.

Sistemas operativos soportados

Puede utilizar la Herramienta de configuración del servidor si se encuentra en los siguientes sistemas operativos:

  • Windows x86 o x86-64
  • macOS x86-64
  • Linux x86 o Linux x86-64

La herramienta no está disponible en otros sistemas operativos. Debe utilizar las tareas Ant para instalar los componentes de MobileFirst Server tal como se describe en Instalación con Tareas Ant.

Topologías soportadas

La Herramienta de configuración del servidor instala los componentes de MobileFirst Server con las siguientes topologías:

  • Todos los componentes (MobileFirst Operations Console, el servicio de administración de MobileFirst Server, el servicio de Live Update de MobileFirst Server y el tiempo de ejecución de MobileFirst) se encuentran en el mismo servidor de aplicaciones. Sin embargo, en WebSphere Application Server Network Deployment, cuando instala en un clúster, puede especificar un clúster distinto para los servicios de administración y de Live Update, y para el tiempo de ejecución. En el colectivo de Liberty, MobileFirst Operations Console, el servicio de administración y el servicio de Live Update están instalados en un controlador colectivo y el tiempo de ejecución en un miembro de colectivo.
  • Si el servicio de envío por push de MobileFirst Server está instalado, también estará instalado en el mismo servidor. Sin embargo, en WebSphere Application Server Network Deployment cuando instala en un clúster, puede especificar un clúster distinto para el servicio de envío por push. En el colectivo de Liberty, el servicio de envío por push está instalado en un miembro de Liberty que puede ser el mismo que donde está instalado el tiempo de ejecución.
  • Todos los componentes utilizan el mismo sistema de base de datos y usuario. Para DB2, todos los componentes también utilizan el mismo esquema.
  • La Herramienta de configuración del servidor instala los componentes para un único servidor, excepto para el colectivo de Liberty y WebSphere Application Server Network Deployment para el despliegue simétrico. Para una instalación en varios servidores, debe configurarse una granja una vez que se ejecute la herramienta. La configuración de granja de servidores no es necesaria en WebSphere Application Server Network Deployment.

Para otras topologías o valores de base de datos, puede instalar los componentes con Tareas Ant o manualmente en su lugar.

Ejecución de la Herramienta de configuración del servidor

Antes de ejecutar la Herramienta de configuración del servidor, asegúrese de que se cumplen los requisitos siguientes:

  1. Inicie la Herramienta de configuración del servidor.
    • En Linux, desde los atajos de la aplicación Aplicaciones → IBM MobileFirst Platform Server → Herramienta de configuración del servidor.
    • En Windows, pulse Inicio → Programas → IBM MobileFirst Platform Server → Herramienta de configuración del servidor.
    • En macOS, abra una consola de shell. Vaya a mfp_server_install_dir/shortcuts y escriba ./configuration-tool.sh.
    • El directorio mfp_server_install_dir es donde ha instalado MobileFirst Server.
  2. Seleccione Archivo → Nueva configuración para crear una Configuración de MobileFirst Server.
    • En el panel Detalles de configuración, escriba la raíz de contexto del servicio de administración y del componente de tiempo de ejecución. Es posible que desee especificar un ID de entorno. Un ID de entorno se utiliza en casos de uso avanzados, por ejemplo cuando varias instalaciones de MobileFirst Server se realizan en el mismo servidor de aplicaciones o la misma célula de WebSphere Application Server.
    • En el panel Valores de consola, seleccione si desea instalar MobileFirst Operations Console o no. Si la consola no está instalada, debe utilizar las herramientas de línea de mandatos (mfpdev o mfpadm) o la API REST para interactuar con el servicio de administración de MobileFirst Server.
    • En el panel Selección de base de datos, seleccione el sistema de gestión de bases de datos que tiene pensado utilizar. Todos los componentes utilizan el mismo tipo de base de datos y la misma instancia de base de datos. Para obtener más información sobre los paneles de base de datos, consulte Crear las tablas de base de datos con la Herramienta de configuración del servidor.
    • En el panel Selección del servidor de aplicaciones, seleccione el tipo de servidor de aplicaciones donde desea desplegar MobileFirst Server.
  3. En el panel Valores del servidor de aplicaciones, seleccione el servidor de aplicaciones y realice los pasos siguientes:
    • Para una instalación en WebSphere Application Server Liberty:
      • Escriba el directorio de instalación de Liberty y el nombre del servidor donde desea instalar MobileFirst Server.
      • Puede crear un usuario predeterminado para iniciar sesión en la consola. Este usuario se crea en el registro de Liberty Basic. Para una instalación de producción, es posible que desee borrar la opción Crear un usuario predeterminado y configurar el acceso de usuario después de la instalación. Para obtener más información, consulte Configuración de autenticación de usuario para la administración de MobileFirst Server.
      • Seleccione el tipo de despliegue: Despliegue autónomo (valor predeterminado), Despliegue de granja de servidores, o Despliegue de colectivo de Liberty.
      Si está seleccionada la opción de despliegue colectivo de Liberty, realice los pasos siguientes:
      • Especifique el servidor colectivo de Liberty:
        • Donde está instalado el servicio de administración, MobileFirst Operations Console y el servicio de Live Update. El servidor debe ser un controlador colectivo de Liberty.
        • Donde está instalado el tiempo de ejecución. El servidor debe ser un miembro de colectivo de Liberty.
        • Donde está instalado el servicio de envío por push. El servidor debe ser un miembro de colectivo de Liberty.
      • Escriba el ID de servidor del miembro. Este identificador debe ser distinto para cada miembro del colectivo.
      • Escriba el nombre de clúster de los miembros de colectivo.
      • Escriba el nombre de host de controlador y el número de puerto de HTTPS. Los valores deben ser los mismos que los definidos en el elemento variable dentro del archivo server.xml del controlador colectivo de Liberty.
      • Escriba el nombre de usuario y la contraseña del administrador del controlador.
    • Para una instalación en WebSphere Application Server o WebSphere Application Server Network Deployment:
      • Escriba el directorio de instalación de WebSphere Application Server.
      • Seleccione el perfil de WebSphere Application Server donde desea instalar MobileFirst Server. Si instala en WebSphere Application Server Network Deployment, seleccione el perfil del gestor de despliegue. En el perfil de gestor de despliegue, puede seleccionar un ámbito (Servidor o Clúster). Si selecciona Clúster, debe especificar el clúster:
        • Donde está instalado el tiempo de ejecución.
        • Donde está instalado el servicio de administración, MobileFirst Operations Console y el servicio de Live Update.
        • Donde está instalado el servicio de envío por push.
      • Escriba un ID de inicio de sesión y una contraseña del administrador. El usuario administrador debe tener un rol de administrador.
      • Si selecciona la opción Declarar al administrador de WebSphere como usuario administrador en MobileFirst Operations Console, el usuario utilizado para instalar MobileFirst Server se correlaciona con el rol de seguridad de administración de la consola y puede iniciar sesión en la consola con privilegios de administrador. Este usuario también se correlaciona con el rol de seguridad del servicio de Live Update. El nombre de usuario y la contraseña se establecen como propiedades JNDI (mfp.config.service.user y mfp.config.service.password) del servicio de administración.
      • Si no selecciona la opción Declarar al administrador de WebSphere como usuario administrador en MobileFirst Operations Console, antes de utilizar MobileFirst Server, debe realizar las tareas siguientes:
        • Habilitar la comunicación entre el servicio de administración y el servicio de Live Update mediante:
          • Correlación de un usuario con el rol de seguridad configadmin del servicio de Live Update.
          • Adición del ID y de la contraseña de inicio de sesión de este usuario en las propiedades JNDI (mfp.config.service.user and mfp.config.service.password) del servicio de administración.
          • Correlacione uno o varios usuarios en los roles de seguridad del servicio de administración y de MobileFirst Operations Console. Consulte Configuración de autenticación de usuario para la administración de MobileFirst Server.
    • Para una instalación en Apache Tomcat:
      • Escriba el directorio de instalación de Apache Tomcat.
      • Escriba el puerto utilizado para la comunicación de JMX con RMI. De forma predeterminada, el valor es 8686. La Herramienta de configuración del servidor modifica el archivo tomcat_install_dir/bin/setenv.bat o tomcat_install_dir/bin/setenv.sh para abrir este puerto. Si desea abrir el puerto manualmente, o tiene ya algún código que abra el puerto en setenv.bat o setenv.sh, no utilice la herramienta. Instale con tareas Ant en su lugar. Una opción para abrir el puerto RMI manualmente se proporciona para una instalación con tareas Ant.
      • Cree un usuario predeterminado para iniciar sesión en la consola. Este usuario también se crea en el archivo de configuración tomcat-users.xml. Para una instalación de producción, puede que desee borrar la opción Crear un usuario predeterminado y configurar el acceso de usuario tras la instalación. Para obtener más información, consulte Configuración de autenticación de usuario para la administración de MobileFirst Server.
  4. En el panel Valores del servicio de envío por push, seleccione la opción Instalar el servicio de envío por push si desea que el servicio de envío por push se instale en el servidor de aplicaciones. La raíz de contexto es imfpush. Para habilitar la comunicación entre el servicio de envío por push y el servicio de administración, debe definir los parámetros siguientes:
    • Escriba el URL del servicio de envío por push y el URL del tiempo de ejecución. Este URL se puede calcular automáticamente si instala en Liberty, Apache Tomcat, o en WebSphere Application Server autónomo. Utiliza el URL del componente (el tiempo de ejecución o el servicio de envío por push) en el servidor local. Si instala en WebSphere Application Server Network Deployment o las comunicaciones pasan por un proxy web o un equilibrador de carga, debe escribir el URL manualmente.
    • Escriba los ID de clientes confidenciales y el secreto para la comunicación de OAuth entre los servicios. De lo contrario, la herramienta generará valores predeterminados y contraseñas aleatorias.
  5. En el panel Valores de Analytics, seleccione Habilitar la conexión con el servidor de Analytics si MobileFirst Analytics está instalado. Escriba los siguientes valores de conexión:
    • El URL de la consola de Analytics.
    • El URL del servidor de Analytics (el servicio de datos de Analytics).
    • El ID de inicio de sesión y la contraseña del usuario permitidos para publicar datos en el servidor de Analytics.
    La herramienta configura el tiempo de ejecución y el servicio de envío por push para enviar datos al servidor de Analytics.
  6. Pulse Desplegar para continuar con la instalación.

Una vez que la instalación se haya completado correctamente, reinicie el servidor de aplicaciones en el caso de Apache Tomcat o del perfil de Liberty.

Si Apache Tomcat se ha iniciado como un servicio, es posible que no se pueda leer el archivo setenv.bat o setenv.sh que contiene la sentencia para abrir RMI. Como resultado, es posible que MobileFirst Server no pueda funcionar correctamente. Para establecer las variables necesarias, consulte Configuración de la conexión de JMX para Apache Tomcat.

En WebSphere Application Server Network Deployment, las aplicaciones están instaladas pero no se inician. Debe iniciarlas manualmente. Puede hacerlo desde la consola de administración de WebSphere Application Server.

Conserve el archivo de configuración en la Herramienta de configuración del servidor. Puede reutilizarlo para instalar los arreglos temporales. El menú para aplicar un arreglo temporal es Configuraciones > Sustituir los archivos WAR desplegados.

Aplicación de un fixpack utilizando la Herramienta de configuración del servidor

Si MobileFirst Server se instala con la herramienta de configuración y se conserva el archivo de configuración, puede aplicar un fixpack o un arreglo temporal reutilizando el archivo de configuración.

  1. Inicie la Herramienta de configuración del servidor.
    • En Linux, desde los atajos de aplicación Aplicaciones → IBM MobileFirst Platform Server → Herramienta de configuración del servidor.
    • En Windows, pulse Inicio → Programas → IBM MobileFirst Platform Server → Herramienta de configuración del servidor.
    • En macOS, abra una consola de shell. Vaya a mfp_server_install_dir/shortcuts y escriba ./configuration-tool.sh.
    • El directorio mfp_server_install_dir es donde ha instalado MobileFirst Server.
  2. Pulse Configuraciones → Sustituir los archivos WAR desplegados y seleccione una configuración existente para aplicar el fixpack o un arreglo temporal.

Instalación con tareas Ant

Utilice las tareas Ant para instalar los componentes de MobileFirst Server en el servidor de aplicaciones.

Puede encontrar los archivos de configuración de ejemplo para instalar MobileFirst Server en el directorio mfp_install_dir/MobileFirstServer/configuration-samples.

También puede crear una configuración con la Herramienta de configuración del servidor y exportar los archivos Ant utilizando Archivo → Exportar configuración como archivos Ant…. Los archivos Ant de ejemplo tienen las mismas limitaciones que la Herramienta de configuración del servidor:

  • Todos los componentes (MobileFirst Operations Console, servicio de administración de MobileFirst Server, servicio de Live Update de MobileFirst Server, los artefactos de MobileFirst Server y el tiempo de ejecución de MobileFirst) se encuentran en el mismo servidor de aplicaciones. Sin embargo, en WebSphere Application Server Network Deployment, cuando instala en un clúster, puede especificar un clúster distinto para los servicios de administración y de Live Update, y para el tiempo de ejecución.
  • Si el servicio de envío por push de MobileFirst Server está instalado, también estará instalado en el mismo servidor. Sin embargo, en WebSphere Application Server Network Deployment cuando instala en un clúster, puede especificar un clúster distinto para el servicio de envío por push.
  • Todos los componentes utilizan el mismo sistema de base de datos y usuario. Para DB2, todos los componentes también utilizan el mismo esquema.
  • La Herramienta de configuración del servidor instala los componentes para un único servidor. Para una instalación en varios servidores, debe configurarse una granja una vez que se ejecute la herramienta. La configuración de granja de servidores no está soportada en WebSphere Application Server Network Deployment.

Puede configurar los servicios de MobileFirst Server para que se ejecuten en la granja de servidores con tareas Ant. Para incluir el servidor en una granja, debe especificar algunos atributos específicos que configuren su servidor de aplicaciones en consonancia. Para obtener más información sobre cómo configurar una granja de servidores con las tareas Ant, consulte Instalación de una granja de servidores con tareas Ant.

Para otras topologías soportadas en Flujos de red y topologías, puede modificar los archivos Ant de ejemplo.

Las referencias a las tareas Ant son las siguientes:

Para obtener una visión general de la instalación con el archivo y las tareas de configuración de ejemplo, consulte Instalación de MobileFirst Server en modalidad de línea de mandatos.

Puede ejecutar un archivo Ant con la distribución de Ant que forma parte de la instalación del producto. Por ejemplo, si tiene el clúster WebSphere Application Server Network Deployment y su base de datos es IBM DB2, puede utilizar el archivo Ant mfp_install_dir/MobileFirstServer/configuration-samples/configure-wasnd-cluster-db2.xml. Después de editar el archivo y especificar todas las propiedades necesarias, puede ejecutar los mandatos siguientes desde el directorio mfp_install_dir/MobileFirstServer/configuration-samples:

  • mfp_install_dir/shortcuts/ant -f configure-wasnd-cluster-db2.xml help - Este mandato muestra la lista de todos los destinos posibles del archivo Ant, para instalar, desinstalar o actualizar algunos componentes.
  • mfp_install_dir/shortcuts/ant -f configure-wasnd-cluster-db2.xml install - Este mandato instala MobileFirst Server en el clúster de WebSphere Application Server Network Deployment, con DB2 como origen de datos utilizando los parámetros que ha especificado en las propiedades del archivo Ant.


Después de la instalación, realice una copia del archivo Ant para que pueda reutilizarlo para aplicar un fixpack.

Aplicación de un fixpack utilizando los archivos Ant

Actualización con el archivo Ant de ejemplo

Si utiliza los archivos Ant de ejemplo que se proporcionan en el directorio mfp_install_dir/MobileFirstServer/configuration-samples para instalar MobileFirst Server, puede reutilizar una copia de este archivo Ant para aplicar un fixpack. Para los valores de contraseña, puede especificar 12 estrellas (*) en lugar del valor real, para que se le solicite interactivamente cuando se ejecute el archivo Ant.

  1. Verifique el valor de la propiedad mfp.server.install.dir en el archivo Ant. Debe apuntar al directorio que contiene el producto con el fixpack aplicado. Este valor se utiliza para tomar los archivos WAR de MobileFirst Server actualizados.
  2. Ejecute el mandato: mfp_install_dir/shortcuts/ant -f your_ant_file update

Actualización con su propio archivo Ant

Si utiliza su propio archivo Ant, asegúrese de que para cada tarea de instalación (installmobilefirstadmin, installmobilefirstruntime, e installmobilefirstpush), tenga una tarea de actualización correspondiente en el archivo Ant con los mismos parámetros. Las tareas de actualización correspondientes son updatemobilefirstadmin, updatemobilefirstruntime y updatemobilefirstpush.

  1. Verifique la vía de acceso de clases del elemento taskdef para el archivo mfp-ant-deployer.jar. Debe apuntar al archivo mfp-ant-deployer.jar en una instalación de MobileFirst Server a la que se aplica el fixpack. De forma predeterminada, los archivos WAR de MobileFirst Server actualizados se toman de la ubicación de mfp-ant-deployer.jar.
  2. Ejecute las tareas de actualización (updatemobilefirstadmin, updatemobilefirstruntime, y updatemobilefirstpush) del archivo Ant.

Modificaciones de archivos Ant de ejemplo

Puede modificar los archivos Ant de ejemplo proporcionados en el directorio mfp_install_dir/MobileFirstServer/configuration-samples para adaptarlos a sus requisitos de instalación.
En las secciones siguientes se proporcionan los detalles sobre cómo puede modificar los archivos Ant de ejemplo para adaptar la instalación a sus necesidades:

  1. Especificar propiedades JNDI adicionales
  2. Especificar usuarios existentes
  3. Especificar el nivel de Liberty Java EE
  4. Especificar propiedades JDBC del origen de datos
  5. Ejecutar los archivos Ant en un sistema donde MobileFirst Server no esté instalado
  6. Especificar destinos de WebSphere Application Server Network Deployment
  7. Configuración manual del puerto RMI en Apache Tomcat

Especificar propiedades JNDI adicionales

Las tareas Ant installmobilefirstadmin, installmobilefirstruntime e installmobilefirstpush declaran los valores para las propiedades JNDI que son necesarios para que funcionen los componentes. Estas propiedades JNDI se utilizan para definir la comunicación JMX, y también los enlaces a otros componentes (como el servicio de Live Update, el servicio de envío por push, el servicio de análisis o el servidor de autorizaciones). Sin embargo, también puede definir valores para otras propiedades JNDI. Utilice el elemento <property> que existe para estas tres tareas. Para obtener una lista de propiedades JNDI, consulte:

Por ejemplo:

<installmobilefirstadmin ..>
    <property name="mfp.admin.actions.prepareTimeout" value="3000000"/>
</installmobilefirstadmin>

Especificar usuarios existentes

De forma predeterminada, la tarea Ant installmobilefirstadmin crea usuarios:

  • En WebSphere Application Server Liberty para definir un administrador de Liberty para la comunicación de JMX.
  • En cualquier servidor de aplicaciones, para definir un usuario utilizado para la comunicación con el servicio de Live Update.

Para utilizar un usuario existente en lugar de crear un usuario nuevo, puede realizar las siguientes operaciones:

  1. En el elemento <jmx>, especifique un usuario y una contraseña, y establezca el valor del atributo createLibertyAdmin en false. Por ejemplo:

    <installmobilefirstadmin ...>
        <jmx libertyAdminUser="myUser" libertyAdminPassword="password" createLibertyAdmin="false" />
        ...
    
  2. En el elemento <configuration>, especifique un usuario y una contraseña y establezca el valor del atributo createConfigAdminUser en false. Por ejemplo:

     <installmobilefirstadmin ...>
         <configuration configAdminUser="myUser" configAdminPassword="password" createConfigAdminUser="false" />
         ...
    

Además, el usuario que se crea mediante los archivos Ant de ejemplo se correlaciona con los roles de seguridad del servicio de administración y de la consola. Con este valor, puede utilizar este usuario para iniciar sesión en MobileFirst Server después de la instalación. Para cambiar dicho comportamiento, elimine el elemento <user> de los archivos Ant de ejemplo. Como alternativa, puede eliminar el atributo password del elemento <user>, y el usuario no se creará en el registro local del servidor de aplicaciones.

Especificar el nivel de Liberty Java EE

Algunas distribuciones de WebSphere Application Server Liberty dan soporte a características de Java EE 6 o de Java EE 7. De forma predeterminada, las tareas Ant detectan automáticamente las características que hay que instalar. Por ejemplo, la característica de Liberty jdbc-4.0 está instalada para Java EE 6 y la característica jdbc-4.1 está instalada en el caso de Java EE 7. Si la instalación de Liberty da soporte a las dos características de Java EE 6 y Java EE 7, es posible que desee forzar un determinado nivel de características. Un ejemplo podría ser que tenga previsto ejecutar MobileFirst Server V8.0.0 y V7.1.0 en el mismo servidor de Liberty. MobileFirst Server V7.1.0 o anterior sólo da soporte a característica de Java EE 6.

Para forzar un determinado nivel de características de Java EE 6, utilice el atributo jeeversion del elemento <websphereapplicationserver>. Por ejemplo:

<installmobilefirstadmin execute="${mfp.process.admin}" contextroot="${mfp.admin.contextroot}">
    [...]
    <applicationserver>
      <websphereapplicationserver installdir="${appserver.was.installdir}"
        profile="Liberty" jeeversion="6">

Especificar propiedades JDBC del origen de datos

Puede especificar las propiedades para la conexión de JDBC. Utilice el elemento <property> de un elemento <database>. El elemento está disponible en las tareas Ant configureDatabase, installmobilefirstadmin, installmobilefirstruntime e installmobilefirstpush. Por ejemplo:

<configuredatabase kind="MobileFirstAdmin">
    <db2 database="${database.db2.mfpadmin.dbname}"
        server="${database.db2.host}"
        instance="${database.db2.instance}"
        user="${database.db2.mfpadmin.username}"
        port= "${database.db2.port}"
        schema = "${database.db2.mfpadmin.schema}"
        password="${database.db2.mfpadmin.password}">

       <property name="commandTimeout" value="10"/>
    </db2>

Ejecutar los archivos Ant en un sistema donde MobileFirst Server no está instalado

Para ejecutar las tareas Ant en un sistema donde MobileFirst Server no está instalado, necesita los elementos siguientes:

  • Una instalación Ant
  • Una copia del archivo mfp-ant-deployer.jar en el sistema remoto. Esta biblioteca contiene la definición de las tareas Ant.
  • Para especificar los recursos que se van a instalar. De forma predeterminada, los archivos WAR se toman cerca de mfp-ant-deployer.jar, pero puede especificar la ubicación de estos archivos WAR. Por ejemplo:
<installmobilefirstadmin execute="true" contextroot="/mfpadmin" serviceWAR="/usr/mfp/mfp-admin-service.war">
  <console install="true" warFile="/usr/mfp/mfp-admin-ui.war"/>

Para obtener más información, consulte las tareas Ant para instalar cada componente de MobileFirst Server en Referencia de instalación.

Especificar los destinos de WebSphere Application Server Network Deployment

Para instalar en WebSphere Application Server Network Deployment, el perfil especificado de WebSphere Application Server debe ser el gestor de despliegue. Puede desplegar en las siguientes configuraciones:

  • Un clúster
  • Un único servidor
  • Una célula (todos los servidores de una célula)
  • Un nodo (todos los servidores de un nodo)

Los archivos de ejemplo como configure-wasnd-cluster-dbms-name.xml, configure-wasnd-server-dbms-name.xml y configure-wasnd-node-dbms-name.xml contienen la declaración para desplegar en cada tipo de destino. Para obtener más información, consulte las tareas Ant para instalar cada componente de MobileFirst Server en la Referencia de instalación.

Nota: A partir de V8.0.0, no se proporcionará el archivo de configuración de ejemplo para la célula de WebSphere Application Server Network Deployment.

Configuración manual del puerto RMI en Apache Tomcat

De forma predeterminada, las tareas Ant modifican el archivo setenv.bat o el archivo setenv.sh para abrir el puerto RMI. Si prefiere abrir el puerto RMI manualmente, añada el atributo tomcatSetEnvConfig con el valor false en el elemento <jmx> de las tareas installmobilefirstadmin, updatemobilefirstadmin y uninstallmobilefirstadmin.

Instalación de los componentes de MobileFirst Server manualmente

También puede instalar los componentes de MobileFirst Server en su servidor de aplicaciones manualmente.
Los temas siguientes le proporcionan la información completa para guiarle por el proceso de instalación de los componentes en las aplicaciones soportadas en producción.

Instalación manual en WebSphere Application Server Liberty

Asegúrese de que también haya cumplido los requisitos tal como se describe en Requisitos previos de WebSphere Application Server Liberty.

Restricciones de topología

El servicio de administración de MobileFirst Server, el servicio de Live Update de MobileFirst Server y el tiempo de ejecución de MobileFirst deben estar instalados en el mismo servidor de aplicaciones. La raíz de contexto del servicio de Live Update debe estar definida como the-adminContextRootconfig. La raíz de contexto del servicio de envío por push debe ser imfpush. Para obtener más información acerca de las restricciones, consulte Restricciones en los componentes de MobileFirst Server y MobileFirst Analytics.

Valores del servidor de aplicaciones

Debe configurar el elemento webContainer para cargar los servlets de inmediato. Este valor es necesario para la inicialización mediante JMX. Por ejemplo: <webContainer deferServletLoad="false"/>.

Opcionalmente, para evitar problemas de tiempo de espera excedido que rompan la secuencia de arranque del tiempo de ejecución y el servicio de administración en algunas versiones de Liberty, cambie el elemento executor predeterminado. Establezca valores grandes en los atributos coreThreads y maxThreads. Por ejemplo:

<executor id="default" name="LargeThreadPool"
  coreThreads="200" maxThreads="400" keepAlive="60s"
  stealPolicy="STRICT" rejectedWorkPolicy="CALLER_RUNS"/>

También puede configurar el elemento tcpOptions y establecer el atributo soReuseAddr en true: <tcpOptions soReuseAddr="true"/>.

Características de Liberty requeridas por las aplicaciones de MobileFirst Server

Puede utilizar las siguientes características para Java EE 6 o Java EE 7.

Servicio de administración de MobileFirst Server

  • jdbc-4.0 (jdbc-4.1 for Java EE 7)
  • appSecurity-2.0
  • restConnector-1.0
  • usr:MFPDecoderFeature-1.0

Servicio de envío por push de MobileFirst Server

  • jdbc-4.0 (jdbc-4.1 for Java EE 7)
  • servlet-3.0 (servlet-3.1 for Java EE 7)
  • ssl-1.0
  • usr:MFPDecoderFeature-1.0

Tiempo de ejecución de MobileFirst

  • jdbc-4.0 (jdbc-4.1 for Java EE 7)
  • servlet-3.0 (servlet-3.1 for Java EE 7)
  • ssl-1.0
  • usr:MFPDecoderFeature-1.0

Entradas JNDI globales

Las siguientes entradas JNDI globales son necesarias para configurar la comunicación JMX entre el tiempo de ejecución y el servicio de administración:

  • mfp.admin.jmx.host
  • mfp.admin.jmx.port
  • mfp.admin.jmx.user
  • mfp.admin.jmx.pwd
  • mfp.topology.platform
  • mfp.topology.clustermode

Estas entradas JNDI globales se establecen con esta sintaxis y no tienen como prefijos una raíz de contexto. Por ejemplo: <jndiEntry jndiName="mfp.admin.jmx.port" value="9443"/>.

Nota: Para proteger contra una conversión automática de los valores JNDI, para que 075 no se convierta a 61 o que 31,500 no se convierta en 31,5, utilice esta sintaxis ‘“075”’ al definir el valor.

Para obtener más información sobre las propiedades JNDI para el servicio de administración, consulte Lista de propiedades JNDI para el servicio de administración de MobileFirst Server.

Para la configuración en una granja de servidores, consulte también los temas siguientes:

Cargador de clases

Para todas las aplicaciones, el cargador de clases debe tener la delegación del último padre. Por ejemplo:

<application id="mfpadmin" name="mfpadmin" location="mfp-admin-service.war" type="war">
  [...]
  <classloader delegation="parentLast">
  </classloader>
</application>

Característica de usuario decodificador de contraseñas

Copie la característica de usuario decodificador de contraseñas en el perfil de Liberty. Por ejemplo:

  • En sistemas UNIX y Linux:

    mkdir -p LIBERTY_HOME/wlp/usr/extension/lib/features
    cp product_install_dir/features/com.ibm.websphere.crypto_1.0.0.jar LIBERTY_HOME/wlp/usr/extension/lib/
    cp product_install_dir/features/MFPDecoderFeature-1.0.mf LIBERTY_HOME/wlp/usr/extension/lib/features/
    
  • En sistemas Windows:

    mkdir LIBERTY_HOME\wlp\usr\extension\lib
    copy /B product_install_dir\features\com.ibm.websphere.crypto_1.0.0.jar
    LIBERTY_HOME\wlp\usr\extension\lib\com.ibm.websphere.crypto_1.0.0.jar
    mkdir LIBERTY_HOME\wlp\usr\extension\lib\features
    copy /B product_install_dir\features\MFPDecoderFeature-1.0.mf
    LIBERTY_HOME\wlp\usr\extension\lib\features\MFPDecoderFeature-1.0.mf
    

Detalles de la configuración

El servicio de administración está empaquetado como una aplicación WAR para desplegar en el servidor de aplicaciones. Necesita realizar algunas configuraciones específicas para esta aplicación en el archivo server.xml. El archivo WAR del servicio de administración se encuentra en mfp_install_dir/MobileFirstServer/mfp-admin-service.war. Puede definir la raíz de contexto como desee. Sin embargo, normalmente es /mfpadmin.

Propiedades JNDI obligatorias

Al definir las propiedades JNDI, los nombres de JNDI deben tener como prefijo la raíz de contexto del servicio de administración. El ejemplo siguiente ilustra el caso para declarar mfp.admin.push.url mediante el que el servicio de administración está instalado con /mfpadmin como raíz de contexto:

<jndiEntry jndiName="mfpadmin/mfp.admin.push.url" value="http://localhost:9080/imfpush"/>

Si el servicio de envío por push está instalado, debe configurar las siguientes propiedades JNDI:

  • mfp.admin.push.url
  • mfp.admin.authorization.server.url
  • mfp.push.authorization.client.id
  • mfp.push.authorization.client.secret
  • mfp.admin.authorization.client.id
  • mfp.admin.authorization.client.secret

Las propiedades JNDI para la comunicación con el servicio de configuración son las siguientes:

  • mfp.config.service.user
  • mfp.config.service.password

Para obtener más información sobre las propiedades JNDI, consulte Lista de propiedades JNDI para el servicio de administración de MobileFirst Server.

Origen de datos

El nombre JNDI del origen de datos para el servicio de administración debe estar definido como jndiName=the-contextRoot/jdbc/mfpAdminDS. En el ejemplo siguiente se ilustra el caso mediante el que el servicio de administración está instalado con la raíz de contexto /mfpadmin, y que el servicio está utilizando una base de datos relacional:

<dataSource jndiName="mfpadmin/jdbc/mfpAdminDS" transactional="false">
  [...]
</dataSource>

Declare los roles siguientes en el elemento application-bnd de la aplicación:

  • mfpadmin
  • mfpdeployer
  • mfpmonitor
  • mfpoperator

El servicio de Live Update está empaquetado como una aplicación WAR para que la despliegue en el servidor de aplicaciones. Necesita realizar algunas configuraciones específicas para esta aplicación en el archivo server.xml. Antes de continuar, consulte Instalación manual en WebSphere Application Server Liberty para ver los detalles de configuración que son comunes a todos los servicios.

El archivo WAR del servicio de Live Update se encuentra en mfp_install_dir/MobileFirstServer/mfp-live-update.war. La raíz de contexto del servicio de Live Update debe definirse de esta forma: /the-adminContextRootconfig. Por ejemplo, si la raíz de contexto del servicio de administración es /mfpadmin, la raíz de contexto del servicio de Live Update debe ser /mfpadminconfig.

Origen de datos

El nombre JNDI del origen de datos para el servicio de Live Update debe estar definido como the-contextRoot/jdbc/ConfigDS. El ejemplo siguiente ilustra el caso mediante el que el servicio de Live Update está instalado con la raíz de contexto /mfpadminconfig, y en el que el servicio está utilizando una base de datos relacional:

<dataSource jndiName="mfpadminconfig/jdbc/ConfigDS" transactional="false">
  [...]
</dataSource>

Declare el rol configadmin en el elemento application-bnd de la aplicación. Como mínimo un usuario debe estar correlacionado con este rol. El usuario y su contraseña deben estar proporcionados en las siguientes propiedades JNDI del servicio de administración:

  • mfp.config.service.user
  • mfp.config.service.password

La consola está empaquetada como una aplicación WAR para que la despliegue en el servidor de aplicaciones. Necesita realizar algunas configuraciones específicas para esta aplicación en el archivo server.xml. Antes de continuar, consulte Instalación manual en WebSphere Application Server Liberty para ver los detalles de configuración que son comunes a todos los servicios.

El archivo WAR de la consola se encuentra en mfp_install_dir/MobileFirstServer/mfp-admin-ui.war. Puede definir la raíz de contexto como desee. Sin embargo, normalmente es /mfpconsole.

Propiedades JNDI obligatorias

Al definir las propiedades JNDI, los nombres de JNDI deben tener como prefijo la raíz de contexto de la consola. El ejemplo siguiente ilustra el caso para declarar mfp.admin.endpoint mediante el que la consola se instala con /mfpconsole como raíz de contexto:

<jndiEntry jndiName="mfpconsole/mfp.admin.endpoint" value="*://*:*/mfpadmin"/>

El valor típico para la propiedad mfp.admin.endpoint es *://*:*/the-adminContextRoot.
Para obtener más información sobre las propiedades JNDI, consulte Propiedades JNDI para MobileFirst Operations Console.

Roles de seguridad

Declare los roles siguientes en el elemento application-bnd de la aplicación:

  • mfpadmin
  • mfpdeployer
  • mfpmonitor
  • mfpoperator
Cualquier usuario que esté correlacionado con un rol de seguridad de la consola también debe estar correlacionado en el mismo rol de seguridad que el servicio de administración.

El tiempo de ejecución está empaquetado como una aplicación WAR para que la despliegue en el servidor de aplicaciones. Necesita realizar algunas configuraciones específicas para esta aplicación en el archivo server.xml. Antes de continuar, consulte Instalación manual en WebSphere Application Server Liberty para ver los detalles de configuración que son comunes a todos los servicios.

El archivo WAR de tiempo de ejecución se encuentra en mfp_install_dir/MobileFirstServer/mfp-server.war. Puede definir la raíz de contexto como desee. Sin embargo, es /mfp de forma predeterminada.

Propiedades JNDI obligatorias

Al definir las propiedades JNDI, los nombres de JNDI deben tener como prefijo la raíz de contexto del tiempo de ejecución. El ejemplo siguiente ilustra el caso para declarar mfp.analytics.url mediante el que se instala el tiempo de ejecución con /mobilefirst como raíz de contexto:

<jndiEntry jndiName="mobilefirst/mfp.analytics.url" value="http://localhost:9080/analytics-service/rest"/>

Debe definir la propiedad mobilefirst/mfp.authorization.server. Por ejemplo:

<jndiEntry jndiName="mobilefirst/mfp.authorization.server" value="embedded"/>

Si MobileFirst Analytics está instalado, tiene que definir las siguientes propiedades JNDI:

  • mfp.analytics.url
  • mfp.analytics.console.url
  • mfp.analytics.username
  • mfp.analytics.password

Para obtener más información sobre las propiedades JNDI, consulte Lista de propiedades JNDI para el tiempo de ejecución de MobileFirst.

Origen de datos

El nombre JNDI del origen de datos para el tiempo de ejecución debe estar definido como jndiName=the-contextRoot/jdbc/mfpDS. El ejemplo siguiente ilustra el caso mediante el que el tiempo de ejecución está instalado con la raíz de contexto /mobilefirst, y que el tiempo de ejecución está utilizando una base de datos relacional:

<dataSource jndiName="mobilefirst/jdbc/mfpDS" transactional="false">
  [...]
</dataSource>

El servicio de envío por push está empaquetado como una aplicación WAR para que la despliegue en el servidor de aplicaciones. Necesita realizar algunas configuraciones específicas para esta aplicación en el archivo server.xml. Antes de continuar, consulte Instalación manual en WebSphere Application Server Liberty para ver los detalles de configuración que son comunes a todos los servicios.

El archivo WAR del servicio de envío por push se encuentra en mfp_install_dir/PushService/mfp-push-service.war. Debe definir la raíz de contexto como /imfpush. De lo contrario, los dispositivos cliente no se podrán conectar a la misma, ya que la raíz de contexto está codificada en el SDK.

Propiedades JNDI obligatorias

Al definir las propiedades JNDI, los nombres de JNDI deben tener como prefijo la raíz de contexto del servicio de envío por push. El ejemplo siguiente ilustra el caso para declarar mfp.push.analytics.user mediante el que el servicio de envío por push está instalado con /imfpush como raíz de contexto:

<jndiEntry jndiName="imfpush/mfp.push.analytics.user" value="admin"/>
Debe definir las propiedades siguientes:
  • mfp.push.authorization.server.url
  • mfp.push.authorization.client.id
  • mfp.push.authorization.client.secret
  • mfp.push.services.ext.security - el valor debe ser com.ibm.mfp.push.server.security.plugin.OAuthSecurityPlugin.
  • mfp.push.db.type - para una base de datos relacional, el valor debe ser DB.
Si se configura MobileFirst Analytics, defina las siguientes propiedades JNDI:
  • mfp.push.analytics.endpoint
  • mfp.analytics.username
  • mfp.analytics.password
  • mfp.push.services.ext.analytics - el valor debe ser com.ibm.mfp.push.server.analytics.plugin.AnalyticsPlugin.
Para obtener más información sobre las propiedades JNDI, consulte Lista de propiedades JNDI para el servicio de envío por push de MobileFirst Server.

El componente de artefactos está empaquetado como una aplicación WAR para que la despliegue en el servidor de aplicaciones. Necesita realizar algunas configuraciones específicas para esta aplicación en el archivo server.xml. Antes de continuar, consulte Instalación manual en WebSphere Application Server Liberty para ver los detalles de configuración que son comunes a todos los servicios.

El archivo WAR para este componente se encuentra en mfp_install_dir/MobileFirstServer/mfp-dev-artifacts.war. Debe definir la raíz de contexto como /mfp-dev-artifacts.

Instalación manual en el colectivo de WebSphere Application Server Liberty

Asegúrese de que también haya cumplido los requisitos tal como se describe en Requisitos previos de WebSphere Application Server Liberty.

Restricciones de topología

El servicio de administración de MobileFirst Server, el servicio de Live Update de MobileFirst Server y MobileFirst Operations Console se deben instalar en un controlador colectivo de Liberty. El tiempo de ejecución de MobileFirst y el servicio de envío por push de the MobileFirst Server deben estar instalados en cada miembro del clúster colectivo de Liberty.

La raíz de contexto del servicio de Live Update debe estar definida como the-adminContextRootconfig. La raíz de contexto del servicio de envío por push debe ser imfpush. Para obtener más información acerca de las restricciones, consulte Restricciones en los componentes de MobileFirst Server y MobileFirst Analytics.

Valores del servidor de aplicaciones

Debe configurar el elemento webContainer para cargar los servlets de inmediato. Este valor es necesario para la inicialización mediante JMX. Por ejemplo: <webContainer deferServletLoad="false"/>.

Opcionalmente, para evitar problemas de tiempo de espera excedido que rompan la secuencia de arranque del tiempo de ejecución y el servicio de administración en algunas versiones de Liberty, cambie el elemento executor predeterminado. Establezca valores grandes en los atributos coreThreads y maxThreads. Por ejemplo:

<executor id="default" name="LargeThreadPool"
  coreThreads="200" maxThreads="400" keepAlive="60s"
  stealPolicy="STRICT" rejectedWorkPolicy="CALLER_RUNS"/>

También puede configurar el elemento tcpOptions y establecer el atributo soReuseAddr en true: <tcpOptions soReuseAddr="true"/>.

Características de Liberty requeridas por las aplicaciones de MobileFirst Server

Debe añadir las siguientes características para Java EE 6 o Java EE 7.

Servicio de administración de MobileFirst Server

  • jdbc-4.0 (jdbc-4.1 for Java EE 7)
  • appSecurity-2.0
  • restConnector-1.0
  • usr:MFPDecoderFeature-1.0

Servicio de envío por push de MobileFirst Server

  • jdbc-4.0 (jdbc-4.1 for Java EE 7)
  • servlet-3.0 (servlet-3.1 for Java EE 7)
  • ssl-1.0
  • usr:MFPDecoderFeature-1.0

Tiempo de ejecución de MobileFirst

  • jdbc-4.0 (jdbc-4.1 for Java EE 7)
  • servlet-3.0 (servlet-3.1 for Java EE 7)
  • ssl-1.0
  • usr:MFPDecoderFeature-1.0

Entradas JNDI globales

Las siguientes entradas JNDI globales son necesarias para configurar la comunicación JMX entre el tiempo de ejecución y el servicio de administración:

  • mfp.admin.jmx.host
  • mfp.admin.jmx.port
  • mfp.admin.jmx.user
  • mfp.admin.jmx.pwd
  • mfp.topology.platform
  • mfp.topology.clustermode
  • mfp.admin.serverid

Estas entradas JNDI globales se establecen con esta sintaxis y no tienen como prefijos una raíz de contexto. Por ejemplo: <jndiEntry jndiName="mfp.admin.jmx.port" value="9443"/>.

Nota: Para proteger contra una conversión automática de los valores JNDI, para que 075 no se convierta a 61 o que 31,500 no se convierta en 31,5, utilice esta sintaxis ‘“075”’ al definir el valor.

Cargador de clases

Para todas las aplicaciones, el cargador de clases debe tener la delegación del último padre. Por ejemplo:

<application id="mfpadmin" name="mfpadmin" location="mfp-admin-service.war" type="war">
  [...]
  <classloader delegation="parentLast">
  </classloader>
</application>

Característica de usuario decodificador de contraseñas

Copie la característica de usuario decodificador de contraseñas en el perfil de Liberty. Por ejemplo:

  • En sistemas UNIX y Linux:

    mkdir -p LIBERTY_HOME/wlp/usr/extension/lib/features
    cp product_install_dir/features/com.ibm.websphere.crypto_1.0.0.jar LIBERTY_HOME/wlp/usr/extension/lib/
    cp product_install_dir/features/MFPDecoderFeature-1.0.mf LIBERTY_HOME/wlp/usr/extension/lib/features/
    
  • En sistemas Windows:

    mkdir LIBERTY_HOME\wlp\usr\extension\lib
    copy /B product_install_dir\features\com.ibm.websphere.crypto_1.0.0.jar
    LIBERTY_HOME\wlp\usr\extension\lib\com.ibm.websphere.crypto_1.0.0.jar
    mkdir LIBERTY_HOME\wlp\usr\extension\lib\features
    copy /B product_install_dir\features\MFPDecoderFeature-1.0.mf
    LIBERTY_HOME\wlp\usr\extension\lib\features\MFPDecoderFeature-1.0.mf
    

    Detalles de la configuración

El servicio de administración está empaquetado como una aplicación WAR para que la despliegue en el controlador colectivo de Liberty. Necesita realizar algunas configuraciones específicas para esta aplicación en el archivo server.xml del controlador colectivo de Liberty.

Antes de continuar, consulte Instalación manual en el colectivo de WebSphere Application Server Liberty para ver los detalles de configuración que son comunes a todos los servicios.

El archivo WAR del servicio de administración se encuentra en mfp_install_dir/MobileFirstServer/mfp-admin-service-collective.war. Puede definir la raíz de contexto como desee. Sin embargo, normalmente es /mfpadmin.

Propiedades JNDI obligatorias

Al definir las propiedades JNDI, los nombres de JNDI deben tener como prefijo la raíz de contexto del servicio de administración. El ejemplo siguiente ilustra el caso para declarar mfp.admin.push.url mediante el que el servicio de administración está instalado con /mfpadmin como raíz de contexto:

<jndiEntry jndiName="mfpadmin/mfp.admin.push.url" value="http://localhost:9080/imfpush"/>

Si el servicio de envío por push está instalado, debe configurar las siguientes propiedades JNDI:

  • mfp.admin.push.url
  • mfp.admin.authorization.server.url
  • mfp.push.authorization.client.id
  • mfp.push.authorization.client.secret
  • mfp.admin.authorization.client.id
  • mfp.admin.authorization.client.secret

Las propiedades JNDI para la comunicación con el servicio de configuración son las siguientes:

  • mfp.config.service.user
  • mfp.config.service.password

Para obtener más información sobre las propiedades JNDI, consulte Lista de propiedades JNDI para el servicio de administración de MobileFirst Server.

Origen de datos

El nombre JNDI del origen de datos para el servicio de administración debe estar definido como jndiName=the-contextRoot/jdbc/mfpAdminDS. En el ejemplo siguiente se ilustra el caso mediante el que el servicio de administración está instalado con la raíz de contexto /mfpadmin, y que el servicio está utilizando una base de datos relacional:

<dataSource jndiName="mfpadmin/jdbc/mfpAdminDS" transactional="false">
  [...]
</dataSource>

Roles de seguridad

Declare los roles siguientes en el elemento application-bnd de la aplicación:

  • mfpadmin
  • mfpdeployer
  • mfpmonitor
  • mfpoperator

El servicio de Live Update está empaquetado como una aplicación WAR para que desplegarse en el controlador colectivo de Liberty. Necesita realizar algunas configuraciones específicas para esta aplicación en el archivo server.xml del controlador colectivo de Liberty.

Antes de continuar, consulte Instalación manual en el colectivo de WebSphere Application Server Liberty para ver los detalles de configuración que son comunes a todos los servicios.

El archivo WAR del servicio de Live Update se encuentra en mfp_install_dir/MobileFirstServer/mfp-live-update.war. La raíz de contexto del servicio de Live Update debe definirse de esta forma: /the-adminContextRootconfig. Por ejemplo, si la raíz de contexto del servicio de administración es /mfpadmin, la raíz de contexto del servicio de Live Update debe ser /mfpadminconfig.

Origen de datos

El nombre JNDI del origen de datos para el servicio de Live Update debe estar definido como the-contextRoot/jdbc/ConfigDS. El ejemplo siguiente ilustra el caso mediante el que está instalado el servicio de Live Update con la raíz de contexto /mfpadminconfig, y que el servicio está utilizando una base de datos relacional:

<dataSource jndiName="mfpadminconfig/jdbc/ConfigDS" transactional="false">
  [...]
</dataSource>

Roles de seguridad

Declare el rol configadmin en el elemento application-bnd de la aplicación. Como mínimo un usuario debe estar correlacionado con este rol. El usuario y su contraseña deben estar proporcionados en las siguientes propiedades JNDI del servicio de administración:

  • mfp.config.service.user
  • mfp.config.service.password

La consola está empaquetada como una aplicación WAR para desplegarse en el controlador colectivo de Liberty. Necesita realizar algunas configuraciones específicas para esta aplicación en el archivo server.xml del controlador colectivo de Liberty.

Antes de continuar, consulte Instalación manual en WebSphere Application Server Liberty para ver los detalles de configuración que son comunes a todos los servicios.

El archivo WAR de la consola se encuentra en mfp_install_dir/MobileFirstServer/mfp-admin-ui.war. Puede definir la raíz de contexto como desee. Sin embargo, normalmente es /mfpconsole.

Propiedades JNDI obligatorias

Al definir las propiedades JNDI, los nombres de JNDI deben tener como prefijo la raíz de contexto de la consola. El ejemplo siguiente ilustra el caso para declarar mfp.admin.endpoint mediante el que la consola se instala con /mfpconsole como raíz de contexto:

<jndiEntry jndiName="mfpconsole/mfp.admin.endpoint" value="*://*:*/mfpadmin"/>

El valor típico para la propiedad mfp.admin.endpoint es *://*:*/the-adminContextRoot.
Para obtener más información sobre las propiedades JNDI, consulte Propiedades JNDI para MobileFirst Operations Console.

Roles de seguridad

Declare los roles siguientes en el elemento application-bnd de la aplicación:

  • mfpadmin
  • mfpdeployer
  • mfpmonitor
  • mfpoperator
Cualquier usuario que esté correlacionado con un rol de seguridad de la consola también debe estar correlacionado en el mismo rol de seguridad que el servicio de administración.

El tiempo de ejecución está empaquetado como una aplicación WAR para desplegarse en los miembros del clúster colectivo de Liberty. Necesita realizar algunas configuraciones específicas para esta aplicación en el archivo server.xml de cada miembro del clúster colectivo de Liberty.

Antes de continuar, consulte Instalación manual en el colectivo de WebSphere Application Server Liberty para ver los detalles de configuración que son comunes a todos los servicios.

El archivo WAR de tiempo de ejecución se encuentra en mfp_install_dir/MobileFirstServer/mfp-server.war. Puede definir la raíz de contexto como desee. Sin embargo, es /mfp de forma predeterminada.

Propiedades JNDI obligatorias

Al definir las propiedades JNDI, los nombres de JNDI deben tener como prefijo la raíz de contexto del tiempo de ejecución. El ejemplo siguiente ilustra el caso para declarar mfp.analytics.url mediante el que se instala el tiempo de ejecución con /mobilefirst como raíz de contexto:

<jndiEntry jndiName="mobilefirst/mfp.analytics.url" value="http://localhost:9080/analytics-service/rest"/>

Debe definir la propiedad mobilefirst/mfp.authorization.server. Por ejemplo:

<jndiEntry jndiName="mobilefirst/mfp.authorization.server" value="embedded"/>

Si MobileFirst Analytics está instalado, tiene que definir las siguientes propiedades JNDI:

  • mfp.analytics.url
  • mfp.analytics.console.url
  • mfp.analytics.username
  • mfp.analytics.password

Para obtener más información sobre las propiedades JNDI, consulte Lista de propiedades JNDI para el tiempo de ejecución de MobileFirst.

Origen de datos

El nombre JNDI del origen de datos para el tiempo de ejecución debe estar definido como jndiName=the-contextRoot/jdbc/mfpDS. El ejemplo siguiente ilustra el caso mediante el que el tiempo de ejecución está instalado con la raíz de contexto /mobilefirst, y que el tiempo de ejecución está utilizando una base de datos relacional:

<dataSource jndiName="mobilefirst/jdbc/mfpDS" transactional="false">
  [...]
</dataSource>

El servicio de envío por push está empaquetado como una aplicación WAR para desplegarla en un miembro del clúster colectivo de Liberty o en un servidor de Liberty. Si instala el servicio de envío por push en un servidor de Liberty, consulte Detalles de configuración del servicio de envío por push de MobileFirst Server en Instalación manual en WebSphere Application Server Liberty.

Cuando el servicio de envío por push de MobileFirst Server esté instalado en un colectivo de Liberty, se podrá instalar en el mismo clúster que el tiempo de ejecución o en otro clúster.

Necesita realizar algunas configuraciones específicas para esta aplicación en el archivo server.xml de cada miembro del clúster colectivo de Liberty. Antes de continuar, consulte Instalación manual en el colectivo de WebSphere Application Server Liberty para ver los detalles de configuración que son comunes a todos los servicios.

El archivo WAR del servicio de envío por push se encuentra en mfp_install_dir/PushService/mfp-push-service.war. Debe definir la raíz de contexto como /imfpush. De lo contrario, los dispositivos cliente no se podrán conectar a la misma, ya que la raíz de contexto está codificada en el SDK.

Propiedades JNDI obligatorias

Al definir las propiedades JNDI, los nombres de JNDI deben tener como prefijo la raíz de contexto del servicio de envío por push. El ejemplo siguiente ilustra el caso para declarar mfp.push.analytics.user mediante el que el servicio de envío por push está instalado con /imfpush como raíz de contexto:

<jndiEntry jndiName="imfpush/mfp.push.analytics.user" value="admin"/>
Debe definir las propiedades siguientes:
  • mfp.push.authorization.server.url
  • mfp.push.authorization.client.id
  • mfp.push.authorization.client.secret
  • mfp.push.services.ext.security - el valor debe ser com.ibm.mfp.push.server.security.plugin.OAuthSecurityPlugin.
  • mfp.push.db.type - para una base de datos relacional, el valor debe ser DB.
Si se configura MobileFirst Analytics, defina las siguientes propiedades JNDI:
  • mfp.push.analytics.endpoint
  • mfp.analytics.username
  • mfp.analytics.password
  • mfp.push.services.ext.analytics - el valor debe ser com.ibm.mfp.push.server.analytics.plugin.AnalyticsPlugin.
Para obtener más información sobre las propiedades JNDI, consulte Lista de propiedades JNDI para el servicio de envío por push de MobileFirst Server.

El componente artifacts está empaquetado como una aplicación WAR para desplegarse en el controlador colectivo de Liberty. Necesita realizar algunas configuraciones específicas para esta aplicación en el archivo server.xml del controlador colectivo de Liberty. Antes de continuar, consulte Instalación manual en WebSphere Application Server Liberty para ver los detalles de configuración que son comunes a todos los servicios.

El archivo WAR para este componente se encuentra en mfp_install_dir/MobileFirstServer/mfp-dev-artifacts.war. Debe definir la raíz de contexto como /mfp-dev-artifacts.

Instalación manual en Apache Tomcat

Asegúrese de que cumpla los requisitos tal como se describe en Requisitos previos de Apache Tomcat.

Restricciones de topología

El servicio de administración de MobileFirst Server, el servicio de Live Update de MobileFirst Server y el tiempo de ejecución de MobileFirst deben estar instalados en el mismo servidor de aplicaciones. La raíz de contexto del servicio de Live Update debe estar definida como the-adminContextRootconfig. La raíz de contexto del servicio de envío por push debe ser imfpush. Para obtener más información acerca de las restricciones, consulte Restricciones en los componentes de MobileFirst Server y MobileFirst Analytics.

Valores del servidor de aplicaciones

Debe activar Valve de inicio de sesión único. Por ejemplo:

<Valve className="org.apache.catalina.authenticator.SingleSignOn"/>

Opcionalmente, es posible que desee activar el dominio de memoria si los usuarios están definidos en tomcat-users.xml. Por ejemplo:

<Realm className="org.apache.catalina.realm.MemoryRealm"/>

Detalles de la configuración

El servicio de administración está empaquetado como una aplicación WAR para desplegar en el servidor de aplicaciones. Necesita realizar algunas configuraciones específicas para esta aplicación en el archivo server.xml del servidor de aplicaciones.

Antes de continuar, consulte Instalación manual en Apache Tomcat para ver los detalles de configuración que son comunes a todos los servicios.

El archivo WAR del servicio de administración se encuentra en mfp_install_dir/MobileFirstServer/mfp-admin-service.war. Puede definir la raíz de contexto como desee. Sin embargo, normalmente es /mfpadmin.

Propiedades JNDI obligatorias

Las propiedades JNDI están definidas en el elemento Environment del contexto de aplicaciones. Por ejemplo:

<Environment name="mfp.admin.push.url" value="http://localhost:8080/imfpush" type="java.lang.String" override="false"/>

Para habilitar la comunicación de JMX con el tiempo de ejecución, defina las siguientes propiedades JNDI:

  • mfp.topology.platform
  • mfp.topology.clustermode

Si el servicio de envío por push está instalado, debe configurar las siguientes propiedades JNDI:

  • mfp.admin.push.url
  • mfp.admin.authorization.server.url
  • mfp.push.authorization.client.id
  • mfp.push.authorization.client.secret
  • mfp.admin.authorization.client.id
  • mfp.admin.authorization.client.secret

Las propiedades JNDI para la comunicación con el servicio de configuración son las siguientes:

  • mfp.config.service.user
  • mfp.config.service.password

Para obtener más información sobre las propiedades JNDI, consulte Lista de propiedades JNDI para el servicio de administración de MobileFirst Server.

Origen de datos

El origen de datos (jdbc/mfpAdminDS) se declara como un recurso en el elemento **Context**. Por ejemplo:

<Resource name="jdbc/mfpAdminDS" type="javax.sql.DataSource" .../>

Roles de seguridad

Los roles de seguridad disponibles para la aplicación del servicio de administración son:

  • mfpadmin
  • mfpdeployer
  • mfpmonitor
  • mfpoperator

El servicio de Live Update está empaquetado como una aplicación WAR para que la despliegue en el servidor de aplicaciones. Necesita realizar algunas configuraciones específicas para esta aplicación en el archivo server.xml.

Antes de continuar, consulte Instalación manual en Apache Tomcat para ver los detalles de configuración que son comunes a todos los servicios.

El archivo WAR del servicio de Live Update se encuentra en mfp_install_dir/MobileFirstServer/mfp-live-update.war. La raíz de contexto del servicio de Live Update debe definirse de esta forma: /the-adminContextRoot/config. Por ejemplo, si la raíz de contexto del servicio de administración es /mfpadmin, la raíz de contexto del servicio de Live Update debe ser /mfpadminconfig.

Origen de datos

El nombre JNDI del origen de datos para el servicio de Live Update debe estar definido como jdbc/ConfigDS. Declárelo como un recurso en el elemento Context.

Roles de seguridad

El rol de seguridad disponible para la aplicación de servicio de Live Update es configadmin.

Como mínimo un usuario debe estar correlacionado con este rol. El usuario y su contraseña deben estar proporcionados en las siguientes propiedades JNDI del servicio de administración:

  • mfp.config.service.user
  • mfp.config.service.password

La consola está empaquetada como una aplicación WAR para que la despliegue en el servidor de aplicaciones. Necesita realizar algunas configuraciones específicas para esta aplicación en el archivo server.xml del servidor de aplicaciones.

Antes de continuar, consulte Instalación manual en Apache Tomcat para ver los detalles de configuración que son comunes a todos los servicios.

El archivo WAR de la consola se encuentra en mfp_install_dir/MobileFirstServer/mfp-admin-ui.war. Puede definir la raíz de contexto como desee. Sin embargo, normalmente es /mfpconsole.

Propiedades JNDI obligatorias

Debe definir la propiedad mfp.admin.endpoint. El valor típico para esta propiedad es *://*:*/the-adminContextRoot.

Para obtener más información sobre las propiedades JNDI, consulte Propiedades JNDI para MobileFirst Operations Console.

Roles de seguridad

Los roles de seguridad disponibles para la aplicación son:

  • mfpadmin
  • mfpdeployer
  • mfpmonitor
  • mfpoperator

El tiempo de ejecución está empaquetado como una aplicación WAR para que la despliegue en el servidor de aplicaciones. Necesita realizar algunas configuraciones específicas para esta aplicación en el archivo server.xml.

Antes de continuar, consulte Instalación manual en Apache Tomcat para ver los detalles de configuración que son comunes a todos los servicios.

El archivo WAR de tiempo de ejecución se encuentra en mfp_install_dir/MobileFirstServer/mfp-server.war. Puede definir la raíz de contexto como desee. Sin embargo, es /mfp de forma predeterminada.

Propiedades JNDI obligatorias

Debe definir la propiedad mfp.authorization.server. Por ejemplo:

<Environment name="mfp.authorization.server" value="embedded" type="java.lang.String" override="false"/>

Para habilitar la comunicación de JMX con el servicio de administración, defina las siguientes propiedades JNDI:

  • mfp.topology.platform
  • mfp.topology.clustermode

Si MobileFirst Analytics está instalado, tiene que definir las siguientes propiedades JNDI:

  • mfp.analytics.url
  • mfp.analytics.console.url
  • mfp.analytics.username
  • mfp.analytics.password

Para obtener más información sobre las propiedades JNDI, consulte Lista de propiedades JNDI para el tiempo de ejecución de MobileFirst.

Origen de datos

El nombre JNDI del origen de datos para el tiempo de ejecución debe estar definido como jdbc/mfpDS. Declárelo como un recurso en el elemento Context.

El servicio de envío por push está empaquetado como una aplicación WAR para que la despliegue en el servidor de aplicaciones. Necesita realizar algunas configuraciones específicas para esta aplicación. Antes de continuar, consulte Instalación manual en Apache Tomcat para ver los detalles de configuración que son comunes a todos los servicios.

El archivo WAR del servicio de envío por push se encuentra en mfp_install_dir/PushService/mfp-push-service.war. Debe definir la raíz de contexto como /imfpush. De lo contrario, los dispositivos cliente no se podrán conectar a la misma, ya que la raíz de contexto está codificada en el SDK.

Propiedades JNDI obligatorias

Debe definir las propiedades siguientes:

  • mfp.push.authorization.server.url
  • mfp.push.authorization.client.id
  • mfp.push.authorization.client.secret
  • mfp.push.services.ext.security - el valor debe ser com.ibm.mfp.push.server.security.plugin.OAuthSecurityPlugin.
  • mfp.push.db.type - para una base de datos relacional, el valor debe ser DB.

Si se configura MobileFirst Analytics, defina las siguientes propiedades JNDI:

  • mfp.push.analytics.endpoint
  • mfp.analytics.username
  • mfp.analytics.password
  • mfp.push.services.ext.analytics - el valor debe ser com.ibm.mfp.push.server.analytics.plugin.AnalyticsPlugin.
Para obtener más información sobre las propiedades JNDI, consulte Lista de propiedades JNDI para el servicio de envío por push de MobileFirst Server.

El componente de artefactos está empaquetado como una aplicación WAR para que la despliegue en el servidor de aplicaciones. Necesita realizar algunas configuraciones específicas para esta aplicación en el archivo server.xml del servidor de aplicaciones. Antes de continuar, consulte Instalación manual en Apache Tomcat para ver los detalles de configuración que son comunes a todos los servicios.

El archivo WAR para este componente se encuentra en mfp_install_dir/MobileFirstServer/mfp-dev-artifacts.war. Debe definir la raíz de contexto como /mfp-dev-artifacts.

Instalación manual en WebSphere Application Server y WebSphere Application Server Network Deployment

Asegúrese de que cumpla los requisitos tal como se describe en Requisitos previos de WebSphere Application Server y WebSphere Application Server Network Deployment.

Restricciones de topología

En un WebSphere Application Server autónomo
El servicio de administración de MobileFirst Server, el servicio de Live Update de MobileFirst Server y el tiempo de ejecución de MobileFirst deben estar instalados en el mismo servidor de aplicaciones. La raíz de contexto del servicio de Live Update debe estar definida como the-adminContextRootConfig. La raíz de contexto del servicio de envío por push debe ser imfpush. Para obtener más información acerca de las restricciones, consulte Restricciones en los componentes de MobileFirst Server y MobileFirst Analytics.

En WebSphere Application Server Network Deployment
El gestor de despliegue debe estar en ejecución mientras MobileFirst Server se encuentra en ejecución. El gestor de despliegue se utiliza para la comunicación JMX entre el tiempo de ejecución y el servicio de administración. El servicio de administración y el servicio de Live Update deben estar instalados en el mismo servidor de aplicaciones. El tiempo de ejecución puede estar instalado en distintos servidores que el servicio de administración, pero debe estar en la misma célula.

Valores del servidor de aplicaciones

La seguridad administrativa y la seguridad de la aplicación deben estar habilitadas. Puede habilitar la seguridad de la aplicación en la consola de administración de WebSphere Application Server:

  1. Inicie sesión en la consola de administración de WebSphere Application Server.
  2. Pulse Seguridad → Seguridad global. Asegúrese de que esté seleccionado Habilitar seguridad administrativa.
  3. Además, asegúrese de que Habilitar seguridad de la aplicación esté seleccionado. La seguridad de la aplicación puede estar habilitada sólo si está habilitada la seguridad administrativa.
  4. Pulse Aceptar.
  5. Guarde los cambios.

Para obtener más información, consulte Habilitación de seguridad en la documentación de WebSphere Application Server.

La política de cargador de clases del servidor debe dar soporte a la delegación del último padre. Los archivos WAR de MobileFirst Server deben estar instalados con la modalidad del cargador de clases del último padre. Consulte la política de cargador de clases:

  1. Inicie sesión en la consola de administración de WebSphere Application Server.
  2. Pulse Servidores → Tipos de servidores → Servidores de aplicaciones de WebSphere, y pulse en el servidor que se utiliza para Mobile Foundation.
  3. Si la política de cargador de clases se establece en Varios, no haga nada.
  4. Si la política de cargador de clases se establece en Única y la modalidad de carga de clases se establece en Clases cargadas con cargador de clases local en primer lugar (último padre), no haga nada.
  5. Si la política de cargador de clases se establece en Única y la modalidad de carga de clases se establece en Clases cargadas con el cargador de clases padre en primer lugar (primer padre), cambie la política de cargador de clases a Varios. Además, establezca el orden de cargador de clases de todas las aplicaciones que no sean aplicaciones de MobileFirst Server en Clases cargadas con el cargador de clases padre en primer lugar (primer padre).

Cargador de clases

Para todas las aplicaciones de MobileFirst Server, el cargador de clases debe tener la delegación de último padre.

Para establecer la delegación del cargador de clases a último padre una vez que se instale una aplicación, siga estos pasos:

  1. Pulse el enlace Gestionar aplicaciones, o pulse Aplicaciones → Tipos de aplicaciones → Aplicaciones empresariales de WebSphere.
  2. Pulse la aplicación MobileFirst Server. De forma predeterminada, el nombre de la aplicación es el nombre del archivo WAR.
  3. En la sección Propiedades detalladas, pulse el enlace Carga de clase y detección de actualización.
  4. En el panel Orden de cargador de clases, seleccione la opción Clases cargadas con el cargador de clases locales en primer lugar (último padre).
  5. Pulse Aceptar.
  6. En la sección Módulos, pulse el enlace Gestionar módulos.
  7. Pulse el módulo.
  8. Para el campo Orden de cargador de clases, seleccione la opción Clases cargadas con el cargador de clases locales en primer lugar (último padre).
  9. Pulse Aceptar dos veces para confirmar la selección y volver al panel Configuración de la aplicación.
  10. Pulse Guardar para persistir los cambios.

Detalles de la configuración

El servicio de administración está empaquetado como una aplicación WAR para desplegar en el servidor de aplicaciones. Necesita realizar algunas configuraciones específicas para esta aplicación en el archivo server.xml del servidor de aplicaciones.

Antes de continuar, consulte Instalación manual en WebSphere Application Server y WebSphere Application Server Network Deployment para ver los detalles de configuración que son comunes a todos los servicios.

El archivo WAR del servicio de administración se encuentra en mfp_install_dir/MobileFirstServer/mfp-admin-service.war. Puede definir la raíz de contexto como desee. Sin embargo, normalmente es /mfpadmin.

Propiedades JNDI obligatorias

Puede establecer propiedades JNDI con la consola de administración de WebSphere Application Server. Vaya a Aplicaciones → Tipos de aplicaciones → Aplicaciones empresariales de WebSphere → nombre_aplicación → Entradas de entorno para módulos Web y establezca las entradas.

Para habilitar la comunicación de JMX con el tiempo de ejecución, defina las siguientes propiedades JNDI:

En WebSphere Application Server Network Deployment
  • mfp.admin.jmx.dmgr.host
  • mfp.admin.jmx.dmgr.port - el puerto SOAP en el gestor de despliegue.
  • mfp.topology.platform - establezca el valor como WAS.
  • mfp.topology.clustermode - establezca el valor como Clúster.
  • mfp.admin.jmx.connector - establezca el valor como SOAP.
En un WebSphere Application Server autónomo
  • mfp.topology.platform - establezca el valor como WAS.
  • mfp.topology.clustermode - establezca el valor como Autónomo.
  • mfp.admin.jmx.connector - establezca el valor como SOAP.

Si el servicio de envío por push está instalado, debe configurar las siguientes propiedades JNDI:

  • mfp.admin.push.url
  • mfp.admin.authorization.server.url
  • mfp.push.authorization.client.id
  • mfp.push.authorization.client.secret
  • mfp.admin.authorization.client.id
  • mfp.admin.authorization.client.secret

Las propiedades JNDI para la comunicación con el servicio de configuración son las siguientes:

  • mfp.config.service.user
  • mfp.config.service.password

Para obtener más información sobre las propiedades JNDI, consulte Lista de propiedades JNDI para el servicio de administración de MobileFirst Server.

Origen de datos

Cree un origen de datos para el servicio de administración y correlaciónelo con jdbc/mfpAdminDS.

Iniciar orden

La aplicación de servicio de administración debe iniciarse antes de la aplicación de ejecución. Puede establecer el orden en la sección Comportamiento de arranque. Por ejemplo, establezca el Orden de arranque en 1 para el servicio de administración y en 2 en el tiempo de ejecución.

Roles de seguridad

Los roles de seguridad disponibles para la aplicación del servicio de administración son:

  • mfpadmin
  • mfpdeployer
  • mfpmonitor
  • mfpoperator

El servicio de Live Update está empaquetado como una aplicación WAR para que la despliegue en el servidor de aplicaciones. Necesita realizar algunas configuraciones específicas para esta aplicación en el archivo server.xml.

Antes de continuar, consulte Instalación manual en WebSphere Application Server y WebSphere Application Server Network Deployment para ver los detalles de configuración que son comunes a todos los servicios.

El archivo WAR del servicio de Live Update se encuentra en mfp_install_dir/MobileFirstServer/mfp-live-update.war. La raíz de contexto del servicio de Live Update debe definirse de esta forma: /the-adminContextRoot/config. Por ejemplo, si la raíz de contexto del servicio de administración es /mfpadmin, la raíz de contexto del servicio de Live Update debe ser /mfpadminconfig.

Origen de datos

Cree un origen de datos para el servicio de Live Update y correlaciónelo con jdbc/ConfigDS.

Roles de seguridad

El rol configadmin está definido para esta aplicación.

Como mínimo un usuario debe estar correlacionado con este rol. El usuario y su contraseña deben estar proporcionados en las siguientes propiedades JNDI del servicio de administración:

  • mfp.config.service.user
  • mfp.config.service.password

La consola está empaquetada como una aplicación WAR para que la despliegue en el servidor de aplicaciones. Necesita realizar algunas configuraciones específicas para esta aplicación en el archivo server.xml del servidor de aplicaciones.

Antes de continuar, consulte Instalación manual en WebSphere Application Server y WebSphere Application Server Network Deployment para ver los detalles de configuración que son comunes a todos los servicios.

El archivo WAR de la consola se encuentra en mfp_install_dir/MobileFirstServer/mfp-admin-ui.war. Puede definir la raíz de contexto como desee. Sin embargo, normalmente es /mfpconsole.

Propiedades JNDI obligatorias

Puede establecer propiedades JNDI con la consola de administración de WebSphere Application Server. Vaya a las entradas Aplicaciones → Tipos de aplicaciones → Aplicaciones empresariales de WebSphere → nombre_aplicación → Entorno para módulos Web y establezca las entradas.

Debe definir la propiedad mfp.admin.endpoint. El valor típico para esta propiedad es *://*:*/the-adminContextRoot.

Para obtener más información sobre las propiedades JNDI, consulte Propiedades JNDI para MobileFirst Operations Console.

Roles de seguridad

Los roles de seguridad disponibles para la aplicación son:

  • mfpadmin
  • mfpdeployer
  • mfpmonitor
  • mfpoperator
Cualquier usuario que esté correlacionado con un rol de seguridad de la consola también debe estar correlacionado en el mismo rol de seguridad que el servicio de administración.

El tiempo de ejecución está empaquetado como una aplicación WAR para que la despliegue en el servidor de aplicaciones. Necesita realizar algunas configuraciones específicas para esta aplicación en el archivo server.xml.

Antes de continuar, consulte Instalación manual en WebSphere Application Server y WebSphere Application Server Network Deployment para ver los detalles de configuración que son comunes a todos los servicios.

El archivo WAR de tiempo de ejecución se encuentra en mfp_install_dir/MobileFirstServer/mfp-server.war. Puede definir la raíz de contexto como desee. Sin embargo, es /mfp de forma predeterminada.

Propiedades JNDI obligatorias

Puede establecer propiedades JNDI con la consola de administración de WebSphere Application Server. Vaya a las entradas Aplicaciones → Tipos de aplicaciones → Aplicaciones empresariales de WebSphere → nombre_aplicación → Entorno para módulos Web y establezca las entradas.

Debe definir la propiedad mfp.authorization.server con el valor como incorporado.
Además, defina las siguientes propiedades JNDI para habilitar la comunicación de JMX con el servicio de administración:

En WebSphere Application Server Network Deployment
  • mfp.admin.jmx.dmgr.host - el nombre de host del gestor de despliegue.
  • mfp.admin.jmx.dmgr.port - el puerto SOAP del gestor de despliegue.
  • mfp.topology.platform - establezca el valor como WAS.
  • mfp.topology.clustermode - establezca el valor como Clúster.
  • mfp.admin.jmx.connector - establezca el valor como SOAP.
En un WebSphere Application Server autónomo
  • mfp.topology.platform - establezca el valor como WAS.
  • mfp.topology.clustermode - establezca el valor como Autónomo.
  • mfp.admin.jmx.connector - establezca el valor como SOAP.

Si MobileFirst Analytics está instalado, tiene que definir las siguientes propiedades JNDI:

  • mfp.analytics.url
  • mfp.analytics.console.url
  • mfp.analytics.username
  • mfp.analytics.password

Para obtener más información sobre las propiedades JNDI, consulte Lista de propiedades JNDI para el tiempo de ejecución de MobileFirst.

Iniciar orden

La aplicación de ejecución debe iniciarse después de la aplicación del servicio de administración. Puede establecer el orden en la sección Comportamiento de arranque. Por ejemplo, establezca el Orden de arranque en 1 para el servicio de administración y en 2 en el tiempo de ejecución.

Origen de datos

Cree un origen de datos para el tiempo de ejecución y correlaciónelo con jdbc/mfpDS.

El servicio de envío por push está empaquetado como una aplicación WAR para que la despliegue en el servidor de aplicaciones. Necesita realizar algunas configuraciones específicas para esta aplicación. Antes de continuar, consulte Instalación manual en WebSphere Application Server y WebSphere Application Server Network Deployment para ver los detalles de configuración que son comunes a todos los servicios.

El archivo WAR del servicio de envío por push se encuentra en mfp_install_dir/PushService/mfp-push-service.war. Debe definir la raíz de contexto como /imfpush. De lo contrario, los dispositivos cliente no se podrán conectar a la misma, ya que la raíz de contexto está codificada en el SDK.

Propiedades JNDI obligatorias

Puede establecer propiedades JNDI con la consola de administración de WebSphere Application Server. Vaya a Aplicaciones > Tipos de aplicaciones → Aplicaciones empresariales de WebSphere → nombre_aplicación → Entradas de entorno para módulos Web y establezca las entradas.

Debe definir las propiedades siguientes:

  • mfp.push.authorization.server.url
  • mfp.push.authorization.client.id
  • mfp.push.authorization.client.secret
  • mfp.push.services.ext.security - el valor debe ser com.ibm.mfp.push.server.security.plugin.OAuthSecurityPlugin.
  • mfp.push.db.type - para una base de datos relacional, el valor debe ser DB.

Si se configura MobileFirst Analytics, defina las siguientes propiedades JNDI:

  • mfp.push.analytics.endpoint
  • mfp.analytics.username
  • mfp.analytics.password
  • mfp.push.services.ext.analytics - el valor debe ser com.ibm.mfp.push.server.analytics.plugin.AnalyticsPlugin.

Para obtener más información sobre las propiedades JNDI, consulte Lista de propiedades JNDI para el servicio de envío por push de MobileFirst Server.

Origen de datos

Cree el origen de datos para el servicio de envío por push y correlaciónelo con jdbc/imfPushDS.

El componente de artefactos está empaquetado como una aplicación WAR para que la despliegue en el servidor de aplicaciones. Necesita realizar algunas configuraciones específicas para esta aplicación en el archivo server.xml del servidor de aplicaciones. Antes de continuar, consulte Instalación manual en WebSphere Application Server y WebSphere Application Server Network Deployment para ver los detalles de configuración que son comunes a todos los servicios.

El archivo WAR para este componente se encuentra en mfp_install_dir/MobileFirstServer/mfp-dev-artifacts.war. Debe definir la raíz de contexto como /mfp-dev-artifacts.

Instalación una granja de servidores

Puede instalar la granja de servidores ejecutando tareas Ant, con la Herramienta de configuración del servidor, o manualmente.

Planificación de la configuración de una granja de servidores

Para planificar la configuración de una granja de servidores, seleccione el servidor de aplicaciones, configure las bases de datos de MobileFirst y despliegue los archivos WAR de los componentes de MobileFirst Server en cada servidor de la granja de servidores. Tiene las opciones de utilizar la Herramienta de configuración del servidor, las tareas Ant o las operaciones manuales para configurar una granja de servidores.

Cuando tenga la intención de planificar una instalación de granja de servidores, consulte Restricciones en el servicio de administración de MobileFirst Server, en el servicio de Live Update de MobileFirst Server y en el tiempo de ejecución de MobileFirst en primer lugar, y en particular consulte Topología de la granja de servidores.

En Mobile Foundation, una granja de servidores se compone de varios servidores de aplicaciones autónomos que no están federados ni administrados por un componente de gestión de un servidor de aplicaciones. MobileFirst Server proporciona internamente un plug-in de granja de servidores como medio para ampliar un servidor de aplicaciones para que pueda formar parte de una granja de servidores.

Cuándo declarar una granja de servidores

Declare una granja de servidores en los casos siguientes:

  • MobileFirst Server se instala en varios servidores de aplicaciones de Tomcat.
  • MobileFirst Server se instala en varios servidores de WebSphere Application Server pero no en WebSphere Application Server Network Deployment.
  • MobileFirst Server se instala en varios servidores de WebSphere Application Server Liberty.

No declare una granja de servidores en los casos siguientes:

  • El servidor de aplicaciones es autónomo.
  • Varios servidores de aplicaciones están federados por WebSphere Application Server Network Deployment.

Porqué es obligatorio declarar una granja de servidores

Cada vez que se realiza una operación de gestión a través de MobileFirst Operations Console o de la aplicación de servicio de administración de MobileFirst Server, la operación necesitará replicarse en todas las instancias de un entorno de ejecución. Algunos ejemplos de tales operaciones de gestión son la carga de una versión nueva de una aplicación o de un adaptador. La réplica se realiza mediante las llamadas de JMX realizadas por la instancia de la aplicación de servicio de administración que maneja la operación. El servicio de administración necesita ponerse en contacto con todas las instancias de ejecución del clúster. En entornos listados bajo Cuándo declarar una granja de servidores anterior, se puede poner en contacto con la ejecución mediante JMX sólo si se configura una granja de servidores. Si se añade un servidor a un clúster sin la configuración adecuada de la granja de servidores, la ejecución en dicho servidor estará en un estado incoherente después de cada operación de gestión, y hasta que se reinicie de nuevo.

Instalación de una granja de servidores con la Herramienta de configuración del servidor

Utilice la Herramienta de configuración del servidor para configurar cada servidor de la granja de servidores de acuerdo con los requisitos del tipo único de servidor de aplicaciones que se utilice para cada miembro de la granja de servidores.

Cuando planifique una granja de servidores con la Herramienta de configuración del servidor, cree en primer lugar los servidores autónomos y configure sus respectivos almacenes de confianza para que se puedan comunicar entre sí de una forma segura. A continuación, ejecute la herramienta que realiza las operaciones siguientes:

  • Configurar la instancia de base de datos que comparten los componentes de MobileFirst Server.
  • Desplegar los componentes de MobileFirst Server en cada servidor
  • Modificar su configuración para convertirla en un miembro de una granja de servidores

MobileFirst Server requiere que se configure la conexión JMX segura.

  1. Prepare los servidores de aplicaciones que se deben configurar como miembros de la granja de servidores.
    • Elija el tipo de servidor de aplicaciones que se utilizará para configurar los miembros de la granja de servidores. Mobile Foundation da soporte a los siguientes servidores de aplicaciones en granjas de servidores:
      • Perfil completo de WebSphere Application Server
        Nota: En una topología de granja de servidores, no puede utilizar el conector RMI JMX. En esta topología, sólo se da soporte al conector SOAP mediante Mobile Foundation.
      • Perfil de Liberty de WebSphere Application Server
      • Apache Tomcat
      Para saber qué versiones de los servidores de aplicaciones están soportadas, consulte Requisitos del sistema.
      Importante: Mobile Foundation sólo da soporte a granjas de servidores homogéneas. Una granja de servidores es homogénea cuando conecta el mismo tipo de servidores de aplicaciones. Intentar asociar distintos tipos de servidores de aplicaciones puede dar lugar a un comportamiento impredecible en el tiempo de ejecución. Por ejemplo, una granja de servidores con una mezcla de servidores de Apache Tomcat y servidores de perfil completo de WebSphere Application Server es una configuración no válida.
    • Configure tantos servidores autónomos como el número de miembros que desee en la granja de servidores.
    • Intercambie los certificados de firmante entre todos los servidores en sus respectivos almacenes de confianza.

      Este paso es obligatorio para las granjas de servidores que utilizan el perfil completo de WebSphere Application Server o deba habilitarse Liberty como seguridad. Además, para las granjas de servidores de Liberty, se debe replicar la misma configuración de LTPA en cada servidor para asegurar la funcionalidad de inicio de sesión único. Para llevar a cabo esta configuración, siga las directrices en el paso 6 de Configuración de una granja de servidores manualmente.
  2. Ejecute la Herramienta de configuración del servidor para cada servidor de la granja de servidores. Todos los servidores deben compartir las mismas bases de datos. Asegúrese de seleccionar el tipo de despliegue: Despliegue de granja de servidores en el panel Valores del servidor de aplicaciones. Para obtener más información sobre la herramienta, consulte Ejecución de la Herramienta de configuración del servidor.

Instalación de una granja de servidores con tareas Ant

Utilice las tareas Ant para configurar cada servidor de la granja de servidores según los requisitos del tipo único de servidor de aplicaciones que se utiliza para cada miembro de la granja de servidores.

Cuando planifique una granja de servidores con tareas Ant, cree en primer lugar los servidores autónomos y configure sus respectivos almacenes de confianza para que se puedan comunicar entre sí de forma segura. A continuación, ejecute las tareas Ant para configurar la instancia de base de datos que comparten los componentes de MobileFirst Server. Finalmente, ejecute tareas Ant para desplegar los componentes de MobileFirst Server en cada servidor y modificar su configuración para convertirla en miembro de una granja de servidores.

MobileFirst Server requiere que se configure la conexión JMX segura.

  1. Prepare los servidores de aplicaciones que se deben configurar como miembros de la granja de servidores.
    • Elija el tipo de servidor de aplicaciones que se utilizará para configurar los miembros de la granja de servidores. Mobile Foundation da soporte a los siguientes servidores de aplicaciones en granjas de servidores:
      • Perfil completo de WebSphere Application Server. Nota: En una topología de granja de servidores, no puede utilizar el conector RMI JMX. En esta topología, sólo se da soporte al conector SOAP mediante Mobile Foundation.
      • Perfil de Liberty de WebSphere Application Server
      • Apache Tomcat
      Para saber qué versiones de los servidores de aplicaciones están soportadas, consulte Requisitos del sistema.
      Importante: Mobile Foundation sólo da soporte a granjas de servidores homogéneas. Una granja de servidores es homogénea cuando conecta el mismo tipo de servidores de aplicaciones. Intentar asociar distintos tipos de servidores de aplicaciones puede dar lugar a un comportamiento impredecible en el tiempo de ejecución. Por ejemplo, una granja de servidores con una mezcla de servidores de Apache Tomcat y servidores de perfil completo de WebSphere Application Server es una configuración no válida.
    • Configure tantos servidores autónomos como el número de miembros que desee en la granja de servidores.

      Cada uno de estos servidores autónomos debe comunicarse con la misma base de datos. Debe asegurarse de que cualquier puerto que utilice cualquiera de estos servidores no lo utilice también otro servidor configurado en el mismo host. Esta restricción se aplica a los puertos utilizados por los protocolos HTTP, HTTPS, REST, SOAP y RMI.

      Cada uno de estos servidores debe tener el servicio de administración de MobileFirst Server, el servicio de Live Update de MobileFirst Server y uno o varios tiempos de ejecución de MobileFirst desplegados.

      Para obtener más información sobre cómo configurar un servidor, consulte Restricciones en el servicio de administración de MobileFirst Server, en el servicio de Live Update de MobileFirst Server y en el tiempo de ejecución de MobileFirst.
    • Intercambie los certificados de firmante entre todos los servidores en sus respectivos almacenes de confianza.

      Este paso es obligatorio para las granjas de servidores que utilizan el perfil completo de WebSphere Application Server o deba habilitarse Liberty como seguridad. Además, para las granjas de servidores de Liberty, se debe replicar la misma configuración de LTPA en cada servidor para asegurar la funcionalidad de inicio de sesión único. Para llevar a cabo esta configuración, siga las directrices en el paso 6 de Configuración de una granja de servidores manualmente.
  2. Configure la base de datos para el servicio de administración, el servicio de Live Update y el tiempo de ejecución.
    • Decida la base de datos que desee utilizar y elija el archivo Ant para crear y configurar la base de datos en el directorio de mfp_install_dir/MobileFirstServer/configuration-samples:
      • Para DB2, utilice create-database-db2.xml.
      • Para MySQL, utilice create-database-mysql.xml.
      • Para Oracle, utilice create-database-oracle.xml.
      Nota: No utilice la base de datos Derby en una topología de granja de servidores porque la base de datos Derby sólo permite una única conexión al mismo tiempo.
    • Edite el archivo Ant y escriba todas las propiedades necesarias para la base de datos.

      Para habilitar la configuración de la base de datos que utilizan los componentes de MobileFirst Server, establezca los valores de las siguientes propiedades:
      • Establezca mfp.process.admin en true. Para configurar la base de datos para el servicio de administración y el servicio de Live Update.
      • Establezca mfp.process.runtime en true. Para configurar la base de datos para el tiempo de ejecución.
    • Ejecute los mandatos siguientes desde el directorio dir_instal_mfp/MobileFirstServer/configuration-samples donde create-database-ant-file.xml se debe sustituir por el nombre de archivo Ant real que elija: dir_instal_mfp/shortcuts/ant -f create-database-ant-file.xml admdatabases y dir_instal_mfp/shortcuts/ant -f create-database-ant-file.xml rtmdatabases.

      Puesto que las bases de datos de MobileFirst Server se comparten entre los servidores de aplicaciones de una granja de servidores, estos dos mandatos se deben ejecutar sólo una vez, sea cual sea el número de servidores de la granja de servidores.
    • Opcionalmente, si desea instalar otro tiempo de ejecución, debe configurar otra base de datos con otro nombre o esquema de base de datos. Para hacerlo, edite el archivo Ant, modifique las propiedades y ejecute el mandato siguiente una vez, sea cual sea el número de servidores de la granja de servidores: dir_instal_mfp/shortcuts/ant -f create-database-ant-file.xml rtmdatabases.
  3. Despliegue el servicio de administración, el servicio de Live Update y el tiempo de ejecución en los servidores y configure estos servidores como miembros de una granja de servidores.
    • Elija el archivo Ant que se corresponda con su servidor de aplicaciones y su base de datos en el directorio mfp\_install\_dir/MobileFirstServer/configuration-samples para desplegar el servicio de administración, el servicio de Live Update y el tiempo de ejecución en los servidores.

      Por ejemplo, elija el archivo configure-liberty-db2.xml para un despliegue en el servidor de Liberty con la base de datos de DB2. Realice tantas copias de este archivo como el número de miembros que desee en la granja de servidores.

      Nota: Conserve estos archivos después de la configuración, ya que se pueden volver a utilizar para actualizar los componentes de MobileFirst Server que ya se han desplegado, o para desinstalarlos de cada miembro de la granja de servidores.
    • Edite cada copia del archivo Ant, especifique las mismas propiedades para la base de datos que se utilizan en el paso 2, y escriba también el resto de las propiedades necesarias para el servidor de aplicaciones.

      Para configurar el servidor como un miembro de la granja de servidores, establezca los valores de las siguientes propiedades:
      • Establezca mfp.farm.configure en true.
      • mfp.farm.server.id: Un identificador que defina para este miembro de la granja de servidores. Asegúrese de que cada servidor de la granja de servidores tenga su propio identificador exclusivo. Si dos servidores de la granja de servidores tienen el mismo identificador, la granja de servidores podría comportarse de un modo imprevisible.
      • mfp.config.service.user: El nombre de usuario que se utiliza para acceder al servicio de Live Update. El nombre de usuario debe ser el mismo para todos los miembros de la granja de servidores.
      • mfp.config.service.password: La contraseña que se utiliza para acceder al servicio de Live Update. La contraseña debe ser la misma para todos los miembros de la granja de servidores.
      Para habilitar el despliegue de los archivos WAR de los componentes de MobileFirst Server en el servidor, establezca los valores de las propiedades siguientes:
      • Establezca mfp.process.admin en true. Para desplegar los archivos WAR del servicio de administración y del servicio de Live Update.
      • Establezca mfp.process.runtime en true. Para desplegar el archivo WAR del tiempo de ejecución.

      Nota: Si tiene la intención de instalar más de un tiempo de ejecución en los servidores de la granja de servidores, especifique el ID de atributo y establezca un valor que debe ser exclusivo para cada tiempo de ejecución en installmobilefirstruntime, updatemobilefirstruntime y en las tareas Ant uninstallmobilefirstruntime.
      Por ejemplo,
      <target name="rtminstall">
          <installmobilefirstruntime execute="true" contextroot="/runtime1" id="rtm1">
    • Para cada servidor, ejecute los siguientes mandatos, donde configure-appserver-database-ant-file.xml se debe sustituir por el nombre de archivo Ant real que haya elegido: dir_instal_mfp/shortcuts/ant -f configure-appserver-database-ant-file.xml adminstall y dir_instal_mfp/shortcuts/ant -f configure-appserver-database-ant-file.xml rtminstall.

      Estos mandatos ejecutan installmobilefirstadmin y las tareas Ant de installmobilefirstruntime. Para obtener más información sobre estas tareas, consulte Tareas Ant para la instalación de MobileFirst Operations Console, los artefactos de MobileFirst Server, la administración de MobileFirst Server y los servicios de Live Update y Tareas Ant para la instalación de entornos de ejecución de MobileFirst.
    • Opcionalmente, si desea instalar otro tiempo de ejecución, lleve a cabo los pasos siguientes:
      • Haga una copia del archivo Ant que ha configurado en el paso 3.b.
      • Edite la copia, establezca una raíz de contexto distinta y un valor para el id de atributo de installmobilefirstruntime, updatemobilefirstruntime y uninstallmobilefirstruntime que sea distinto de la otra configuración de tiempo de ejecución.
      • Ejecute el siguiente mandato en cada servidor de la granja de servidores donde configure-appserver-database-ant-file2.xml se debe sustituir por el nombre real del archivo Ant que está editado: dir_instal_mfp/shortcuts/ant -f configure-appserver-database-ant-file2.xml rtminstall.
      • Repita este paso para cada servidor de la granja de servidores.
  4. Reinicie todos los servidores.

Configuración de una granja de servidores manualmente

Debe configurar cada servidor de la granja de servidores según los requisitos del tipo único de servidor de aplicaciones que utiliza cada miembro de la granja de servidores.

Cuando planifique una granja de servidores, cree en primer lugar servidores autónomos que se comuniquen con la misma instancia de base de datos. A continuación, modifique la configuración de estos servidores para convertirlos en miembros de una granja de servidores.

  1. Elija el tipo de servidor de aplicaciones que se utilizará para configurar los miembros de la granja de servidores. Mobile Foundation da soporte a los siguientes servidores de aplicaciones en granjas de servidores:
    • Perfil completo de WebSphere Application Server
      Nota: En una topología de granja de servidores, no puede utilizar el conector RMI JMX. En esta topología, sólo se da soporte al conector SOAP mediante Mobile Foundation.
    • Perfil de Liberty de WebSphere Application Server
    • Apache Tomcat
    Para saber qué versiones de los servidores de aplicaciones están soportadas, consulte Requisitos del sistema.
    Importante: Mobile Foundation sólo da soporte a granjas de servidores homogéneas. Una granja de servidores es homogénea cuando conecta el mismo tipo de servidores de aplicaciones. Intentar asociar distintos tipos de servidores de aplicaciones puede dar lugar a un comportamiento impredecible en el tiempo de ejecución. Por ejemplo, una granja de servidores con una mezcla de servidores de Apache Tomcat y servidores de perfil completo de WebSphere Application Server es una configuración no válida.
  2. Decida qué base de datos desea utilizar. Puede elegir entre:
    • DB2
    • MySQL
    • Oracle
    Las bases de datos de MobileFirst Server se comparten entre los servidores de aplicaciones de una granja de servidores, lo que significa:
    • Ha creado la base de datos sólo una vez, sea cual sea el número de servidores de la granja de servidores.
    • No puede utilizar la base de datos Derby en una topología de granja de servidores porque la base de datos Derby sólo permite una única conexión a la vez.
    Para obtener más información acerca de las bases de datos, consulte Configuración de bases de datos.
  3. Configure tantos servidores autónomos como el número de miembros que desee en la granja de servidores.
    • Cada uno de estos servidores autónomos debe comunicarse con la misma base de datos. Debe asegurarse de que cualquier puerto que utilice cualquiera de estos servidores no lo utilice también otro servidor configurado en el mismo host. Esta restricción se aplica a los puertos utilizados por los protocolos HTTP, HTTPS, REST, SOAP y RMI.
    • Cada uno de estos servidores debe tener el servicio de administración de MobileFirst Server, el servicio de Live Update de MobileFirst Server y uno o varios tiempos de ejecución de MobileFirst desplegados.
    • Cuando cada uno de estos servidores esté funcionando correctamente en una topología autónoma, puede transformarlos en miembros de una granja de servidores.
  4. Detenga todos los servidores que estén pensados para que pasen a ser miembros de la granja de servidores.
  5. Configure cada servidor correctamente para el tipo de servidor de aplicaciones.
    Debe establecer algunas propiedades JNDI correctamente. En una topología de granja de servidores, las propiedades JNDI mfp.config.service.user y mfp.config.service.password deben tener el mismo valor para todos los miembros de la granja de servidores. Para Apache Tomcat, también debe comprobar que los argumentos JVM estén correctamente definidos.
    • Perfil de Liberty de WebSphere Application Server
      En el archivo server.xml, establezca las propiedades JNDI tal como se muestran en el siguiente código de ejemplo.
      <jndiEntry jndiName="mfp.topology.clustermode" value="Farm"/>
      <jndiEntry jndiName="mfp.admin.serverid" value="farm_member_1"/>
      <jndiEntry jndiName="mfp.admin.jmx.user" value="myRESTConnectorUser"/>
      <jndiEntry jndiName="mfp.admin.jmx.pwd" value="password-of-rest-connector-user"/>
      <jndiEntry jndiName="mfp.admin.jmx.host" value="93.12.0.12"/>
      <jndiEntry jndiName="mfp.admin.jmx.port" value="9443"/>
      Estas propiedades deben establecerse con valores adecuados:
      • mfp.admin.serverid: El identificador que ha definido para este miembro de la granja de servidores. Este identificador debe ser exclusivo en todos los miembros de la granja de servidores.
      • mfp.admin.jmx.user y mfp.admin.jmx.pwd: Estos valores deben coincidir con las credenciales de un usuario, tal como está declarado en el elemento administrator-role.
      • mfp.admin.jmx.host: Establezca este parámetro en el IP o en el nombre de host que utilicen miembros remotos para acceder a este servidor. Por lo tanto, no lo establezca en localhost. Este nombre de host lo utilizan otros miembros de la granja de servidores y debe estar accesible para todos los miembros de la granja de servidores.
      • mfp.admin.jmx.port: Establezca este parámetro en el puerto HTTPS del servidor que se utiliza para la conexión JMX REST. Puede encontrar el valor en el elemento httpEndpoint del archivo server.xml.
    • Apache Tomcat
      Modifique el archivo conf/server.xml para establecer las siguientes propiedades JNDI en el contexto del servicio de administración y en cada contexto de tiempo de ejecución.
      <Environment name="mfp.topology.clustermode" value="Farm" type="java.lang.String" override="false"/>
      <Environment name="mfp.admin.serverid" value="farm_member_1" type="java.lang.String" override="false"/>
      La propiedad mfp.admin.serverid se debe establecer en el identificador definido para este miembro de la granja de servidores. Este identificador debe ser exclusivo en todos los miembros de la granja de servidores.
      Debe asegurarse de que el argumento JVM -Djava.rmi.server.hostname esté establecido en el IP o en el nombre de host utilizado por los miembros remotos para acceder a este servidor. Por lo tanto, no lo establezca en localhost. Además, debe asegurarse de que el argumento JVM -Dcom.sun.management.jmxremote.port se establezca con un puerto que aún no esté en uso para habilitar las conexiones JMX RMI. Ambos argumentos se establecen en la variable de entorno CATALINA_OPTS.
    • Perfil completo de WebSphere Application Server
      Debe declarar las siguientes propiedades JNDI en el servicio de administración y en cada aplicación de ejecución desplegada en el servidor.
      • mfp.topology.clustermode
      • mfp.admin.serverid
      En la consola de WebSphere Application Server,
      • seleccione Aplicaciones → Tipos de aplicaciones → Aplicaciones empresariales de WebSphere.
      • Seleccione la aplicación del servicio de administración.
      • En Propiedades de módulo web, pulse Entradas de entorno para módulos web para visualizar las propiedades de JNDI.
      • Establezca los valores de las siguientes propiedades.
        • Establezca mfp.topology.clustermode en Farm.
        • Establezca mfp.admin.serverid en el identificador que ha elegido para este miembro de la granja de servidores. Este identificador debe ser exclusivo en todos los miembros de la granja de servidores.
        • Establezca mfp.admin.jmx.user en un nombre de usuario que tenga acceso al conector SOAP.
        • Establezca mfp.admin.jmx.pwd en la contraseña del usuario, tal como se declara en mfp.admin.jmx.user.
        • Establezca mfp.admin.jmx.port en el valor del puerto SOAP.
      • Verifique que mfp.admin.jmx.connector esté establecido en SOAP.
      • Pulse Aceptar y guarde la configuración.
      • Realice cambios similares para cada aplicación de ejecución de MobileFirst desplegada en el servidor.
  6. Intercambie los certificados de servidor en sus almacenes de confianza entre todos los miembros de la granja de servidores. Intercambiar los certificados de servidor en sus almacenes de confianza es obligatorio para granjas de servidores que utilizan el perfil completo de WebSphere Application Server y el perfil de WebSphere Application Server Liberty ya que, en estos conjuntos de servidores, las comunicaciones entre los servidores están protegidas por SSL.
    • Perfil de Liberty de WebSphere Application Server
      Puede configurar el almacén de confianza mediante programas de utilidad de IBM como Keytool o iKeyman.
      • Para obtener más información sobre Keytool, consulte Keytool en IBM SDK, Java Technology Edition.
      • Para obtener más información sobre iKeyman, consulte iKeyman en IBM SDK, Java Technology Edition.
      Las ubicaciones del almacén de claves y del almacén de confianza están definidas en el archivo server.xml. Consulte los atributos keyStoreRef y trustStoreRef en Atributos de configuración de SSL. De forma predeterminada, el almacén de claves del perfil de Liberty se encuentra en ${server.config.dir}/resources/security/key.jks. Si falta la referencia del almacén de confianza o no está definida en el archivo server.xml, se utilizará el almacén de claves especificado por keyStoreRef. El servidor utiliza el almacén de claves predeterminado y el archivo se creará la primera vez que se ejecute el servidor. En tal caso, se creará un certificado predeterminado con un periodo de validez de 365 días. Para producción, es posible que considere la posibilidad de utilizar su propio certificado (incluidos los intermedios, si es necesario) o de cambiar la fecha de caducidad del certificado generado.
      Nota: Si desea confirmar la ubicación del almacén de confianza, puede hacerlo añadiendo la siguiente declaración al archivo server.xml:
      <logging traceSpecification="SSL=all:SSLChannel=all"/>
      Por último, inicie el servidor y busque las líneas que contienen com.ibm.ssl.trustStore en el archivo ${wlp.install.dir}/usr/servers/server_name/logs/trace.log.
      • Importe los certificados públicos del resto de servidores de la granja de servidores en el almacén de confianza al que se hace referencia mediante el archivo de configuración server.xml del servidor. La guía de aprendizaje Instalación de MobileFirst Server en modalidad gráfica proporciona las instrucciones para intercambiar los certificados entre dos servidores de Liberty de una granja de servidores. Para obtener más información, consulte el paso 5 de la sección Creación de una granja de servidores de dos servidores de Liberty que ejecutan MobileFirst Server.
      • Reinicie cada instancia del perfil de WebSphere Application Server Liberty para que surta efecto la configuración de seguridad. Los pasos siguientes son necesarios para que funcione el inicio de sesión único (SSO).
      • Inicie un miembro de la granja de servidores. En la configuración de LTPA predeterminada, una vez que el servidor de Liberty se inicie correctamente, generará un almacén de claves de LTPA como ${wlp.user.dir}/servers/server_name/resources/security/ltpa.keys.
      • Copie el archivo ltpa.keys al directorio ${wlp.user.dir}/servers/server_name/resources/security de cada miembro de la granja de servidores para replicar los almacenes de claves de LTPA entre los miembros de la granja de servidores. Para obtener más información sobre la configuración de LTPA, consulte Configuración de LTPA en el perfil de Liberty.
    • Perfil completo de WebSphere Application Server
      Configure el almacén de confianza en la consola de administración de WebSphere Application Server.
      • Inicie sesión en la consola de administración de WebSphere Application Server.
      • Seleccione Seguridad → Certificado SSL y gestión de claves.
      • En Elementos relacionados, seleccione Almacenes de claves y certificados.
      • En el campo Usos del almacén de claves, asegúrese de que Almacenes de claves de SSL esté seleccionado. Ahora puede importar los certificados desde el resto de los servidores de la granja de servidores.
      • Pulse NodeDefaultTrustStore.
      • En Propiedades adicionales, seleccione Certificados de firmante.
      • Pulse Recuperar de puerto. Ahora puede especificar la comunicación y los detalles de seguridad de cada uno del resto de los servidores de la granja de servidores. Siga los pasos siguientes para cada uno del resto de los miembros de la granja de servidores.
      • En el campo Host, especifique el nombre de host de servidor o la dirección IP.
      • En el campo Puerto, especifique el puerto de transporte de HTTPS (SSL).
      • En Configuración de SSL para la conexión saliente, seleccione NodeDefaultSSLSettings.
      • En el campo Alias, especifique un alias para este certificado de firmante.
      • Pulse Recuperar información de firmante.
      • Revise la información recuperada del servidor remoto y, a continuación, pulse Aceptar.
      • Pulse Guardar.
      • Reinicie el servidor.

Verificación de una configuración en una granja de servidores

La finalidad de esta tarea es comprobar el estado de los miembros de la granja de servidores y verificar si una granja de servidores está configurado correctamente.

  1. Inicie todos los servidores de la granja de servidores.
  2. Acceda a MobileFirst Operations Console. Por ejemplo, http://server_name:port/mfpconsole, o https://hostname:secure_port/mfpconsole en HTTPS. En la barra lateral de la consola, aparecerá un menú adicional etiquetado como Nodos de la granja de servidores.
  3. Pulse Nodos de la granja de servidores para acceder a la lista de miembros de la granja de servidores registrados y a su estado. En el ejemplo siguiente, el nodo identificado como FarmMember2 se considera que está inactivo, lo que indica que este servidor probablemente ha fallado y requiere un poco de mantenimiento.

Estado de nodos de granja de servidores en MobileFirst Operations Console

Ciclo de vida de un nodo de granja de servidores

Puede configurar la tasa de latido y los valores de tiempo de espera para indicar posibles problemas del servidor entre miembros de la granja de servidores desencadenando un cambio en el estado de un nodo afectado.

Registro y supervisión de servidores como nodos de la granja de servidores

Cuando se haya iniciado un servidor configurado como un nodo de granja de servidores, el servicio de administración de dicho servidor lo registra automáticamente como un nuevo miembro de la granja de servidores. Cuando se cierra un miembro de la granja de servidores, se elimina automáticamente de la granja de servidores.

Existe un mecanismo de latido para realizar el seguimiento de los miembros de la granja de servidores que puede que se queden sin responder, por ejemplo, debido a un corte de electricidad o a un fallo del servidor. En este mecanismo de latido, los tiempos de ejecución de MobileFirst envían periódicamente un latido a los servicios de administración de MobileFirst a una velocidad especificada. Si el servicio de administración de MobileFirst registra que ha pasado demasiado tiempo desde que un miembro de la granja de servidores haya enviado un latido, se considerará que el miembro de la granja de servidores está desactivado.

Los miembros de la granja de servidores que se consideran como desactivados no sirven ninguna solicitud más a aplicaciones móviles.

Tener uno o varios nodos no impide que el resto de los miembros de la granja de servidores sirvan solicitudes correctamente a aplicaciones móviles ni que acepten nuevas operaciones de gestión desencadenadas mediante la MobileFirst Operations Console.

Configuración de la tasa de latido y de los valores de tiempo de espera

Puede configurar la tasa de latido y los valores de tiempo de espera definiendo las siguientes propiedades JNDI:

  • mfp.admin.farm.heartbeat
  • mfp.admin.farm.missed.heartbeats.timeout


Para obtener más información sobre propiedades JNDI, consulte Lista de propiedades JNDI para el servicio de administración de MobileFirst Server.

Last modified on July 17, 2018