为 Web App 预览、缩略图和仅查看共享配置 StorageZones Controller

本地文件预览由本地 Microsoft Office Web 应用程序 (OWA) 服务器呈现。预览存储在 Citrix 管理的存储区域中的文件时,将由 Citrix 托管的或 Microsoft 托管的 OWA 服务器呈现预览。

重要:

白名单要求:

*.sf-api.com 必须可由 Office 在线服务器访问,以便预览和编辑才能在 5.0 或更高版本的存储区域上正常运行。

要求

支持本地文件预览的文件类型

  • 文档,.docx,.dot,.dotm,.dotx,.odt,.odt
  • .ods,.xls,.xlsb,.xlsm,.xlsx
  • 波特、波特、波特、波特、波特、波特、波特、波特、波特、波特、波特、波特、波特、波特、
  • .pdf
  • 图像文件(bmp,GIF,JPG,JPEG,PNG,TIF,TIFF)

支持本地文件编辑的文件类型

  • 数码头、数码头、数码头、数码头等
  • .ods,.xlsb,.xlsm,.xlsx
  • 。。。。

支持的环境

  • 标准区
  • 多租户区
  • 网络应用程序

白名单/网络考虑事项

  • OOS 服务器应该能够达到https://\*.sf-api.com (或 .eu)
  • SZC 服务器应该能够访问https://\*.sf-api.comhttps://\*.sharefile.com(或 .eu)
  • SZC 服务器应该能够访问 OOS 服务器https://\<Customer OOS / OWA Endpoint\>/hosting/discovery(例如,https://oos.sharefileexample.com/hosting/discovery

要编辑本地文件,文件版本控制必须在 ShareFile 帐户上启用。

在 ShareFile Web 应用程序高级首选项菜单中打开 Microsoft Office 在线编辑的设置不会影响编辑本地文件的功能。该特定切换会控制您编辑本地文件的能力,但将应用于编辑存储在公有云中的任何文件。启用预备文件的编辑完全由 StorageZones Controller Admin 使用以下步骤进行控制。

Microsoft 服务器兼容性

  • Microsoft Server 2016: 同时支持编辑和预览文件功能。编辑也可以禁用。

  • Microsoft Server 2013: 仅支持预览文件的功能。

体系结构和网络示意图

ShareFile 预览流程

  1. 经过身份验证的用户请求 ShareFile 中的文件预览。
  2. ShareFile 发出重定向到客户端设备与 Office Online Server FQDN
  3. 客户端设备重定向到 Office Online Server FQDN。注意:HTTPS 连接、DNS 应具有内部服务器 IP 的记录或负载均衡器 VIP 的记录,具有客户端设备与端口 443 上的任何防火墙之间的适用路由。
  4. Office 在线服务器处理请求,使 API 调用 StorageZones Controller 服务器。注意:HTTPS 连接、DNS 应具有内部服务器 IP 的记录或负载均衡器 VIP 的记录,具有客户端设备和端口 443 上的任何防火墙之间的适用路由。
  5. StorageZones Controller 检查https://\<DNSname\>/hosting/discovery 是可访问的。只有当可访问时,SZC 将 API 响应发送回 Office 在线服务器。注意: StorageZones Controller 必须连接到 Office 联机服务器。两个内部托管服务器之间的 HTTPS 连接。
  6. StorageZones Controller 将出站连接到 ShareFile API (sf-api.com)。注意:这是通过任何防火墙、代理或出站路由设备进行的强制性出站连接。确保 StorageZones Controller 服务器可以通过 HTTPS/443 到上述记录的 IP 地址进行出站通信。
  7. Office Online Server 将出站连接到 ShareFile API。注意:这是通过任何防火墙、代理或出站路由设备进行的强制性出站连接。确保 Office Online Server 可以通过 HTTPS/443 到上述记录的 IP 地址进行出站通信。
  8. 发生预览。

要让 StorageZones Controller 将文件字节流到 OOS,而不是调用 ShareFile 控制平面来下载内容:我们需要更新 StorageZones Controller 上的配置文件之一的密钥。

C:\inetpub\wwwroot\Citrix\StorageCenter\WopiServer\AppSettingsReleaseOnPrem.config 需要更新。

此配置文件有一个密钥 下载文件 FromSC ,该密钥目前是 的。将密钥更改为 true 并重新启动 IIS。

这样做会更新配置。OOS 也不再调用 ShareFile 控制平面来下载文件内容。

使用此选项时,说明控制平面没有入站流量到 OOS 是否正确?

如果使用上述选项,OOS 将不再与 ShareFile 控制平面建立出站连接。

但是,ShareFile 控制平面仍然与 OOS 建立出站连接,无论是否使用上述选项。

使用一种方法与另一种方法是否有优点或缺点?

在这种方法中,OOS 不直接下载文件内容。StorageZones Controller 下载并将文件字节流式传输到 OOS。因此,它将增加在 StorageZones Controller 服务器上的负载。

下载和流式处理文件字节是一项资源密集型任务。根据用户数量和预览和编辑操作的数量, StorageZones Controller 服务器上的负载增加。

启用本地预览和编辑

要支持浏览器内的文档和图像预览、缩略图、仅查看共享客户管理的存储区域中存储的数据以及本地文件编辑,请按照以下方式配置 StorageZones Controller:

  1. 在 StorageZones Controller 控制台中,单击 ShareFile 数据 选项卡。

  2. 在 “ 本地网络共享配置 ” 部分中,启用 “配 置 Office Web 应用程序预览 ”。

  3. 输入 Microsoft Office Web 应用程序 (OWA) 服务器的外部 URL。
    • 用户必须通过其 Microsoft Office MSDN 订阅下载和配置 OWA 服务器软件。
  4. 选择 启用 Office 在线编辑 (如果需要)

  5. 验证 OWA URL 是否可在外部访问。

  6. 验证您的 Office 在线服务器可以与之进行通信*.sf-api.com

  7. 在 StorageZones Controller 控制台中,单击 控选项卡。

  8. 验证 OWA 服务器连接 是否具有绿色复选标记。

注意:

编辑本地文件需文件版本控制要为 ShareFile 帐户启用。如果该帐户禁用了文件版本控制,则本地编辑将不起作用。

重要:

配置时钟同步:

修改 OWA URAL 或禁用预览:

  • 上述操作之一要求为每个主 Controller 和辅助控制器重新启动 IIS 服务。

限制

  • 移动应用程序不支持浏览器内编辑。
  • 连接器不支持浏览器内的预览。

VDR 帐户不支持 WOPI 预览。

有关如何将 Citrix ADC 配置为仅查看共享的信息,请参阅为 StorageZones Controller 配置 Citrix ADC。

解决 OWA 和 OOS 问题

如果您在预览或编辑 Prem 文件时遇到问题,以下步骤将有助于识别和更正特定问题。

要对配置进行故障排除,请先登录 OWA 或 OOS 计算机。

  1. 验证 Office WebApps 或 OfficeOnline Windows 服务是否在 services.msc 中运行。

  2. 在新浏览器中,打开http://localhost/hosting/discovery 页面。如果此页面成功加载,则应返回 XML 响应。

  3. 以管理员身份运行 PowerShell 并执行以下命令:

Get-OfficeWebAppsFarm

如果您在响应中收到警告或错误消息,请检查您的配置设置是否存在任何错误或错误。

网络注意事项:

  • OOS 服务器应该能够达到https://*.sf-api.com (或 .eu)
  • SZC 服务器应该能够访问https://*.sf-api.comhttps://*.sharefile.com(或 .eu)
  • SZC 服务器应该能够访问 OOS 服务器https://<CustomerOOS/OWAEndpoint\>/hosting/discovery。例如 https://oos.sharefileexample.com/hosting/discovery

为 Web App 预览、缩略图和仅查看共享配置 StorageZones Controller