User Tools

Site Tools


cobi.wms:print_service

This is an old revision of the document!


Print Service

The COBI.wms Print Service is an MS Windows service which receives commands from the Android app and triggers a print event on the Windows machine. Currently, it only supports doing so by generating a Coresuite Remote Print XML file.

Download: cobiwms-print-service.zip

Install

  1. Extract the contents of cobiwms-print-service.zip to C:\cobiwms-print-service\.
  2. Run the following command in cmd.exe or PowerShell: C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe C:\cobiwms-print-service\cobiwms-print-service.exe
  3. Create C:\cobiwms-print-service\config.json with contents like below.
  4. You can now start/stop the service from the MS Windows Services application.

Example config for single-tenant setup (e.g. on-premises or private cloud):

{
  "ListenPort": 9110,
  "TenantConfig": [
    {
      "PrintDirectory": "C:\\CoresuiteRemotePrint\\Productive"
    }
  ]
}

Example config for multi-tenant setup (e.g. public cloud):

{
  "ListenPort": 9110,
  "TenantConfig": [
    {
      "AuthToken": "SECRET_1",
      "PrintDirectory": "C:\\CoresuiteRemotePrint\\Tenant_1\\Productive"
    },
    {
      "AuthToken": "SECRET_2",
      "PrintDirectory": "C:\\CoresuiteRemotePrint\\Tenant_2\\Productive"
    }
  ]
}

In a multi-tenant environment, the correct AuthToken must be entered in the COBI.wms Print Settings screen for the app to be able to trigger print jobs. The token serves both to identify the tenant, and as a password to ensure that tenants running on the same cloud environment cannot accidentally or intentionally trigger print jobs for each other.

Note that the COBI.wms Print Service does not support encrypted communication. This means that if you make the TCP port of the Print Service open to the Internet, and set up COBI.wms to contact it, then the tokens will be sent unencrypted over the Internet. It is strongly advised to set up a VPN connection in this scenario to ensure encrypted communication.

Update

  1. Stop the service.
  2. Extract the contents of the new ZIP file into C:\cobiwms-print-service\.
  3. Start the service.

Uninstall

  1. Stop the service.
  2. Run the following command in cmd.exe or PowerShell: C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe /u C:\cobiwms-print-service\cobiwms-print-service.exe
  3. Delete the folder C:\cobiwms-print-service\.
cobi.wms/print_service.1662019647.txt.gz · Last modified: 2022/09/01 10:07 by tkammer

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki