Citrix Application Delivery Management 服务

配置 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 内置代理:

  1. 登录 Citrix Cloud。

  2. 应用程序交付管理 磁贴上,单击 管理。然后,选择适合您业务需求的区域。有关详细信息,请参阅使用快速帐户管理 Citrix ADM

    Citrix ADM 快递帐户

  3. 单击入门

    入门

  4. 选择 本地 作为 ADC 部署类型。

    选择本地 ADC 部署类型

  5. 选择 内置代理

    **重

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

    选择内置代理

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

  6. 复制 服务 URL激活代码

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

    复制服务 URL 和激活码

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

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

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

      在 SDX 实例上

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

      ./mastool_init.sh <device-profile-name> <service-url> <activation-code> -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.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 对中,完成主节点上的注册。如果在辅助节点上运行注册,将显示以下消息:

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

  8. 返回 ADM 服务页面,然后单击 注册实例

  9. 添加实例中,查看您启动内置代理的实例。确保实例处于 “ 动” 状态,然后单击 “ 下一步”。

    添加实例

  10. 单击完成

完整的内置代理配置

成功配置内置代理后,您可以访问 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 中的二进制日志
配置 ADC 内置代理以管理实例