Skip to main content Skip to complementary content

Installing Qlik NPrinting Engine

Qlik NPrinting Engine is required to generate reports. You must have at least one active Qlik NPrinting Engine in your Qlik NPrinting deployment. Engines can be installed using the user interface or command line interface (CLI).

Qlik NPrinting Server must be installed before you install Qlik NPrinting Engine. The Qlik NPrinting scheduler 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.8.0

    .NET framework is installed when you install Qlik NPrinting Server, Qlik NPrinting Engine, or Qlik NPrinting Designer. The installation of .NET framework requires an internet connection. If .NETframework is not already installed on a computer without an internet connection, the installation stops. Before you begin the installation of Qlik NPrinting Server, Qlik NPrinting Engine, or Qlik NPrinting Designer, you must install the .NET framework on computers without an internet connection. If an internet connection is not available on a computer with .NET framework already installed, the installer will skip this part of the installation.

  • PDF-XChange

Requirements

Limitations

  • Qlik NPrinting can only be installed on C drives.

  • 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. It cannot be accessed as a virtual application.
  • 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.
  • Local data such as logs, configuration files, template files, and newsstand files are stored in C:\ProgramData\NPrinting. This location is not configurable.

Creating a Qlik NPrinting service user

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 note

      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.

      Information noteIf 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.
      Information noteThis 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.
      Information noteQlikView 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.

Downloading the installation file

Download QlikNPrintingEngine_x64.exe from the Qlik Download Site

For more information, see Downloading installation files.

Installing Qlik NPrinting Engine via user interface

Do the following:

  1. Double-click QlikNPrintingEngine_x64.exe to launch the setup.
  2. Select the check box to accept the license agreement, and click Install.

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

  3. On the Qlik NPrinting Engine Setup Welcome page, click Next.
  4. 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.
  5. 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.
    Information noteYou 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 noteFirewalls must allow connections on port 5672 between the Qlik NPrinting Engine computer (outbound) and the Qlik NPrinting Server node (inbound). See: Ports
    Information noteIf 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.
  6. On the Engine certificate password screen, enter a password to encrypt certificate exchange for TLS certificates.

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

  7. Click Next to continue.
  8. Click Install.
  9. Click Finish.

    The Setup Successful screen appears.

  10. 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:

Installing Qlik NPrinting Engine via command line

Viewing command line arguments

To display a list of command line arguments, execute the following in the command line:

QlikNPrintingServer_x64.exe /help
QlikNPrintingEngine_x64.exe /help

/quiet install or uninstall means no UI is displayed.

/passive install or uninstall means a minimum UI with a progress bar is displayed, but no wizards or user interaction.

Install Qlik NPrinting Engine

Execute the following command in the command line as an administrator:

QlikNPrintingEngine_x64.exe /install {/quiet/passive} accept-eula=1 service-username="{DOMAIN\USERNAME}" service-password="{USER_PASSWORD}" engine-certs-password="{CERTS_PASSWORD}" server-hostname="{HOSTNAME}" [/log"{PATH_TO_LOG_FILE}"]

Example

QlikNPrintingEngine_x64.exe /install /passive accept-eula=1 service-username="qtsel\admin" service-password="s3cr3t" engine-certs-password="s3cr3t" server-hostname="np-server" /log ".\engine.log"

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

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!