The Qlik NPrinting Engine Certificates and Resolving Qlik NPrinting Engine Offline, Scheduler will not start issues

Frank_S — Thu, 16 Jun 2022 15:52:44 GMT

NPrinting Engine remains offline

Error log:

System.InvalidOperationException: Found 0 certificates for RabbitMQ Certification Authority. Expected value is 1

Unable to start NP Scheduler service or NP Web Engine service

RabbitMq bus is not connected

Environments

See Video for General Installation/Configuration Details.

What has changed or possibly caused this issue?

A new certificate process that secures communication between the NPrinting server and the NPrinting Engine has been added as of the November 2018 release of NPrinting and newer versions
New port exemption required: port 4997 needs to be opened outbound on Qlik NPrinting Server and inbound on all Qlik NPrinting Engines
Some RabbitMQ users are missing during the NPrinting installation
A different user was used to install or upgrade NPrinting
The user account used to run the NPrinting Engine service has been changed

About this article:

This article contains a video showing the steps to installing the NPrinting Server>Admin>Engine manager and the new NPrinting Engine certificate steps during the Engine Install process.
When installing the NP Engine software, ensure to carefully document the certificate password used as it will be needed again when configuring the updated Engine in the NP web console/Engine Manager interface
You will also need to insert the Engine certificate password for the Engine in Admin>Engine Manager and click Save.
Once the steps in the video below are completed, the NP Engine Status will return to 'Online'

NOTE: If firewall is in use, the following port needs to be opened outbound on Qlik NPrinting Server and inbound on all Qlik NPrinting Engines: 4997. See Reference following for port configuration details Ports.

! If the steps in the attached video are not followed, the NPrinting Engine will likely remain in an 'Offline' status after an upgrade from NPrinting versions prior to November 2018 release or later versions.

*Before proceeding below, we recommend restarting the Qlik Sense and NPrinting servers to ensure that Windows memory leakage is not the root cause of the issue*

Resolution:

Resend Certificate: (November 2019 or newer releases of NPrinting):

On the NPrinting Web Console "Admin>Engine manager" page, the Qlik NPrinting Engine is enabled, but offline.
In this case, you need to resend the certificates.

If the resend option is not visible yet, simply:

Make note the NP engine 'address' and delete the engine entry
Re-create the NPrinting Engine entry and re-enter the NP engine address field
Next, enter the NP engine certificate password and Send Certificate to enable the Qlik NPrinting Engin
There is no need to reinstall the certificates nor the NPrinting Engine if you have the correct NP Engine Certificate password. If you no longer have the password you will need to reinstall the NP engine.

Engine remains offline

! Part 1: If the Engine remains offline

uninstall the NP Engine Software again,
avoid use of '=' or ';' in the certificate and NP service account password See NPrinting engine installation failed - Service account password starting with "=" or containing ";"
reinstall the NP Engine software while considering the points above
delete the corresponding Engine from the Engine Manager in the NP web console ( this is required as per "known issues and limitations' found in the NPrinting product release notes).
re-add the engine in the NPrinting Engine Manager
click the send certificate password button
Engine should now come online

! Part 2: If the Engine remains offline or NP scheduler and or NP web engine services do not start

NP engine log error: "RabbitMq bus is not connected"
Check the following or contact Qlik Support and we will check the health of RabbitMQ components of NPrinting via remote session: Qlik NPrinting messaging service (RabbitMQ) start up and connection problems
Lastly, you will need to reinstall the NPrinting Engine after performing bullet point 2 above.

! Part 3: Check and update Ciphers

https://community.qlik.com/t5/Knowledge-Base/NPRINTING-ERROR-CEF-RENDERING-EXCEPTION-Cipher-Issue/ta-p/1800453

Related Information:

https://community.qlik.com/t5/Knowledge-Base/How-to-Resolve-Qlik-NPrinting-Engine-Offline-Status/ta-p/1716166

Internal ID:

OP-8657

article The Qlik NPrinting Engine Certificates and Resolving Qlik NPrinting Engine Offline, Scheduler will not start issues in Official Support Articles