# 安装 Qlik Analytics Migration Tool

Qlik Analytics 迁移工具包含一个引导式安装程序，可简化部署，同时支持企业环境的高级配置。本安装指南概述了每个步骤，包括证书设置、端口验证、服务帐户配置和最终验证。

## 先决条件

确认满足所有[系统要求](https://help.qlik.com/zh-CN/migration/Content/AnalyticsMigrationTool/Installation/System-Requirements.htm)，包括支持的操作系统、磁盘空间、内存、权限和网络访问。

信息注释

如果您正在使用 Qlik Cloud Government 或 Qlik Cloud Government - DoD，请确保在安装前已激活 FIPS 加密。

## 安装步骤

### 1.下载安装程序

从[Qlik 社区](https://community.qlik.com/t5/Download-Qlik-Products/tkb-p/Downloads)下载 Qlik Analytics 迁移工具安装程序。

### 2.以管理员身份运行安装程序

右键单击已下载的`.exe`文件，然后选择Run as administrator以启动引导式设置。

### 3.接受许可协议

执行以下操作：

1. 审阅最终用户许可协议。
2. 选择Accept以继续。

### 4安装所需的运行时

如果出现提示，请安装所需的.NET软件包。

### 5。输入公司名称

提供一个公司名称，用作 Qlik Analytics Migration Tool 中的显示标签。

信息注释

这无需反映法律实体。

### 6。配置证书和域

#### 专用服务器

* Certificate：从 LocalMachine 证书存储中选择有效的第三方 SSL/TLS 证书。
* Domain：输入与证书匹配的完全限定域名 (FQDN)（例如，`migrationtool.company.com`）。

确保安装后浏览器中显示的证书与配置的域匹配。浏览器警告通常表示不匹配。

#### 非专用服务器（评估）

* Certificate：使用自签名证书。

### 7配置端口

* Default Ports:
  * HTTP：9037
  * HTTPS：9038
* Dedicated Server Option:
  * HTTP：80
  * HTTPS：443

验证端口可用性：

* `netstat -ano | findstr :80`
* `netstat -ano | findstr :443`
* `netstat -ano | findstr :9037`
* `netstat -ano | findstr :9038`

识别哪个进程正在使用端口：

* `tasklist /FI "PID eq <PID>"`

### 8配置可选电子邮件通知

输入 SMTP 服务器详细信息以通过电子邮件启用用户邀请通知。

此步骤是可选的。

### 9选择身份验证类型

选择 Windows Authentication（默认且推荐）。

Azure Entra ID 也受支持，目前处于预览阶段，尚未完全记录。

### 10设置管理员和服务帐户

#### 管理员用户

输入一个 Windows account 作为初始管理员。

此帐户将在安装后用于访问 Web 界面。

#### 服务帐户

选择 Windows 服务帐户类型：

* `Windows User`：手动指定域帐户。
* `Local System`：使用内置系统上下文。

信息注释

**重要：**

如果迁移基于文件的数据（例如 QVD、CSV、TXT），请选择具有适当访问所需文件共享权限的域帐户。

如果不需要文件迁移，则可以使用`Local System`。

如果您正在使用指向非网络驱动器的直接文件路径（例如：数据连接是 C 盘或 D 盘的绝对路径），则 Qlik Analytics Migration Tool 必须安装在与 Qlik Sense 相同的服务器上，或者必须更改这些数据连接以引用网络共享文件夹路径。

##### 安装后更新服务帐户

执行以下操作：

1. 打开 services.msc。
2. 找到Qlik Analytics Migration Tool。
3. 右键单击 → Properties → Log On选项卡。
4. 选择This account并提供域凭据。
5. 单击Apply，然后重启服务。

### 11.配置代理（可选）

如果需要代理才能进行出站 Internet 访问：

* 选中Enable Proxy框。
* 输入代理地址和端口。
* 选中Use default Windows credentials框，或者在适用时输入身份验证凭据。

### 12选择安装目录

选择一个具有足够可用空间的安装目标文件夹，以支持：

* 导出的或导入的Qlik应用程序
* 迁移的数据文件（QVD、CSV 等）
* 日志文件和备份

Qlik应用程序默认在不包含数据的情况下导出。当导出包含数据或迁移大型数据集时，请确保有足够的磁盘容量。

### 13最终设置选项

* Create Desktop Shortcut：在桌面添加快捷方式。
* Launch Application After Install：完成后在浏览器中自动打开工具。

选择Install以开始安装过程。

## 完成

安装后：

如果Launch Application After Install已启用，Qlik Analytics Migration Tool 将自动打开。

否则，请使用受支持的浏览器访问该工具：

* 如果非专用机器上使用了自签名证书：  
  `https://<machine-name>:<HTTPS port>`

* 如果使用了第三方证书：  
  `https://<FQDN>`（使用端口 443，否则包含所选的 HTTPS 端口）

使用配置的管理员帐户登录并验证：

* Web 界面可访问。
* 所有服务均正常运行。

## 相关页面

* [系统要求](https://help.qlik.com/zh-CN/migration/Content/AnalyticsMigrationTool/Installation/Installing-the-Qlik-Analytics-Migration-Tool.htm#system-requirements)
* [规划您的迁移](https://help.qlik.com/zh-CN/migration/Content/AnalyticsMigrationTool/Installation/Installing-the-Qlik-Analytics-Migration-Tool.htm#planning-your-migration)
* [管理用户](https://help.qlik.com/zh-CN/migration/Content/AnalyticsMigrationTool/Installation/Installing-the-Qlik-Analytics-Migration-Tool.htm#managing-users)
* [创建计划](https://help.qlik.com/zh-CN/migration/Content/AnalyticsMigrationTool/Installation/Installing-the-Qlik-Analytics-Migration-Tool.htm#creating-plans)
* [运行作业](https://help.qlik.com/zh-CN/migration/Content/AnalyticsMigrationTool/Installation/Installing-the-Qlik-Analytics-Migration-Tool.htm#managing-jobs)