Installing the Android Service Host

The Android Service Host APK is an Android package file used to distribute and install the POS service host application software on a device running the Android operating system.
  • Starting with Simphony version 19.3.1, you do not need to use CAL to install, upgrade, or downgrade the Android Service Host. This section describes the steps required to install the Android Service Host using Simphony version 19.3.1.

  • If you are using Simphony version 19.3 or earlier, you need to use CAL to install or upgrade the Android Service Host. See the Oracle MICROS Simphony Client Deployment Guide—specifically Installing CAL on the Android Device—for instructions to install the Android Service Host using Simphony version 19.3 or earlier.

Install the Android Service Host APK for the first time on a new Android mobile device. Login credentials are required for the Simphony EMC and the mobile device in order to install the Android Service Host for the first time.

To install the Android Service Host on Simphony 19.3.1:

  1. In the EMC, select the property, click Setup, and then click Workstations.
  2. Click the insert icon This image shows the Insert icon, which is a green circle with a white plus sign. on the toolbar.
  3. Enter the Android device name, and then click OK.
  4. Double-click the new Android device record.
  5. On the General tab, select 6 - Tablet Client in the Type drop-down list.
  6. Enter the IP adress for the device in the Address / Host Name field.
  7. Click the Options tab, click the Offline/Misc subtab, and then enable the following options:
    • 17 - Allow Offline Operations

    • 45 - Exclude this Workstation from EMC Module Version Validations

  8. Click Save.
  9. Using the mobile device on which you want to install Android Service Host, access the Simphony Web Portal (SWP) by opening a web browser and entering the following address: https://[ServerName]/SimphonyApp.
  10. Enter the User Name, Company, and Password, and then click the Login button.

    Depending on your organization, there may not be a Company field.

  11. Click Downloads.

    If you are using a small device in portrait mode, you may have to scroll to the right to see the Downloads option.

    On some devices, you need to expand a menu to see the Downloads option.

  12. In the Download Type drop-down list, select Simphony Point of Sale Client Install (Android).
  13. In the Version Download Type drop-down list, select the Simphony version.
  14. Click the Download button to download the .apk file.
  15. Navigate to the Downloads folder, locate the AndroidServiceHost.apk file that you downloaded, and click it to install the application.
  16. Click Continue or Install. When the .apk installation is complete, the message App installed appears beneath a check mark.
  17. Click Open in the lower right area, and then click Allow. The Oracle MICROS Simphony launch page appears briefly.
  18. In the Host Name (Server Name/IP Address) field, enter the server name.

    Figure 8-1 Host Name


    This figure shows the Host Name (Server Name/IP Address) field with a gray background
  19. (Optional) To view the Server Port and EGateway information, click Advanced. This information may be required for support purposes and should not be changed..

    Figure 8-2 Advanced Options


    This figure shows the Advanced Options, which allow you to change the Server Port number
  20. Click the Next button.
  21. In the Enter Simphony Credentials dialog, enter your User Name, Enterprise Name, and Password, and then click the Login button. The Service Host APK is authenticated with the Simphony server.

    Depending on your Simphony system, the Enterprise Name may not appear.

    Figure 8-3 Simphony Credentials


    This figure shows the Enter Simphony Credentials dialog, which is a smaller dialog showing the User Name, Enterprise Name, and Password fields.
  22. If prompted, select the location, and then click the Next button. Otherwise, continue to the next step.

    If there is only one location, this page does not appear.

    Figure 8-4 Select Property


    This figure shows the list of properties in the left pane on a light gray background.
  23. Click the Android device, and then click the Save button. The device identity is verified, and the Service Host icon appears on the Android device screen.

    Figure 8-5 Select Device


    This figure shows the list of Android devices in the Available Workstation List.