Differences

This shows you the differences between two versions of the page.

--- cobi.wms:print_helper [2022/08/29 13:12] – [Install] tkammer
+++ cobi.wms:print_helper [2022/09/01 10:06] (current) – removed tkammer
@@ Line 1: / Line 1: @@
-====== Print Helper ======
-The COBI.wms Print Helper 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-helper.zip}}
-===== Install =====
-  - Extract the contents of ''cobiwms-print-helper.zip'' to ''C:\cobiwms-print-service\''.
-  - 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''
-  - Create ''C:\cobiwms-print-service\config.json'' with contents like below.
-  - 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):
-<code json>
-{
-  "ListenPort": 9110,
-  "TenantConfig": [
-    {
-      "PrintDirectory": "C:\\CoresuiteRemotePrint\\Productive"
-    }
-  ]
-}
-</code>
-Example config for multi-tenant setup (e.g. public cloud):
-<code json>
-{
-  "ListenPort": 9110,
-  "TenantConfig": [
-    {
-      "AuthToken": "SECRET_1",
-      "PrintDirectory": "C:\\CoresuiteRemotePrint\\Tenant_1\\Productive"
-    },
-    {
-      "AuthToken": "SECRET_2",
-      "PrintDirectory": "C:\\CoresuiteRemotePrint\\Tenant_2\\Productive"
-    }
-  ]
-}
-</code>
-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 print helper does not support encrypted communication.  This means that if you make the TCP port of the print helper 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 =====
-  - Stop the service.
-  - Extract the contents of the new ZIP file into ''C:\cobiwms-print-service\''.
-  - Start the service.
-===== Uninstall =====
-  - Stop the service.
-  - 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''
-  - Delete the folder ''C:\cobiwms-print-service\''.