升级 Qlik NPrinting

您可使用 Qlik NPrinting 安装程序从 Qlik NPrinting April 2018 (18.9.5) 或更新版本升级。在升级时，之前的版本完全由新版本替换。

要从April 2018之前的版本升级，请参阅制定升级计划

配置文件

在升级过程中，会覆盖以下文件的内容：

• NewsStand 代理配置文件

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

• Qlik NPrinting web 控制台 代理配置文件

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

当您升级到 Qlik NPrinting April 2018 或更高版本时，会自动创建以下新文件夹：

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

注释了一切内容的 app.conf 文件的副本在每个文件夹中插入。没有在 app.conf 文件中注释的设置比旧文件具有更高优先级，因此它们将覆盖较旧文件夹中的相同设置。在首次升级之后，将保留新 app.conf 文件中的设置。

经由用户界面升级

进行以下操作：

1. 请确认您有储存库的当前备份。
   警告注释您必须备份您的数据后才能继续。如果在升级期间发生问题，数据可能会损坏，因此必须具有备份以从中还原储存库。请参阅储存库备份和还原。
2. 打开 Windows 服务。
3. 通过右键单击以下 Qlik NPrinting 服务来停止它们，然后单击停止：
• Qlik NPrinting Engine
• Qlik NPrinting Scheduler
• Qlik NPrinting WebEngine
• Qlik NPrinting MessagingService
• Qlik NPrinting RepoService
• Qlik NPrinting License Service
4. 关闭 Windows 服务。

   Windows 仅会在您关闭此程序后停止服务，所以请勿将其处于打开状态。

警告注释只有在确信所提及的所有服务均已停止后再继续操作，否则储存库可能会损坏。在升级过程中，如果仍在运行这些服务中的任何一项，升级会失败，并且可能必须要从备份中还原数据。
5. 打开 Windows 任务管理器，然后执行以下操作：
   1. 浏览至进程选项卡。
   2. 单击显示所有用户的进程，确保能够看到所有正常运行的进程。
   3. 如果正在运行下列任一进程，请右键单击它并选择终止进程树：
      • Qlik.NPrinting.Engine.exe
      • Qlik.NPrinting.Scheduler.exe
      • Qlik.NPrinting.WebEngine.exe
      • Qlik.NPrinting.Cefsharp.exe. 如果显示多个具有此名称的进程，请选择所有者为 Qlik NPrinting 服务的 Windows 用户的进程。
      • webconsoleproxy.exe
      • newsstandproxy.exe

      • Qlik.NPrinting.License.exe

      • licenses.exe

      警告注释只有在确信所有先前的进程均已停止后再继续操作，否则储存库可能会损坏。
      警告注释如果您尝试在 Windows 服务和进程在运行时升级 Qlik NPrinting，可能导致安装失败，因此在继续操作前进行检查很重要，并根据需要手动停止它们。
6. 按照安装 Qlik NPrinting 中的说明安装 Qlik NPrinting。
7. 完成升级后，请检查是否所有 Qlik NPrinting 服务都在运行。可能必须手动启动它们。

经由命令行升级

查看命令行参数

要显示命令行参数列表，请在命令行中执行以下操作：

QlikNPrintingServer_x64.exe /help

QlikNPrintingEngine_x64.exe /help

/quiet 安装或卸载意味着不显示任何UI。

/passive 安装或卸载意味着显示带有进度条的最精简户界面，但没有向导或用户交互。

升级 Qlik NPrinting Server

以管理员身份在命令行中执行以下命令：

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

示例

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

升级 Qlik NPrinting Engine

以管理员身份在命令行中执行以下命令：

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

示例

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"

故障排除 - 取消升级

Qlik NPrinting Server 或 Qlik NPrinting Engine 升级或取消后的回滚可能会损坏相关 Qlik NPrinting 安装。在升级执行过程中，错误或单击“取消”按钮会触发回滚。回滚导致损坏后，可能会卸载或无法启动服务。您需要恢复引擎和服务器。

将 Qlik NPrinting Server 恢复至其初始状态

进行以下操作：

1. 检索最近备份。

2. 卸载 Qlik NPrinting Server。有关更多信息，请参阅： 卸载 Qlik NPrinting Server

3. 执行与备份相同的 Qlik NPrinting Server 的洁净安装。

4. 恢复备份。

将 Qlik NPrinting Engine 恢复至其初始状态

进行以下操作：

1. 卸载 Qlik NPrinting Engine。有关更多信息，请参阅：卸载 Qlik NPrinting Engine

2. 执行 Qlik NPrinting Engine 的洁净安装。