Mise à niveau de Qlik NPrinting

Vous pouvez effectuer une mise à niveau depuis Qlik NPrinting April 2018 (18.9.5) ou une version ultérieure via le programme de configuration Qlik NPrinting. Lors de la mise à niveau, la version précédente est entièrement remplacée par la nouvelle version.

Pour effectuez une mise à niveau depuis des versions ultérieures à April 2018, voir Planification de la mise à niveau (uniquement en anglais)

Fichiers de configuration

Le contenu des fichiers suivants est écrasé pendant le processus de mise à niveau :

• Fichier de configuration proxy NewsStand

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

• Fichier de configuration proxy Console Web Qlik NPrinting

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

Lors de la mise à niveau vers la version Qlik NPrinting April 2018 (ou une version ultérieure), les nouveaux dossiers suivants sont automatiquement créés :

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

Une copie du fichier app.conf, avec des commentaires, est insérée dans chaque dossier. Les paramètres qui ne comportent pas de commentaires dans les fichiers app.conf ont une priorité plus élevée que les anciens fichiers. Par conséquent, les paramètres identiques inclus dans les fichiers plus anciens seront écrasés. Après la première mise à niveau, les paramètres dans les nouveaux fichiers app.conf seront conservés.

Mise à niveau via l'interface utilisateur

Procédez comme suit :

1. Confirmez que vous disposez d’une sauvegarde à jour du référentiel.
   Note AvertissementSauvegardez vos données avant de continuer. Les données peuvent être endommagées si un problème se produit pendant la mise à niveau. Il est donc nécessaire de disposer d'une sauvegarde à partir de laquelle restaurer le référentiel. Voir la section Sauvegarde et restauration d'un référentiel (uniquement en anglais).
2. Ouvrez les services Windows.
3. Arrêtez les services Qlik NPrinting suivants en cliquant dessus avec le bouton droit de la souris, puis en choisissant Arrêter :
• Qlik NPrinting Engine
• Qlik NPrinting Scheduler
• Qlik NPrinting WebEngine
• Qlik NPrinting MessagingService
• Qlik NPrinting RepoService
• Qlik NPrinting License Service
4. Fermez les services Windows.

   Windows arrête les services uniquement après la fermeture de ce programme, il convient donc de ne pas le maintenir ouvert.

Note AvertissementPoursuivez uniquement si vous êtes sûr que tous les services mentionnés sont arrêtés, faute de quoi vous pourriez endommager le référentiel. Si l'un de ces services est en cours d'exécution pendant la mise à niveau, cette dernière peut échouer et il peut être nécessaire de restaurer les données à partir de la sauvegarde.
5. Ouvrez le Windows Gestionnaire des tâches, puis procédez comme suit :
   1. Accédez à l'onglet Processus.
   2. Cliquez sur Afficher les processus de tous les utilisateurs pour afficher tous les processus actifs.
   3. Si l'un des processus suivants est en cours d'exécution, cliquez dessus avec le bouton droit de la souris et sélectionnez Terminer l'arborescence du processus pour l'arrêter :
      • Qlik.NPrinting.Engine.exe
      • Qlik.NPrinting.Scheduler.exe
      • Qlik.NPrinting.WebEngine.exe
      • Qlik.NPrinting.Cefsharp.exe. Si vous voyez plusieurs processus sous ce nom, sélectionnez celui détenu par l'utilisateur Windows des services Qlik NPrinting.
      • webconsoleproxy.exe
      • newsstandproxy.exe

      • Qlik.NPrinting.License.exe

      • licenses.exe

      Note AvertissementPoursuivez uniquement si vous êtes sûr que tous les processus précédents sont arrêtés, faute de quoi vous pourriez endommager le référentiel.
      Note AvertissementSi vous tentez de mettre à niveau Qlik NPrinting alors que les services et processus Windows sont toujours en cours d'exécution, l'installation risque d'échouer. Il est donc important de procéder à cette vérification avant de continuer et d'arrêter manuellement ces composants si nécessaire.
6. Installez Qlik NPrinting de la manière décrite dans la section Installation de Qlik NPrinting (uniquement en anglais).
7. Vérifiez que tous les services Qlik NPrinting sont en cours d'exécution à la fin de la mise à niveau. Il se peut que vous deviez les démarrer manuellement.

Mise à niveau via la ligne de commande

Affichage des arguments de ligne de commande

Pour afficher une liste des arguments de ligne de commande, exécutez la commande suivante dans la ligne de commande :

QlikNPrintingServer_x64.exe /help

QlikNPrintingEngine_x64.exe /help

Une installation ou une désinstallation /quiet signifie qu'aucune IU n'est affichée.

Une installation ou une désinstallation /passive signifie qu'une IU minimale avec une barre de progression est affichée, mais sans aucun assistant ni aucune interaction utilisateur.

Mise à niveau de Qlik NPrinting Server

Exécutez la commande suivante dans la ligne de commande en tant qu'administrateur :

QlikNPrintingServer_x64.exe /install {/quiet|/passive} accept-eula=1 service-username="{DOMAIN\USERNAME}" service-password="{USER_PASSWORD}" [/log"{PATH_TO_LOG_FILE}"]

Exemple

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

Mise à niveau de Qlik NPrinting Engine

Exécutez la commande suivante dans la ligne de commande en tant qu'administrateur :

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}"]

Exemple

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"

Dépannage - Annulation d'une mise à niveau

La restauration qui suit l'annulation d'une mise à niveau Qlik NPrinting Server ou Qlik NPrinting Engine peut corrompre l'installation Qlik NPrinting associée. Un restauration est déclenchée par des erreurs ou par un clic sur le bouton Annuler lors de l'exécution de la mise à niveau. Après une corruption causée par une restauration, il se peut que les services soient désinstallés ou qu'ils ne puissent pas démarrer. Vous devrez restaurer le moteur et le serveur.

Restauration de Qlik NPrinting Server à son état d'origine

Procédez comme suit :

1. Récupérez une sauvegarde récente.

2. Désinstallez Qlik NPrinting Server. Pour plus d'informations, voir : Désinstallation de Qlik NPrinting Server (uniquement en anglais)

3. Effectuez une nouvelle installation du même Qlik NPrinting Server comme sauvegarde.

4. Restaurez la sauvegarde.

Restauration de Qlik NPrinting Engine à son état d'origine

Procédez comme suit :

1. Désinstallez Qlik NPrinting Engine. Pour plus d'informations, voir :Désinstallation de Qlik NPrinting Engine (uniquement en anglais)

2. Effectuez une nouvelle installation de Qlik NPrinting Engine.