Skip to main content

Gateway 1745

Craig Weir
Updated
Gateway 1745 Manual

Gateway 1745 Manual

Document: 266.01A — Qmatic

Copyright Notice

The information in this document is subject to change without prior notice and does not represent a commitment on the part of Q-MATIC AB. All efforts have been made to ensure the accuracy of this manual, but Q-MATIC AB cannot assume any responsibility for any errors and their consequences. This manual is copyrighted and all rights are reserved. Reproduction is not allowed without written permission from Q-MATIC AB.

COPYRIGHT © Q-MATIC AB, 2022. Feedback and questions: documentation@qmatic.com.

1. What’s New

Version Chapter Change
01.A General Manual for GW1745 created. Section in Reference Manual removed.

2. Installation

2.1 Introduction

Gateway 1745 manages all Qmatic hardware at the branch and communicates with the central/distributed Queue Agent. When there are no Qmatic 1745 devices in branches, the Gateway 1745 software can be installed on the central server.

2.2 Install Gateway 1745 on Windows

  1. Copy the files from the gw1745_*.zip file to a suitable directory, for example: C:\QMATIC\Gateway1745.
  2. For each Gateway 1745 instance to run on the branch, install a service by executing installGWService.bat. This creates a sub-folder named <branchPrefix>_<UnitId> (e.g. GBG_GW1745) and a gw1745.cfg file inside it that the service will use.
  3. InstallGWService.bat will prompt for configuration parameters — see section 2.3.1.
  4. Installation complete.
  5. Restart the machine (or start the services via the Services Explorer: start > run > services.msc). The GW1745 service should start and keep running.
The status of the GW1745 service can be checked in the Services Explorer (services.msc). All services running on the machine are listed with their service names.

2.3 Install Gateway 1745 on Linux

  1. Transfer gw1745-linux-<version>.tgz to the server (preferably to a tmp directory). Unpack it and change into the extracted folder: 
    tar zxvf gw1745-linux-<version>.tgz
cd gw1745-<version>
    Use a user with superuser rights.
  2. Create the qmatic user if it does not already exist: 
    sudo adduser qmatic
  3. Add the qmatic user to the dialout group (required for COM port access for 1745 communication; skip if no 1745 devices are used): 
    sudo usermod -a -G dialout qmatic
  4. Create the gw1745 directory: 
    sudo mkdir -p /opt/qmatic/gw1745
  5. Grant rights to the qmatic user: 
    sudo chown -R qmatic:qmatic /opt/qmatic/gw1745
  6. Switch to the qmatic user: 
    sudo su - qmatic
  7. Copy the unpacked files to the installation folder: 
    cp -r * /opt/qmatic/gw1745
  8. Switch back to a user with superuser rights and change to the installation directory: 
    exit
cd /opt/qmatic/gw1745/
  9. Install libqwebsockets: 
    sudo ./install_lib.sh
  10. Create service scripts for each required GW1745 process (run once per process needed). You will be prompted for configuration parameters — see section 2.3.1: 
    sudo ./create_startup_script.sh
  11. The script creates service scripts in /etc/systemd/service named gw1745_<BranchPrefix>_<UnitId>, and a directory for each daemon at /opt/qmatic/gw1745/<BranchPrefix>_<unitId> containing the configuration and log files.
  12. Start the daemon now, or it will start automatically after the next reboot: 
    sudo systemctl start gw1745_<BranchPrefix>_<UnitId>
    To stop the daemon: 
    sudo systemctl stop gw1745_<BranchPrefix>_<UnitId>

2.3.1 Configuration Parameters

Parameter Description
Branch Prefix Must match the branch prefix in the Orchestra branch administration GUI.
Unit ID Unit ID of the Gateway.
Queue Agent IP address IP address or hostname of the Queue Agent server.
Queue Agent device server websocket port Configured in agent.conf for the Queue Agent, parameter device.deviceController.websocket.port.
Com port For example COM1, COM2, or NONE if no 1745 equipment is used.
Event port The UDP port TP printers use to communicate with GW1745. Must be unique for each GW1745 instance if several are running on the same machine.
SSL Encrypted connection setting: 0 = no SSL, 1 = SSL, 2 = SSL and allow self-signed certificates.
trustedCACertPath Path to the trusted CA certificate file, e.g. c:/ssl/certs/ca-bundle.crt. Default uses the system trust store.

Q-MATIC AB, Box 198, SE-431 23 Mölndal, Sweden. Phone: +46 31 756 46 00. Email: info@qmatic.com. Web: www.qmatic.com