Back to Olo.com

Olo Focus POS Service Installation


Updated

Audience

Technical Teams, Customer Success Teams, Client's POS Programmer   

Description of the Issue

Olo is not installed on the Focus POS computer and this is required for Olo integration.

Solution Summary

The instructions below may seem intimidating at first glance, but each step is quite simple and the installation (assuming the configurations in place are already correct) can take less than 7 minutes to complete.

Overview

  Step 1: Confirm store is “Offline” on the Olo Dashboard

  Step 2: Generate a Password

  Step 3: Download the Installer

  Step 4: Follow the Instructions in Wizard

  Step 5: Confirm Store is Online Using the Dashboard

Installation Procedure (basic store install):

Step 1: Confirm store is “Offline” on the Olo Dashboard

The purpose of this step is mainly to confirm that you have dashboard permission to view the store, and since the store will connect automatically and disappear from the “Offline” list, it is a nice way to confirm that your installation has succeeded.

Log into the Olo Dashboard at https://my.Olo.com and click “See Offline Vendors” button. The store will be listed below.

Step 2: Generate the POS Password

Since it takes 2 minutes or so for the password to register with the POS connection servers, it makes sense to generate it for the store before running the installation tool.  

Tip: If you forget to generate the password upfront and instead generate it right before entering it into the installation tool, you may see an “Invalid Username or Password” error. Simply wait a few minutes for the newly generated password to register and then try it again.

From the Offline list click on the store’s name to go to the Settings page for the location. Click on POS Settings link.

Click on “Generate a New Password” button. Confirm the warning dialog and a password will be generated. Mouse-over the box to see the password for the username listed above the warning message. Keep this page open as you move to the store computer for installation.

Step 3: Download the Installer from the Olo Dashboard

  1. Go to Brand section on the left control list

  2. Select POS Downloads
           
                
                                                                      
  3. Select Focus for your POS software



  4. Download the most current version of the Olo Focus Agent



  5. Run the installer on the POS server

Step 4: Follow the Instructions in the Install Wizard

  1. Click Next to begin the process.
  2. Click Next for the destination folder.
  3. Enter the Olo username and password (the one generated on the Olo Dashboard in Settings).
  4. Click Install and then Finish when it is done.

Important Tip (!): You will have to start the installation over if the values entered here are incorrect. Be sure to double-check these entries to be sure you get them right the first time!

Step 5: Confirm the store is online using Dashboard

Once the services are running, the store should be automatically connected and displayed as Online within a couple of minutes

Open up the dashboard and click See Offline Vendors button to refresh the list, and confirm that the installed store is no longer listed

Troubleshooting

If any problems are encountered after the installation, e.g. a test order placed to the store fails, take the following steps:

Confirm that the services are running

  1. Open a run box by keying [Win]+R (or the [Start] button, then Run...)
  2. Type services.msc and click [Enter]. This opens the Windows Services list.
  3. Verify that the two OLO services named OLO FocusPOS Integration Service and OLO Update Service are in the list with status Started.
  4. If they aren’t, right-click each and select Start from the context menu.

If test orders continue to fail, proceed to the next step.

Check the logs for errors

The services’ log files are located at:

C:\Program Files\OLO\OLO FocusPOS Integration Service 1.0\Logs\

There are two log files, one for the Integration Service itself, and one for the Update Service which handles upgrading the Integration Service when new versions become available.  Most often, the Integration Service log is the one that will be most useful.  The Integration Service log is formatted:

OLO-YYYYMMDD.log

While the Update Service log is formatted:

ServiceUpdater-YYYYMMDD.log

Open the Integration Service log with the correct date (today’s date) and look for exceptions - doing a text search (CTRL + F) for the actual term “exception” is a good strategy.  The general rule of thumb is that if the exception came from the POS, it will be formatted:

These are errors that occur at the POS level itself, and generally indicate some kind of misconfiguration.  An example of a non-POS-generated error looks like this:

System.Net.WebException: Unable to connect to the remote server ---> System.Net.Sockets.SocketException: A connection attempt failed because the connected party did not properly respond after a period of time, or established connection failed because connected host has failed to respond 67.192.242.213:443

This particular error indicates that the Update Service can’t connect to the internet, which is usually indicative of a network problem at the store location.

It isn’t possible to list every scenario, but generally the error message will offer some clue as to where the problem lies.  The main candidates are POS itself, the internet connection, and the Integration Service.  Other less common environmental configuration issues may also present themselves, but should be made clear by the specific error message from the log.

 

 

 

Didn't find what you need?

Submit a request to our Help Team and someone will
get back to you shortly.

Submit a request

Copyright © 2017 Olo. All rights are reserved.