Skip to main content
OCLC Support

Set up your POS printer

Follow the below instructions to set up your Epson receipt printer for use with the Circulation module.

  • The Windows account used must have Administrator rights in order to install the required software and print drivers.
  • If you have problems at any time, contact OCLC Support.

If you have already installed the Java Runtime Environment (JRE) and JavaPOS ADK, see POS Printer Preferences for instructions on downloading the POS Printer Application.

Windows 10 users
1. Download Java
  1. Go to http://java.com/en/download/manual.jsp.
  2. Download Java version jre-8u131-windows-x64.exe or higher and save the file to your computer.
  3. Find the downloaded Java file on your computer and install the file.
2. Download JavaPOS ADK
  1. Use this file: EPSON_JavaPOS_ADK_1144.zip
3. Run the printer setup

This must be run as an Administrator.

  1. Open Start > All Programs > Epson JavaPOS ADK > SetupPOS.
  2. Click Edit > Add.
  3. On the Important Properties screen, fill in the fields:
    1. If needed, enter a new Logical Device Name.
    2. Select POSPrinter from the Device Category list.
    3. Select your device from the Device Name list.
  4. Click Next.
  5. Select your Port Type from the list, and click Next.
  6. On the Common screen, change any settings as needed, and click Done.
  7. To save your configuration click File > Save, and save your file as jpos.xml.
  8. On the Confirmation window, click Yes.
  9. Close SetupPOS.
4. Run Health Check
  1. Open Start > All Programs > Epson JavaPOS ADK > CheckHealth.bat.
  2. On the CheckHealthTool window, on the left sidebar, click POSPrinter > POSPrinter.
  3. Click CheckHealth.
  4. On the POSPrinter Service, click Print. The POS printer should print.
  5. Click Close.
5. Configure the printer in Windows
  1. Navigate to Control Panel > System and Security > System.
  2. Select Advanced system settings.
  3. On the Advanced tab, click Environment Variables.
  4. From the System variables list, select Path and click Edit....
  5. Input the path to the JavaPOS bin folder.
    • Example: C:\Program Files\epson\JavaPos\bin
    • epson/JavaPOS is where the epson drivers are installed and bin is the folder we want in the path.

     Note: This variable contains pathways for multiple applications. Each pathway is separated by a semi-colon (;). If you need to enter the Path value, navigate to the Java folder on your computer, and open the folder. View the properties of a file within the bin folder and copy the Location into the Variable value field. You should update this value any time a new version of Java is installed (the active directory name will be different).

  6. Click OK to confirm changes.
  7. Close the Control Panel.
  8. Browse to C:\Program Files\epson\JavaPOS\lib (this is where you installed the JavaPOS drivers). In this lib folder, you should see jar files.
  9. Copy all of the files in the folder and paste them in the Java JRE ext lib folder. Overwrite files if asked. Note: If you make changes using SetupPOS in the future, you must repeat this step.
6. Download POS Printer application
  1. In a new web browser, go to OCLC Service Configuration.
  2. Navigate to WMS Circulation > Admin/General > POS Printer Preferences.
  3. Click Click here to Download the POS Printer application and allow the application to install.
7. Test printing
  1. Make sure the Java Console is open while testing printing. See section 10 for details on the Java Console.
  2. In the Circulation module, find a patron with checked out items.
  3. In the Check Out, select items using the check boxes.
  4. Click Receipt, and select POSPrinter.
  5. If nothing prints, copy and paste the text in the Java Console into the OCLC Support form.
  6. If the POSPrinter option is not there, see Troubleshoot your POS printer.
Windows 7 users
1. Download Java
  1. Go to http://java.com/en/download/manual.jsp.
  2. Download the Java version compatible with your computer, and save the file to your computer.
  3. Find the downloaded Java file on your computer, and install the file.
2. Make sure that the JAVA_HOME and Path are set correctly
  1. Open the Control Panel.
  2. Click System.
  3. Click Advanced system settings.
  4. On the Advanced tab, click Environment Variables....
  5. In the System variables section, navigate to the variable JAVA_HOME, and confirm that the value is correct.
    • Example value: C:\Program Files (x86)\Java\jre1.8.0_60
    • If you do not see JAVA_HOME, you may have to add the variable by clicking New... and filling out the fields.
    • If you need to add or edit the JAVA_HOME value, navigate to the Java folder on your computer, and open the folder. View the properties of a file within the folder and copy the Location into the Variable value field.
    • You should updated this value anytime a new version of Java is installed (as the active directory name will be different).
  6. In the System variables section, navigate to the variable Path, and confirm that the value is correct.
    • Example value: C:\Program Files (x86)\Java\jre1.8.0_60\bin
    • This variable contains pathways for multiple applications. Each pathway is separated by a semi-colon (;).
    • If you need to enter the Path value, navigate to the Java folder on your computer, and open the folder. View the properties of a file within the bin folder and copy the Location into the Variable value field.
    • You should updated this value anytime a new version of Java is installed (as the active directory name will be different).
3. Register for Epson

In order to download the Epson JavaPOS ADK software, you must create an account with Epson.

  • Skip this section if you have already created an account with Epson.
  • If you are located in the United States, Canada, or Latin America, you need to create an account with Epson Insider in order to download the software.
  • If you are located in Europe, Singapore, or Australia, you need to create an account with Epson in order to download the software.
Epson
  1. Go to https://www.epson-biz.com.
  2. Click Register, at the top right of the page.
  3. Enter your email address, and click Go.
  4. Enter the Key you received at the email address you entered in the previous step, and click Go.
  5. On the Privacy Policy screen, click I Agree.
  6. Fill out the profile input form, and click Register.
  7. Confirm your profile information, and click Register.
Epson Insider
  1. Go to https://www.epsoninsider.com/.
  2. Enter your email address.
  3. Click the second click here.
  4. Fill out the user registration form, and click Register.
  5. Confirm the form information you entered is correct, and click Register.
  6. On the Terms of Use screen, click Accept.
4. Download JavaPOS ADK

Depending on your region, you must download the Java software from either Epson or Epson Insider.

  • If you are located in the United States, Canada, or Latin America, follow the Epson Insider instructions.
  • If you are located in Europe, Singapore, or Australia, follow the Epson instructions.
Epson
  1. Sign in to https://download.epson-biz.com/.
  2. Click POS.
  3. Click Software.
  4. Under Development Kit, click JavaPOS ADK.
  5. Under EPSON JavaPOS ADK for TM Series, click Download page.
  6. Fill out the form, and click Continue.
  7. Find the most recent version for your operating system, and click Download page.
  8. On the download page, click Accept under the License Agreement, and click Download.
  9. Save the file to your computer.
Epson Insider
  1. Sign in to https://www.epsoninsider.com/.
  2. On the left navigation, click Technical Information.
  3. On the window that appears, click POS - Software.
  4. On the POS - Software screen, click JavaPOS ADK.
  5. In the More Info box, click Downloads.
  6. Select your operating system.
  7. Download the latest version by clicking on its Title.
  8. On the End User Software Agreement screen, click Accept.
  9. Save the file to your computer.
5. Copy JAI files to the Java folder
  1. Download these Java files to your computer:
  2. Copy the JAI files to the Java folder on your computer.
    • Example Java folder location: C:\Program Files (x86)\Java\jre1.8.0_60\lib\ext
6. Install JavaPOS ADK

This must be run as an Administrator.

  1. Locate the zip file you downloaded in step 4 on your computer and open it.
  2. Click Epson_JavaPOS_ADK_114.exe. You may have to extract some files.
  3. Open the .exe file.
  4. Select a language, and click OK.
  5. On the Introduction screen, click Next.
  6. On the License Agreement screen, click I accept the terms of the License Agreement.
  7. Click Browse to select your Java Runtime Environment. Locate the file on your computer and click Open.
    • Example pathway: C:\Program Files (x86)\Java\jre1.8.0_60\bin\java.exe
  8. Once you have chosen the file, click Next.
  9. On the Choose Install Set screen, click User, and click Next.
  10. On the Set User Classpath, select the radio button next to the path that ends in ext, and click Next.
  11. On the Choose your communication method screen, select how the POS printer is connected to your computer, and click Next.
  12. On the Location for jpos.xml screen, click Next.
  13. On the Pre-Installation Summary screen, click Install.
  14. Once the file is installed, you may need to restart your computer. Click Done.
7. Run the printer setup

This must be run as an Administrator.

  1. Open Start > All Programs > Epson JavaPOS ADK > SetupPOS.
  2. Click Edit > Add.
  3. On the Important Properties screen, fill in the fields:
    1. If needed, enter a new Logical Device Name.
    2. Select POSPrinter from the Device Category list.
    3. Select your device from the Device Name list.
  4. Click Next.
  5. Select your Port Type from the list, and click Next.
  6. On the Common screen, change any settings as needed, and click Done.
  7. To save your configuration click File > Save, and save your file as jpos.xml.
  8. On the Confirmation window, click Yes.
  9. Close SetupPOS.
8. Run Health Check
  1. Open Start > All Programs > Epson JavaPOS ADK > CheckHealth.bat.
  2. On the CheckHealthTool window, on the left sidebar, click POSPrinter > POSPrinter.
  3. Click CheckHealth.
  4. On the POSPrinter Service, click Print. The POS printer should print.
  5. Click Close.
9. Clear Java cache
  1. Open the Control Panel.
  2. Click Java.
  3. On the General tab, under Temporary Internet Files, click Settings....
  4. On the Temporary Files Settings window, click Delete Files....
  5. On the Delete Files and Applications window, select all the check boxes, and click OK.
  6. On the Temporary Files Settings window, click OK.
  7. Optional. To confirm deletion, on the General tab of the Java Control Panel, under Temporary Internet Files, click View.... The Java Cache Viewer should be empty.
  8. On the Java Control Panel, click OK.
(Optional). Download POS printer application in Service Configuration

See POS Printer Preferences for instructions on downloading the POS Printer Application.

10. Turn the Logging on High
  1. Log into WMS and open the Circulation module.
  2. In the Windows taskbar, right click the Java icon, and click Open Console.
    • If the Java icon does not appear in your taskbar, go to Control Panel > Java > Advanced tab. Under Miscellaneous, click Place Java icon in system tray.
  3. Make sure the Java Console window is active (click in the window).
  4. On the keyboard, press <o> (the letter o).
  5. In the Java Console window, look for the true statement: "Logging set to : true ... completed."
  6. On the keyboard, press <5>.
  7. In the Java Console window, look for the trace level statement: "Trace level set to 5: all ... completed."
  8. Leave Java Console open while testing printing.
11. Test Printing
  1. Make sure the Java Console is open while testing printing. See section 10 for details on the Java Console.
  2. In the Circulation module, find a patron with checked out items.
  3. In the Check Out, select items using the check boxes.
  4. Click Receipt, and select POSPrinter.
  5. If nothing prints, copy and paste the text in the Java Console into the OCLC Support form.
  6. If the POSPrinter option is not there, see Printer missing in Circulation module.
  • Was this article helpful?