Upgrading and Downgrading the Android Service Host

Upgrading

When a property is upgraded to a later Simphony version (19.3.1 or later), the Service Host on an existing Android device validates its version with the CAPS version during its startup.

You can download the latest Android Service Host from the application server if your Simphony system is self-hosted. Step 1 describes how to upgrade the Android Service Host for a self-hosted system.

Note:

If your Simphony system is hosted in the Oracle Cloud, do not complete the steps in this section. An Oracle Cloud Interface representative performs the upgrade.

All database information is retained when the system upgrades the Service Host.

Downgrading

The CAPS version should always be upgraded before upgrading the Service Host. If the Service Host version is later than the CAPS version (for example, the CAPS machine was not upgraded first and the devices experience a version mismatch), the Service Host application shows an out of synchronization error message. Step 2 describes how to downgrade the Android Service Host.

1. To upgrade the Android Service Host:
   1. Open the Service Host on a mobile device running the Android operating system.

      During the POS Operations startup, Service Host validates its version with CAPS to make sure both CAPS and Service Host are on the same version. Service Host also checks its version with CAPS at the start of each transaction. If the Service Host and CAPS are running on different versions, a message appears stating you need to restart the application and download the Service Host. (If CAPS is offline, POS Operations runs in offline mode and this message does not appear.)

   2. To download from the application server, click OK at the version message.

      Service Host automatically downloads and installs the APK files from the application repository based on the CAPS version. If prompted, allow permission to install on the device.

2. To downgrade the Android Service Host:
   1. Open the Service Host on a mobile device running the Android operating system.
   2. Click the OK button at the message to manually downgrade the Service Host version to match the CAPS version.
   3. Manually uninstall the Android Service Host APK from the device.
   4. Download the correct version of the Android Service Host APK from the SWP. See Installing the Android Service Host for more information.