Administración de aplicaciones a través de Terminal

improve this page | report issue

Visión general

Puede administrar aplicaciones MobileFirst a través del programa mfpadm.

Las versiones del IBM Mobile Foundation SDK posteriores a la versión 8.0.0.0-MFPF-IF201701250919 tienen un soporte de autenticidad de aplicación actualizado, con mandatos mfpadm para conmutar entre una validación dinámica y otra estática (también es posible restablecerla).

Vaya hasta el directorio de instalación de IBM Mobile Foundation /MobilefirstPlatformServer/shortcuts y ejecute los mandatos mfpadm.

1.Para conmutar entre tipos de validación:

	mfpadm --url=  --user=  --passwordfile= --secure=false app version [RUNTIME] [APPNAME] [ENVIRONMENT] [VERSION] set authenticity-validation TYPE

El valor para TYPE puede ser static o dynamic

Ejemplo para android: Aquí se establecerá TYPE en la validación dynamic.

  mfpadm --url=http://localhost:8080/mfpadmin --user=admin --passwordfile="C:\userhome\mfppassword\MFP_password.txt" --secure=false app version mfp test android 1.0 set authenticity-validation dynamic

2.Para restablecer los datos utilizando el siguiente mandato que borra la huella de la aplicación.

  mfpadm --url=  --user=  --passwordfile= --secure=false app version [RUNTIME] [APPNAME] [ENVIRONMENT] [VERSION] reset authenticity

Ejemplo:

  mfpadm --url=http://localhost:8080/mfpadmin --user=admin --passwordfile="C:\userhome\mfppassword\MFP_password.txt" --secure=false app version mfp sample.com.pincodeandroid android 1.0 reset authenticity

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, como en los siguientes casos:

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

El programa mfpadm y las tareas Ant de mfpadm son más fáciles de utilizar e informan mejor sobre los errores que los servicios REST. La ventaja del programa mfpadm sobre las tareas Ant de mfpadm es que son más fáciles de integrar cuando la integración con los mandatos del sistema operativo ya está presente. Además, es más adecuado para una utilización interactiva.

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.

El mandato mfpadm se proporciona en el directorio dir_instalacion_producto/shortcuts/ como un conjunto de scripts:

  • mfpadm para UNIX / Linux
  • mfpadm.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.
Para utilizar el programa mfpadm, añada el directorio dir_instalacion_producto/shortcuts/ a su variable de entorno PATH, o haga referencia al nombre absoluto del archivo en cada llamada.

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 al programa mfpadm

Utilice el programa mfpadm para administrar aplicaciones de MobileFirst.

Sintaxis:

Las llamadas al programa mfpadm tienen el siguiente formato:

mfpadm --url= --user= ... [--passwordfile=...] [--secure=false] algún mandato

El programa mfpadm tiene las siguientes opciones:

Opción Tipo Descripción Obligatorio Predeterminado  
–url   URL Base URL of the MobileFirst web application for administration services Yes  
–secure Boolean Whether to avoid operations with security risks No true  
–user name User name for accessing the MobileFirst admin services Yes    
–passwordfile file File containing the password for the user No    
–timeout Number Timeout for the entire REST service access, in seconds No    
–connect-timeout Number Timeout for establishing a network connection, in seconds No    
–socket-timeout Number Timeout for detecting the loss of a network connection, in seconds No    
–connection-request-timeout Number Timeout for obtaining an entry from a connection request pool, in seconds No      
–lock-timeout Number Timeout for acquiring a lock, in seconds No 2  
–verbose Detailed output No      

url
El URL preferiblemente utiliza el protocolo HTTPS. Por ejemplo, si utiliza las raíces de contexto y los puertos predeterminados, utilice este URL:

  • Para WebSphere Application Server: https://server:9443/mfpadmin
  • Para Tomcat: https://server:8443/mfpadmin

secure
La opción --secure se establece como verdadera de forma predeterminada. Si la establece como --secure=false 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 del nombre de host del servidor.

password
Especifique la contraseña en un archivo separado que se pasa en la opción --passwordfile. Alternativamente, en la modalidad interactiva (consulte Modalidad interactiva), puede especificar la contraseña de forma interactiva. La contraseña es información confidencial y, por lo tanto, debe estar protegida. Debe impedir que otros usuarios en el mismo sistema sepan estas contraseñas. 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

Por esta razón, no pase la contraseña a un proceso a través de un argumento de línea de mandatos. En muchos sistemas operativos, otros usuarios pueden inspeccionar los argumentos de línea de mandatos de sus procesos.

Las llamadas a mfpadm contienen un mandato. Se da soporte a los siguientes mandatos.

Mandato Descripción
show info  
Muestra información de configuración y de usuario.  
show global-config  
Muestra información de configuración global.  
show diagnostics  
Muestra información de diagnósticos.  
show versions  
Muestra información de versión.  
unlock  
Libera el bloqueo de propósito general.  
list runtimes [–in-database] Lista los tiempos de ejecución.
show runtime [runtime-name] Muestra información sobre un tiempo de ejecución.
delete runtime [runtime-name] condition Suprime un tiempo de ejecución.
show user-config [runtime-name] Muestra la configuración de usuario de un tiempo de ejecución.
set user-config [runtime-name] file Especifica la configuración de usuario de un tiempo de ejecución.
set user-config [runtime-name] property = value Especifica una configuración de usuario de un tiempo de ejecución.
show confidential-clients [runtime-name] Muestra la configuración de los clientes confidencial de un entorno de ejecución.
set confidential-clients [runtime-name] file Especifica la configuración de los clientes confidencial de un entorno de ejecución.
set confidential-clients-rule [runtime-name] id display-name secret allowed-scope Especifica una regla para la configuración de los clientes confidenciales de un entorno de ejecución.
list adapters [runtime-name] Lista los adaptadores.
deploy adapter [runtime-name] property = value Despliega un adaptador.
show adapter [runtime-name] adapter-name Muestra información sobre un adaptador.
delete adapter [runtime-name] adapter-name Suprime un adaptador.
adapter [runtime-name] adapter-name get binary [> tofile] Obtiene los datos binarios de un adaptador.
list apps [runtime-name] Lista las aplicaciones.
deploy app [runtime-name] file Despliega una aplicación.
show app [runtime-name] app-name Muestra información sobre una aplicación.
delete app [runtime-name] app-name Suprime una aplicación.
show app version [runtime-name] app-name environment version Muestra información sobre una versión de una aplicación.
delete app version [runtime-name] app-name environment version Suprime una versión de una aplicación.
app [runtime-name] app-name show license-config Muestra la configuración de licencia de señal de una aplicación.
app [runtime-name] app-name set license-config app-type license-type Muestra la configuración de licencia de señal de una aplicación.
app [runtime-name] app-name delete license-config Elimina la configuración de licencia de señal de una aplicación.
app version [runtime-name] app-name environment version get descriptor [> tofile] Obtiene el descriptor de una versión de aplicación.
app version [runtime-name] app-name environment version get web-resources [> tofile] Obtiene los recursos web de una aplicación.
app version [runtime-name] app-name environment version set web-resources file Especifica los recursos web de una versión de aplicación.
app version [runtime-name] app-name environment version get authenticity-data [> tofile] Obtiene los datos de autenticidad de una versión de aplicación.
app version [runtime-name] app-name environment version set authenticity-data [file] Especifica los datos de autenticidad de una versión de aplicación.
app version [runtime-name] app-name environment version delete authenticity-data Suprime los datos de autenticidad de una versión de aplicación.
app version [runtime-name] app-name environment version show user-config Muestra la configuración de usuario de una versión de aplicación.
app version [runtime-name] app-name environment version set user-config file Especifica la configuración de usuario de una versión de aplicación.
app version [runtime-name] app-name environment version set user-config property = value Especifica una configuración de usuario de una versión de aplicación.
list devices [runtime-name][–query query] Lista los dispositivos.
remove device [runtime-name] id Elimina un dispositivo.
device [runtime-name] id set status new-status Cambia el estado de un dispositivo.
device [runtime-name] id set appstatus app-name new-status Cambia el estado de un dispositivo para una aplicación.
list farm-members [runtime-name] Lista los servidores que son miembros de la granja de servidores.
remove farm-member [runtime-name] server-id Elimina un servidor de la lista de miembros de la granja.

Modalidad interactiva

Como alternativa, también puede llamar a mfpadm en la línea de mandatos sin ningún mandato. Puede entonces especificar mandatos de forma interactiva, uno por línea. El mandato exit, o el final de archivo en la salida estándar (Control-D en terminales UNIX) finaliza mfpadm.

También en esta modalidad, hay disponibles mandatos help de ayuda. Por ejemplo:

  • help
  • help show versions
  • help device
  • help device set status

Historial de mandatos en la modalidad interactiva

En algunos sistemas operativos, el mandato mfpadm interactivo recuerda el historial de mandatos. Con el historial de mandatos, puede seleccionar un mandato ejecutado de forma previa, utilizando las flechas de dirección, editarlo y ejecutarlo.

En Linux
El historial de mandatos está habilitado en las ventanas del emulador de terminal si el paquete rlwrap está instalado y se encuentra en PATH. Para instalar el paquete rlwrap:

  • En Red Hat Linux: sudo yum install rlwrap
  • En SUSE Linux: sudo zypper install rlwrap
  • En Ubuntu: sudo apt-get install rlwrap

En OS X
El historial de mandatos está habilitado en el programa Terminal si el paquete rlwrap está instalado y se encuentra en PATH. Para instalar el paquete rlwrap:

  1. Instale MacPorts utilizando el instalador de www.macports.org.
  2. Ejecute el mandato: sudo /opt/local/bin/port install rlwrap
  3. A continuación, para que el programa rlwrap esté disponible en PATH, utilice este mandato en un shell compatible con Bourne: PATH=/opt/local/bin:$PATH

En Windows
El historial de mandatos está habilitado en las ventanas de consola de cmd.exe.

En entornos en los que rlwrap no funciona o no es necesario, puede inhabilitar su utilización a través de la opción --no-readline.

Archivo de configuración

También puede almacenar las opciones en un archivo de configuración en lugar de pasarlas en la línea de mandatos en cada una de las llamadas. Cuando un archivo de configuración está presente y se especifica la opción –configfile=file, puede omitir las opciones siguientes:

  • –url=URL
  • –secure=boolean
  • –user=name
  • –passwordfile=file
  • –timeout=seconds
  • –connect-timeout=seconds
  • –socket-timeout=seconds
  • –connection-request-timeout=seconds
  • –lock-timeout=seconds
  • runtime-name

Utilice estos mandatos para almacenar estos valores en el archivo de configuración.

Mandato Comentario
mfpadm [–configfile=file] config url URL  
mfpadm [–configfile=file] config secure boolean  
mfpadm [–configfile=file] config user name  
mfpadm [–configfile=file] config password Prompts for the password.
mfpadm [–configfile=file] config timeout seconds  
mfpadm [–configfile=file] config connect-timeout seconds  
mfpadm [–configfile=file] config socket-timeout seconds  
mfpadm [–configfile=file] config connection-request-timeout seconds  
mfpadm [–configfile=file] config lock-timeout seconds  
mfpadm [–configfile=file] config runtime runtime-name  

Utilice este mandato para listar los valores almacenados en el archivo de configuración: mfpadm [--configfile=file] config

El archivo de configuración es un archivo de texto, en la codificación del entorno local actual, en la sintaxis .properties de Java. Estos son los archivos de configuración predeterminados:

  • UNIX: ${HOME}/.mfpadm.config
  • Windows: My Documents\IBM MobileFirst Platform Server Data\mfpadm.config

Nota: Cuando no se especifica una opción --configfile, el archivo de configuración predeterminado únicamente se utiliza en la modalidad interactiva y en mandatos config. Para utilización no interactiva de otros mandatos, debe designar de forma explícita el archivo de configuración si desea utilizar uno.

Importante: La contraseña se almacena en un formato enmascarado que la oculta de una visualización accidental. Sin embargo, este enmascaramiento no proporciona seguridad.

Opciones genéricas

También hay las opciones genéricas usuales:

Opción Descripción
–help Shows some usage help
–version Shows the version

Formato XML

Los mandatos que reciben una respuesta XML del servidor verifican que dicha respuesta cumpla el esquema especifico. Puede inhabilitar esta comprobación especificando --xmlvalidation=none.

Conjunto de caracteres de salida

La salida normal del programa mfpadm se codifica en el entorno local actual. En Windows, este formato de codificación es 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 “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 formato es el entorno local predeterminado en Red Hat Linux y OS X. Muchos otros sistemas operativos tienen un entorno local en_US.UTF-8.
  • O utilice la tarea Ant de mfpadm, con el atributo output="algún nombre de archivo" para redireccionar la salida de un mandato a un archivo.

Mandatos para la configuración general

Cuando llama al programa 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.

Sintaxis: show global-config

Acepta las siguientes opciones:

Argumento Descripción
–xml Produces XML output instead of tabular output.

Ejemplo

show global-config

Este mandato se basa en el servicio REST Global Configuration (GET)


Mandato show user-config

El mandato show user-config muestra la configuración de usuario de un tiempo de ejecución.

Sintaxis: show user-config [--xml] [runtime-name]

Acepta los siguientes argumentos:

Argumento Descripción
runtime-name Nombre de tiempo de ejecución.

El mandato show user-config utiliza las siguientes opciones después del verbo.

Argumento Descripción Obligatorio Predeterminado
–xml Produces output in XML format instead of JSON format. No Standard output

Ejemplo

show user-config mfp

Este mandato se basa en el servicio REST Runtime Configuration (GET).


Mandato set user-config

El mandato set user-config especifica la configuración de usuario de un tiempo de ejecución o una propiedad individual en la misma.

La sintaxis para toda la configuración: set user-config [runtime-name] file

Acepta los siguientes argumentos:

Atributo Descripción
runtime-name Nombre de tiempo de ejecución.
file Nombre del archivo XML o JSON que contiene la nueva configuración.

Sintaxis para una propiedad individual: set user-config [runtime-name] property = value

El mandato set user-config acepta los siguientes argumentos:

Argumento Descripción
runtime-name Nombre de tiempo de ejecución.
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.
value Valor de la propiedad.

Ejemplos

set user-config mfp myconfig.json
set user-config mfp timeout = 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.

Sintaxis: show confidential-clients [--xml] [runtime-name]

Acepta los siguientes argumentos:

Atributo Descripción
runtime-name Nombre de tiempo de ejecución.

El mandato show confidential-clients utiliza las siguientes opciones después del verbo.

Argumento Descripción Obligatorio Predeterminado
–xml Produces output in XML format instead of JSON format. No Standard output

Ejemplo

show confidential-clients --xml mfp

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.

Sintaxis: set confidential-clients [runtime-name] file

Acepta los siguientes argumentos:

Atributo Descripción
runtime-name Nombre de tiempo de ejecución.
file Nombre del archivo XML o JSON que contiene la nueva configuración.

Ejemplo

set confidential-clients mfp 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.

Sintaxis: set confidential-clients-rule [runtime-name] id displayName secret allowedScope

Acepta los siguientes argumentos:

Atributo Descripción
runtime Nombre de tiempo de ejecución.
id El identificador de la regla.
displayName El nombre de visualización de la regla.
secret Secreto de la regla.
allowedScope Ámbito de la regla. Lista de señales separadas por espacios. Utilice comillas dobles para pasar una lista de dos o más señales.

Ejemplo

set confidential-clients-rule mfp push Push lOa74Wxs "**"

Este mandato se basa en el servicio REST Confidential Clients (PUT).

Mandatos para adaptadores

Cuando invoca al programa mfpadm, puede incluir varios mandatos para los adaptadores.

Mandato list adapters

El mandato list adapters devuelve una lista de los adaptadores desplegados en un tiempo de ejecución.

Sintaxis: list adapters [runtime-name]

Acepta los siguientes argumentos:

Argumento Descripción
runtime-name Nombre de tiempo de ejecución.

El mandato list adapters acepta las siguientes opciones después del objeto.

Opción Descripción
–xml Produce XML output instead of tabular output.

Ejemplo

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

Sintaxis: deploy adapter [runtime-name] file

Acepta los siguientes argumentos:

Argumento Descripción
runtime-name Nombre de tiempo de ejecución.
file Archivo de adaptador binario (.adapter)

Ejemplo

deploy adapter mfp MyAdapter.adapter

Este mandato se basa en el servicio REST Adapter (POST).


Mandato show adapter

El mandato show adapter muestra detalles sobre un adaptador.

Sintaxis: show adapter [runtime-name] adapter-name

Acepta los siguientes argumentos.

Argumento Descripción
runtime-name Nombre de tiempo de ejecución.
adapter-name Nombre de un adaptador

El mandato show adapter acepta las siguientes opciones después del objeto.

Opción Descripción
–xml Produce XML output instead of tabular output.

Ejemplo

show adapter mfp 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.

Sintaxis: delete adapter [runtime-name] adapter-name

Acepta los siguientes argumentos:

Argumento Descripción
runtime-name Nombre de tiempo de ejecución.
adapter-name Nombre de un adaptador.

Ejemplo

delete adapter mfp MyAdapter

Este mandato se basa en el servicio REST Adapter (DELETE).


Prefijo de mandato adapter

El prefijo de mandato adapter utiliza los siguientes argumentos antes del verbo.

Argumento Descripción
runtime-name Nombre de tiempo de ejecución.
adapter-name Nombre de un adaptador.


Mandato adapter get binary

El mandato adapter get binary devuelve el archivo de adaptador binario.

Sintaxis: adapter [runtime-name] adapter-name get binary [> tofile]

Acepta las siguientes opciones después del verbo.

Opción Descripción Obligatorio Predeterminado
> tofile Nombre del archivo de salida. No Salida estándar

Ejemplo

adapter mfp MyAdapter get binary > /tmp/MyAdapter.adapter

Este mandato se basa en el servicio REST Export runtime resources (GET).


Mandato adapter show user-config

El mandato adapter show user-config muestra la configuración de usuario del adaptador.

Sintaxis: adapter [runtime-name] adapter-name show user-config [--xml]

Acepta las siguientes opciones después del verbo.

Opción Descripción
–xml Produces output in XML format instead of JSON format.

Ejemplo

adapter mfp MyAdapter show user-config

Este mandato se basa en el servicio REST Adapter Configuration (GET).


Mandato adapter set user-config

El mandato adapter set user-config especifica la configuración de usuario del adaptador o propiedad individual dentro de esta configuración.

Sintaxis para toda la configuración: adapter [runtime-name] adapter-name set user-config file

Acepta los siguientes argumentos después del verbo.

Opción Descripción
file Nombre del archivo XML o JSON que contiene la nueva configuración.

Sintaxis para una propiedad individual: adapter [runtime-name] adapter-name set user-config property = value

Acepta los siguientes argumentos después del verbo.

Opción Descripción
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.
value Valor de la propiedad.

Ejemplos

adapter mfp MyAdapter set user-config myconfig.json
adapter mfp MyAdapter set user-config timeout = 240

Este mandato se basa en el servicio REST Adapter configuration (PUT).

Mandatos para aplicaciones

Cuando se invoca al programa mfpadm, se pueden 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.

Sintaxis: list apps [runtime-name]

Acepta los siguientes argumentos:

Argumento Descripción
runtime-name Nombre de tiempo de ejecución.

El mandato list apps acepta las siguientes opciones después del objeto.

Opción Descripción
–xml Produce XML output instead of tabular output.

Ejemplo

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

Sintaxis: deploy app [runtime-name] file

Acepta los siguientes argumentos:

Argumento Descripción
runtime-name Nombre de tiempo de ejecución.
file Descriptor de la aplicación, un archivo JSON.

Ejemplo

deploy app mfp MyApp/application-descriptor.json

Este mandato se basa en el servicio REST Application (POST).

Mandato show app

El mandato show app muestra detalles sobre una aplicación en un tiempo de ejecución, en concreto, sus entornos y versiones.

Sintaxis: show app [runtime-name] app-name

Acepta los siguientes argumentos:

Argumento Descripción
runtime-name Nombre de tiempo de ejecución.
app-name Nombre de una aplicación.

El mandato show app acepta las siguientes opciones después del objeto.

Opción Descripción
–xml Produce XML output instead of tabular output.

Ejemplo

show app mfp 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, de todos los entornos y todas las versiones, de un tiempo de ejecución.

Sintaxis: delete app [runtime-name] app-name

Acepta los siguientes argumentos:

Argumento Descripción
runtime-name Nombre de tiempo de ejecución.
app-name Nombre de una aplicación

Ejemplo

delete app mfp 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.

Sintaxis: show app version [runtime-name] app-name environment version

Acepta los siguientes argumentos:

Argumento Descripción
runtime-name Nombre de tiempo de ejecución.
app-name Nombre de una aplicación.
environment Plataforma móvil.
version Versión de la aplicación.

El mandato show app version acepta las siguientes opciones después del objeto.

Argumento Descripción
– xml Produces XML output instead of tabular output.

Ejemplo

show app version mfp MyApp iPhone 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.

Sintaxis: delete app version [runtime-name] app-name environment version

Acepta los siguientes argumentos:

Argumento Descripción
runtime-name Nombre de tiempo de ejecución.
app-name Nombre de una aplicación.
environment Plataforma móvil.
version Versión de la aplicación.

Ejemplo

delete app version mfp MyApp iPhone 1.1

Este mandato se basa en el servicio REST Application Version (DELETE).

Prefijo de mandato app

El prefijo de mandato app utiliza los siguientes argumentos antes del verbo.

Argumento Descripción
runtime-name Nombre de tiempo de ejecución.
app-name Nombre de una aplicación.

Mandato app show license-config

El mandato app show license-config muestra la configuración de licencia de señal de una aplicación.

Sintaxis: app [runtime-name] app-name show license-config

Acepta las siguientes opciones después del objeto:

Argumento Descripción
–xml Produces XML output instead of tabular output.

Ejemplo

app mfp MyApp show license-config

Este mandato se basa en el servicio REST Application (GET).

Mandato app set license-config

El mandato app set license-config especifica la configuración de licencia de señal de una aplicación.

Sintaxis: app [runtime-name] app-name set license-config app-type license-type

Acepta los siguientes argumentos después del verbo.

Argumento Descripción
appType Tipo de aplicación: B2C o B2E.
licenseType Tipo de aplicación: APPLICATION o ADDITIONAL_BRAND_DEPLOYMENT o NON_PRODUCTION.

Ejemplo

app mfp MyApp iPhone 1.1 set license-config B2E APPLICATION

Este mandato se basa en el servicio REST Application License Configuration (POST)

Mandato app delete license-config

El mandato app delete license-config restablece la configuración de licencia de señal de una aplicación, esto es, la devuelve a su estado inicial.

Sintaxis: app [runtime-name] app-name delete license-config

Ejemplo

app mfp MyApp iPhone 1.1 delete license-config

Este mandato se basa en el servicio REST License configuration (DELETE).

Prefijo de mandato app version

El prefijo de mandato app version utiliza los siguientes argumentos antes del verbo.

Argumento Descripción
runtime-name Nombre de tiempo de ejecución.
app-name Nombre de una aplicación.
environment Plataforma móvil
version Versión de la aplicación

Mandato app version get descriptor

El mandato app version get descriptor devuelve el descriptor de aplicación de una versión de una aplicación.

Sintaxis: app version [runtime-name] app-name environment version get descriptor [> tofile]

Acepta los siguientes argumentos después del verbo.

Argumento Descripción Obligatorio Predeterminado
> tofile Nombre del archivo de salida. No Salida estándar

Ejemplo

app version mfp MyApp iPhone 1.1 get descriptor > /tmp/MyApp-application-descriptor.json

Este mandato se basa en el servicio REST Application Descriptor (GET).

Mandato app version get web-resources

El mandato app version get web-resources devuelve los recursos web de una versión de una aplicación, como un archivo .zip.

Sintaxis: app version [runtime-name] app-name environment version get web-resources [> tofile]

Acepta los siguientes argumentos después del verbo.

Argumento Descripción Obligatorio Predeterminado
> tofile Nombre del archivo de salida. No Salida estándar

Ejemplo

app version mfp MyApp iPhone 1.1 get web-resources > /tmp/MyApp-web.zip

Este mandato se basa en el servicio REST Retrieve Web Resource (GET).

Mandato app version set web-resources

El mandato app version set web-resources especifica los recursos web de una versión de una aplicación.

Sintaxis: app version [runtime-name] app-name environment version set web-resources file

Acepta los siguientes argumentos después del verbo.

Argumento Descripción
file Nombre del archivo de entrada (debe ser un archivo .zip).

Ejemplo

app version mfp MyApp iPhone 1.1 set web-resources /tmp/MyApp-web.zip

Este mandato se basa en el servicio REST Deploy a web resource (POST).

Mandato app version get authenticity-data

El mandato app version get authenticity-data devuelve los datos de autenticidad de una versión de una aplicación.

Sintaxis: app version [runtime-name] app-name environment version get authenticity-data [> tofile]

Acepta los siguientes argumentos después del verbo.

Argumento Descripción Necesario Predeterminado
> tofile Nombre del archivo de salida. No Salida estándar

Ejemplo

app version mfp MyApp iPhone 1.1 get authenticity-data > /tmp/MyApp.authenticity_data

Este mandato se basa en el servicio REST Export runtime resources (GET).

Mandato app version set authenticity-data

El mandato app version set authenticity-data especifica los datos de autenticidad de una versión de una aplicación.

Sintaxis: app version [runtime-name] app-name environment version set authenticity-data file

Acepta los siguientes argumentos después del verbo.

Argumento Descripción
file Nombre del archivo de entrada:<ul><li>Un archivo .authenticity_data,</li><li>O un archivo de dispositivo (.ipa, .apk o .appx), a partir del que se extraen los datos de autenticidad.</li></ul>

Ejemplos

app version mfp MyApp iPhone 1.1 set authenticity-data /tmp/MyApp.authenticity_data
app version mfp MyApp iPhone 1.1 set authenticity-data MyApp.ipa
app version mfp MyApp android 1.1 set authenticity-data MyApp.apk

Este mandato se basa en el servicio REST Deploy Application Authenticity Data (POST).

Mandato app version delete authenticity-data

El mandato app version delete authenticity-data suprime los datos de autenticidad de una versión de una aplicación.

Sintaxis: app version [runtime-name] app-name environment version delete authenticity-data

Ejemplo

app version mfp MyApp iPhone 1.1 delete authenticity-data

Este mandato se basa en el servicio REST Application Authenticity (DELETE).

Mandato app version show user-config

El mandato app version show user-config muestra la configuración de usuario de una versión de una aplicación.

Sintaxis: app version [runtime-name] app-name environment version show user-config [--xml]

Acepta las siguientes opciones después del verbo.

Argumento Descripción Obligatorio Predeterminado
[–xml] Genera salida en formato XML en lugar de formato JSON. No Salida estándar

Ejemplo

app version mfp MyApp iPhone 1.1 show user-config

Este mandato se basa en el servicio REST Application Configuration (GET).

Mandato app version set user-config

El mandato app version set user-config especifica la configuración de usuario de una versión de una aplicación o de una propiedad individual en dicha configuración.

Sintaxis para toda la configuración: app version [runtime-name] app-name environment version set user-config file

Acepta los siguientes argumentos después del verbo.

Argumento Descripción
file Nombre del archivo XML o JSON que contiene la nueva configuración.

Sintaxis para una propiedad individual: app version [runtime-name] app-name environment version set user-config property = value

El mandato app version set user-config utiliza los siguientes argumentos después del verbo.

Argumento Descripción
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.
value Valor de la propiedad.

Ejemplos

app version mfp MyApp iPhone 1.1 set user-config /tmp/MyApp-config.json
app version mfp MyApp iPhone 1.1 set user-config timeout = 240

Este mandato se basa en el servicio REST Application Configuration (PUT)

Mandatos para dispositivos

Cuando invoca al programa 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.

Sintaxis: list devices [runtime-name] [--query query]

Acepta los siguientes argumentos:

Argumento Descripción
runtime-name Nombre de tiempo de ejecución.
query Nombre descriptivo o identificador de usuario, para buscar. Este parámetro especifica una serie que buscar. Se devuelven todos los dispositivos que tienen un nombre descriptivo o identificador de usuario que contenga esta serie (con coincidencia insensible a las mayúsculas y minúsculas).

El mandato list devices acepta las siguientes opciones después del objeto.

Opción Descripción
–xml Produces XML output instead of tabular output.

Ejemplos

list-devices mfp
list-devices mfp --query=john

Este mandato se basa en el servicio Devices (GET) REST.

Mandato remove device

El mandato remove device borra el registro sobre un dispositivo que contactó las aplicaciones de un tiempo de ejecución.

Sintaxis: remove device [runtime-name] id

Acepta los siguientes argumentos:

Argumento Descripción
runtime-name Nombre de tiempo de ejecución.
id Identificador de dispositivo exclusivo.

Ejemplo

remove device mfp 496E974CCEDE86791CF9A8EF2E5145B6

Este mandato se basa en el servicio REST Device (DELETE).

Prefijo de mandato device

El prefijo de mandato device utiliza los siguientes argumentos antes del verbo.

Argumento Descripción
runtime-name Nombre de tiempo de ejecución.
id Identificador de dispositivo exclusivo.

Mandato device set status

El mandato device set status cambia el estado de un dispositivo, en el ámbito de un tiempo de ejecución.

Sintaxis: device [runtime-name] id set status new-status

Acepta los siguientes argumentos:

Argumento Descripción
new-status Nuevo estado.

El estado puede tener uno de los siguientes valores:

  • ACTIVE
  • LOST
  • STOLEN
  • EXPIRED
  • DISABLED

Ejemplo

device mfp 496E974CCEDE86791CF9A8EF2E5145B6 set status EXPIRED

Este mandato se basa en el servicio REST Device Status (PUT).

Mandato device set appstatus

El mandato device set appstatus cambia el estado de un dispositivo, en relación a una aplicación en un tiempo de ejecución.

Sintaxis: device [runtime-name] id set appstatus app-name new-status

Acepta los siguientes argumentos:

Argumento Descripción
app-name Nombre de una aplicación.
new-status Nuevo estado.

El estado puede tener uno de los siguientes valores:

  • ENABLED
  • DISABLED

Ejemplo

device mfp 496E974CCEDE86791CF9A8EF2E5145B6 set appstatus MyApp DISABLED

Este mandato se basa en el servicio REST Device Application Status (PUT).

Mandatos para la resolución de problemas

Cuando se invoca al programa mfpadm, se pueden incluir varios mandatos para la resolución de problemas.

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.

Sintaxis: show info

Acepta las siguientes opciones después del objeto.

Opción Descripción
–xml Produces XML output instead of tabular output.

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 exacta de la que se toma mfp-ant-deployer.jar.
  • productVersion: Número de versión de MobileFirst Server exacta de la que se toma mfp-admin-service.war.
  • mfpAdminVersion: Número de versión de construcción exacto de sólo mfp-admin-service.war.

Sintaxis: show versions

Acepta las siguientes opciones después del objeto.

Opción Descripción
–xml Produces XML output instead of tabular output.

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.

Sintaxis: show diagnostics

Acepta las siguientes opciones después del objeto.

Opción Descripción
–xml Produces XML output instead of tabular output.

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.

Ejemplo

unlock

Mandato list runtimes

El mandato list runtimes devuelve una lista de tiempos de ejecución desplegados.

Sintaxis: list runtimes [--in-database]

Acepta las siguientes opciones:

Opción Descripción
–in-database Whether to look in the database instead of via MBeans
–xml Produces XML output instead of tabular output.

Ejemplos

list runtimes
list runtimes --in-database

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.

Sintaxis: show runtime [runtime-name]

Acepta los siguientes argumentos:

Argumento Descripción
runtime-name Nombre de tiempo de ejecución.

El mandato show runtime acepta las siguientes opciones después del objeto.

Opción Descripción
–xml Produces XML output instead of tabular output.

Este mandato se basa en el servicio REST Runtime (GET).

Ejemplo

show runtime mfp

Mandato delete runtime

El mandato delete runtime suprime un 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.

Sintaxis: delete runtime [runtime-name] condition

Acepta los siguientes argumentos:

Argumento Descripción
runtime-name Nombre de tiempo de ejecución.
condition Condición cuando lo suprime: empty o always. Atención: La opción always es peligrosa.

Ejemplo

delete runtime mfp 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.

Sintaxis: list farm-members [runtime-name]

Acepta los siguientes argumentos:

Argumento Descripción
runtime-name Nombre de tiempo de ejecución.

El mandato list farm-members acepta las siguientes opciones después del objeto.

Opción Descripción
–xml Produces XML output instead of tabular output.

Ejemplo

list farm-members 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 la que se ha desplegado el tiempo de ejecución especificado. Utilice este mandato cuando el servidor no esté disponible o se haya desconectado.

Sintaxis: remove farm-member [runtime-name] server-id

Acepta los siguientes argumentos.

Argumento Descripción
runtime-name Nombre de tiempo de ejecución.
server-id Identificador del servidor.

El mandato remove farm-member acepta las siguientes opciones después del objeto.

Opción Descripción
–force Force removal of a farm member, even if it is available and connected.

Ejemplo

remove farm-member mfp 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.
Last modified on February 27, 2020