Printer Setup - Troubleshooting steps.

Device: Add Device

All the devices need to be registered as a virtual device here with the specification of the type of operation for

which it is going to be used, i.e., Receipt, BAR Printer, Kitchen Printer, etc.

Go to: Configuration Panel > Settings > Device > Add

Terminal

A terminal is used to a mapped virtual device with a physical device which is connected to a machine.

For printing to work from eO, all the printers which are needed to print Receipt/KOT need to be configured in

the Terminal Module.

Go to: Back Office > Settings > Terminal

Terminal: Configuration

Goto: Back Office > Settings > Terminal > Add

To add a new terminal, click on the ADD(+) button on the top-right corner of the terminal listing screen.

As shown in the picture, the printers can be added in the terminal by clicking on the Device Mapping Button.

Terminal: Add Device Mapping

Adding a device is a very crucial part of printer configuration. The wrong configuration may lead to inconsistent

printing or no printing at all.

Below given is a description of the properties of the device mapping form.

1. Device:

To choose the virtual device on which eO should send a print based on the type of the virtual device

specified when creating it.

● When Device type is KOT Printer, Selection of KOT Template will appear at the bottom of the screen.

● When Device type is Receipt Printer, It will provide an option to choose Guest Check and Receipt

Template for Each Order Type

Note: You can create different templates for KOT And Receipt from Back Office > Settings > Printing

Template.

2. Device Name:

Name of Printer which physically installed in OS (For Optimus Printer Service) or Name to identify Printer (For

Browser or Ethernet Type)

3. Connection Type:

To determine communication channel with a printer.

Optimus Print Service:

Optimus Print Service is required when needs to print on multiple printers. For this option need to Install

Optimus Print Service on Terminal or Printer server where printers are connected or installed. You can setup it

on multiple bases on your hardware setup.

On selection of this connection type, the system will ask for IP address where Optimus Printer Sevice Installed.

You can use 127.0.0.1 if service is installed on the same machine which you are using. When Service is

installed on a different computer, need to set a fixed IP address of that computer and mapped it with this field.

In the next section, you can get step for Optimus Printer service setup and configuration.

Ethernet: Optimus can print directly to network printer without Optimus Print Service. But this Option is

available for limited printers only.

On selection of this option, the system will ask for IP address of that printer and enter 8043 in port number

field.

Browser: This is available for Receipt Printer Only. With this setting, all communication with the printer will be

handled by the browser. So whatever printer is supported by the browser we can print a receipt on it.

eZee Optimus Printer Service (EOP): Installation

Download service from the following link.

https://ezeenextgen.s3-us-west-2.amazonaws.com/download/Integration/EO%20Printer/EOP_Setup.exe

1. Run the EOP_Setup.exe file to start the installation process.

2. After the installation is complete, when you'll run the EOP for the first time, the following dialogue will

appear. Click on Allow Access.

3. To check whether it has access or not, Navigate to Windows Control Panel, System and Security and

Windows Firewall. Select Advanced settings and highlight Inbound Rules in the left pane.

You should see something like the following image.

Note: The EOP must be running on the same machine where the printer is installed.

eZee Optimus Printer Service: Troubleshooting

1. Check if the printer service is running.

Type the following URL in the address bar of the browser: <ip>:8006, where <ip> is the IP of the machine

which is configured in terminal.

e.g. 127.0.0.1:8006

If the printer service is connected, you'll see a message in the window saying "Printer service is started on

Port: 8006".

If you don't see this message, check firewall rules and restart the eO Printer Service.

2. Check if the printer service can send the prints to the printer.

Right click on the EOP in the system tray. Click on the Printers. The screen shown in the following image will

open.

● If the printing is working from this screen then it means that the printer service is connected to the

printer.

● If not, check if the printer is connected to the machine. You can check it by printing a test page from

printer preferences or printing a Notepad Document.

● If all of the above checkpoints are working fine. then move to the next point.

3. Check Terminal configuration

● Check Device Name if it matches the name given in Printer Properties in Printer

settings of the machine. It must be the same.

4. Service Installed on Different Machine

In case you're sending a print from a different machine/tablet of the same network (other than the one in which

the printer is connected)

○ Make sure the EOP is running on the HOST.

○ Perform the 1st step of troubleshooting in the CLIENT.

○ The printing will work only if you can access the EOP from the CLIENT.

○ If you don't receive any acknowledgment than check the Windows Firewall/Defender Setting in

HOST and Make sure the Java(TM) Platform SE binary is allowed all accesses in public

network.

Note: HOST - Machine in which the printer is connected and EOP is running.

CLIENT - Machine(s)/Device(s) in the same network other than the Host.

5. Firewall Setting (If Required)

Navigate to the Windows Control Panel, System and Security and Windows Firewall. Select Advanced settings

and highlight Inbound Rules in the left pane. Find Java(TM) Platform SE Binary.

Ethernet: Troubleshooting

1. Check if the printer is in the network.

Open terminal and ping IP of the printer. If connection times out, then the printer is not connected to the

network.

2. Check the IP and port in the terminal configuration.

● As stated in Terminal Configuration, In ethernet printing, the IP field should contain the IP of the printer

instead of the machine itself. So please check if it's right.

● The port should be 8043. If it doesn't work, find the port in the printer utility (can be opened by typing

the printer IP in the address bar of the browser)