1.5

Page 36
Troubleshooting
If you find that you cannot solve an issue here are a few things to check.
1. Check if the
OLCS
Database service is running on the machine where you have installed
Workflow
and the plug-in. The service is called
OL Connect Send DBServer
. Make sure
that the service is running. If not, uninstall and then reinstall the
OLCS
plug-in. After
reinstallation, make sure that the service is running.
2. Switch
OLCS
printer driver logging to “DEBUG”. This can be done by modifying the OLCS
printer driver: run OLCS Printer Driver Setup from "Programs and Features". Please, refer
to the chapter Installing OL Connect Send Printer Driver.
3. Before running a new print, please clean up the OLCS printer’s temp and logs folders.
They are located under:
%ProgramData%\Objectif Lune\CPD\Temp\<OLCS Printer Name>
and
%ProgramData%\Objectif Lune\CPD\Log\<OLCS Printer Name>
It is very important to remove all files from the Temp folder, otherwise the OLCS printer
will retry sending these again and again.
4. When running the printer driver and plug-in on the same machine the host name must be
“127.0.0.1” instead of “localhost”, otherwise the communication between the two won’t
work.
5. It has been seen, in some cases, that using two instances of the
OLCS
plug-in in different
Workflow
processes could lead to an error. Delete all the processes using the OLCS
printer driver and redo them from scratch.
Please do not use copy & paste.
It is also
strongly recommended to use only one single process with the OLCS plug-in and set this
to “Self Replicating”. Any further processing can be managed by the follow-up processes.
Using two or more
OLCS
plug-ins in
Workflow
has been known to cause an error when
(re-)starting
Workflow
.
6. Sometimes, the license cannot be successfully activated due to the fact that the license
file is locked, blocked or under the control of a specific user account. In this case the
Software Activation Tool
of Connect will show a message telling you that the license
could not be activated. The
Software Activation Tool
of Workflow will silently take note
of this error and close without displaying it. Please double check if the license with the
OLCS
branch has successfully been activated by reopening the
Software Activation Tool
and clicking on the small
i
button. This will open the license overview window. A valid
OLCS
license will have a respective entry at the end of the list. If this is not the case, the
activation has failed. In this case you need to activate manually by replacing the existing
license file with the new one:
a. Rename the new license file with the OLCS enhancement to
“OLConnect1.OLConnectLicense”.
b. Stop any Connect and Workflow services.
c.
Remove the existing “OLConnect1.OLConnectLicense” from
“%ProgramData%\Objectif Lune\OL Connect\licenses”.
d. Put the new license at that location.
e. Restart any Connect services you stopped. You may notice that removing the
existing license may be forbidden and you need to allow it explicitly. It may even
be that you need to log on as an administrator to delete the file.