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
! Part 3: Check and update Ciphers
Related Information:
Internal ID:
