Installing Qlik NPrinting Server

Qlik NPrinting Server must be installed first. The Qlik NPrinting scheduler service that is installed with Qlik NPrinting Server is required to communicate with the Qlik NPrinting Engine. Servers can be installed using the user interface or command line interface (CLI).

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 audit service
• Qlik NPrinting web engine
• Qlik NPrinting messaging service
• Qlik NPrinting licensing service

• Qlik NPrinting repo service (PostgreSQL 13.11-2)

• .NET framework: 4.8.0 or higher

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

• Erlang OTP 24.0

• Microsoft Visual C++ 2013 Redistributable x64 (12.0.30501)

• Microsoft Visual C++ 2015-2022 Redistributable x86 (14.34.31931)

• Microsoft Visual C++ 2015-2022 Redistributable x64 (14.34.31931)

Requirements

• Check that your environment meets the System requirements for Qlik NPrinting Server.
• Check that the required Ports are available.
• Prepare the User accounts required to run the Qlik NPrinting services.
• Understand how Licensing Qlik NPrinting is configured, and have your license key available.

Limitations

• Qlik NPrinting can only be installed on C drives.

• 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.

• Local data such as logs, configuration files, template files, and NewsStand files are stored in C:\ProgramData\NPrinting. This location is not configurable.

• 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.

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

      

Downloading the installation file

Installing Qlik NPrinting Server via user interface

Do the following:

1. Double-click QlikNPrintingServer_x64.exe to launch the setup.
2. Click 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.
3. On the Qlik NPrinting repository Service Setup Welcome page, click Next.
4. 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. You will need this password to administrate your PostgreSQL installation.

   

   Information noteYou can proceed without creating a password, but this is not recommended.
5. On the Administrator credentials screen:
   1. 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 noteSave these credentials. You cannot retrieve them later.
   2. Click Next.
6. Click Install.

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

   

7. Click Finish.
8. On the Qlik NPrinting Server Welcome page, click Next.
9. On the Installation options screen, select your preferred program shortcut locations and click Next.
10. On the Service logon credentials screen, type the credentials for the user that you created in Creating:
    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.

       

    4. Click Next.
11. Click Install.
12. Click Finish.

    The Setup Successful screen appears.

13. 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

  

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

Installing Qlik NPrinting Server 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 Server

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

QlikNPrintingServer_x64.exe /install {/quiet|/passive} accept-eula=1 service-username="{DOMAIN\USERNAME}" service-password="{USER_PASSWORD}" database-password="{DATABASE_PASSWORD}" admin-email="{ADMIN_EMAIL}" admin-username="{ADMIN_USERNAME}" admin-password="{ADMIN_PASSWORD}" [/log"{PATH_TO_LOG_FILE}"]

Example

QlikNPrintingServer_x64.exe /install /passive accept-eula=1 service-username="qtsel\admin" service-password="s3cr3t" database-password="s3cr3t" admin-email="admin@qlik.com" admin-username="Admin" admin-password="admin" /log ".\server.log"

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