ADC

Citrix StoreFront 应用商店监视

您可以为 Citrix StoreFront 商店配置用户监视器。监视器通过连续探测帐户服务、发现服务和身份验证终端节点(如果 Citrix StoreFront Store 是经过身份验证的应用商店)来确定 StoreFront 应用商店的状态。如果这些服务中的任何一项未响应探测器,则监视器探测器将失败,并且 StoreFront 商店将标记为“关闭”。监视器将探测发送到绑定服务的 IP 地址和端口。有关更多信息,请参阅 Citrix StoreFront 商店服务 API

注意:监视器探测源自 NSIP 地址。但是,如果 StoreFront 服务器的子网与设备的子网不同,则使用子网 IP (SNIP) 地址。

您也可以将 StoreFront 显示器绑定到服务组。监视器绑定到服务组的每个成员,并将探测器发送到绑定成员(服务)的 IP 地址和端口。此外,由于现在使用成员的 IP 地址监视服务组的每个成员,因此您现在可以使用 StoreFront 监视器监视添加为服务组成员的 StoreFront 群集节点。

在早期版本中,StoreFront 监视器尝试对匿名应用商店进行身份验证。因此,服务可以标记为关闭,并且您无法使用负载平衡虚拟服务器的 URL 启动 Citrix Virtual Apps 和 Citrix Virtual Desktops。

探测顺序已更改。监视器现在通过先后探测帐户服务、发现文档和身份验证服务来确定 StoreFront 存储的状态,并跳过匿名存储的身份验证。

不建议使用 StoreFront 监视器的主机名参数。安全参数现在用于确定是使用 HTTP(默认)还是 HTTPS 发送监视探测器。

要使用 HTTPS,请将安全选项设置为“是”。

使用 CLI 创建 StoreFront 显示器

在命令提示符处,键入以下命令以配置 StoreFront 监视器并验证配置:

add lb monitor <monitorName> STOREFRONT <string> -storeName <string> [-storefrontacctservice ( YES | NO )] -secure ( YES | NO )

show lb monitor <monitorName>
<!--NeedCopy-->

示例

add lb monitor storefront_ssl STOREFRONT -storename myStore -storefrontacctservice YES -secure YES
<!--NeedCopy-->

使用 GUI 创建 StoreFront 显示器

导航到 流量管理 > 负载平衡 > 监视器,然后创建 STOREFRONT类型的监视器。

基本参数设置:

  • 间隔:两个连续探测之间的时间间隔。默认时间间隔为 5 秒。
  • 响应超时:NetScaler 在将探测器标记为失败之前等待的持续时间。默认持续时间为 2 秒。
  • 应用商店名称:必须监控的 StoreFront 应用店。默认情况下,用户监视器使用 /Citrix/StoreWeb 应用商店进行监控。
  • StoreFront 帐户服务:启用或禁用 StoreFront 帐户服务的探测功能。
  • 检查后端服务:此选项允许监控 StoreFront 服务器上运行的服务。
  • 安全:如果您使用的是 HTTPS,请启用此选项。

StoreFront 显示器

注意

有关 StoreFront 监视器的更多信息,请参阅 StoreFront 文

扩展版StoreFront 显示器

NetScaler 推出了一款扩展的 StoreFront 监视器,它可以代表测试用户帐户在 Citrix StoreFront 商店中模拟身份验证和应用程序枚举。您必须在 StoreFront 上预配置并启用测试用户帐户才能进行监控。提供测试用户凭证、存储名称和 nssf_extend.pl 脚本以使用此监视器的功能。

如果 StoreFront 监视器绑定到某个服务组,则它会使用用户凭据来监控该服务组的所有成员。因此,我们建议您在所有服务组成员的 Active Directory 中提供测试用户凭据。如果监视器处于活动状态,并且至少有一个应用程序已授权给测试用户,则确保测试用户凭证不会过期。

使用 GUI 配置扩展的 StoreFront 显示器

  • 导航到“流量管理”>“负载平衡”>“监视器”,然后单击“添加”。

  • 将类型选择为“用户”。

  • 在“基本参数”部分中,提供以下详细信息:

    • 安全参数:在此字段中提供用户名、密码和商店名称。详细信息必须采用该格式 user=<DomainName\username>;password=<password>;store=/Citrix/StoreWeb。如果未提供存储名称, 则使用默认应用商店 /Citrix/StoreWeb 进行监控。

    • 脚本名称:选择 nssf _extend.pl 脚本。

    • 间隔响应超时:将时间间隔和响应设置为更大的值,最好以分钟为单位。这可确保在 StoreFront 监视器进行多次 HTTP/HTTPS 调用时完成监视器探测。

使用 CLI 配置扩展的 StoreFront 监视器

使用以下命令在 CLI 上配置扩展 StoreFront 监视器:

add lb monitor <monitorName> USER -scriptName nssf_extend.pl -secureArgs “user=<DomainName\username>;password=<password>;store=/Citrix/StoreWeb;” -interval 2 Min -resptimeout 1 Min

注意:

要进行身份验证,请使用安全参数参数而不是脚本参数参数。Secure Arguments 参数以加密格式保存用户凭据。

错误消息

下表描述了显示器探测失败时显示的错误消息。有关错误的详细信息,请参阅“描述”列。

错误 说明
参数数量不足 管理员必须在“安全参数”参数中提供用户名和密码。
参数格式无效 管理员必须以正确的格式提供安全参数, “user=<DomainName><username>;password=<password>;store=/Citrix/Storeweb 或者 user=<DomainName><username>;password=<password>
未生成 ASP.NET_SessionId 或 CsrfToken 在 StoreFront 的回复中找不到 CSRF 令牌或 ASP.NET_SessionId cookies。
无法获取客户机配置 显示器无法从 StoreFront 获取客户端配置设置。
缺少 CtxsDeviceId cookie 在 StoreFront 的回复中找不到 CtxsDeviceId cookie。
无法获取身份验证方法的 API 端点 StoreFront 监视器无法获取 API 端点以获取已配置的身份验证方法列表。
不支持使用用户名/密码登录 StoreFront 上已禁用用户名和密码方法。它必须在 StoreFront 上启用。
无法获取身份验证端点 无法从监视器访问用于身份验证的端点。
用户名或密码不正确 为 StoreFront 显示器配置的测试用户凭据无效。
配置的域名不正确 为 StoreFront 显示器配置的域名不正确。
身份验证失败 StoreFront 上的身份验证已失败。
未生成授权 cookie 在 StoreFront 的响应中找不到授权 cookie。
枚举没有所有必填字段 未枚举任何应用程序或应用程序枚举不完整。
应用程序枚举失败 从 StoreFront 中列举应用程序失败。
注销失败 会话注销不成功。这可能会导致 StoreFront 上积累未过期的会话。

show service <name>show servicegroup <name> 命令的输出中,您可以查看监视器在 Last response 字段探测的状态。

示例 1:

show service svc
State: UP
Last state change was at Wed Aug  2 08:53:37 2023
Time since last state change: 0 days, 00:00:21.900

...

Monitor Name: extended_monitor
State: DOWN    Weight: 1    Passive: 0
Probes: 3    Failed [Total: 3 Current: 3]
Last response: Failure - Authorization cookie is not generated
Response Time: 5000.000 millisec
<!--NeedCopy-->

示例 2:

show servicegroup sg_ext_monitor
sg_ext_monitor - HTTP
State: ENABLED Effective State: PARTIAL-UP Monitor Threshold : 0
Max Conn: 0 Max Req: 0 Max Bandwidth: 0 kbits

...

1) Monitor Name: extended_monitor State: ENABLED Weight: 1 Passive: 0
1)   10.106.44.33:80 State: UP Server Name: 10.106.44.33 Server ID: None Weight: 1 Order: Default

...

Monitor Name: extended_monitor State: UP Passive: 0
Probes: 4 Failed [Total: 0 Current: 0]
Last response: Success - Probe succeeded.
Response Time: 1.039 millisec
2)    10.106.44.34:80 State: DOWN Server Name: 10.106.44.34 Server ID: None Weight: 1 Order: Default

...

Monitor Name: extended_monitor State: DOWN Passive: 0
Probes: 4 Failed [Total: 4 Current: 4]
Last response: Failure - Authorization cookie is not generated
<!--NeedCopy-->
Citrix StoreFront 应用商店监视