Installing Qlik NPrinting Engine

The Qlik NPrinting Engine is required to generate reports. You must have at least one active Qlik NPrinting Engine in your Qlik NPrinting deployment.

Qlik NPrinting Server must be installed before you install Qlik NPrinting Engine. The Qlik NPrinting scheduler service service is installed with Qlik NPrinting Server, and is required to communicate with the Qlik NPrinting Engine. You can install multiple Qlik NPrinting Engines on different computers to distribute the workload and create a high-availability reporting system. Qlik NPrinting Engine can be installed on the same computer as the Qlik NPrinting Server or on a different computer.

What is installed

Qlik NPrinting Engine installs the following. These must not be uninstalled from the server:

  • Qlik NPrinting Engine service
  • .NET framework: 4.6.2 or higher.

    .NET framework version 4.6.2 is installed when you install Qlik NPrinting Server, Qlik NPrinting Engine, or Qlik NPrinting Designer. The installation of .NET framework version 4.6.2 requires an active internet connection. If .NET framework version 4.6.2 or later is not already installed on a computer without an internet connection, the installation will fail. You must install the .NET framework version 4.6.2 or later on computers without and internet connection before you install Qlik NPrinting Server, Qlik NPrinting Engine, or Qlik NPrinting Designer.If an internet connection is not available on a computer with .NET framework version 4.6.2 or later already installed, the installer will skip this part of the installation.

  • PDF-XChange

Requirements

Limitations

  • You can install only one Qlik NPrinting Engine on each physical computer or virtual machine.
  • The Qlik NPrinting Engine is multi-threaded, so it can use all the server CPU cores. A minimum of two cores is required.
  • If you are connecting to QlikView, QlikView Desktop must be installed locally on the same physical computer or virtual machine as the Qlik NPrinting Engine.
  • Before you install Qlik NPrinting Engine, ensure that your environment fulfills the system requirements.
  • You must install the Qlik NPrinting Server before you install the Qlik NPrinting Engines.
  • Ports 4242, 4243 and 4747 must be opened outbound on the Qlik NPrinting Engine computer.

Installing the Qlik NPrinting Engine

Do the following:

  1. Create a user to run your Qlik NPrinting services. The user must be a local Administrator, with Logon as a Service rights, and should be used exclusively to run the Qlik NPrinting services.
    1. In WindowsComputer Management, go to Local Users and Groups > Users, and click Action > New User....
    2. Enter a User name and Password for the user and click Create.
    3. Right click on the user that you created in the previous step, and click Properties.
    4. Click on the Member Of tab and click Add....
    5. Enter Administrators in the field and click Check Names. If the name is valid, click OK.
    6. From the WindowsControl Panel, go to Administrative Tools, and click on Local Security Policy.
    7. Go to Local Policies > User Rights Assignment, and click Log on as a service.
    8. On the Local Security Setting tab, click Add User or Group....
    9. Enter the user that you created in the previous steps and click Check Names. If the name is valid, click OK.
    10. Warning:

      If you are connecting to QlikView, you must use a different Windows user account for each Qlik NPrinting Engine instance.

      If you are connecting to Qlik Sense, you can use the same Windows user account for all Qlik NPrinting Engine installations.

      Note: If you are installing an instance of Qlik NPrinting Engine on the same computer as the Qlik NPrinting Server, you can use the same Windows user account to run all Qlik NPrinting services on that computer.
      Note: This user will require additional permissions configured in Qlik Sense or QlikView to connect to those servers.
  2. If you are connecting Qlik NPrinting to Qlik Sense, you must assign RootAdmin authorization to the user that runs the Qlik NPrinting Engine service.
    1. On the Qlik Sense server, open the QMC and click Users.
    2. Select the user that you created in step 1 from the list, and click Edit.
    3. Click Add role, ans select RootAdmin from the list.
    4. Click Apply.
  3. If you are connecting Qlik NPrinting to QlikView, the user that runs the Qlik NPrinting Engine service must:
    • Be a member of the Administrators group on all QVS servers used by Qlik NPrinting.
    • Have an active license for QlikView Desktop, which must be installed on the Qlik NPrinting Engine computer.
      Note: QlikView DesktopPersonal Edition is not supported. Licensing Qlik NPrinting.
  4. Log into the computer where you plan to install Qlik NPrinting Engine as a local Windows administrator. You can use the account that you created in the previous steps.
    1. To verify that you are logged on as a local administrator, go to Control Panel > User Accounts. You can see the groups that the user belongs to under the name on the contact card.

      Windows User Accounts screen showing an Administrator account.

  5. Download the QlikNPrintingEngine_x64.exe file from www.qlik.com, and launch the setup.
  6. Select the check box to accept the license agreement, and click Install.

    If the User Account Control window appears, click Yes to proceed.

  7. On the Qlik NPrinting Engine Setup Welcome page, click Next.
  8. On the Service logon credentials screen, use the credentials for the user that you created in step 1. to complete the fields as follows:
    1. Account - Enter the Domain and User name in this format Domain\User name. You can use the Browse button to search for the user.
    2. Password - Enter the user's Password.
    3. Click Test Credentials to verify that the user credentials are valid.

      If the log on credentials are validated successfully, the Test Credentials button is grayed out and a green check mark appears next to it.

      Qlik NPrinting Engine service logon credentials screen with example account info.

    4. Click Next.
  9. On the Qlik NPrinting Server node screen, enter the name of the computer where Qlik NPrinting Server is installed.
    1. Click Test Credentials to verify that the server name is valid, and that it can be reached from the Qlik NPrinting Engine computer.

      If the server node is validated successfully, the Test Credentials button is grayed out and a green check mark appears next to it.

      Engine server node window with example computer name.
    Note: You can enter the domain name of the computer, its IP address, or its DNS name. The Qlik NPrinting Engine computer must be able to resolve the DNS name if that option is used.
    Warning: Firewalls must allow connections on port 5672 between the Qlik NPrinting Engine computer (outbound) and the Qlik NPrinting Server node (inbound). See: Ports
    Note: If the Qlik NPrinting Engine is installed on the same computer as Qlik NPrinting Server you can use the loopback network interface, so that you can insert the IP address 127.0.0.1 or localhost. In that case it is not necessary to open firewall ports on the public network interface.
  10. On the Engine certificate password screen, enter a password to encrypt certificate exchange for TLS certificates.

    Note: The same password must be provided to the Qlik NPrinting Server on the engine configuration page.
    Note: On Qlik NPrinting Server, port 4997 must be open outbound. On all Qlik NPrinting Engines, port 4997 must be open inbound.

  11. Click Next to continue.
  12. Click Install.
  13. Click Finish.

    The Setup Successful screen appears.

  14. Click Close.

Qlik NPrinting Engine installs the Qlik NPrinting Engine Windows service that must be running.

Windows Services screen showing that the Engine service is running.

Once you have installed Qlik NPrinting Engine successfully, you must: