Version compatibility
Compatibility among different versions of the IBM MobileFirst™ Platform Foundation client and server depends on several factors.
The following table describes different situations and the compatibility rules that apply to each.
version.release.modification.fixpack| Description | Compatibility rule | Examples |
|---|---|---|
| The server and client have the same version and release. (Modification and fix pack release numbers can be different.) | Server and client with the same version and release are fully compatible. | 7.1.0.0 server is compatible with 7.1.0.0 client. |
| The server is newer than the client. | Compatible. | 7.1.0.0 server is compatible with 7.0.0.0 client |
| The server is older than the client. | Not compatible. | 7.0.0.0 server is not compatible with 7.1.0.0 client |
| The server artifacts were created with older version of MobileFirst Studio or MobileFirst Platform Command Line Interface than the version of the server. | For complete details of which server, .war file,
and artifacts work together, see Table
2. However, the following guidelines apply: For versions earlier than 6.1.0, only the same versions of server, .war file, and application (.wlapp file) and adapters can work together. If the initial server version is Worklight Server 6.1 or 6.2, the .war file that was created with the same version of Worklight Studio or Command Line Interface for IBM Worklight Developers can be migrated to a later server version, but the newer server can accommodate only artifacts (.wlapp and adapter files) that were built from the initial version. If the initial server
version is Worklight Server 6.2.0.1
or later, including MobileFirst Server 6.3
or later, the .war file that was created with
the same initial version of Studio or the Command Line Interface can
be migrated to the later server version. The migrated .war file
can accommodate artifacts that were created with any of the following
versions of Studio or the Command Line Interface:
The artifacts behave as though they are running on the older version of the server. For information about migrating the .war file, see Migrating a project WAR file for use with a new MobileFirst Server. |
Example 1: Artifacts built with MobileFirst Studio 7.0.0.0 can run on server 7.1.0.0. However, the artifacts will behave as though they are running on server version 7.0.0.0. Example 2: Initially, a version 6.2.0.1 .war file can run the artifacts from 6.2.01 and earlier versions on a 6.2.0.1 server. If this .war file is migrated to 7.1, then the migrated .war file can run 7.1 artifacts. However, this .war file cannot run MobileFirst Server 7.0.0.0 artifacts. |
| Server artifacts created with a later version of MobileFirst Studio or the MobileFirst Platform Command Line Interface than the version of the server. | Not compatible. | Artifacts built with MobileFirst Studio 7.1.0.0 cannot run on server 7.0.0.0. |
| Direct Update feature | If the version of MobileFirst Studio or the MobileFirst Platform Command Line Interface that was used to build an update package differs from the version of MobileFirst Studio or the MobileFirst Platform Command Line Interface that was used to build the original application package then the update will not be applied. | Original application was built with MobileFirst Studio 7.0.0.0; update was built with MobileFirst Studio 7.1.0.0. Update will not occur. |
The following table shows which .war file and artifact versions can work with each server version. Application behavior remains as with the original version of the application. Version numbers Before 6.3 apply to Worklight products. Version numbers of 6.3 and later apply to MobileFirst products.
| Server version | Can work with the following project versions (.war file created with this version of Studio or Command Line Interface) | Can work with the following artifact versions (application and adapter files created with this version of Studio or command line) |
|---|---|---|
| 7.1.0 | 7.1.0 | 5.0.6, 6.0.0, 6.1.0, 6.2.0, 6.3.0, 7.0.0, 7.1.0 |
| 7.1.0 | 7.0.0 migrated to 7.1.0 | .0.6, 6.0.0, 6.1.0, 6.2.0, 6.3.0, 7.0.0 |
| 7.1.0 | 6.3.0 migrated to 7.1.0 | 5.0.6, 6.0.0, 6.1.0, 6.2.0, 6.3.0 |
| 7.1.0 | 6.2.0 migrated to 7.1.0 | 6.2.0 |
| 7.1.0 | 6.10 migrated to 7.1.0 | 6.1.0 |
| 7.1.0 | 6.0.0 migrated to 7.1.0 | 6.0.0 |
| 7.1.0 | 5.0.6 migrated to 7.1.0 | 5.0.6 |
| 7.0.0 | 7.0.0 | 5.0.6, 6.0.0, 6.1.0, 6.2.0, 6.3.0, 7.0.0 |
| 7.0.0 | 6.3.0 migrated to 7.0.0 | 5.0.6, 6.0.0, 6.1.0, 6.2.0, 6.3.0 |
| 7.0.0 | 6.2.0 migrated to 7.0.0 | 6.2.0 |
| 7.0.0 | 6.10 migrated to 7.0.0 | 6.1.0 |
| 7.0.0 | 6.0.0 migrated to 7.0.0 | 6.0.0 |
| 7.0.0 | 5.0.6 migrated to 7.0.0 | 5.0.6 |
| 6.3.0 | 6.3.0 | 5.0.6, 6.0.0, 6.1.0, 6.2.0, 6.3.0 |
| 6.3.0 | 6.2.0 migrated to 6.3.0 | 6.2.0 |
| 6.3.0 | 6.1.0 migrated to 6.3.0 | 6.1.0 |
| 6.3.0 | 6.0.0 migrated to 6.3.0 | 6.0.0 |
| 6.3.0 | 5.0.6 migrated to 6.3.0 | 5.0.6 |
| 6.2.0.1 | 6.2.0.1 | 5.0.6, 6.0.0, 6.1.0, 6.2.0, 6.2.0.1 |
| 6.2.0.1 | 6.2.0 migrated to 6.2.0.1 | 6.2.0 |
| 6.2.0.1 | 6.1.0 migrated to 6.2.0.1 | 6.1.0 |
| 6.2.0 | 6.2.0 | 6.2.0 |
| 6.2.0 | 6.1.0 migrated to 6.2.0 | 6.1.0 |
| 6.2.0 | 6.0.0 migrated to 6.2.0 | 6.0.0 |
| 6.2.0 | 5.0.6 migrated to 6.2.0 | 5.0.6 |
| 6.1.0 | 6.1.0 | 6.1.0 |
| 6.1.0 | 6.0.0 migrated to 6.1.0 | 6.1.0 |
| 6.1.0 | 5.0.6 migrated to 6.1.0 | 6.0.0 |
| 6.0.0 | 6.0.0 | 6.0.0 |
| 5.0.6 | 5.0.6 | 5.0.6 |