Skip to content

IBM MobileFirst Platform (formerly Worklight) - Process Steps

Change Application Configuration

Changes an applications configuration on IBM MobileFirst. Note: This step is for server 6.2 or later.

NameTypeDescriptionRequired
Application NameStringThe application name to reconfigure.Yes
Configuration FileStringThe .json or .xml file path containing the applications new configuration.Yes
EnvironmentStringThe name of the environment.Yes
PasswordPasswordThe users password to access the IBM MobileFirst server. Note: This property is required for Worklight 6.2 and later.No
RuntimeStringThe runtime on which to change the applications configuration.Yes
SecureBooleanWhether to transmit in a secure way. Utilized in versions 6.2 to 7.1.No
Server PathStringThe URL to the IBM MobileFirst server and role of the MobileFirst authorized user. For Worklight versions 7.1 and older, the default path is /worklightadmin. For MobileFirst versions 8.0 and newer, the default path is /mfpadmin.Yes
UserStringThe user name that is required to access a secure IBM MobileFirst server. Note: This property is required for Worklight 6.2 and later.No
VersionStringThe name of the version.Yes
Worklight Ant JAR File PathStringThe path to the Worklight Ant Deployer JAR (worklight-ant-deployer.jar) file. The Worklight 6.0.0 Server can use the value: ${PLUGIN\_HOME}/lib/worklight-ant.jar. Required for server versions less than 8.0.No

Delete Adapter

Deletes the adapter from the IBM MobileFirst server. Note: This step is for Worklight and IBM MobileFirst servers 6.2 and later.

NameTypeDescriptionRequired
Adapter NameStringThe adapter to delete from the IBM MobileFirst server.Yes
PasswordPasswordThe users password to access the IBM MobileFirst server. Note: This property is required for Worklight 6.2 and later.No
RuntimeStringThe runtime on which to remove the adapter.Yes
SecureBooleanWhether to transmit in a secure way. Utilized in server versions 6.2 to 7.1.No
Server PathStringThe URL to the IBM MobileFirst server and role of the MobileFirst authorized user. For Worklight versions 7.1 and older, the default path is /worklightadmin. For MobileFirst versions 8.0 and newer, the default path is /mfpadmin.Yes
UserStringThe user name that is required to access a secure IBM MobileFirst server. Note: This property is required for Worklight 6.2 and later.No
Worklight Ant JAR File PathStringThe path to the Worklight Ant Deployer JAR (worklight-ant-deployer.jar) file. The Worklight 6.0.0 Server can use the value: ${PLUGIN\_HOME}/lib/worklight-ant.jar. Required for server versions less than 8.0.No

Delete Application

Delete an application from IBM MobileFirst. Note: This step is for Worklight Server 6.2 or later.

NameTypeDescriptionRequired
Application NameStringThe name of the Worklight application to remove.Yes
EnvironmentStringThe applications environment. Only required if using IBM MobileFirst v8+.No
PasswordPasswordThe users password to access the IBM MobileFirst server. Note: This property is required for Worklight 6.2 and later.No
RuntimeStringThe runtime on which to remove the IBM MobileFirst application. Note: This property is required for Worklight 6.2 or later.No
SecureBooleanWhether to transmit in a secure way. Utilized in server versions 6.2 to 7.1.No
Server PathStringThe URL to the IBM MobileFirst server and role of the MobileFirst authorized user. For Worklight versions 7.1 and older, the default path is /worklightadmin. For MobileFirst versions 8.0 and newer, the default path is /mfpadmin.Yes
UserStringThe user name that is required to access a secure IBM MobileFirst server. Note: This property is required for Worklight 6.2 and later.No
VersionStringThe applications version number. Only required if using IBM MobileFirst v8+.No
Worklight Ant JAR File PathStringThe path to the Worklight Ant Deployer JAR (worklight-ant-deployer.jar) file. The Worklight 6.0.0 Server can use the value: ${PLUGIN\_HOME}/lib/worklight-ant.jar. Required for IBM MobileFirst versions less than 8.0.No

Deploy Adapter

Deploys the adapter to IBM MobileFirst.

NameTypeDescriptionRequired
Adapter FilesStringA list, separated by commas or newline characters, of IBM MobileFirst Adapter (.adapter) files to deploy to the IBM MobileFirst Server.Yes
PasswordPasswordThe users password to access the IBM MobileFirst server. Note: This property is required for Worklight 6.2 and later.No
RuntimeStringThe runtime on which to deploy the adapter. Note: This property is required for Worklight 6.2 and later.No
SecureBooleanWhether to transmit in a secure way. Utilized in server versions 6.2 to 7.1.No
Server PathStringThe URL to the IBM MobileFirst server and role of the MobileFirst authorized user. For Worklight versions 7.1 and older, the default path is /worklightadmin. For MobileFirst versions 8.0 and newer, the default path is /mfpadmin.Yes
UserStringThe user name that is required to access a secure IBM MobileFirst server. Note: This property is required for Worklight 6.2 and later.No
Worklight Ant JAR File PathStringThe path to the Worklight Ant Deployer JAR (worklight-ant-deployer.jar) file. The Worklight 6.0.0 Server can use the value: ${PLUGIN\_HOME}/lib/worklight-ant.jar. Required for server versions less than 8.0.No

Deploy Application

Deploys an application to IBM MobileFirst.

NameTypeDescriptionRequired
Application FilesStringA list, separated by commas or newline characters, of theWorklight Application files to deploy to the Worklight Server.Specify .wlapp files for IBM MobileFirst pre-v8 and .json or .xml files for IBM MobileFirst v8+.Yes
PasswordPasswordThe users password to access the IBM MobileFirst server. Note: This property is required for Worklight 6.2 and later.No
RuntimeStringThe runtime on which to deploy the IBM MobileFirst application. Note: This property is required for Worklight 6.2 or later.No
SecureBooleanWhether to transmit in a secure way. Utilized in server versions 6.2 to 7.1.No
Server PathStringThe URL to the IBM MobileFirst server and role of the MobileFirst authorized user. For Worklight versions 7.1 and older, the default path is /worklightadmin. For MobileFirst versions 8.0 and newer, the default path is /mfpadmin.Yes
UserStringThe user name that is required to access a secure IBM MobileFirst server. Note: This property is required for Worklight 6.2 and later.No
Worklight Ant JAR File PathStringThe path to the Worklight Ant Deployer JAR (worklight-ant-deployer.jar) file. The Worklight 6.0.0 Server can use the value: ${PLUGIN\_HOME}/lib/worklight-ant.jar. Required for IBM MobileFirst versions less than 8.0.No

Deploy Web Resource

Deploys a web resource compressed file (.zip) for a specific application version. Note: This step is for MobileFirst 8.0 or later.

NameTypeDescriptionRequired
Application IdentifierStringThe MobileFirst application in which to deploy the web resource archive.Yes
EnvironmentStringThe MobileFirst applications environment in which to deploy the web resource archive.Yes
PasswordPasswordThe user password that is required to access the Application Center.Yes
RuntimeStringThe MobileFirst runtime in which to deploy the web resource archive.Yes
Server PathStringThe URL to the IBM MobileFirst server and role of the MobileFirst authorized user. For Worklight versions 7.1 and older, the default path is /worklightadmin. For MobileFirst versions 8.0 and newer, the default path is /mfpadmin.Yes
UserStringThe user name that is required to access the Application Center.Yes
VersionStringThe MobileFirst applications version number in which to deploy the web resource archive.Yes
Web Resource FileStringThe name of the web resource (.zip) file to deploy to the IBM MobileFirst Server.Yes

Remove Application from Application Center

Removes the native application from the IBM MobileFirst Application Center.

NameTypeDescriptionRequired
Application Center Ant JAR File PathStringThe path to the Application Center Deploy Tool Ant JAR (applicationcenterdeploytool.jar) file. The Worklight 6.0.0 Server can use the value: ${PLUGIN\_HOME}/lib/applicationcenterdeploytool.jar.Yes
Application PackageStringThe package name of the application to remove from the Application Center.Yes
ContextStringThe context of the Application Center. For example, applicationcenter.Yes
Disable SSL Security CheckingBooleanDisables SSL security checking. Use of this flag is a security risk.No
JSON4J JAR File PathStringThe path to the JSON4J JAR (json4j.jar) file. The Worklight 6.0.0 Server can use the value: ${PLUGIN\_HOME}/lib/json4j.jar.Yes
Operating SystemEnumeration:
  • all
  • Android
  • iOS | The operating system of the application to remove from the Application Center. | No | | Password | Password | The user password. The default value is: ${p:environment/applicationCenterPassword}. | Yes | | Server Path | String | The URL to the IBM MobileFirst server and role of the MobileFirst authorized user. For Worklight versions 7.1 and older, the default path is /worklightadmin. For MobileFirst versions 8.0 and newer, the default path is /mfpadmin. | Yes | | User | String | The user name that is required to access the Application Center. | Yes | | Version | String | The internal version (not the commercial version) of the application to remove from the Application Center. | No |

Upload Application to Application Center

Uploads the application to the IBM MobileFirst Application Center.

NameTypeDescriptionRequired
ActiveBooleanStore the application in the Application Center as an active application.No
Application Center Ant JAR File PathStringThe path to the Application Center Deploy Tool Ant JAR (applicationcenterdeploytool.jar) file. The Worklight 6.0.0 Server can use the value: ${PLUGIN\_HOME}/lib/applicationcenterdeploytool.jar.Yes
ContextStringThe context of the Application Center. For example, applicationcenter.Yes
DescriptionStringThe description of the application to upload to the Application Center.No
Disable SSL Security CheckingBooleanDisables SSL security checking. Use of this flag is a security risk.No
FileStringThe Android application package (.apk) or iOS application (.ipa) file to upload to the Application Center.Yes
Force UploadBooleanForce existing applications to be uploaded to the Application Center.No
InstallerBooleanStore the application in the Application Center with the installer flag.No
JSON4J JAR File PathStringThe path to the JSON4J JAR (json4j.jar) file. The Worklight 6.0.0 Server can use the value: ${PLUGIN\_HOME}/lib/json4j.jar.Yes
LabelStringThe fallback label in the Application Center.No
PasswordPasswordThe user password. The default value is: ${p:environment/applicationCenterPassword}.Yes
Ready for productionBooleanStore the application in the Application Center with the ready-for-production flag.No
RecommendedBooleanStore the application in the Application Center with the recommended flag.No
Server PathStringThe URL to the IBM MobileFirst server and role of the MobileFirst authorized user. For Worklight versions 7.1 and older, the default path is /worklightadmin. For MobileFirst versions 8.0 and newer, the default path is /mfpadmin.Yes
UserStringThe user name that is required to access the Application Center.Yes