Installing Qlik NPrinting Server

Qlik NPrinting Server must be installed first. The Qlik NPrinting scheduler service service that is installed with Qlik NPrinting Server is required to communicate with the Qlik NPrinting Engine.

What is installed

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

  • Qlik NPrinting scheduler service
  • Qlik NPrinting repository
  • Qlik NPrinting web engine
  • Qlik NPrinting messaging 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.

  • Erlang OTP 21.0
  • PostgreSQL 10.1: its service is marked as Qlik NPrintingRepoService

  • Visual C++ 2013 Redistributable x64 (12.0.30501)
  • Visual C++ 2013 Redistributable x64 (12.0.40660)
  • Visual C++ 2013 Redistributable x86 (12.0.40660)

Requirements

Limitations

  • Starting with Qlik NPrinting 17.2.1, the Qlik NPrinting Server setup removes RabbitMQ and replaces it with the Qlik NPrinting messaging service.
  • RabbitMQ cannot be installed on the same computer as Qlik NPrinting Server 17.2.1 or newer.
  • You must install the Qlik NPrinting Server before you install the Qlik NPrinting Engines.
  • You cannot install Qlik NPrinting Server 17 and newer on the same computer as Qlik NPrinting Server 16.
  • Any email addresses used to create accounts must be compliant with the HTML specification.

    Comments, quoted strings, and special characters like []/();:'"<>, are not allowed. See: W3C page.

Installing Qlik NPrinting Server

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 Windows Computer 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 Windows Control 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.
  2. Log into the computer where you plan to install Qlik NPrinting Server 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 Server User Accounts window showing an Administrator account.

  3. Download the QlikNPrintingServer_x64.exe file from www.qlik.com, and launch the setup.
  4. Select the check box to accept the license agreement, and click Install. If:
    • The User Account Control window appears, click Yes to proceed.
    • The MicrosoftVisual C++ 2013 window appears, accept the license terms and install it. If you have an older version installed, click Repair. When the installation is complete, click Close.
    • The Windows Security Alert appears, select both check boxes and then click on Allow access. Erlang needs to communicate over the network, so you must allow the creation of the related firewall rule.
  5. On the Qlik NPrinting repository Service Setup Welcome page, click Next.
  6. On the Repository database superuser password screen, enter a password for the Qlik NPrinting repository database superuser.

    Qlik NPrinting installs a PostgreSQL repository database during setup. The database superuser is a PostgreSQL login role with the highest level of privileges that bypasses all permission checks. Save this password as you will need it for administration of your PostgreSQL installation.

    Qlik NPrinting repository service installation window showing password creation.

    Note: It is possible but, not recommended, to proceed without creating a password.

    The password is stored in the configuration file without encryption, but is accessible only to the administrator.

    For more information, see User accounts.

  7. On the Administrator credentials screen, enter the following to create a Qlik NPrinting user with administrative privileges:
    • Administrator username
    • Email address
    • Password

      This user is used the first time you log into Qlik NPrinting.

      Warning: Save these credentials. You cannot retrieve them later.

      Click Next.

  8. Click Install.

    A screen indicating that the repository database setup is complete appears.

  9. Click Finish.
  10. On the Qlik NPrinting Server Welcome page, click Next.
  11. On the Installation options screen, select your preferred program shortcut locations and click Next.
  12. 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.

      Service logon credentials window with example account name.

    4. Click Next.
  13. Click Install.
  14. Click Finish.

    The Setup Successful screen appears.

  15. Click Close.

Qlik NPrinting Server installs four Windows services that must be running:

  • Qlik NPrinting Scheduler
  • Qlik NPrinting Web Engine
  • Qlik NPrinting messaging service
  • Qlik NPrinting RepoService

    Windows services task window showing the Qlik NPrinting services that must be running to continue installation.

To open the Qlik NPrinting web console, point you web browser to https://YourServerName:4993, and then log in with the administrator email and password that you set up in step 7. To open the NewsStand, point your web browser to https://YourServerName:4994, and then log in with the same email and password.

You are now ready to install Qlik NPrinting Engine. See: Installing Qlik NPrinting Engine.