Skip to main content

Upgrading Qlik NPrinting

ON THIS PAGE

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.

Warning: You cannot upgrade from QlikView NPrinting 16 using the setup program. To upgrade from QlikView NPrinting 16, see Planning your migration.

Configuration files

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

  • NewsStand proxy configuration file

    %ProgramFiles%\NPrintingServer\proxy\newsstandproxy\src\qlik.com\newsstandproxy\conf\app.conf

  • Qlik NPrinting web console proxy configuration file

    %ProgramFiles%\NPrintingServer\proxy\webconsoleproxy\src\qlik.com\webconsoleproxy\conf\app.conf

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.

Upgrading

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
    • Qlik NPrinting License Service
  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
      • Qlik.NPrinting.License.exe

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