Back to Olo.com

Positouch Installation


Updated

PRE-INSTALL CONFIGURATION

There are a few Positouch and environment updates that must be in place before Olo will be able to run properly.

  • The Back of House (BOH) server must have sufficient disk space to process orders (Olo recommends at least 1GB of RAM and at least 5GB of free hard drive space)

  • Firewall requirements:

Network connections are always initiated from inside the store network (on the Back of House). No inbound ports need to be opened. The store computer needs to be able to make DNS lookups and make outbound connections to Olo’s servers.

Our windows service has the following network access pattern:

  1. It accesses https://api.olo.com on port 443
  2. It then connects to either pos1.olo.com, pos2.olo.com or pos3.olo.com on port 9292 (TCP). This connection is long-running and bidirectional.

 

 

Reason

FQDN

TCP Port

New IP Addresses

POS Connectivity

api.olo.com

443

52.0.148.73

52.1.103.28

52.1.106.63

52.202.120.141

52.203.244.50

54.83.190.167

54.84.184.104

54.165.137.17

54.208.197.95

pos1.olo.com

9292

52.20.200.81

pos2.olo.com

9292

52.23.79.84

pos3.olo.com

9292

52.207.85.59

pos4.olo.com

9292

54.80.187.138

pos5.olo.com

9292

54.80.236.14

POS Connectivity
(additional endpoint needed for Windows XP/2003 only)

legacy-api.olo.com

443

52.54.252.206

52.44.215.203

52.54.152.250

52.55.199.228

52.1.236.38

107.23.176.167

52.207.31.174

52.45.140.150

54.236.236.219

Olo Dashboard

(if used in-store)

my.olo.com

443

52.73.161.210

52.2.55.227

52.1.138.129

52.204.138.253

52.21.16.139

52.202.217.214

52.71.161.253

52.203.92.251

54.87.49.124

 

A good way to test this: open a command prompt, and try to telnet to our server using the command “telnet pos1.olo.com 9292” - if telnet fails, there is a problem with the store network or outbound port traffic configuration.

Installation Guide for Positouch Services

Goals

This guide should assist you in the installation of the Positouch services at a new location that has been configured for remote ordering

  1. Create 2 Virtual Printers if they are not yet created
  • XML Send
  • XML Confirm
  • Note of the Device Number IDs (3 and 4 in the example below)
  1. Link Virtual Printers in XML I/O
  • Notice that the Confirm XML printer is only linked to the XML Confirm Order
  • The XML Order detect interval seconds cannot be 0, otherwise the XML files will not be processed

 

  1. Edit the SPCWINI.ini
  • Add the XML Confirm Virtual Printer path from the previous step (Device Number 3 in our example) to the [VIRTUAL] section
  • Add the XMLInOrderPath to the [XML] section

 

  1. Setting for Customer Name
  • Go to the Club Accounts (Page 2) Print Options, Account Types and Status Codes form
  • Select the Check boxes of the desired items to be printed on receipts

 

  1. Perform an Immediate System Change to activate the new settings

 

  1. The following items will need to be provided to Olo to ensure orders can be received by Positouch:
  • Specific Employee number for every location (this is used for both employee and cashier number)
  • Specific Store Number that matches the Store Number in Positouch
  • Specific Menu Number from POS (this helps determine printer routing for orders)
  • Specific Terminal Number
  • Specific Menu Item number used for special instructions
  • Specific Cost Center from Positouch
  • Specific Payment Method from Positouch (must have tips enabled even if not used)
  • Specific Table Number for Olo Orders
  • Online Orders XML Confirmation Path
  • Online Orders XML Send Path

 

Installation Guide for Olo Services

Goals

This guide should assist you in the installation of the Olo services at a new location that has been configured for remote ordering

 

Summary

There are 6 steps to install the Olo Services and confirm that the services are running properly. 

 

Although the instructions here may seem intimidating at first glance, each step is quite simple and the installation – assuming the configurations in place are already correct – can take less than 5-7 minutes to complete.

 

Section 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: Start the Olo Services

Step 6: Confirm Store is Online Using the Dashboard

 

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 Positouch

4)  Click the button to download the most current version of the Olo Positouch Agent

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 must 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: Start the Olo Services

 

Start button -> Run -> Services.msc

Right-click the Olo Positouch Service, click Start.

 

The Olo Positouch Service will automatically start the Olo Update Service.

 

Step 6: Confirm Store is Online Using the Dashboard

 

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

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

 

Related Articles

  • Positouch Installation
  • Didn't find what you need?

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

    Copyright © 2017 Olo. All rights are reserved.