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

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

重要:

白名单要求:

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

要求

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

  • 文档、.docm、.docx、.dot、.dotm、.dotx、.odt
  • .ods、.xl、.xlsb、.xlsx、.xlsx
  • 点点点点点点点点点点点点点点点点点点点点点点点点点点点点点点点点点点点点点点点点点点点
  • .pdf
  • 图像文件(bmp,gif,jpg,jpeg,png,TIF,TIFF)

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

  • .docm、.docx、.odt
  • .ods、.xlsb、.xlsm、.xlsx
  • .odp、.ppsx、.pptx

支持的环境

  • 标准区域
  • 多租户区域
  • Web 应用程序

白名单/网络注意事项

  • 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 需要更新。

这个配置文件有一个密钥 下载文件 ,目前是 错误的。将密钥更改为 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. 输入您的微软 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 问题进行故障排除

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

要对配置进行故障排除,请首先登录 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