Creating installation thumb drive

(USB drive is reusable, only necessary to make

new one if the auto install file changes)

Download ISO file from

OwnCloud Synetouch Tech
/ Reseller Releases /
Server auto install
Format thumb drive to Fat32
filesystem
ª File explorer and right click to the pen drive –
choose format
Make Fat32 is selected for File system, leave other settings as it is

Download unetbootin (https://unetbootin.github.io/)

Start unetbootin - check disk image and
select the downloaded iso file

Mount disk image file (ISO) to this thumb

drive
 Setting up a Synetouch Server (using the auto install USB thumb drive)

On the Server
Enter to the server BIOS using DEL/ESC key.
Choose Advanced option Select CSM configuration
Set Compatibility Support Module configuration (CSM configuration) to enabled: Boot mode is set
to Legacy mode.
Save your settings.

NUC – No special settings is necessary

Insert installation USB and make sure server connected to internet

Boot from USB - choose option: Auto install EVERY DATA WILL BE LOST!
After booting it will take 30-50 min. The installer is doing everything automatically. When it installed the
system it writes: “Installation complete”
Remove USB stick and press “Continue”
The computer is rebooting and loading the newly installed Debian Linux system.

Once installation is done then in the terminal (black window for command lines) the script will ask: “Type
the name of new restaurant database! Do not use space accented and special characters in the
name!!!” Type the correct data and press enter.

The scripts setup a blank database (only demo user, no menu items, tables – Synetouch application on
server - CUPS with printer drivers - synetouch application - startup scripts - a backup script -
TeamViewer.

The last step that the script starts the installed TeamViewer, please add to your TeamViewer account and
send it to us. You can also add this server to your personal Teamviewer account by using the
connection details from the server on your personal computer. Be sure that you follow the check boxes
in the bottom of Teamviewer to setup “Unattended Access”

After this the base system installed and ready for specific configuration.

Restart server
 How to prevent Debian from going to sleep and requesting a password
Applications > Settings > Power Manager
Under System tab: Change System Sleep Mode to Suspend
Under Display tab: Move all sliders to Never
Under Security tab: Change “Automatically lock the session” to Never in the drop-down menu AND
uncheck the box next to “Lock screen when system is going for sleep”

Testing the synetouch system

After Linux loaded back open Firefox and hit this URL: http://localhost:8080/"databasename"/admin the
“databasename” is the name what you’ve typed in the script as database name.
In the login window type:

User: demo

Password: 1234

If you are able to login the server installed successfully. Bookmark the page.
 UBIQUITY ROUTER SETUP
Connection and Download Files

- Connect server to 1st port of Ubi router

- Connect internet to any other port
- Download the latest configuration files from ShareFile (Installation > Ubiquity ), and place them in the Rounter, folder on
the Servers root directory.
o ubi_default.sh
o ubi.cfg
Setup
- Right click in the Router folder and open a Terminal
- Give edit rights by typing command
o chmod 777 ubi_default.sh
- Run this from terminal
o ./ubi_default.sh
o * do not run as sudo
- Answer to questions:
o Name of restaurant
set user name: admin
set pass: proconxus

- Type in terminal command

o Ssh ubnt@192.168.1.1
o Password: ubnt
o Type in reboot
FINISH SETUP
- When done restart server and connect internet to 1st port and server to any other
- Login to router 192.168.88.1 to reseve Ips for any other connected devices

UBIQUITI AP
- Connect Unifi AP (on power adapter make sure POE
goes to AP LAN to router)
- Type in browser https://localhost:18443
- First time it will say your connection is not secure -
click advanced and add exception - Confirm security
exception
- Use this:
o user
o proconxus

Login to AP

- admin

- SyneUS17

- Skip cloud enable

 Setting Up an iPad

1. Turn on the iPad

2. Press the home button
3. Choose the language.
4. Select “United States” as your country or region.
5. Select a WIFI network. Choose the Synetouch network for the restaurant if it is available. If using a
Synetouch network the password should be “proconxus”
6. Wait for the iPad to Activate.
7. Enable Location Services
8. If your iPad allows Touch ID select “Set Up Touch ID Later” and press Continue
9. Create a Passcode for the iPad. We recommend 1234 or 123456 as a default password. If you choose to use
a different passcode please record it. This passcode can be turned off later in the iPad Settings. If you are
asked “are you sure you want to use this code” choose “Use Code.”
10. Type in your passcode again to confirm the code.
11. Select “Set Up as New iPad”
12. Choose “Don’t have an Apple ID or forgot it?”
13. Select “Set Up Later in Settings” at the bottom of the page. When asked “Are you sure you don’t want to
use an Apple ID?” choose “Don’t Use”
14. Select “Agree” at the bottom right corner of the Terms and Conditions page.
15. Select “Don’t Use Siri”
16. Select “Don’t Share” at the bottom of the iPad Analytics page.
17. Select “Get Started”
18. Move the Settings button to the Quick Bar along the bottom of the iPad home screen.
19. Move Messages, Mail, and Music off the Quick Bar.
20. Create a folder for the unused apps by dragging one app on top of another.
21. Drag all apps except for Safari and Settings to the new folder.
22. Move Safari off the Quick Bar.
23. Open Safari
24. In “Search or enter website name” type https://apps.procon-x.hu:444/app/synetouch.html

25. Download the Latest Stable version or other compatible version.

26. Choose “Install”
27. Save a shortcut to this page by pressing the icon of a box
with arrow next to the URL and choose “Add to Home
Screen”. Save the shortcut as Synetouch Apps.
28. Go back to the home screen of the iPad
29. Move the Synetouch App to the Quick Bar and move the
Synetouch Apps shortcut to next to the Safari App. Press the
home button to stop moving apps.
30. Open Settings
31. Make sure the iPad is connected to the correct Synetouch
network for it to connect to the server. If you are using a
provided remote access URL you can use any network with
an internet connection.
32. Go to General > Device Management. Select “Project Control Expert.” Select Trust “Project Control
 Expert…” Confirm that you trust the app.
33. Go to General > Keyboard and turn off all the keyboard options except for “Enable Caps Lock.”
34. Go to Touch ID & Passcode, enter the passcode you set up in Step 9, select Turn Passcode Off. Enter your
passcode again.
35. Go to Settings > Synetouch
36. Turn off “Animation enabled”
37. In the URL enter the IP address of the server followed by :8080 or use the remote access URL if needed. Ex:
###.###.###.###:8080 or #####.synetouch.com
38. If you are using a remote access URL you will need to enable “Https connection.” Skip this if you are using
the server’s IP address.
39. In “Path” enter the name of the .war file or restaurant name.
40. Under “Credit Card Reader” select the appropriate model of reader.
41. Assign the printer ID in “Assigned printer” if you have it.
42. Exit the Settings and Launch the Synetouch App.
43. If you get an error message about an untrusted app see Step 32.
44. Allow the permissions the app asks for.
45. If you get a blank screen check or connection error check the Settings from Steps 31 and 37. Then double
click the home button and swipe up on all the running apps to close them.
46. Enter the default pin number (1234) for the demo user.
47. If the app takes you to an update page please download the update and launch the app again.
48. If the iPad has not been activated it will prompt you to activate the iPad before you continue.
49. To activate an iPad log into the back office and go to System > Terminals. Find the iPad and check the
Activated box.
50. Log into the app again with the default pin number (1234) and choose Clock In.
51. If you are able to log in you have successfully set up the Synetouch App.
 Set up Printers and CUPS
Connect all the needed printers to the router or switch.
Press and hold the reset button while turning on the printer, continue holding the reset button for 5
seconds. This will get an IP address from the router.
After releasing the reset button wait for another 5 seconds and press the reset button again to print
the printers network information.
After you have done this to all printers, log into the router by typing 192.168.88.1 to the browser and
go to IP > DHCP server and set the IP addresses of the printer to static.
Go to IP > DNS and Click on Static.
To test the printers, open a terminal and ping each printer with the names you just created.
Open Firefox and go to localhost:631.
Login with: ID-user , Pass– proconxus
Go to Administration and Add Printer
Choose AppSocket/HP JetDirect
Add the printer using socket://hostname:9100 where hostname is the ip address. (etc:192.168.88.254)
Give the printer a name, description, and location.
Select Bixolon.
Choose the driver that matches the printer.
Under the general settings change the Media Size to 72mm * 80mm (for Bixolon SRP-350III only) and
enable Color Mode (for Bixolon SRP-275II and Bixolon SRP-275III only).
In Policies change the Error Policy to abort-job.
Test printer from cups on the left drop down page
Drop down print test page
Change ip to static on printer by typing the IP address of the printer in the browser address bar, and
uncheck the DHCP check box
Add printer to BO by copying the address in the browser bar for Cups into the Back Office System >
Printers in the Address bar.
Test from BO by clicking the print test page button
 To Install a Pax S300 Unit:
(Note: You will need to make sure the Synetouch router is set up to complete the setup.)
Make sure you have the payment credentials programmed into the system. You may do this later but it must
be done before you can take payments.
Make sure Heartland has added the Pax to the restaurants account and had the configuration file ready to
download. You may also do this later but it must be done before you can use the Pax.
Plug in the Pax.
Connect the Pax to the restaurant’s Synetouch network. The red plug is the LAN Connection.
The Pax will check for updates and download the configuration file from Heartland when it boots or reboots.
Next, you will need to reserve the IP address of the Pax.
Make sure the Pax is Connected
Press Func + 1 to open the Pax menu.
Enter the password 916860. This is the password for every menu option in the Pax.
Scroll to Communication >> LAN Parameters
Scroll to DHCP Type and set the type to DHCP.
Exit the menus. You should see a message about DHCP.
Go back to DHCP Type and change the type back to static.
Go to Communication >> LAN Parameters >> IP Address and record the IP address.
Log into the router. Go to IP >> DHCP Server >> Leases and choose the entry for the Pax. Click the Make Static
button and exit the router.
Add the Pax to the Back Office:
Log into the back office and go to System >> Card Readers.
Click New Item
Add the IP address, set the port to 10009, and give the pax a name.
You can assign specific Pax’s to specific iPads by going to System >> Terminals, if you do not assign the Pax’s to
iPads it will prompt the server to select a Pax when they run a card.
Updating a Pax:
You will need to clear the database on the Pax and reboot the device before you go live.
On the Pax go to System Settings >> Database
Enter the password 916860.
Select Clear Database
Press Enter
Select All
Unplug the Pax and plug it back in. If it has an internet connection it will check for updates.
Note: Clearing the Pax database will resolve many non-networking issues with the Pax.
 Setup Up Payment Settings
in Back Office

Log into back office

In the browser address window add this to the
end of the address after ADMIN/
payment_settings_editor.xhtml

Enter these payment details, then click test

and save.
Everything is entered correctly you will see
blue text bar at the top that says it was
successful.

Some of these details are found either on the

Pax Device or in the email Heartland will send.
And other details in the Heartland Developer
portal.

URL:

https://posgateway.secureexchange.net/Hps.Exchange.PosGateway/PosGatewayService.asmx

Device ID: From Heartland or Pax

Licence ID: From Heartland or Pax
Site ID: From Heartland or Pax
Site trace: Same as Site ID with extra 1 at end

Manual entry public key: from heartand developer site

Manual entry private key: from heartand developer site

Manual entry token url: https://api2.heartlandportico.com/SecureSubmit.v1/api/token

Username: From Heartland or Pax

Password: From Heartland or Pax

Modification password: pce4321

The Device ID, Username, and Password can change from what Heartland sends out initially.
They should ALL be the same across ALL devices. You will not be able to batch, void, or add tips if they are not
ALL the same for every Pax device. Heartland will have to update the Pax files for the devices to ensure they
are all the same if any are different.

Test to make sure all settings work

Ring up a transaction on pax and adjust tip then void from BO
Ring up a manual enter transaction. Either on pax and long pressing credit card and typing on the ipad.
Ring a 1 cent transaction and batch out that transaction from back office. Call Heartland to make sure they see the
batch.
 Updating a Synetouch System

Download the latest stable projectrestaurant.war file from ownCloud.

Extract the prod_dev.properties file from projectrestaurant.war/WEB-INF/config
Open prod_dev file.properties and change rest_dev in the line
jdbcUrl=jdbc\:mysql\://localhost\:3306/rest_dev to whatever the name of the schema of the database is.
Save your changes.
Drag and drop the updated prod_dev.properties file back to projectrestaurant.war/WEB-INF/config
To create a backup of the restaurant’s database open a terminal and run “sudo mysqldump
–routines -u root restaurantname > restaurantname_time_date.sql” changing restaurantname for the
name of the schema. Check the size of the file in the home folder.
Change the name of the projectrestaurant.war file to the name of the current .war file. (This is usually the
name of the restaurant.
Copy the restaurants current running WAR file and Database back up into separate folder
Make a second database backup
Restart the server. ( Not necessary before each update but suggested)
Delete the current .war file from the webapps folder. Wait for the other folder with the name of the .war file
in webapps to be deleted. (If the folder is not automatically deleted you may delete it by opening a
terminal in the webapps folder and run sudo rm -r foldername)
Open a terminal and run the top command.
Copy and paste the new .war file to the webapps folder.
Watch the activity in top running in the terminal for the synetouch services (Java and MySQL). You will see
these services near the top taking up most of the system resources. When the use of system resources
synetouch drops off, try to log into the back office.
If you were able to log into the back office you have successfully updated the system.
After you have updated the system open a terminal and run “sudo service restart synetouch” or restart the
server to free up memory. (You will need to wait 5 to 10 minutes for either method to finish.)
To update the iPads open the app and try to login. If the system detects an update it will open a webpage to
download the compatible version.
 Daily closing procedures
Ipad side

Each server/manager should go trough the following points:

Look for open orders with Opened orders icon (tables,tabs,to-go tabs ), check reopened orders and close
them
Check credit card transactions under Tip screen (all has to be adjusted with tip even if it’s 0) the sceen
should be empty
Checkout by with the door sign in the upper left corner (declaring cash sales if necessary)
Save server checkout report
Clock out – if user clock out before prints this report it will zero out the report and only way is to print
again from backoffice
After all servers loged out managers can run a house report from the ipad
Report sreen – House report

Backoffice
Admin – Live transaction editor : make sure all the transaction has the right tip amount and has checked
all the In Batch boxes
Reports – Sales – Sales analysis, House report, Batch close report
Reports – Server – Server Checkout reports :
If there is a doubt that printed server checkout report does not show the right numbers (e.g.:server
clock out before print checkout report) you can run the report from here – it is always reflect
the final numbers
Settings- Employee work hour editor :
Check who not clocked out (pick today date to From field an hit show result
Modify hours
 Synetouch Kitchen Display Getting Started

Installation
Unzip the file
Edit the settings.properties
Set the host to the Synetouch server IP with PORT e.g.: http://192.168.144.187:8080
Set the path to the Synetouch server application, e.g.: lxr

Kitchen Display Files

jre directory – build-in java environment. DO NOT MODIFY THIS DIRECTORY!
tools directory (wget.exe, libeay32.dll, libiconv2.dll, libintl3.dll, libssl32.dll, wget64.exe and unzip.exe) –
binaries required to the auto-update mechanism
kd.bat – run kitchen display using the KD’s build-in java environment
kd_update.bat – Update from Synetouch server and run kitchen display using the KD’s build-in java
environment
synetouchkitchendisplay.jar – Kitchen Display client application
settings.properties – Synetouch server configuration

Running
Run kd.bat (just run) or kd_update.bat (update and run)
Use application in full-screen mode
Application can be closed with ALT+F4 combination, like any windows application

Setup & Usage

To have orders displayed, you have to add a Kitchen Display in Back Office, and assign it to one or more
categories the items of which you would like to have displayed. Follow these steps:
Run Back Office
Go to ‘Printers’
Add a printer, set type to ‘Kitchen Display’
Go to ‘Menu Editor’
Chose a category and add the Kitchen Display to the category’s printer list. From now on the items of this
category will be displayed on KD when they are ordered.

General usage of Kitchen Display:

Once you launched KD and you have your iPad with Synetouch ready you may start using KD. Make sure
Back Office server is running as well.
Order a few items from the category, to which you added a kitchen display as printer.
After you place your order, the relevant items will show up on your KD screen.

Auto-update System
Kitchen Display comes with an auto-update mechanism:
Latest KD client distributed in the server’s .war file
The KD installation contains the required scripts to perform the auto-update
Stop the running Kitchen Display client
 Run the kd_update.bat that perform the auto update
To update the system the settings.properties file has to be configured properly because server url in this
file will be used during the update process

Testing the Auto-update System

Preparing to the test
Stop running Kitchen Display client application
Always use the latest server version
Check your settings.properties configuration
Check your tools directory
Check your kd_update.bat
Remove your synetouchkitchendisplay.jar file

Running the Test

Run kd_update.bat
If KD client downloaded, the KD client should start automatically

BUMP BAR INSTALLATION

Contents of Utilities.zip:
KBWN.exe
Keyboard Layouts.docx (available by itself)
KitchenDisplay.tpl

********************************
**** How-To Install BUMPBAR ****
********************************

* Connect BumpBar to YOUR Windows machine, not the one you are installing it to
* Open program KBWN.exe
* Click Keyboard--> KB1700 (select)
* Select Template--> Load
* Navigate to the KB file directory and select "KitchenDisplayFIXED.tpl"
* Go to Configuration--> and choose "Write Into KB"

* The BumpBar should now be mapped correctly. You can connect it to the install machine and test it
 Adding Images to Syneweb
I set up locally the online ordering so you can see
the changes while you are woking on that.

So login to backoffice, may be from home on this

link: https://48XXX.synetouch.com/WAR FILE
NAME/admin

Select what Cartes you like to show up online

ordering, right now all of them but if you click
each carte you can uncheck online ordering:

Then upload picture for each menu item:

Then on menu editor click on Sync

If it says successfull after a few minutes you can check the pictures here:
https://48XXX.synetouch.com/’Syneweb WAR file name”/index.xhtml?token=”syneweb database name”
You can also use the online ordering app, just go ipad settings – cestlavie app settings and have the
following there:
OO URl : https://48XXX.synetouch.com/”Syneweb WAR File Name”
OO Token: Syneweb Database Name

You do not need to change the rest of them and when it is done customer do not need to do this.
 ADMIN Right for online ordering page to activate payments
In mysql pick a user and give him admin right by creating a new query

Select * From sweb_users

Find thier User ID #
Create a second query
Select * from syneweb2.sweb_users_sweb_roles

In the row that matches that User ID # select RolesID

Change it to 2
Hit Apply (bottom right)
Close the Window
In a web browser login to the website with that users credentials at this path
http://”localhost”:8080/”synewebPATH”/index.xhtml?token=”synewebTOKEN”
Go to the payment settings screen
http://”localhost”:8080/”synewebPATH”/admin/payment_settings_editor.xhtml
Enter the Payment Credentials in fields the same as for Back Office
Click Save (if you see a red bar appear they were not accepted)
 Installing the Digital Menu App
Update android OS
Download the digital menu app from https://apps.procon-x.hu:444/app/digitalmenu.html
Install the app. You may need to allow apps from third party sources in the android settings.
To enable 3rd party apps go to android Settings > About Device
Tap the line for Build Number 7 times
Now go back to the Settings and tap the Developer Options that has shown up
Tap the option to enable 3rd party apps
Open the digital menu settings on the app.
In the server URL enter the server’s URL such as http://172.16.198.14:8080/ or
http://199.synetouch.com:8080/ (for REMOTE)

In APPLICATION NAME enter the name of the restaurant’s .war file, such as orderdemo.
 Create a blank Database

script will create one schema with blank database

First, make sure to download either an existing .sql file or a blank .sql file to create the database that the
restaurant will be using. NOTE: We use MySQL Workbench instead of Emma, but do not remove Emma
Open MySQL Workbench.

Select “New Connection”

Name it “localhost”

Double-click “localhost” above where you clicked New Connection to open the connection.

Create a new database (schema) by clicking the Gold  icon.

Choose “Apply” and then “Apply” again to create the new schema.

Double-click the new schema in the left-hand navigation pane,

Load the blank.SQL

Leave LF

Execute it using the  icon.

 Deploy the application (.war file) using Synetouch
We will first need to modify the prod_dev.propeties file which is located within the .war archive.
From the Applications Menu choose File Manager and navigate to where you have saved the
restaurant.war file.

Right-click the .war file and choose “Open with Xarchiver” or “Archive
Manager”

Inside the archive viewer navigate to “/WEB-INF/config”

Locate the prod_dev.propeties file and drag it anywhere outside of the

archive. – If you open with Archive manager then you can edit this
prod_dev.properties file without moving out.

Open the file you just extracted and change the name in bold below to
match your DATABASE name in MySQL.

#main rendszer a production serveren

jdbcUrl=jdbc\:mysql\://localhost\:3306/databasname
user=root
password=
settingsBean.picturesLocation=/opt/synetouch/images
settingsBean.defaultPictureName=defaultItemImage.jpg
settingsBean.printDirectoryLinux=/opt/synetouch/printer/toprint
settingsBean.previewDirectoryLinux=/opt/synetouch/printer/topreview

Save the file.

Drag the updated

prod_dev.propeties file
back into the projectrestaurant.war to the “WEB-INF > config” directory. In case of using Archive
Manager you don’t need to move back anything since you edited the file inside the war file, just
confirm the update.

Rename the .war filename to the restaurant name.

Copy the .war file to opt/synetouch/webapps

This will create a folder and deploy the application. This process will take around 4-8 min.

You can always check the deploying status by open a terminal and type top, while Synetouch is
among the first few lines of running processes; it is still working.

If you get an error your prod_dev.propeties changed name probably doesn’t match your database
name in MySQL.

To check to see if the back office is available use:

http://localhost:8080/*contextroot*/admin/ManagerLogin.xhtml
(remember to replace *contextroot* with the context root you made)