NetScaler Application Delivery Management 服务

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

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

注意:

内置代理仅适用于以下 NetScaler 实例类型:

  • NetScaler MPX
  • NetScaler VPX
  • NetScaler SDX
  • NetScaler Gateway

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

NetScaler ADM 支持使用内置代理管理和监视 NetScaler 实例。但是,内置代理不支持以下功能:

  • “应用程序”控制板
  • Web Insight
  • SSL Insight
  • HDX Insight
  • Gateway Insight
  • Security Insight
  • 高级分析
  • 池许可

您可以从内置代理过渡到外部代理。有关更多信息,请参阅 从内置代理过渡到外部代理

必备条件

在 NetScaler 实例上配置内置代理之前,请确保以下操作:

  • NetScaler(MPX、VPX 或网关)实例正在版本 12.1.48.13 或更高版本上运行。SDX 实例正在运行版本 13.0.61.x 及更高版本。

  • 将在 NetScaler 实例上添加 DNS 名称服务器。

    有关更多信息,请参阅 添加域名服务器

  • 您有一个 Citrix Cloud 帐户。有关详细信息,请参阅注册 Citrix Cloud

注意:

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

配置内置代理

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

  1. 按照“入门”中的说明选择内置代理选项。

  2. 复制 服务 URL激活码

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

    复制服务 URL 和激活码

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

    1. 登录到您的 NetScaler 实例。有关更多信息,请参阅 访问 NetScaler

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

      在 SDX 实例上

      ||使用 NetScaler 帐户注册|在没有 NetScaler 配置文件的情况下注册| |—|—|—| |前提条件|在注册之前,创建一个 NetScaler 配置文件。有关更多信息,请参阅如何创建 NetScaler 配置文件。| |运行此命令|./mastools_init.sh <device-profile-name> <service-url> <activation-code> -sdx -profile|./mastools_init.sh <user_name> <service-url> <activation-code> -sdx| |用户凭据|在 <device_profile_name> 中输入 nsroot。或者,您可以使用与 nsroot 具有相同访问权限的用户名。|在 <user_name> 中输入 nsroot。或者,您可以使用与 nsroot 具有相同访问权限的用户名。|

      注意:

      NetScaler ADM 会发现运行在该 SDX 上的所有 VPX 实例,您不必单独注册 VPX 实例。

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

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

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

      注意:

      在注册 NetScaler 配置文件之前,必须创建该配置文件。有关更多信息,请参阅 如何创建 NetScaler 配置文件

      ADC 映像版本 Is 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>

    注意:

    • <device_profile_name><user_name> 中,输入 nsroot。或者,您可以使用与 nsroot 具有相同访问权限的用户名。
    • 在 HA 对中,在主节点上完成注册。如果您在辅助节点上运行注册命令,则会出现以下消息: 请在主节点上运行注册命令
  4. 返回 NetScaler ADM 页面,然后单击 注册实例

  5. 添加实例中,查看您启动内置代理的实例。确保实例处于 Up 状态,然后单击 Next

    添加实例

  6. 单击 Done(完成)。

完成内置代理配置

成功配置内置代理后,您可以访问 NetScaler ADM 功能,例如:

  • 虚拟服务器和分析 -向虚拟服务器应用许可证以管理 ADC 实例。有关更多信息,请参阅 管理订阅

  • 应用程序控制板 -以整体方式查看所有应用程序。有关更多信息,请参阅 应用程序管理和控制板

  • 基础设施分析 -此功能可帮助您可视化导致或可能导致实例问题的因素。有关更多信息,请参阅 基础结构分析

注意

您也可以通过导航到 基础结构 > 实例 > 代理 > 生成激活码 页面来配置内置代理。将 URL 和激活码复制并粘贴到 ADC 实例,然后发现该实例。

启动内置代理后,导航到 基础结构 > 实例 > NetScaler。此页显示有关使用内置代理发现的托管实例的详细信息。

故障排除

如果注册失败或者注册成功但内置代理未出现在 NetScaler ADM GUI 中,则可以检查日志。

  • 如果注册失败,请检查登录 /var/mastools/logs/mastools_reg.py.log
  • 如果注册成功,但内置代理未出现在 NetScaler ADM GUI 中,请检查:
    • /var/mastools/logs/mastools_upgrade.log 中的 mastools_Upgrade 日志
    • /var/log/mastoolsd.log 中的二进制日志
配置 ADC 内置代理以管理实例