Differences

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

--- cobi.wms:print_service [2023/05/24 15:15] – [How it works / Limitations] tkammer
+++ cobi.wms:print_service [2023/06/23 08:54] (current) – [Installing the COBI.wms Print Service] tkammer
@@ Line 25: / Line 25: @@
 **NOTE:** All of the above is done by Coresuite, not by the COBI.wms Print Service.  If the XML files are not being processed, check if Coresuite is set up and running correctly.  The job of the COBI.wms Print Service is done in the moment where the XML file is generated and put into the configured folder.
-===== Installation =====
+===== Installing the COBI.wms Print Service =====
-Download: {{cobiwms-print-service.zip}}
+First of all, make sure that a recent version of the Microsoft .NET Framework is installed.
-  - Extract the contents of ''cobiwms-print-service.zip'' to ''C:\cobiwms-print-service\''.
+Download the program here: {{cobiwms-print-service.zip}}
-  - 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.
+  - Extract the ZIP into a folder called exactly ''C:\cobiwms-print-service\''.
-  - You can now start/stop the service from the MS Windows ''Services'' application.
+  - Open the folder, right-click on ''cobiwms-print-service.exe'' and open its Properties.
+  - At the bottom of the Properties window, check "Unblock" and confirm.  (If you can't see "Unblock", skip this step.)
+  - Start ''cmd.exe'' or ''PowerShell'' as Administrator.
+  - Enter this command: ''C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe C:\cobiwms-print-service\cobiwms-print-service.exe''
+  - Create the file ''C:\cobiwms-print-service\config.json'' with contents like below.
+**Note:** Currently it is not supported to install the service under any other path than ''C:\cobiwms-print-service\''; please contact ''support@cobisoft.de'' if this poses a problem for you.
+After the service is installed and the configuration file is created, you can start/stop the service from the MS Windows **Services** application.
 Example config for single-tenant setup (e.g. on-premises or private cloud):
@@ Line 69: / Line 77: @@
 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.
+**NOTE:**  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.
+===== Troubleshooting =====
+First of all, make sure that the COBI.wms Print Service and the Coresuite Service are both actually running.  One or both of the services may have failed to start automatically after a server reboot.  (If you don't have Coresuite Service, make sure that an SAP Business One Client with the Coresuite Designer add-on is running.)
+If XML files **are** appearing in the ''PrintDirectory'' defined in the configuration of the COBI.wms Print Service, but the printing isn't working correctly, check the following:
+  * Make sure the Print Definition ID and Layout ID are configured correctly in the Android app.  See [[COBI.wms:Print Settings]].  You can open the XML files with Notepad and verify the contents.
+  * Make sure Coresuite Service (or an SAP Business One Client with the Coresuite Designer add-on) is running and that it's configured correctly.
+If the XML files are **not** appearing in the ''PrintDirectory'' defined in the configuration of the COBI.wms Print Service, check the following:
+  * Double-check the configuration file.  For example, note that you must use double-backslashes (''\\'') in file paths due to JSON syntax.
+  * Make sure the COBI.wms Print Service is really running by using the MS Windows **Services** application.
+  * Make sure the TCP Port on which the Service is listening can be reached from the Android devices COBI.wms is running on.
+  * Use the MS Windows **Event Viewer** application on the server on which the COBI.wms Print Service is running, and navigate to **Windows Logs --> Application**, to see whether the Service is logging anything.  (If there are lots of irrelevant log entries, you can filter the table to "Source = COBI.wms Print Service".)
+If the COBI.wms Print Service is running but not logging anything at all, it means that it's not receiving any commands from the Android app, in which case double-check that the TCP Port is open and reachable from the Android devices.  Otherwise, the log entries should tell you what the problem is.
-===== Update =====
+===== Updating =====
   - Stop the service.
-  - Extract the contents of the new ZIP file into ''C:\cobiwms-print-service\''.
+  - Extract the contents of the new ZIP file into ''C:\cobiwms-print-service\'', overwriting existing files.
   - Start the service.