Instalación de MobileFirst Server en un servidor de aplicaciones

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. En una configuración JMX con SSL habilitado, añada las opciones siguientes:

   -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.

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 su instalación de Liberty, escriba el mandato siguiente:

                      
  liberty_install_dir/bin/productInfo featureInfo

  Nota: Verifique que la salida de este mandato contiene restConnector-1.0.

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.

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 y 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.

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

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"/>

• 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.

• 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.

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.

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

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"/>

• 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.

• 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.

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.

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.

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.

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:

• 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.

• 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

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:

• 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.

• 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.

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.
     
     

     Nota: Este paso es obligatorio para las granjas que utilizan el perfil completo de WebSphere Application Server o se debe habilitar 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 esta configuración, siga las directrices del 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.

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.
     
     

     Nota: Este paso es obligatorio para las granjas que utilizan el perfil completo de WebSphere Application Server o se debe habilitar 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.
     For example,

     <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.

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 se deben establecer con los 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 que ha definido para este miembro de granja. 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, añada la declaración siguiente 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).
     • Intercambie los certificados de firmante entre todos los servidores en sus respectivos almacenes de confianza.
       
       

       Nota: Este paso es obligatorio para las granjas que utilizan el perfil completo de WebSphere Application Server o se debe habilitar 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 realizar esta configuración, siga los pasos siguientes.

     • 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.