Upgrading Qlik NPrinting

You can upgrade from Qlik NPrinting 17.3.0 or later to Qlik NPrinting June 2017 or later using the Qlik NPrinting setup program. When upgrading, the previous version is completely replaced by the new version.

Upgrading from Qlik NPrinting 16 cannot be done using the setup program. To upgrade from Qlik NPrinting 16, see Upgrading from Qlik NPrinting 16.

The content of the following files is overwritten during the upgrade process:

  • NewsStand proxy configuration file


  • Qlik NPrinting web console proxy configuration file


If you have made custom configurations in either of these files in your existing Qlik NPrinting deployment, you must recreate them manually after an upgrade.

Note: We recommend recreating custom configurations in the files after upgrading instead of copying the Qlik NPrinting app.conf files from a previous deployment and using them in the upgraded installation because the upgraded files could include some different settings. You can compare a copy of the existing Qlik NPrintingapp.conf files with the upgraded versions to ensure that no custom configurations are lost.

When you upgrade to Qlik NPrinting June 2017 or later the following new folders are created automatically:

  • %ProgramData%\NPrinting\newsstandproxy\
  • %ProgramData%\NPrinting\webconsoleproxy\

A copy of the app.conf file, with everything commented, is inserted in each folder. Settings that are not commented in the app.conf files have a higher priority than the old files, so they will overwrite the same settings in the older files. After the first upgrade the settings in the new app.conf files will be kept.


Do the following:

  1. Confirm that you have a current backup of the repository.
    Warning: You must back up your data before you continue. Data can be damaged if a problem occurs during the upgrade, so it is necessary to have backup to restore the repository from . See Backup and restore a repository.
  2. Open Windows Services.
  3. Stop the following Qlik NPrinting services by right-clicking them, and then clicking Stop:
    • Qlik NPrinting Engine
    • Qlik NPrinting Scheduler
    • Qlik NPrinting WebEngine
    • Qlik NPrinting MessagingService
    • Qlik NPrinting RepoService
  4. Close Windows Services.

    Windows stops the services only after you close this program, so do not keep it open.

  5. Warning: Proceed only when you are sure that all the services mentioned are stopped or the repository may be damaged. If any of these services are left running during upgrade, the upgrade can fail, and it may be necessary to restore data from backup.
  6. Open the Windows Task Manager, then do the following:
    1. Browse to the Processes tab.
    2. Click on Show processes from all users to be sure to see all working processes.
    3. If any of the following processes is running, terminate it by right clicking on it and choosing End process tree:
      • Qlik.NPrinting.Engine.exe
      • Qlik.NPrinting.Scheduler.exe
      • Qlik.NPrinting.WebEngine.exe
      • Qlik.NPrinting.Cefsharp.exe. If you see more than one process with this name, select the one owned by the Windows user of the Qlik NPrinting services.
      • webconsoleproxy.exe
      • newsstandproxy.exe
      Warning: Proceed only when you are sure that all previous processes are stopped or the repository may be damaged.
      Warning: If you attempt to upgrade Qlik NPrinting while the Windows services and process are running, it can result in a installation failure, so it is important to check before proceeding, and stop them manually if necessary.
  7. Install Qlik NPrinting as described in Installing Qlik NPrinting.
  8. Check all Qlik NPrinting services are running after the upgrade is complete. It may be necessary to start them manually.
Note: When you install or upgrade your Qlik NPrinting Server, Qlik NPrinting Engines, and Qlik NPrinting Designer, ensure that they are all the same software version. Mixing versions of Qlik NPrinting components is not supported.

Upgrading from Qlik NPrinting 16

You must remove Qlik NPrinting Server 16 and Designer 16 from a computer before you install Qlik NPrinting.

Warning: You cannot import a Qlik NPrinting 16 project into Qlik NPrinting 17.0 and newer. You can only import a single report at a time (Refer to Import reports) and recreate the rest of reporting system.

Do the following:

  1. Open the Qlik NPrinting Server.
  2. Stop the NPrinting Service by clicking Stop in the bottom right corner.
  3. Close the Qlik NPrinting Server window.
  4. In Windows, open the program uninstaller from the Control Panel.
  5. Uninstall the Qlik NPrinting Designer.

    Uninstall the Qlik NPrinting Server, if it is installed.

  6. When the uninstall is complete, restart your computer.
  7. Install Qlik NPrinting as explained in Qlik NPrinting installation

You must also uninstall the Qlik NPrinting Designer on developers' computers. The new Qlik NPrinting Designer is not compatible with the old Qlik NPrinting 16 Designer.