Konfigurieren des StorageZones Controller für Web App-Vorschauen, Miniaturansichten und Nur-Sharing Sharing

Lokale Dateivorschau werden von Ihrem lokalen Microsoft Office Web Apps (OWA) Server gerendert. Bei der Vorschau von Dateien, die in einer von Citrix verwalteten Speicherzone gespeichert sind, werden die Vorschau von Citrix verwalteten oder von Microsoft verwalteten OWA-Servern gerendert.

Wichtig:

Whitelisting-Anforderungen:

*.sf-api.com muss von Ihrem Office Online Server für die Vorschau und Bearbeitung zur ordnungsgemäßen Funktion auf Speicherzonen ab Version 5.0 zugreifen.

Anforderungen

Unterstützte Dateitypen für lokale Dateivorschau

  • doc, docm, docx, dot, dotm, dotx, odt
  • .ods, .xls, .xlsb, .xlsm, .xlsx
  • .odp, .pot, .potm, .potx, .pps, .ppsm, .ppsx, .ppt, .pptm, .pptx
  • .pdf
  • Bilddateien (bmp, gif, jpg, jpeg, png, tif, tiff)

Unterstützte Dateitypen für die lokale Dateibearbeitung

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

Unterstützte Umgebungen

  • Standardzonen
  • Mehrmandanten-Zonen
  • Webanwendung

Whitelisting/Netzwerküberlegungen

  • OOS Server sollte https://\*.sf-api.com (oder .eu) erreichen können
  • SZC Server sollte in der Lage sein, https://\*.sf-api.com und https://\*.sharefile.com (oder .eu) zu erreichen
  • SZC Server sollte OOS Server erreichen könnenhttps://\<Customer OOS / OWA Endpoint\>/hosting/discovery(zum Beispielhttps://oos.sharefileexample.com/hosting/discovery)

Um lokale Dateien zu bearbeiten, Dateiversionierung muss in Ihrem ShareFile Konto aktiviert sein.

Die Einstellung zum Aktivieren der Microsoft Office Online-Bearbeitung im Menü Erweiterte Einstellungen für ShareFile Web App wirkt sich nicht auf die Fähigkeit zum Bearbeiten lokaler Dateien aus. Dieser spezielle Umschalter steuert nicht Ihre Fähigkeit, lokale Dateien zu bearbeiten, sondern gilt für die Bearbeitung von Dateien, die in einer Public Cloud gespeichert sind. Die Aktivierung der Bearbeitung von On-Prem-Dateien wird ausschließlich vom Storage Zones Controller Admin mit den unten beschriebenen Schritten gesteuert.

Microsoft-Serverkompatibilität

  • Microsoft Server 2016: unterstützt die Möglichkeit zum Bearbeiten und Vorschauen von Dateien. Die Bearbeitung kann auch deaktiviert werden.

  • Microsoft Server 2013: unterstützt nur die Möglichkeit, Dateien in der Vorschau anzuzeigen.

Architektur- und Netzwerkdiagramm

ShareFile Vorschaufluss

  1. Authentifizierter Benutzer fordert eine Dateivorschau in ShareFile an.
  2. ShareFile gibt eine Umleitung auf das Clientgerät mit Office Online Server-FQDN aus
  3. Clientgerät leitet an Office Online Server-FQDN weiter. Hinweis: HTTPS-Verbindung, DNS sollte entweder einen Datensatz für interne Server-IP oder einen Datensatz für Load Balancer VIP haben, mit anwendbarem Routing zwischen Client-Gerät und einer Firewall an Port 443.
  4. Office Online Server verarbeitet Anforderung, macht API-Aufrufe an Speicherzonen Controller -Server. Hinweis: HTTPS-Verbindung, DNS sollte entweder einen Datensatz für interne Server-IP oder einen Datensatz für Load Balancer VIP haben, mit anwendbarem Routing zwischen Client-Gerät und einer Firewall an Port 443.
  5. Die Controller Prüfungen der Speicherzonenhttps://\<DNSname\>/hosting/discovery sind erreichbar. Nur wenn es erreichbar ist, sendet SZC API-Antworten zurück an Office Online Server. Hinweis: Der SpeicherzonenController muss eine Verbindung zum Office Online Server herstellen. HTTPS-Verbindung zwischen beiden intern gehosteten Servern.
  6. Der StorageZones Controller verbindet ausgehend mit der ShareFile e-API (sf-api.com). Hinweis: Dies ist eine obligatorische ausgehende Verbindung über eine Firewall, einen Proxy oder eine ausgehende Routing-Appliance. Stellen Sie sicher, dass der Storage Zones Controller -Server ausgehend über HTTPS/443 mit den oben dokumentierten IP-Adressen kommunizieren kann.
  7. Office Online Server verbindet ausgehend mit der ShareFile e-API. Hinweis: Dies ist eine obligatorische ausgehende Verbindung über eine Firewall, einen Proxy oder eine ausgehende Routing-Appliance. Stellen Sie sicher, dass der Office Online Server ausgehend über HTTPS/443 mit den oben dokumentierten IP-Adressen kommunizieren kann.
  8. Vorschau wird angezeigt.

Um Speicherzonen Controller Dateibyte an OOS streamen, anstatt OOS, die ShareFile Steuerebene zum Herunterladen des Inhalts aufruft: Wir müssen einen Schlüssel in einer der Konfigurationsdateien auf dem StorageZones Controller aktualisieren.

Das C:\inetpub\wwwroot\Citrix\StorageCenter\WopiServer\AppSettingsReleaseOnPrem.config muss aktualisiert werden.

Diese Konfigurationsdatei hat einen Schlüssel DownloadFileFromSC , der derzeit falsch ist. Ändern Sie den Schlüssel auf true , und starten Sie IIS neu.

Dadurch wird die Konfiguration aktualisiert. OOS ruft auch nicht mehr die ShareFile Steuerungsebene auf, um den Dateiinhalt herunterzuladen.

Wäre es richtig, wenn Sie diese Option verwenden, wenn Sie angeben, dass kein eingehender Verkehr von der Steuerebene zu OOS gäbe?

Wenn die obige Option verwendet wird, stellt OOS keine ausgehenden Verbindungen zur ShareFile Steuerungsebene mehr her.

Die ShareFile Steuerungsebene macht jedoch immer noch ausgehende Verbindungen zu OOS, unabhängig davon, ob die obige Option verwendet wird oder nicht.

Gibt es Vor- oder Nachteile bei der Verwendung einer Methode gegenüber der anderen?

Bei diesem Ansatz lädt OOS den Dateiinhalt nicht direkt herunter. Der StorageZones Controller lädt die Dateibytes zu OOS herunter und streamt sie. Dadurch wird die Last auf den Speicherzonen Controller -Servern erhöht.

Das Herunterladen und Streamen von Dateibytes ist eine ressourcenintensive Aufgabe. Abhängig von der Anzahl der Benutzer und der Anzahl der Vorschau- und Bearbeitungsvorgänge erhöht sich die Last auf den Controller -Servern der Speicherzonen.

Aktivieren der lokalen Vorschau und Bearbeitung

Konfigurieren Sie den StorageZones Controller wie folgt, um die Dokument- und Bildvorschau im Browser, Miniaturansichten, die gemeinsame Nutzung der in vom Kunden verwalteten Speicherzonen gespeicherten Daten und die lokale Dateibearbeitung im Browser zu unterstützen:

  1. Klicken Sie in der Storage Zones Controller Konsole auf die Registerkarte ShareFile Daten .

  2. Aktivieren Sie im Abschnitt Konfiguration der lokalen Netzwerkfreigabe die Option Vorschau von Office-Webanwendungen konfigurieren .

  3. Geben Sie die externe URL Ihres Microsoft Office Web Apps (OWA) -Servers ein.
    • Benutzer müssen die OWA-Serversoftware über ihr Microsoft Office MSDN-Abonnement herunterladen und konfigurieren.
  4. Wählen Sie Office Online-Bearbeitung aktivieren (falls erforderlich)

  5. Stellen Sie sicher, dass die OWA-URL extern zugänglich ist.

  6. Stellen Sie sicher, dass Ihre Office Online-Server mit kommunizieren können*.sf-api.com.

  7. Klicken Sie in der Storage Zones Controller Konsole auf die Registerkarte Überwachung .

  8. Stellen Sie sicher, dass OWA Server Connectivity ein grünes Häkchen hat.

Hinweis:

Das Bearbeiten lokaler DateienDateiversionierungmuss für das ShareFile Konto aktiviert sein. Wenn die Dateiversionierung für das Konto deaktiviert ist, funktioniert die lokale Bearbeitung nicht.

Wichtig:

Uhrsynchronisierung konfigurieren:

Ändern der OWA URAL oder Deaktivieren der Vorschau:

  • Eine der oben genannten Aktionen erfordert, dass der IIS-Dienst für jeden primären und sekundären Controller neu gestartet wird.

Einschränkungen

  • Mobile Apps unterstützen die Bearbeitung im Browser nicht.
  • Connectors unterstützen keine Browservorschau.

WOPI-Vorschauen werden für VDR-Konten nicht unterstützt.

Informationen zum Konfigurieren des Citrix ADC für die reine View-Only Sharing finden Sie unter Konfigurieren Sie Citrix ADC für den Storage Zones Controller.

Fehlerbehebung bei OWA und OOS Problemen

Wenn bei der Vorschau oder Bearbeitung von On-Prem-Dateien Probleme auftreten, helfen die folgenden Schritte bei der Identifizierung und Korrektur bestimmter Probleme.

Melden Sie sich zuerst bei der OWA- oder OOS-Maschine an, um Probleme bei der Konfiguration zu beheben.

  1. Stellen Sie sicher, dass die Office WebApps- oder OfficeOnline-Windows-Dienste in services.msc ausgeführt werden.

  2. Öffnen Sie in einem neuen Browser diehttp://localhost/hosting/discovery Seite. Wenn diese Seite erfolgreich geladen wird, sollte eine XML-Antwort zurückgegeben werden.

  3. Führen Sie PowerShell als Administrator aus, und führen Sie den folgenden Befehl aus:

Get-OfficeWebAppsFarm

Wenn Sie in der Antwort eine WARNUNG oder FEHLER Meldung erhalten, überprüfen Sie Ihre Konfigurationseinstellungen auf Fehler oder Fehler.

Netzwerküberlegungen:

  • OOS Server sollte https://*.sf-api.com (oder .eu) erreichen können
  • SZC Server sollte in der Lage sein, https://*.sf-api.comund https://*.sharefile.com (oder .eu) zu erreichen
  • SZC Server sollte OOS Server erreichen könnenhttps://<CustomerOOS/OWAEndpoint\>/hosting/discovery. Zum Beispiel, https://oos.sharefileexample.com/hosting/discovery.