Mechanics of client upgrade rules

Note

Client upgrade rules are based on users and device types. Once a user has completed an upgrade, the server no longer attempts to upgrade that user on the same device type. If a user switches to a different device type, the new device is upgraded. If the user switches to a different device of the same type, that new device is not upgraded.

All upgraded clients are of the same localized version (language) as the previous client.

Client download directory structure

Within the M-Business Server directory structure, at <M-Business_Home>/tomcat/webapps/admin/install, there exists one or more directories with the naming convention <majorversion>_<minorversion>_<buildnumber> (for example, 6_7_55), where:

  • <majorversion> is the M-Business Anywhere major version number installed—the "6" in 6.7.

  • <minorversion> is the M-Business Anywhere major version number installed—the "7" in 6.7.

  • <buildnumber> is the actual M-Business Anywhere build number installed.

Information from these directories is used to populate the To New Client Version list in the Create a Client Upgrade Rule page. You cannot specify an M-Business Client version to upgrade to, unless the version is represented in this client download directory structure.

Automated M-Business Client upgrade example

Here is a possible scenario of how you could use the M-Business Client upgrade feature. Assume the following:

  • You start with a version 6.7 M-Business Server.

  • Your M-Business Server bundles M-Business Client version 6.7.55.

  • Your users of this system have been synchronizing a variety of device types, through cradles, using M-Business Client version 6.7.55.

Now you are upgrading the server from 6.7 to 7.0. Suppose that the 7.0 server bundles client 7.0.61. Create an upgrade rule with the following parameters:

  • Rule Name – "Upgrade All from 6.7 to 7.0" (or whatever you like)

  • Device Type – All

  • From Client Version – 6.7.55

  • To Client Version – 7.0.61

  • Apply To – All users

As users cradle-synchronize to the server, their clients are upgraded from 6.7.55 to 7.0.61. You can monitor the progress of the upgrade on the List Rules page. See Listing client upgrade rules.