Install 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 Essentials version 19.4, 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 Essentials version 19.3.1 and later.

• If you are using Simphony Essentials 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 Essentials 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 Essentials 19.4 and later:

1. In the EMC, select the property, click Setup, and then click Workstations.
2. Click the insert icon 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 2 - Workstation Client in the Type drop-down list.

   For Adyen Castles devices, select 7 - Castles Tech S1F2. See Add a Workstation for more information.

6. Select the Workstation Class for the device.

   Smaller devices, such as mobile phones, use 4 - Mobile Table Service Restaurant or 5 - Mobile Quick Service Restaurant. Larger Android devices, such as tablets, use 1 - Table Service Restaurant, 2 - Quick Service Restaurant, or 3 - Bar. See Add a Workstation for more information.

7. Enter the IP adress or host name of the service host where the workstation device application runs in the Address / Host Name field.
8. 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

9. Click Save.
10. 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.
11. Enter the User Name, Company, and Password, and then click the Login button.

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

12. 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.

    Figure 21-1 Welcome to Simphony Page with Downloads Option

    
    
    

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

    Figure 21-2 Welcome to Simphony Page with Expand Icon

    Figure 21-3 Welcome to Simphony Page with Expand Icon and Downloads

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

    Figure 21-4 Oracle MICROS Simphony Launch Page

    
    
    
19. Enter one of the following:

    • Cloud Code: Enter the cloud code from your welcome letter to connect to Simphony Essentials.

      If you enter more than five characters, the following message appears: Incorrect Cloud Code, please try again.

      Figure 21-5 Cloud Details

      
      
      

    • Server Name: Enter the URL to connect to the server.

      This entry field is free format. If you enter a decimal point, a list of common domain suggestions appears. You can select one of these domains rather than manually entering it.

    Figure 21-6 Server Details

    
    
    
20. (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 21-7 Advanced Server Settings

    
    
    
21. When the Cloud Code or Server Name (entered in Step 19) is valid, the Next button becomes active. Click Next.
22. In the Enter Simphony Credentials dialog, enter your User Name, Enterprise Name, and Password, and then click Next. The Service Host APK is authenticated with the Simphony server.

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

    Figure 21-8 Enter Simphony Credentials

    
    
    
23. If prompted, select the location, and then click Next. Otherwise, continue to the next step.

    This page does not appear for Adyen S1F2 devices. If there is only one location, this page does not appear.

    Figure 21-9 Select Location

    
    
    
24. Select a workstation device that shows either In Use or Available, and then click Next. When you select a workstation, it is highlighted in blue.

    In Use means the device has already been through the CAL process.

    This page does not appear for Adyen S1F2 devices.

    Figure 21-10 Select Workstation

    
    
    
25. On the Confirm Workstation Identity page, check the information shown, and then click Confirm and Start Point of Sale to start Simphony Essentials.

    Figure 21-11 Confirm Workstation Identity

    
    
    

    Figure 21-12 Starting Simphony Essentials