Citrix SD-WAN

自定义插件 MSI 文件

November 1, 2021

投稿者:

您可以更改 WANOP 客户端插件分发文件中的参数，该文件采用标准 Microsoft 安装程序 (MSI) 格式。自定义需要使用 MSI 编辑器。

注意

已编辑过的参数中已更改。MSI 文件仅适用于新安装。当现有插件用户更新到新版本时，其现有设置将保留。因此，更改参数后，您应该建议用户在安装新版本之前卸载旧版本。

最佳实践：

创建解析到最近已启用插件的设备的 DNS 条目。例如，定义“Repeater.mycompany.com”，并将其解析为您的设备（如果您只有一个设备）。或者，假如您有五台设备，将 Repeater.mycompany.com 解析为您的五台设备中的一台，选择设备是根据靠近客户端或 VPN 单元的程度进行的。例如，使用与特定 VPN 关联的地址的客户端应看到 Repeater.mycompany.com 解析为连接到该 VPN 的 WANOP 客户端插件设备的 IP 地址。使用 MSI 编辑器（如 Oorca）将此地址构建到插件二进制文件中。添加、移动或删除设备时，更改 DNS 服务器上的此单个 DNS 定义会自动更新插件上的设备列表。

您也可以将 DNS 条目解析为多个设备，但除非所有设备的配置相同，否则这是不可取的，因为插件从列表中最左侧的设备获取其中一些特征，并在全局范围内应用它们（包括 SSL 压缩特征）。这可能会导致不希望的和令人困惑的结果，尤其是当 DNS 服务器为每个请求旋转 IP 地址的顺序时。

安装 Orca MSI 编辑器：

有许多 MSI 编辑器，如 Oorca，它是微软免费平台 SDK 的一部分，可以从微软下载。

安装 Orca MSI 编辑器的步骤

下载软件开发工具包的 PSDK-x86.exe 版本并执行它。按照安装说明进行操作。
安装 SDK 后，必须安装 Orca 编辑器。它将在微软平台 SDK\ Bin\ Orca.Msi 下。启动 Orca.msi 以安装实际的逆戟鲸编辑器 (orca.exe)。
运行 Orca— 微软在线提供了 Orca 文档。以下信息介绍了如何编辑最重要的 WANOP 客户端插件参数。
使用 开始 > 所有程序 > Orca 启动 Orca。当出现空白的 Orca 窗口时，使用 “文件” > “打开” 打开 WANOP 客户端插件插件MSI 文件。

图 1. 使用奥卡岛

在表菜单上，单击属性。此时将显示 .MSI 文件的所有可编辑属性的列表。编辑下表中显示的参数。要编辑参数，请双击其值，键入新值，然后按 En ter键。

参数	说明	默认值	注意
WSAPPLIANCES	设备列表	无	以逗号分隔的列表形式在此处输入您的 WANOP 设备的 IP 或 DNS 地址，即 { appliance1, appliance2, appliance3 }。如果用于信令连接的端口与默认端口 (443) 不同，请以 Appliance1：Port_Number 格式指定端口。
DBCMINSIZE	用于压缩的最小磁盘空间量（以兆字节为单位）	250	将其更改为较大的值（例如，2000）可提高压缩性能，但如果磁盘空间不足，则会阻止安装。除非您为 DBCMINSIZE 指定的值之外，还有至少 100 MB 的可用磁盘空间，否则不会安装插件。
EKEYPEM	插件的私钥。使用SSL 压缩的证书/钥钥对的部分	无	使用逆戟鲸的粘贴单元格命令。正常的粘贴函数不会保留键的格式。应该是 PEM 格式的私钥（开头为 —–BEGIN RSA PRIVATE KEY—–）
X509CERTPEM	插件的证书。使用SSL 压缩的证书/钥钥对的部分	无	使用逆戟鲸的粘贴单元格命令。正常的粘贴函数不会保留键的格式。应该是 PEM 格式的证书（开头为 —–BEGIN CERTIFICATE —–）
CACERTPEM	插件的证书颁发机构证书。与 SSL 压缩一起使用	无	使用逆戟鲸的粘贴单元格命令。正常的粘贴函数不会保留键的格式。应该是 PEM 格式的证书（开头为 —–BEGIN CERTIFICATE —–）

在表菜单上单击属性。此时将显示 .MSI 文件的所有可编辑属性的列表。编辑下表中显示的参数。要编辑参数，请双击其值，键入新值，然后按 En ter键。

参数	说明	默认值	注意
WSAPPLIANCES	设备列表	无	在此处以逗号分隔的列表中输入 WANOP 客户端插件设备的 IP 或 DNS 地址，形式为 {appliance1、APPLIANCE2、设备 3} 。如果用于信令连接的端口与默认端口 (443) 不同，请以 Appliance1：Port_Number 格式指定端口。
DBCMINSIZE	用于压缩的最小磁盘空间量（以兆字节为单位）	250	将其更改为较大的值（例如，2000）可提高压缩性能，但如果磁盘空间不足，则会阻止安装。除非您为 DBCMINSIZE 指定的值之外，还有至少 100 MB 的可用磁盘空间，否则不会安装插件。
PRIVATEKEYPEM	插件的私钥。使用SSL 压缩的证书/钥钥对的部分	无	使用逆戟鲸的粘贴单元格命令。正常的粘贴函数不会保留键的格式。应该是 PEM 格式的私钥（开头为 —–BEGIN RSA PRIVATE KEY—–）
X509CERTPEM	插件的证书。使用SSL 压缩的证书/钥钥对的部分	无	使用逆戟鲸的粘贴单元格命令。正常的粘贴函数不会保留键的格式。应该是 PEM 格式的证书（开头为 —–BEGIN CERTIFICATE —–）
CACERTPEM	插件的证书颁发机构证书。与 SSL 压缩一起使用	无	使用逆戟鲸的粘贴单元格命令。正常的粘贴函数不会保留键的格式。应该是 PEM 格式的证书（开头为 —–BEGIN CERTIFICATE —–）

完成后，使用 “ 文件:另存为” 命令用新的文件名保存编辑过的文件，例如 test.msi。

图 2：在 Orca 中编辑参数：
完成后，使用 “ 文件:另存为” 命令用新的文件名保存编辑过的文件，例如 test.msi。

您的插件软件现已定制。

注意

一些用户在 orca 中看到一个错误，导致它将文件截断为 1 MB。检查保存的文件的大小。如果已截断，请创建原始文件的副本，然后使用 “保存” 命令覆盖原始文件。

使用 Orca 自定义设备列表并将自定义 MSI 文件分发给用户后，用户在安装软件时无需键入任何配置信息。

本产品文档的官方版本为英语版本。任何非英语版本仅为方便您而提供，可能包括机器翻译的内容。有关详细信息，请参阅 Cloud Software Group home 上的“机器翻译免责声明”。

NetScaler Secure Deployment Guide

自定义插件 MSI 文件

November 1, 2021

投稿者:

November 1, 2021

投稿者:

在本文中

NetScaler Secure Deployment Guide