+

Search Tips | Advanced Search

For up-to-date product documentation, see the IBM MobileFirst Foundation Developer Center.


Commands for apps

When we invoke the mfpadm program, you can include various commands for apps.


The list apps command

The list apps command returns a list of the apps that are deployed in a runtime. Syntax: list apps [runtime-name]

It takes the following arguments:

Table 1. list apps command arguments
Argument Description
runtime-name Name of the runtime.

The list apps command takes the following options after the object.

Table 2. list apps command options
Option Description
--xml Produce XML output instead of tabular output.


Example

This command is based on the Applications (GET) REST service.


The deploy app command

The deploy app command deploys an app version in a runtime. Syntax: deploy app [runtime-name] file

It takes the following arguments:

Table 3. deploy app command arguments
Argument Description
runtime-name Name of the runtime.
file The application descriptor, a JSON file.


Example

This command is based on the Application (POST) REST service.


The show app command

The show app command shows details about an app in a runtime, in particular its environments and versions. Syntax: show app [runtime-name] app-name

It takes the following arguments:

Table 4. show app command arguments
Argument Description
runtime-name Name of the runtime.
app-name Name of an app.

The show app command takes the following options after the object.

Table 5. show app command options
Option Description
--xml Produce XML output instead of tabular output.


Example

This command is based on the Application (GET) REST service.


The delete app command

The delete app command removes (undeploys) an app, from all environments and all versions, from a runtime. Deleting an application from MobileFirst Operations Console will remove all push subscriptions on that application as well. Syntax: delete app [runtime-name] app-name

It takes the following arguments:

Table 6. delete app command arguments
Argument Description
runtime-name Name of the runtime.
app-name Name of an app


Example

This command is based on the Application Version (DELETE) REST service.


The show app version command

The show app version command show details about an app version in a runtime. Syntax: show app version [runtime-name] app-name environment version

It takes the following arguments:

Table 7. show app command arguments
Argument Description
runtime-name Name of the runtime.
app-name Name of an app.
environment Mobile platform.
version Version of the app.

The show app version command takes the following options after the object.

Table 8. show app command options
Argument Description
--xml Produces XML output instead of tabular output.


Example

This command is based on the Application Version (GET) REST service.


The delete app version command

The delete app version command removes (undeploys) an app version from a runtime. Syntax: delete app version [runtime-name] app-name environment version

It takes the following arguments:

Table 9. delete app version command arguments
Argument Description
runtime-name Name of the runtime.
app-name Name of an app.
environment Mobile platform.
version Version of the app.


Example

This command is based on the Application Version (DELETE) REST service.


The app command prefix

The app command prefix takes the following arguments before the verb.

Table 10. app command prefix arguments
Argument Description
runtime-name Name of the runtime.
app-name Name of an app.


The app show license-config command

The app show license-config command shows the token license configuration of an app. Syntax: app [runtime-name] app-name show license-config

It takes the following options after the object:

Table 11. app show license-config option
Argument Description
--xml Produces XML output instead of tabular output.


Example

This command is based on the Application license configuration (GET) REST service.


The app set license-config command

The app set license-config command specifies the token license configuration of an app. Syntax: app [runtime-name] app-name set license-config app-type license-type

It takes the following arguments after the verb.

Table 12. app set license-config command arguments
Argument Description
appType Type of app: B2C or B2E.
licenseType Type of application: APPLICATION or ADDITIONAL_BRAND_DEPLOYMENT or NON_PRODUCTION.


Example

This command is based on the Application License Configuration (POST) REST service.


The app delete license-config command

The app delete license-config command resets the token license configuration of an app, that is, reverts it to the initial state. Syntax: app [runtime-name] app-name delete license-config


Example

This command is based on the License configuration (DELETE) REST service.


The app version command prefix

The app version command prefix takes the following arguments before the verb.

Table 13. app version command prefix arguments
Argument Description
runtime-name Name of the runtime.
app-name Name of an app.
environment Mobile platform
version Version of the app


The app version get descriptor command

The app version get descriptor command returns the application descriptor of a version of an app. Syntax: app version [runtime-name] app-name environment version get descriptor [> tofile]

It takes the following arguments after the verb.

Table 14. app version get descriptor command options
Argument Description Required Default
> tofile Name of the output file. No Standard output


Example

This command is based on the Application Descriptor (GET) REST service.


The app version get web-resources command

The app version get web-resources command returns the web resources of a version of an app, as a .zip file. Syntax: app version [runtime-name] app-name environment version get web-resources [> tofile]

It takes the following arguments after the verb.

Table 15. app version get web-resources command options
Argument Description Required Default
> tofile Name of the output file. No Standard output


Example

This command is based on the Retrieve Web Resource (GET) REST service.


The app version set web-resources command

The app version set web-resources command specifies the web resources for a version of an app. Syntax: app version [runtime-name] app-name environment version set web-resources file

It takes the following arguments after the verb.

Table 16. app version set web-resources command arguments
Argument Description
file Name of the input file (must be a .zip file).


Example

This command is based on the Deploy a web resource (POST) REST service.


The app version get authenticity-data command

The app version get authenticity-data command returns the authenticity data of a version of an app. Syntax: app version [runtime-name] app-name environment version get authenticity-data [> tofile]

It takes the following arguments after the verb.

Table 17. app version get authenticity-data command options
Argument Description Required Default
> tofile Name of the output file. No Standard output


Example

This command is based on the Export runtime resources (GET) REST service.


The app version set authenticity-data command

The app version set authenticity-data command specifies the authenticity data for a version of an app. Syntax: app version [runtime-name] app-name environment version set authenticity-data file

It takes the following arguments after the verb.

Table 18. app version set authenticity-data command arguments
Argument Description
file Name of the input file:

  • Either a .authenticity_data file,
  • Or a device file (.ipa or .apk or .appx), from which the authenticity data is extracted.


Examples

This command is based on the Deploy Application Authenticity Data (POST) REST service.


The app version delete authenticity-data command

The app version delete authenticity-data command deletes the authenticity data for a version of an app. Syntax: app version [runtime-name] app-name environment version delete authenticity-data


Example

This command is based on the Application Authenticity (DELETE) REST service.


The app version show user-config command

The app version show user-config command shows the user configuration of a version of an app. Syntax: app version [runtime-name] app-name environment version show user-config [--xml]

It takes the following options after the verb.

Table 19. app version show user-config command options
Argument Description Required Default
[--xml] Produce output in XML format instead of JSON format. No Standard output


Example

This command is based on the Application Configuration (GET) REST service.


The app version set user-config command

The app version set user-config command specifies the user configuration for a version of an app or a single property among this configuration. Syntax for the entire configuration: app version [runtime-name] app-name environment version set user-config file

It takes the following arguments after the verb.

Table 20. app version set user-config command arguments
Argument Description
file Name of the JSON or XML file that contains the new configuration.
Syntax for a single property: app version [runtime-name] app-name environment version set user-config property = value

The app version set user-config command takes the following arguments after the verb.

Table 21. app version set user-config command arguments
Argument Description
property Name of the JSON property. For a nested property, use the syntax prop1.prop2.....propN. For a JSON array element, use the index instead of a property name.
value The value of the property.


Examples

This command is based on the Application Configuration (PUT) REST service.

Parent topic: Administering MobileFirst applications through the command line