Upgrading Qlik NPrinting

You can upgrade from Qlik NPrinting April 2018 (18.9.5) or later using the Qlik NPrinting setup program. When upgrading, the previous version is completely replaced by the new version.

To upgrade from versions older than April 2018, see Planning your upgrade

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

When you upgrade to Qlik NPrinting April 2018 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 via user interface

Do the following:

1. Confirm that you have a current backup of the repository.
   Warning noteYou 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.

Warning noteProceed 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.
5. 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 noteProceed only when you are sure that all previous processes are stopped or the repository may be damaged.
      Warning noteIf 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.
6. Install Qlik NPrinting as described in Installing Qlik NPrinting.
7. Check all Qlik NPrinting services are running after the upgrade is complete. It may be necessary to start them manually.

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

Upgrade 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}" [/log"{PATH_TO_LOG_FILE}"]

Example

QlikNPrintingServer_x64.exe /install /passive accept-eula=1 service-username="qtsel\admin" service-password="s3cr3t" /log ".\server.log"

Upgrade 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"

Troubleshooting - Canceling an upgrade

The rollback that follows a Qlik NPrinting Server or Qlik NPrinting Engine upgrade cancellation may corrupt the related Qlik NPrinting installation. A rollback is triggered by errors or by clicking the cancel button during the upgrade execution. After a corruption caused by a rollback, services may be uninstalled or cannot be started. You will need to restore the Engine and Server.

Restoring Qlik NPrinting Server to its original status

Do the following:

1. Retrieve a recent backup.

2. Uninstall Qlik NPrinting Server. For more information, see: Uninstalling Qlik NPrinting Server

3. Perform a clean installation of the same Qlik NPrinting Server as the backup.

4. Restore the backup.

Restoring Qlik NPrinting Engine to its original status

Do the following:

1. Uninstall Qlik NPrinting Engine. For more information, see:Uninstalling Qlik NPrinting Engine

2. Perform a clean installation of Qlik NPrinting Engine.