Citrix Application Delivery Management 服务

配置 ADC 内置代理以管理实例

April 29, 2021

贡献者:

在运行版本 12.1.48.13 及更高版本的 Citrix ADC SDX、VPX、网关实例以及运行 13.0 61.x 及更高版本和 12.1 58.x 及更高版本的 Citrix ADC SDX 实例上均提供内置代理。您可以在 ADC 实例上启动此代理，而不是在数据中心或公有云中安装专用代理。内置代理启用实例和 Citrix ADM 服务之间的通信。

注意

内置代理仅适用于以下 Citrix ADC 实例类型：

Citrix ADC MPX

Citrix ADC VPX

Citrix ADC SDX

Citrix Gateway

内置代理非常适合小型 ADC 独立或 HA 对部署。如果您有多个 ADC 实例，请使用专用代理进行部署。此代理可确保您拥有比内置代理更好的数据聚合功能。有关详细信息，请参阅本地安装代理。

Citrix ADM 服务支持使用内置代理管理和监视 Citrix ADC 实例。但是，内置代理不支持以下功能：

应用程序仪表板
Web Insight
SSL Insight
HDX Insight
Gateway Insight
Security Insight
高级分析
池许可

您可以从内置代理过渡到外部代理。有关详细信息，请参阅从内置代理过渡到外部代理。

必备条件

在 Citrix ADC 实例上配置内置代理之前，请确保以下操作：

Citrix ADC（MPX、VPX 或网关）实例正在版本 12.1.48.13 或更高版本上运行。SDX 实例正在运行版本 13.0.61.x 及更高版本。
将在 Citrix ADC 实例上添加 DNS 名称服务器。

有关详细信息，请参阅添加名称服务器。
您有一个 Citrix Cloud 帐户。有关详细信息，请参阅注册 Citrix Cloud。

注意

有关端口和其他系统要求的所有信息，请参阅系统要求。

配置内置代理

执行以下任务以配置 ADC 内置代理：

登录 Citrix Cloud。
在 应用程序交付管理 磁贴上，单击管理。然后，选择适合您业务需求的区域。有关详细信息，请参阅使用快速帐户管理 Citrix ADM。
单击入门。
选择本地作为 ADC 部署类型。
选择 内置代理。

**重

要**信息：要使用内置代理，您的 Citrix ADC 实例必须是版本 12.1 构建 48.13 和更高版本。

生成服务 URL 和激活码并显示在 GUI 上。
复制 服务 URL 和 激活代码。

代理使用服务 URL 查找服务，并使用激活代码向服务注册。如果您是 MPX 或网关客户，请跳过步骤 7。

使用 SSH 客户端启动内置代理。网关用户必须跳过此步骤。

登录到您的 Citrix ADC 实例。有关详细信息，请参阅访问 Citrix ADC。

导航到目 /var/mastools/scripts 录并键入以下命令：

在 SDX 实例上

./mastool_int.sh <user-name> <service-url> <activation-code> -sdx
<!--NeedCopy-->

或

./mastool_init.sh <device-profile-name> <service-url> <activation-code> -sdx -profile

<!--NeedCopy-->

注意

ADM 会发现在该 SDX 上运行的所有 VPX 实例，您无需单独注册 VPX 实例。

在未在 SDX 设备以及 MPX 和网关实例上运行的 VPX 实例上

如果 ADM 映像版本低于 13.0 61.x 或 12.1 57.x，则必须通过键入命令 cat /var/mastools/version.conf 来检查 mastools 版本。如果输出是 0.0-0.0，这是第一次。

根据软件版本，键入以下命令之一。

ADC 映像版本	mastools_version `0.0-0.0`吗？	用个人资料注册的命令	没有配置文件的注册命令
低于 13.0 61.xx 和 12.1 57.xx	是	`./mastools_init.sh <device_profile_name> <service_url> "MAS;<activation_code>" -profile`	`./mastools_init.sh <user_name> <pwd> <service_url> "MAS;<activation_code>"`
低于 13.0 61.xx 和 12.1 57.xx	否	`./mastools_init.sh <device_profile_name> <service_url> <activation_code> -profile`	`./mastools_init.sh <user_name> <pwd> <service_url> <activation_code>`
高于 13.0 61.x 和 12.1 57.xx	不适用	`./mastools_init.sh <device_profile_name> <service_url> <activation_code> -profile`	`./mastools_init.sh <user_name> <pwd> <service_url> <activation_code>`

在中 <username>，输入 Citrix ADC 用户名。
在中 <password>，输入 ADC 密码。
在中 <service_url>，粘贴您在上一步中复制的 URL。
在中 <activation_code>，粘贴您在上一步中复制的激活码。

CLI 启动内置代理

对于 MPX、VPX 和网关实例，使用 mastools 命令的初始化完成后，将建立代理和 ADM 服务之间的通信。只要有最新软件版本可用，代理程序就会自动升级。但是，从 ADC 12.1 57.18 及更高版本以及 ADC 13.0 61.48 及更高版本，内置代理与 ADM 服务通信，而无需定期初始化和自动升级到最新软件版本。对于 SDX 实例，代理在所有受支持的版本中都带有自动升级功能，即 13.0 61.x 及更高版本和 12.1 58.x 及更高版本。

注意：

在 HA 对中，完成主节点上的注册。如果在辅助节点上运行注册，将显示以下消息：

请在主节点上运行注册命令。

返回 ADM 服务页面，然后单击 注册实例。
在 添加实例中，查看您启动内置代理的实例。确保实例处于 “ 启动” 状态，然后单击 “ 下一步”。
单击完成。

完整的内置代理配置

成功配置内置代理后，您可以访问 ADM 功能，例如：

虚拟服务器和分析 — 将许可证应用到虚拟服务器以管理 ADC 实例。有关详细信息，请参阅管理订阅。
应用程序仪表板 — 以整体方式查看所有应用程序。有关详细信息，请参阅应用程序管理和仪表板。
基础架构分析 — 此功能可帮助您可视化导致或可能导致实例问题的因素。有关详细信息，请参阅基础结构分析。

注意：

您还可以通过导航到 “ 网络” > “客户端” > “生成激活码” 页面来配置内置代 理。将 URL 和激活码复制并粘贴到 ADC 实例，然后发现该实例。

启动内置代理后，导航到 “网络” > “实例” > “Citrix ADC”。此页显示有关使用内置代理发现的托管实例的详细信息。

故障排除

您可以检查日志是否注册失败或注册成功但内置代理没有出现在 ADM GUI 中。

如果注册失败，请检查登录 /var/mastools/logs/mastools_reg.py.log
如果注册成功，但内置代理未出现在 ADM GUI 中，请检查：
- /var/mastools/logs/mastools_upgrade.log 中的 mastools_Upgrade 日志
- /var/log/mastoolsd.log 中的二进制日志。

本内容的正式版本为英文版。部分 Citrix 文档内容采用了机器翻译，仅供您参考。Citrix 无法控制机器翻译的内容，这些内容可能包含错误、不准确或不合适的语言。对于从英文原文翻译成任何其他语言的内容的准确性、可靠性、适用性或正确性，或者您的 Citrix 产品或服务沿用了任何机器翻译的内容，我们均不作任何明示或暗示的保证，并且适用的最终用户许可协议或服务条款或者与 Citrix 签订的任何其他协议（产品或服务与已进行机器翻译的任何文档保持一致）下的任何保证均不适用。对于因使用机器翻译的内容而引起的任何损害或问题，Citrix 不承担任何责任。

配置 ADC 内置代理以管理实例

April 29, 2021

贡献者:

April 29, 2021

贡献者: