Administración de aplicaciones a través de Ant
improve this page | report issueVisión general
Administre las aplicaciones de MobileFirst a través de la tarea Ant mfpadm.
Ir a
Comparación con otros recursos
Puede ejecutar operaciones de administración con IBM Mobile Foundation de las siguientes maneras:
- MobileFirst Operations Console, que es interactivo.
- Tareas Ant de mfpadm.
- El programa mfpadm.
- Los servicios REST de administración de MobileFirst.
Las tareas Ant de mfpadm, el programa mfpadm y los servicios REST son útiles para realizar operaciones de ejecución automatizada o sin supervisión como, por ejemplo:
- Eliminación de errores de operador en las operaciones repetitivas, o
- Operaciones fuera de las horas normales de trabajo de los operadores, o
- Configuración de un servidor de producción con los mismos valores que los de un servidor de prueba o previo a la producción.
Las tareas Ant de mfpadm y el programa mfpadm son más fáciles de utilizar e informan mejor sobre los errores que los servicios REST. La ventaja de las tareas Ant de mfpadm sobre el programa mfpadm es que son independientes de la plataforma y más fáciles de integrar cuando la integración de Ant ya está disponible.
Requisitos previos
La herramienta mfpadm se instala con el instalador de MobileFirst Server. En el resto de esta página dir_instalación_producto indica el directorio de instalación del instalador de MobileFirst Server.
Para ejecutar las tareas de mfpadm se necesita Apache Ant. Para obtener información sobre la versión mínima soportada de Ant, consulte los Requisitos del sistema.
Como ayuda, Apache Ant 1.9.4 se incluye en MobileFirst Server. Se proporcionan los siguientes scripts en el directorio dir_instalación_producto/shortcuts/.
- ant para UNIX / Linux
- ant.bat para Windows
Estos scripts están listos para ser ejecutados, lo que significa que no precisan de variables de entorno específicas. Si se ha establecido la variable de entorno JAVA_HOME, el script la acepta.
Puede utilizar las tareas Ant de mfpadm en un sistema diferente del sistema en que MobileFirst Server está instalado.
- Copie el archivo dir_instalación_producto/MobileFirstServer/mfp-ant-deployer.jar al sistema.
- Asegúrese de que en el sistema hay instalada una versión soportada de Apache Ant y un entorno de tiempo de ejecución de Java.
Para utilizar las tareas Ant de mfpadm, añada este mandato de inicialización al script Ant:
<taskdef resource="com/ibm/mfp/ant/deployers/antlib.xml">
<classpath>
<pathelement location="product_install_dir/MobileFirstServer/mfp-ant-deployer.jar"/>
</classpath>
</taskdef>
Otros mandatos de inicialización que hacen referencia al mismo archivo mfp-ant-deployer.jar son redundantes porque la inicialización mediante defaults.properties es realizada por antlib.xml de forma implícita. A continuación se muestra un ejemplo de un mandato de inicialización redundante:
<taskdef resource="com/ibm/mfp/ant/defaults.properties">
<classpath>
<pathelement location="product_install_dir/MobileFirstServer/mfp-ant-deployer.jar"/>
</classpath>
</taskdef>
Para obtener más información sobre cómo ejecutar el instalador de MobileFirst Server, consulte Ejecución de IBM Installation Manager.
Ir a
- Llamada a tareas Ant de mfpadm
- Mandatos para la configuración general
- Mandatos para los adaptadores
- Mandatos para las aplicaciones
- Mandatos para los dispositivos
- Mandatos para la resolución de problemas
Llamada a una tarea Ant de mfpadm
Utilice las tareas Ant de mfpadm y sus mandatos asociados para administrar las aplicaciones de MobileFirst. Llame a las tareas Ant de mfpadm de la siguiente manera:
<mfpadm url=... user=... password=...|passwordfile=... [secure=...]>
algunos mandatos
</mfpadm>
Atributos
Las tareas Ant de mfpadm tienen los siguientes atributos:
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
url | URL base de la aplicación web de MobileFirst para los servicios de administración | Sí | |
secure | Evitar operaciones con riesgos de seguridad | No | verdadero |
user | Nombre de usuario para acceder a los servicios de administración de MobileFirst | Sí | |
password | Contraseña del usuario. | Se necesita una | |
passwordfile | Archivo que contiene la contraseña para el usuario | Se necesita una | |
timeout | Tiempo de espera para todo el acceso al servicio REST, en segundos | No | |
connectTimeout | Tiempo de espera para establecer una conexión de red, en segundos | No | |
socketTimeout | Tiempo de espera para detectar la pérdida de una conexión de red, en segundos | No | |
connectionRequestTimeout | Tiempo de espera para obtener una entrada de una agrupación de solicitudes de conexión, en segundos | No | |
lockTimeout | Tiempo de espera para adquirir un bloqueo | No |
url
El URL base preferentemente utiliza el protocolo HTTPS. Por ejemplo, si utiliza las raíces de contexto y los puertos predeterminados, utilice el siguiente URL.
- Para WebSphere Application Server: https://server:9443/worklightadmin
- Para Tomcat: https://server:8443/worklightadmin
secure
El valor predeterminado es true. Si establece secure=”false” podría ocurrir lo siguiente:
- El usuario y la contraseña se podrían transmitir de forma no segura, posiblemente a través de tráfico HTTP sin cifrar.
- Los certificados SSL del servidor se aceptarán incluso si están autofirmados o si se crearon para un nombre de host diferente al nombre de host del servidor especificado.
password
Especifique la contraseña en el script Ant, a través del atributo password o en el archivo aparte que pasará a través del atributo passwordfile. La contraseña es información confidencial y, por lo tanto, debe estar protegida. Debe impedir que otros usuarios en el mismo sistema sepan esta contraseña. Para proteger la contraseña, antes de especificarla en un archivo, elimine los permisos de lectura del archivo a otros usuarios que no sean usted mismo. Por ejemplo, puede utilizar uno de los siguientes mandatos:
- En UNIX:
chmod 600 adminpassword.txt
- En Windows:
cacls adminpassword.txt /P Administrators:F %USERDOMAIN%\%USERNAME%:F
Además, es posible que desee enmascarar la contraseña para ocultarla de cualquier visualización accidental. Para ello, utilice el mandato mfpadm config password para almacenar la contraseña enmascarada en un archivo de configuración. A continuación, puede copiar y pegar el contraseña enmascarada en el script de Ant o en el archivo de contraseña.
La llamada mfpadm contiene mandatos que se codifican como elementos internos. Estos mandatos se ejecutan en el orden en el que aparecen listados. Si uno de los mandatos falla, el resto de los mandatos no se ejecutan y la llamada mfpadm falla.
Elementos
Utilice los siguientes elementos en llamadas de mfpadm:
Elemento | Descripción | Número |
---|---|---|
show-info | Muestra información de configuración y de usuario | 0..∞ |
show-global-config | Muestra información de configuración global | 0..∞ |
show-diagnostics | Muestra información de diagnósticos | 0..∞ |
show-versions | Muestra información de versiones | 0..∞ |
unlock | Libera el bloqueo de propósito general | 0..∞ |
list-runtimes | Lista los tiempos de ejecución | 0..∞ |
show-runtime | Muestra información sobre un tiempo de ejecución | 0..∞ |
delete-runtime | Suprime un tiempo de ejecución | 0..∞ |
show-user-config | Muestra la configuración de usuario de un tiempo de ejecución | 0..∞ |
set-user-config | Especifica la configuración de usuario de un tiempo de ejecución | 0..∞ |
show-confidential-clients | Muestra las configuraciones de clientes confidenciales de un tiempo de ejecución | 0..∞ |
set-confidential-clients | Especifica las configuraciones de clientes confidenciales de un tiempo de ejecución | 0..∞ |
set-confidential-clients-rule | Especifica una regla para la configuración de clientes confidenciales de un tiempo de ejecución | 0..∞ |
list-adapters | Lista los adaptadores | 0..∞ |
deploy-adapter | Despliega un adaptador | 0..∞ |
show-adapter | Muestra información sobre un adaptador | 0..∞ |
delete-adapter | Suprime un adaptador | 0..∞ |
adapter | Otras operaciones en un adaptador | 0..∞ |
list-apps | Lista las aplicaciones | 0..∞ |
deploy-app | Despliega una aplicación | 0..∞ |
show-app | Muestra información sobre una aplicación | 0..∞ |
delete-app | Suprime una aplicación | 0..∞ |
show-app-version | Muestra información sobre una versión de aplicación | 0..∞ |
delete-app-version | Suprime una versión de una aplicación | 0..∞ |
app | Otras operaciones en una aplicación | 0..∞ |
app-version | Otras operaciones en una versión de aplicación | 0..∞ |
list-devices | Lista los dispositivos | 0..∞ |
remove-device | Elimina un dispositivo. | 0..∞ |
device | Otras operaciones para un dispositivo | 0..∞ |
list-farm-members | Lista los miembros de la granja de servidores | 0..∞ |
remove-farm-member | Elimina un miembro de la granja de servidores | 0..∞ |
Formato XML
La salida de la mayoría de los mandatos es en XML, y la entrada para mandatos específicos, como por ejemplo <set-accessrule>
también es en XML. Puede encontrar los esquemas XML de estos formatos XML en el directorio dir_instalación_producto/MobileFirstServer/mfpadm-schemas/. Los mandatos que reciben una respuesta XML del servidor verifican que dicha respuesta cumpla el esquema especifico. Puede inhabilitar esta comprobación especificando el atributo xmlvalidation=”none”.
Conjunto de caracteres de salida
La salida normal de las tareas Ant de mfpadm se codifica en el entorno local actual. En Windows, este formato de codificación es el denominado el de la “página de códigos ANSI”. Los resultados son los siguientes:
- Los caracteres fuera de este conjunto de caracteres se convierten en interrogantes de cierre en la salida.
- Cuando la salida se dirige a una ventana de un indicador de mandatos de Windows (cmd.exe), los caracteres no ASCII se visualizan de forma incorrecta porque en estas ventanas se presupone que los caracteres están codificados de acuerdo a la denominada “página de códigos OEM”.
Para solucionar esta limitación:
- En sistemas operativos distintos de Windows, utilice un entorno local cuya codificación sea UTF-8. Este entorno local es el entorno local predeterminado en Red Hat Linux y macOS. Muchos sistemas operativos tienen el entorno local en_US.UTF-8.
- O bien utilice el atributo output=”un nombre de archivo” para redirigir la salida de un mandato mfpadm a un archivo.
Mandatos para la configuración general
Cuando llama a una tarea Ant de mfpadm, puede incluir varios mandatos para acceder a la configuración global de IBM MobileFirst Server o de un tiempo de ejecución.
Mandato show-global-config
El mandato show-global-config
muestra la configuración global. Tiene los siguientes atributos:
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
output | Nombre del archivo de salida. | No | No aplicable |
outputproperty | Nombre de la propiedad Ant para la salida. | No | No aplicable |
Ejemplo
<show-global-config/>
Este mandato se basa en el servicio REST Global Configuration (GET)
Mandato show-user-config
El mandato show-user-config
, fuera de los elementos <adapter>
y
<app-version>
, muestra la configuración de usuario de un tiempo de ejecución. Tiene los siguientes atributos:
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
runtime | Nombre de tiempo de ejecución. | Sí | No disponible |
format | Especifica el formato de salida. json o xml. | Sí | No disponible |
output | Nombre del archivo en el que almacenar la salida. | No | No aplicable |
outputproperty | Nombre de un propiedad Ant en la que almacenar la salida. | No | No aplicable |
Ejemplo
<show-user-config runtime="mfp" format="xml"/>
Este mandato se basa en el servicio REST Runtime Configuration (GET).
Mandato set-user-config
El mandato set-user-config
, fuera de los elementos <adapter>
y
<app-version>
, especifica la configuración de usuario de un tiempo de ejecución. Tiene los siguientes atributos para configurar toda la configuración.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
runtime | Nombre de tiempo de ejecución. | Sí | No disponible |
file | Nombre del archivo XML o JSON que contiene la nueva configuración. | Sí | No disponible |
El mandato set-user-config
tiene los atributos siguientes para establecer una propiedad individual en la configuración.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
runtime | Nombre de tiempo de ejecución. | Sí | No disponible |
property | Nombre de la propiedad JSON. Para una propiedad anidada, utilice la sintaxis prop1.prop2…..propN. Para un elemento de matriz JSON, utilice el índice en lugar de un nombre de propiedad. | Sí | No disponible |
value | Valor de la propiedad. | Sí | No disponible |
Ejemplo
<set-user-config runtime="mfp" file="myconfig.json"/>
<set-user-config runtime="mfp" property="timeout" value="240"/>
Este mandato se basa en el servicio REST Runtime configuration (PUT).
Mandato show-confidential-clients
El mandato show-confidential-clients
muestra la configuración de los clientes confidenciales que pueden acceder a un tiempo de ejecución. Para obtener más información sobre los clientes confidenciales, consulte Clientes confidenciales. Este mandato tiene los siguientes atributos:
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
runtime | Nombre de tiempo de ejecución. | Sí | No disponible |
format | Especifica el formato de salida. json o xml. | Sí | No disponible |
output | Nombre del archivo en el que almacenar la salida. | No | No aplicable |
outputproperty | Nombre de un propiedad Ant en la que almacenar la salida. | No | No aplicable |
Ejemplo
<show-confidential-clients runtime="mfp" format="xml" output="clients.xml"/>
Este mandato se basa en el servicio REST Confidential Clients (GET).
Mandato set-confidential-clients
El mandato set-confidential-clients
especifica la configuración de los clientes confidenciales que pueden acceder a un tiempo de ejecución. Para obtener más información sobre los clientes confidenciales, consulte Clientes confidenciales. Este mandato tiene los siguientes atributos:
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
runtime | Nombre de tiempo de ejecución. | Sí | No disponible |
file | Nombre del archivo XML o JSON que contiene la nueva configuración. | Sí | No disponible |
Ejemplo
<set-confidential-clients runtime="mfp" file="clients.xml"/>
Este mandato se basa en el servicio REST Confidential Clients (PUT).
Mandato set-confidential-clients-rule
El mandato set-confidential-clients-rule
especifica una regla en la configuración de los clientes confidenciales que pueden acceder a un tiempo de ejecución. Para obtener más información sobre los clientes confidenciales, consulte Clientes confidenciales. Este mandato tiene los siguientes atributos:
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
runtime | Nombre de tiempo de ejecución. | Sí | No disponible |
id | El identificador de la regla. | Sí | No disponible |
displayName | El nombre de visualización de la regla. | Sí | No disponible |
secret | Secreto de la regla. | Sí | No disponible |
allowedScope | Ámbito de la regla. Lista de señales separadas por espacios. | Sí | No disponible |
Ejemplo
<set-confidential-clients-rule runtime="mfp" id="push" displayName="Push" secret="lOa74Wxs" allowedScope="**"/>
Este mandato se basa en el servicio REST Confidential Clients (PUT).
Mandatos para adaptadores
Cuando llama a una tarea Ant de mfpadm, puede incluir varios mandatos para los adaptadores.
Mandato list-adapters
El mandato list-adapters
devuelve una lista de adaptadores desplegados para un tiempo de ejecución dado. Tiene los siguientes atributos.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
runtime | Nombre de tiempo de ejecución. | Sí | No disponible |
output | Nombre del archivo de salida. | No | No aplicable |
outputproperty | Nombre de la propiedad Ant para la salida. | No | No aplicable |
Ejemplo
<list-adapters runtime="mfp"/>
Este mandato se basa en el servicio REST Adapters (GET).
Mandato deploy-adapter
El mandato deploy-adapter
despliega un adaptador en un tiempo de ejecución. Tiene los siguientes atributos.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
runtime | Nombre de tiempo de ejecución. | Sí | No disponible |
file | Archivo de adaptador binario (.adapter). | Sí | No disponible |
Ejemplo
<deploy-adapter runtime="mfp" file="MyAdapter.adapter"/>
Este mandato se basa en el servicio REST Adapter (POST).
Mandato show-adapter
El mandato show-adapter
muestra detalles sobre un adaptador. Tiene los siguientes atributos.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
runtime | Nombre de tiempo de ejecución. | Sí | No disponible |
nombre | Nombre de un adaptador. | Sí | No disponible |
output | Nombre del archivo de salida. | No | No aplicable |
outputproperty | Nombre de la propiedad Ant para la salida. | No | No aplicable |
Ejemplo
<show-adapter runtime="mfp" name="MyAdapter"/>
Este mandato se basa en el servicio REST Adapter (GET).
Mandato delete-adapter
El mandato delete-adapter
elimina (retira el despliegue) de un adaptador de un tiempo de ejecución. Tiene los siguientes atributos.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
runtime | Nombre de tiempo de ejecución. | Sí | No disponible |
nombre | Nombre de un adaptador. | Sí | No disponible |
Ejemplo
<delete-adapter runtime="mfp" name="MyAdapter"/>
Este mandato se basa en el servicio REST Adapter (DELETE).
Grupo de mandatos adapter
El grupo de mandatos adapter
tiene los siguientes atributos.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
runtime | Nombre de tiempo de ejecución. | Sí | No disponible |
nombre | Nombre de un adaptador. | Sí | No disponible |
El mandato adapter
da soporte a los siguientes elementos.
Elemento | Descripción | Número |
---|---|---|
get-binary | Obtiene los datos binarios. | 0..∞ |
show-user-config | Muestra la configuración de usuario. | 0..∞ |
set-user-config | Especifica la configuración de usuario. | 0..∞ |
Mandato get-binary
El mandato get-binary
en un elemento <adapter>
devuelve el archivo de adaptador binario. Tiene los siguientes atributos.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
tofile | Nombre del archivo de salida. | Sí | No disponible |
Ejemplo
<adapter runtime="mfp" name="MyAdapter">
<get-binary tofile="/tmp/MyAdapter.adapter"/>
</adapter>
Este mandato se basa en el servicio REST Adapter (GET).
Mandato show-user-config
El mandato show-user-config
en un elemento <adapter>
, muestra la configuración de usuario del adaptador. Tiene los siguientes atributos.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
format | Especifica el formato de salida. json o xml. | Sí | No disponible |
output | Nombre del archivo en el que almacenar la salida. | No | No aplicable |
outputproperty | Nombre de un propiedad Ant en la que almacenar la salida. | No | No aplicable |
Ejemplo
<adapter runtime="mfp" name="MyAdapter">
<show-user-config format="xml"/>
</adapter>
Este mandato se basa en el servicio REST Adapter Configuration (GET).
Mandato set-user-config
El mandato set-user-config
, en un elemento <adapter>
, especifica la configuración de usuario del adaptador. Tiene los siguientes atributos para configurar toda la configuración.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
file | Nombre del archivo XML o JSON que contiene la nueva configuración. | Sí | No disponible |
El mandato tiene los atributos siguientes para establecer una propiedad individual en la configuración.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
property | Nombre de la propiedad JSON. Para una propiedad anidada, utilice la sintaxis prop1.prop2…..propN. Para un elemento de matriz JSON, utilice el índice en lugar de un nombre de propiedad. | Sí | No disponible |
value | Valor de la propiedad. | Sí | No disponible |
Ejemplos
<adapter runtime="mfp" name="MyAdapter">
<set-user-config file="myconfig.json"/>
</adapter>
<adapter runtime="mfp" name="MyAdapter">
<set-user-config property="timeout" value="240"/>
</adapter>
Este mandato se basa en el servicio REST Application Configuration (PUT)
Mandatos para aplicaciones
Cuando llama a una tarea Ant de mfpadm, puede incluir varios mandatos para las aplicaciones.
Mandato list-apps
El mandato list-apps
devuelve una lista de aplicaciones desplegadas en un tiempo de ejecución. Tiene los siguientes atributos.
Atributo | Descripción | Obligatorio | Predeterminado | |
---|---|---|---|---|
runtime | Nombre de tiempo de ejecución. | Sí | No disponible | |
output | Nombre del archivo de salida. | No | No aplicable | |
outputproperty | Nombre de la propiedad Ant para la salida. | No | No aplicable |
Ejemplo
<list-apps runtime="mfp"/>
Este mandato se basa en el servicio REST Applications (GET).
Mandato deploy-app
El mandato deploy-app
despliega una versión de aplicación en un tiempo de ejecución. Tiene los siguientes atributos.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
runtime | Nombre de tiempo de ejecución. | Sí | No disponible |
file | Descriptor de la aplicación, un archivo JSON. | Sí | No disponible |
Ejemplo
<deploy-app runtime="mfp" file="MyApp/application-descriptor.json"/>
Este mandato se basa en el servicio REST Application (POST).
Mandato show-app
El mandato show-app
devuelve una lista de versiones de aplicación desplegadas en un tiempo de ejecución. Tiene los siguientes atributos.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
runtime | Nombre de tiempo de ejecución. | Sí | No disponible |
nombre | Nombre de una aplicación. | Sí | No disponible |
output | Nombre del archivo de salida. | No | No aplicable |
outputproperty | Nombre de la propiedad Ant para la salida. | No | No aplicable |
Ejemplo
<show-app runtime="mfp" name="MyApp"/>
Este mandato se basa en el servicio REST Application (GET).
Mandato delete-app
El mandato delete-app
elimina (retira el despliegue) una aplicación, con todas sus versiones de aplicación, de todos los entornos en los que fue desplegada, de un tiempo de ejecución. Tiene los siguientes atributos.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
runtime | Nombre de tiempo de ejecución. | Sí | No disponible |
nombre | Nombre de una aplicación. | Sí | No disponible |
Ejemplo
<delete-app runtime="mfp" name="MyApp"/>
Este mandato se basa en el servicio REST Application Version (DELETE).
Mandato show-app-version
El mandato show-app-version
muestra detalles sobre una versión de aplicación en un tiempo de ejecución. Tiene los siguientes atributos.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
runtime | Nombre de tiempo de ejecución. | Sí | No disponible |
name | Nombre de la aplicación. | Sí | No disponible |
environment | Plataforma móvil. | Sí | No disponible |
version | Número de versión de la aplicación. | Sí | No disponible |
Ejemplo
<show-app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1"/>
Este mandato se basa en el servicio REST Application Version (GET).
Mandato delete-app-version
El mandato delete-app-version
elimina (retira el despliegue) una aplicación de un tiempo de ejecución. Tiene los siguientes atributos.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
runtime | Nombre de tiempo de ejecución. | Sí | No disponible |
name | Nombre de la aplicación. | Sí | No disponible |
environment | Plataforma móvil. | Sí | No disponible |
version | Número de versión de la aplicación. | Sí | No disponible |
Ejemplo
<delete-app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1"/>
Este mandato se basa en el servicio REST Application Version (DELETE).
Grupo de mandatos app
El grupo de mandatos app
tiene los siguientes atributos.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
runtime | Nombre de tiempo de ejecución. | Sí | No disponible |
name | Nombre de la aplicación. | Sí | No disponible |
El grupo de mandatos app da soporte a los siguientes elementos.
Elemento | Descripción | Número |
---|---|---|
show-license-config | Muestra la configuración de licencia de señal. | 0.. |
set-license-config | Especifica la configuración de licencia de señal. | 0.. |
delete-license-config | Elimina la configuración de licencia de señal. | 0.. |
Mandato show-license-config
El mandato show-license-config
muestra la configuración de licencia de señal de una aplicación. Tiene los siguientes atributos.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
output | Nombre de un archivo en el que almacenar la salida. | Sí | No disponible |
outputproperty | Nombre de un propiedad Ant en la que almacenar la salida. | Sí | No disponible |
Ejemplo
<app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1">
<show-license-config output="/tmp/MyApp-license.xml"/>
</app-version>
Este mandato se basa en el servicio REST Application (GET).
Mandato set-license-config
El mandato set-license-config
especifica la configuración de licencia de señal de una aplicación. Tiene los siguientes atributos.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
appType | Tipo de aplicación: B2C o B2E | Sí | No disponible |
licenseType | Tipo de aplicación: APPLICATION o ADDITIONAL_BRAND_DEPLOYMENT o NON_PRODUCTION. | Sí | No disponible |
Ejemplo
<app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1">
<set-license-config appType="B2E" licenseType="APPLICATION"/>
</app-version>
Este mandato se basa en el servicio REST Application License Configuration (POST)
Mandato delete-license-config
El mandato delete-license-config
restablece la configuración de licencia de señal de una aplicación, esto es, la devuelve a su estado inicial.
Ejemplo
<app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1">
<delete-license-config/>
</app-version>
Este mandato se basa en el servicio REST License configuration (DELETE).
Grupo de mandatos app-version
El grupo de mandatos app-version
tiene los siguientes atributos.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
runtime | Nombre de tiempo de ejecución. | Sí | No disponible |
nombre | Nombre de una aplicación. | Sí | No disponible |
environment | Plataforma móvil. | Sí | No disponible |
version | Versión de la aplicación. | Sí | No disponible |
El mandato app-version
da soporte a los siguientes elementos:
Elemento | Descripción | Número |
---|---|---|
get-descriptor | Obtiene el descriptor. | 0.. |
get-web-resources | Obtiene los recursos web. | 0.. |
set-web-resources | Especifica los recursos web. | 0.. |
get-authenticity-data | Obtiene los datos de autenticidad. | 0.. |
set-authenticity-data | Especifica los datos de autenticidad. | 0.. |
delete-authenticity-data | Suprime los datos de autenticidad. | 0.. |
show-user-config | Muestra la configuración de usuario. | 0.. |
set-user-config | Especifica la configuración de usuario. | 0.. |
Mandato get-descriptor
El mandato get-descriptor
, en un elemento <app-version>
, devuelve el descriptor de aplicación de una versión de una aplicación. Tiene los siguientes atributos.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
output | Nombre de un archivo en el que almacenar la salida. | No | No aplicable |
outputproperty | Nombre de un propiedad Ant en la que almacenar la salida. | No | No aplicable |
Ejemplo
<app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1">
<get-descriptor output="/tmp/MyApp-application-descriptor.json"/>
</app-version>
Este mandato se basa en el servicio Application Descriptor (GET).
Mandato get-web-resources
El mandato get-web-resources
, en un elemento <app-version>
, devuelve los recursos web de una versión de una aplicación como un archivo .zip. Tiene los siguientes atributos.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
tofile | Nombre del archivo de salida. | Sí | No disponible |
Ejemplo
<app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1">
<get-web-resources tofile="/tmp/MyApp-web.zip"/>
</app-version>
Este mandato se basa en el servicio REST Retrieve Web Resource (GET).
Mandato set-web-resources
El mandato set-web-resources
, en un elemento <app-version>
, especifica los recursos web para una versión de una aplicación. Tiene los siguientes atributos.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
file | Nombre del archivo de entrada (debe ser un archivo .zip). | Sí | No disponible |
Ejemplo
<app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1">
<set-web-resources file="/tmp/MyApp-web.zip"/>
</app-version>
Este mandato se basa en el servicio REST Deploy a web resource (POST).
Mandato get-authenticity-data
El mandato get-authenticity-data
, en un elemento <app-version>
, devuelve los datos autenticidad de una versión de una aplicación. Tiene los siguientes atributos.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
output | Nombre de un archivo en el que almacenar la salida. | No | No aplicable |
outputproperty | Nombre de un propiedad Ant en la que almacenar la salida. | No | No aplicable |
Ejemplo
<app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1">
<get-authenticity-data output="/tmp/MyApp.authenticity_data"/>
</app-version>
Este mandato se basa en el servicio REST Export runtime resources (GET).
Mandato set-authenticity-data
El mandato set-authenticity-data
, en un elemento <app-version>
, especifica los datos de autenticidad de una versión de una aplicación. Tiene los siguientes atributos.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
file | Nombre del archivo de entrada:<ul><li>Un archivo de datos de autenticidad,</li><li>Un archivo de dispositivo (archivo .ipa, .apk o .appx), a partir del que se extraen los datos de autenticidad.</li></ul> | Sí | No disponible |
Ejemplos
<app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1">
<set-authenticity-data file="/tmp/MyApp.authenticity_data"/>
</app-version>
<app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1">
<set-authenticity-data file="MyApp.ipa"/>
</app-version>
<app-version runtime="mfp" name="MyApp" environment="android" version="1.1">
<set-authenticity-data file="MyApp.apk"/>
</app-version>
Este mandato se basa en el servicio REST Deploy Application Authenticity Data (POST).
Mandato delete-authenticity-data
El mandato delete-authenticity-data
, en un elemento <app-version>
, suprime los datos de autenticidad de una versión de una aplicación. No tiene atributos.
Ejemplo
<app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1">
<delete-authenticity-data/>
</app-version>
Este mandato se basa en el servicio REST Application Authenticity (DELETE).
Mandato show-user-config
El mandato show-user-config
, en un elemento <app-version>
, muestra la configuración de usuario de una versión de una aplicación. Tiene los siguientes atributos.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
format | Especifica el formato de salida. json o xml. | Sí | No disponible |
output | Nombre del archivo de salida. | No | No aplicable |
outputproperty | Nombre de la propiedad Ant para la salida. | No | No aplicable |
Ejemplos
<app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1">
<show-user-config format="json" output="/tmp/MyApp-config.json"/>
</app-version>
<app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1">
<show-user-config format="xml" output="/tmp/MyApp-config.xml"/>
</app-version>
Este mandato se basa en el servicio REST Application Configuration (GET).
Mandato set-user-config
El mandato set-user-config
, en un elemento <app-version>
, especifica la configuración de usuario de una versión de una aplicación. Tiene los siguientes atributos para configurar toda la configuración.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
file | Nombre del archivo XML o JSON que contiene la nueva configuración. | Sí | No disponible |
El mandato set-user-config
tiene los atributos siguientes para establecer una propiedad individual en la configuración.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
property | Nombre de la propiedad JSON. Para una propiedad anidada, utilice la sintaxis prop1.prop2…..propN. Para un elemento de matriz JSON, utilice el índice en lugar de un nombre de propiedad. | Sí | No disponible |
value | Valor de la propiedad. | Sí | No disponible |
Ejemplos
<app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1">
<set-user-config file="/tmp/MyApp-config.json"/>
</app-version>
<app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1">
<set-user-config property="timeout" value="240"/>
</app-version>
Mandatos para dispositivos
Cuando llama a una tarea Ant de mfpadm, puede incluir varios mandatos para los dispositivos.
Mandato list-devices
El mandato list-devices
devuelve una lista de dispositivos que se han puesto en contacto con las aplicaciones de un tiempo de ejecución. Tiene los siguientes atributos:
Atributo | Descripción | Obligatorio | Predeterminado | |
---|---|---|---|---|
runtime | Nombre de tiempo de ejecución. | Sí | No disponible | |
query | Nombre descriptivo o identificador de usuario que buscar. Este parámetro especifica una serie que buscar. Todos los dispositivos que tienen un nombre descriptivo o identificador de usuario que lo contiene. | Se devuelve una serie (con coincidencia insensible a las mayúsculas y minúsculas). | No | No aplicable |
output | Nombre del archivo de salida. | No | No aplicable | |
outputproperty | Nombre de la propiedad Ant para la salida. | No | No aplicable |
Ejemplos
<list-devices runtime="mfp"/>
<list-devices runtime="mfp" query="john"/>
Este mandato se basa en el servicio REST Devices (GET).
Mandato remove-device
El mandato remove-device
borra el registro sobre un dispositivo que contactó las aplicaciones de un tiempo de ejecución. Tiene los siguientes atributos:
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
runtime | Nombre de tiempo de ejecución. | Sí | No disponible |
id | Identificador de dispositivo exclusivo. | Sí | No disponible |
Ejemplo
<remove-device runtime="mfp" id="496E974CCEDE86791CF9A8EF2E5145B6"/>
Este mandato se basa en el servicio REST Device (DELETE).
Grupo de mandatos device
El grupo de mandatos device
tiene los siguientes atributos.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
runtime | Nombre de tiempo de ejecución. | Sí | No disponible |
id | Identificador de dispositivo exclusivo. | Sí | No disponible |
El mandato device
da soporte a los siguientes elementos.
Elemento | Descripción | Número |
---|---|---|
set-status | Cambio de estado. | 0..∞ |
set-appstatus | Cambio de estado para una aplicación. | 0..∞ |
Mandato set-status
El mandato set-status
cambia el estado de un dispositivo, en el ámbito de un tiempo de ejecución. Tiene los siguientes atributos:
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
status | Nuevo estado. | Sí | No disponible |
El estado puede tener uno de los siguientes valores:
- ACTIVE
- LOST
- STOLEN
- EXPIRED
- DISABLED
Ejemplo
<device runtime="mfp" id="496E974CCEDE86791CF9A8EF2E5145B6">
<set-status status="EXPIRED"/>
</device>
Este mandato se basa en el servicio REST Device Status (PUT).
Mandato set-appstatus
El mandato set-appstatus
cambia el estado de un dispositivo, en relación a una aplicación en un tiempo de ejecución. Tiene los siguientes atributos:
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
app | Nombre de una aplicación. | Sí | No disponible |
status | Nuevo estado. | Sí | No disponible |
El estado puede tener uno de los siguientes valores:
- ENABLED
- DISABLED
Ejemplo
<device runtime="mfp" id="496E974CCEDE86791CF9A8EF2E5145B6">
<set-appstatus app="MyApp" status="DISABLED"/>
</device>
Este mandato se basa en el servicio REST Device Application Status (PUT).
Mandatos para la resolución de problemas
Los mandatos de tareas de Ant también sirven para investigar problemas con las aplicaciones web de MobileFirst Server.
Mandato show-info
El mandato show-info
muestra información básica sobre los servicios de administración de MobileFirst que se pueden devolver sin acceder a un tiempo de ejecución ni a una base de datos. Utilice esta mandato para verificar si los servicios de administración de MobileFirst están en ejecución. Tiene los siguientes atributos:
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
output | Nombre del archivo de salida. | No | No aplicable |
outputproperty | Nombre de la propiedad Ant para la salida. | No | No aplicable |
Ejemplo
<show-info/>
Mandato show-versions
El mandato show-versions
visualiza versiones de MobileFirst de varios componentes:
- mfpadmVersion: Número de versión de MobileFirst Server exacto del que se toma el archivo mfp-ant-deployer.jar.
- productVersion: Número de versión de MobileFirst Server exacto que se toma del archivo mfp-admin-service.war.
- mfpAdminVersion: Número de versión de construcción exacto de sólo mfp-admin-service.war.
El mandato tiene los siguientes atributos:
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
output | Nombre del archivo de salida. | No | No aplicable |
outputproperty | Nombre de la propiedad Ant para la salida. | No | No aplicable |
Ejemplo
<show-versions/>
Mandato show-diagnostics
El mandato show-diagnostics
muestra el estado de varios componentes que son necesarios para el correcto funcionamiento del servicio de administración de MobileFirst como, por ejemplo, la disponibilidad de la base de datos y de los servicios auxiliares. Este mandato tiene los siguientes atributos.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
output | Nombre del archivo de salida. | No | No aplicable |
outputproperty | Nombre de la propiedad Ant para la salida. | No | No aplicable |
Ejemplo
<show-diagnostics/>
Mandato unlock
El mandato unlock
libera el bloqueo de propósito general. Algunas operaciones destructivas toman este bloqueo con el propósito de impedir una modificación de forma simultánea de los mismos datos de configuración. En casos poco habituales, si se interrumpe una operación de este tipo, el bloqueo permanece en estado bloqueado, haciendo imposibles otras operaciones destructivas. Utilice el mandato unlock para liberar el bloqueo en estos casos. Este mandato no tiene atributos.
Ejemplo
<unlock/>
Mandato list-runtimes
El mandato list-runtimes
devuelve una lista de tiempos de ejecución desplegados. Tiene los siguientes atributos:
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
runtime | Nombre de tiempo de ejecución. | Sí | No disponible |
output | Nombre del archivo de salida. | No | No aplicable |
outputproperty | Nombre de la propiedad Ant para la salida. | No | No aplicable |
Ejemplos
<list-runtimes/>
<list-runtimes inDatabase="true"/>
Este mandato se basa en el servicio REST Runtimes (GET).
Mandato show-runtime
El mandato show-runtime
muestra información sobre un tiempo de ejecución desplegado dado. Tiene los siguientes atributos:
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
runtime | Nombre de tiempo de ejecución. | Sí | No disponible |
output | Nombre del archivo de salida. | No | No aplicable |
outputproperty | Nombre de la propiedad Ant para la salida. | No | No aplicable |
Ejemplo
<show-runtime runtime="mfp"/>
Este mandato se basa en el servicio REST Runtime (GET).
Mandato delete-runtime
El mandato delete-runtime
suprime el tiempo de ejecución, incluidas sus aplicaciones y adaptadores, de la base de datos. Únicamente puede suprimir un tiempo de ejecución cuando se hayan detenido sus aplicaciones web. El mandato tiene los siguientes atributos.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
runtime | Nombre de tiempo de ejecución. | Sí | No disponible |
condition | Condición cuando lo suprime: empty o always. Atención: La opción always es peligrosa. | No | No aplicable |
Ejemplo
<delete-runtime runtime="mfp" condition="empty"/>
Este mandato se basa en el servicio REST Runtime (DELETE).
Mandato list-farm-members
El mandato list-farm-members
muestra una lista de servidores de miembro de granja en los que se ha desplegado un tiempo de ejecución dado. Tiene los siguientes atributos:
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
runtime | Nombre de tiempo de ejecución. | Sí | No disponible |
output | Nombre del archivo de salida. | No | No aplicable |
outputproperty | Nombre de la propiedad Ant para la salida. | No | No aplicable |
Ejemplo
<list-farm-members runtime="mfp"/>
Este mandato se basa en el servicio REST Farm topology members (GET).
Mandato remove-farm-member
El mandato remove-farm-member
elimina un servidor de la lista de miembros de granja en los que se ha desplegado un tiempo de ejecución dado. Utilice este mandato cuando el servidor no esté disponible o se haya desconectado. El mandato tiene los siguientes atributos.
Atributo | Descripción | Obligatorio | Predeterminado |
---|---|---|---|
runtime | Nombre de tiempo de ejecución. | Sí | No disponible |
serverId | Identificador del servidor. | Sí | No aplicable |
force | Forzar la eliminación de un miembro de granja, incluso cuando no está disponible o está desconectado. | No | falso |
Ejemplo
<remove-farm-member runtime="mfp" serverId="srvlx15"/>
Este mandato se basa en el servicio REST Farm topology members (DELETE).
▲Inclusive terminology note: The Mobile First Platform team is making changes to support the IBM® initiative to replace racially biased and other discriminatory language in our code and content with more inclusive language. While IBM values the use of inclusive language, terms that are outside of IBM's direct influence are sometimes required for the sake of maintaining user understanding. As other industry leaders join IBM in embracing the use of inclusive language, IBM will continue to update the documentation to reflect those changes.