Product Documentation

WorxMail 测试和故障排除

Sep 13, 2016

如果 WorxMail 不能正常运行,通常是连接问题所致。 本文将介绍如何避免连接问题,以及如何在确实发生问题时排除故障。

测试 ActiveSync 连接、用户身份验证和 APNs 配置

Worx Exchange Active Sync (EAS) Test 工具帮助您验证 ActiveSync 是否为 XenMobile 环境中的部署做好准备,以及环境是否满足 WorxMail 推送通知的系统要求。 Worx EAS Test 工具验证以下问题:

  • iOS 和 Android 设备与 Microsoft Exchange 或 IBM Traveler 服务器的连接情况。
  • 用户身份验证。
  • iOS 的推送通知配置,包括 Exchange Server、Exchange Web Services (EWS)、NetScaler Gateway、APNs 证书和 WorxMail。
    有关配置推送通知的信息,请参阅 WorxMail for iOS 的推送通知

此工具提供用于更正问题的完整建议列表。

安装 Worx EAS Test

Worx EAS Test 工具 Worx EASTest.ipa 可以从 http://support.citrix.com/article/CTX141685 下载。

EAS Test 工具支持使用显式用户名和客户端证书身份验证配置的环境。 在设备上安装 Worx EAS Test 的方法取决于要测试的身份验证类型:

身份验证类型 安装方法

显式用户名

使用 iTunes 在 iOS 设备上安装 Worx EASTest.ipa。

客户端证书

使用 MDX Toolkit 打包 Worx EASTest.ipa,然后将应用程序添加到 XenMobile。

卸载 Worx EAS Test:

  1. 在主屏幕上按下 Worx EAS Test 工具图标,直到图标开始前后移动。
  2. 轻按图标左上角的 X。
  3. 系统提示时,轻按删除

Worx EAS Test 日志

Worx EAS Test 将所有日志写入设备上的 /documents/citrixlogs/ 位置。 如果打包 Worx EAS Test,应用程序将生成两个文件:CtxLog_AppInfo.txt 和 CtxLog_AppPolicies.xml。 在 Worx EAS Test 中使用“Send Log”(发送日志)命令可通过电子邮件发送所有日志文件。

使用 Worx EAS Test 进行测试

执行测试的必备条件:

  • 将网络访问策略设置为不限制
  • 将阻止电子邮件撰写策略设置为

设置测试:

  • 在安装 Worx EAS Test 的设备上,打开此工具。
localized image
  • 要添加将要测试的服务器,请轻按 Add new server(添加新服务器)。 指定以下任意内容以连接到服务器:
    • FQDN (subdomain.example.com)
    • IP 地址 (10.20.30.40)
    • 电子邮件地址 (name@example.com)

对于群集配置,请添加包括负载平衡服务器在内的所有服务器。 轻按 Next(下一步)以添加更多服务器,或轻按 Dismiss(取消)以继续执行下一步。 要删除已添加的服务器,请在其名称上向左轻扫,然后轻按 Delete(删除)。

  • 输入用于测试连接的帐户的以下各项。 要输入某项,请轻按此字段,键入值,然后轻按“Next”(下一步)。
    • Username(用户名):指定 userPrincipalName (UPN) 或 sAMAccountName 属性。
    • Domain(域):提供用户域。 如果要为 Traveler 服务器使用内部域,可以将“Domain”(域)留空。
    • Password(密码):指定用户密码。
  • 要启用“Accept All Certificates”(接受所有证书),请将其设置为 On(开)。
  • 默认情况下,“Client OS”(客户端操作系统)设置为 Auto Detect(自动检测)。 在此情况下,此设置的显示情况如下例所示。
localized image
  • 要更改 OS(操作系统)、Version(版本)或 Device Type(设备类型),请从提供的列表中选择。
  • 要添加 Version(版本)或 Device Type(设备类型),请依次轻按其标签和 +,然后按照下例所示输入信息。 完成后,轻按 <。 要返回到主屏幕,请再次轻按 <
localized image
  • 要更改测试运行的次数,请轻按 Repeat Count(重复总数),然后键入一个值。
  • 要运行测试,请轻按右上角的 Diagnose(诊断)。

显示的测试结果如下例所示:

localized image

以下示例显示报告问题的方式。

localized image

以下示例显示了工具如何通知您 WorxMail 成功收到了测试推送通知。

localized image

如果测试期间出现问题,显示的结果如以下示例所示:

localized image
  • 有关详细的 ActiveSync 策略列表,请轻按 Send Logs(发送日志),然后轻按 Send(发送)。
  • 要重置测试,请轻按主屏幕上的 Reset(重置)。 重置会执行以下操作:
    • 删除所有服务器名称。
    • 清除所有凭据
    • Accept All Certificates(接受所有证书)设置为 Off(关)。
    • Client Settings(客户端设置)设置为 Auto Detect(自动检测)。
    • Repeat Count(重置总数)设置为 1

利用 WorxMail 日志排除连接故障

所有 Worx 应用程序都会生成多个日志,以帮助执行故障排除。 要获取 WorxMail 日志,请执行以下操作:

  • 转到 Worx Home > Help(帮助)> Report Issue(报告问题)
  • 从应用程序列表中选择 WorxMail
  • 将打开一封发送给您所在组织的技术支持人员的电子邮件。
  • 填写主题行和正文,用几句话描述您的问题。
  • 选择问题的发生时间。
  • 只有在支持团队指示您这样做时才更改日志设置。
  • 单击 Send(发送)。 将打开完成消息,指出已附加压缩的日志文件。
  • 再次单击 Send(发送)。

注意

在 iOS 设备上,Worx Home 会自动使用本机电子邮件客户端发送 WorxMail 日志。 Worx Home 不允许用户在 WorxMail 中将日志作为电子邮件附件发送。  这是一个第三方问题。 作为一种解决方法,您可以将 XenMobile 10.3 配置为向服务器自动发送日志。 转到 Settings(设置)> Client Support(客户支持)> Send logs to IT help desk(向 IT 技术支持人员发送日志),并选择 directly(直接)。

 

发送的 zip 文件包括以下日志:

  • CtxLog_AppInfo.txt (iOS)、Device_And_AppInfo.txt (Android)、logx.txt 和 WH_logx.txt (Windows Phone)

应用程序信息日志包含关于设备和应用程序的信息。 验证所使用的硬件型号和平台版本是否受支持。 验证所使用的 WorxMail 和 MDX Toolkit 版本是否最新且兼容。 有关详细信息,请参阅 WorxMail 的系统要求XenMobile 兼容性

  • CtxLog_VPNConfig.xml (iOS) 和 VpnConfig.xml (Android)

    仅会为 Worx Home 提供 VPN 配置日志。 检查 NetScaler 版本 () 以确保所使用的是最新的 NetScaler 版本。 按照如下所述检查 和 设置:

    • 如果“Split DNS”(拆分 DNS)设置为 Remote(远程)、Local(本地)或 Both(二者),确认通过 DNS 正确解析邮件服务器 FQDN。 (拆分 DNS 适用于 Android 上的 Worx Home。)
    • 如果“Split Tunnel”(拆分通道)设置为 On(开),确保邮件服务器作为其中一个可以在后端访问的 Internet 应用程序列出。
  • CtxLog_AppPolicies.xml (iOS)、Policy.xml(Android 和 Windows Phone)

策略日志提供截止到获取此日志的时间为止,应用到 WorxMail 的所有 MDX 策略的值。 对于连接问题,请确认 和 策略的值。

  • 诊断日志(位于“diagnostics”(诊断)文件夹中)


对于 WorxMail 的初始配置,最常见的问题是“公司网络当前不可用”。要使用诊断日志排除连接故障,请按照以下所述操作。

诊断日志中的键列包括“Timestamp”(时间戳)、“Message Class”(消息类)和“Message”(消息)。 当 WorxMail 中出现错误消息时,请记下时间,以便快速地在“Timestamp”(时间戳)列查找相关日志条目。

要确定从设备到 NetScaler Gateway 的连接是否成功,请查看 AG Tunneler 条目。 以下消息表示连接成功:

AG policy Intercepting FQDN:443 for STA tunneling(AG 策略正在为 STA 通道拦截 FQDN:443)

New TCP proxy connection to (null):443 established(与 (null):443 的新 TCP 代理连接已建立)

要确定从 NetScaler Gateway 到 XenMobile 的连接是否成功(并因此验证 STA 票据),请访问 Worx Home 诊断日志,并检查设备注册时间“Message Class”(消息类)下面的 INFO (4) 条目。 以下消息表示 XenMobile 从 Worx Home 获取了 STA 票据:

Getting STA Ticket(正在获取 STA 票据)

Got STA Ticket response(已获取 STA 票据响应)

STA Ticket – Success obtaining STA ticket for App -- WorxMail(STA 票据 – 成功获取应用程序的 STA 票据 -- WorxMail)

注意

注册期间,Worx Home 向 XenMobile 服务器发送获取 STA 票据的请求。 XenMobile 服务器将 STA 票据发送到设备,票据将存储在设备上并添加到 XenMobile 服务器 STA 票据列表中。

要确定 XenMobile 服务器是否向用户发放了 STA 票据,请检查包含在 XenMobile 支持捆绑包中的 UserAuditLogFile.log。 此文件中列出每个票据的发放时间、用户名、用户设备和结果。 例如:

Time: 2015-06-30T 12:26:34.771-0700(时间: 2015-06-30T 12:26:34.771-0700)

User: user2(用户: user2)

Device: Mozilla/5.0 (iPad; CPU OS 8_1_2 like Mac OS X)(设备: Mozilla/5.0 (iPad;CPU OS 8_1_2,如 Mac OS X))

Result: Successfully generated STA ticket for user ‘user2’ for app ‘WorxMail’(结果: 已成功为应用程序“WorxMail”的用户“user2”生成 STA 票据)

要检查从 NetScaler Gateway 到邮件服务器的通信,一种确定是否正确配置了 DNS 和网络的快速方法是使用 WorxWeb 访问 Outlook Web Access (OWA)。 与 WorxMail 类似,WorxWeb 可以使用微型 VPN 通道与 NetScaler Gateway 建立连接,后者充当 WorxWeb 所要访问的内部或外部资源的代理。 在大多数情况下,尤其是在 Exchange 环境中,OWA 托管于邮件服务器上。

要测试配置,请打开 WorxWeb 并输入 OWA 页面的 FQDN,以检查是否可以访问此页面。 此请求所采用的路由和 DNS 解析与 NetScaler Gateway 和邮件服务器之间的通信相同。 如果 OWA 页面打开,则可以确定 NetScaler Gateway 正在与邮件服务器通信。

如果上述所有检查都表明通信成功,则可以确定问题与您的 Citrix 设置无关,而是与 Exchange 或 Traveler 服务器有关。

您可以收集信息并将其提供给 Exchange 或 Traveler 服务器管理员。 首先,通过在 WorxMail 诊断日志中搜索“Error”,检查 Exchange 或 Traveler 服务器是否存在 HTTP 问题。 如果错误包含 HTTP 代码并且您拥有多个 Exchange 或 Traveler 服务器,请诊断各个服务器。 Exchange 和 Traveler 具有 HTTP 日志,其中显示来自客户端设备的 HTTP 请求和响应。 Exchange 的日志为 C:\inetpub\LogFiles\W3SVC1\U_EX*.log。 Traveler 的日志为 IBM_TECHNICAL_SUPPORT > HTTHR*.log。

排除电子邮件、联系人或日历问题

假设 WorxMail 遇到无法发送电子邮件、电子邮件卡在草稿阶段、联系人缺失或日历项目不同步之类的问题。 要解决这些类型的问题,请使用 Exchange ActiveSync 邮箱日志。 这些日志显示设备发送的传入请求和邮件服务器的传出响应。

有关更多详细信息,请参阅以下 TechNet 博客:

Exchange ActiveSync Mailbox Logging(Exchange ActiveSync 邮箱日志)

Under The Hood: Exchange ActiveSync Mailbox Log Analysis(内部结构:Exchange ActiveSync 邮箱日志分析)