配置 ADC 内置代理以管理实例
在运行版本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-sdx 或
./mastool_init.sh-sdx -profile 注意
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年。12.1 - 57. xx和xx 是 ./mastools_init.sh"MAS; " -profile ./mastools_init.sh"MAS; " 低13.0于61年。12.1 - 57. xx和xx 否 ./mastools_init.sh-profile ./mastools_init.sh高于 13.0 61.x 和 12.1 57.xx 不适用 ./mastools_init.sh-profile ./mastools_init.sh在中
在中
在中
在中
对于 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中的二进制日志。