Storage zones controller

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

Lokale Dateivorschauen 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 Vorschauen von Citrix verwalteten oder von Microsoft verwalteten OWA-Servern gerendert.

Wichtig:

Anforderungen an die Positivlisten:

*.sf-api.com muss Office Online Server für die Vorschau und Bearbeitung verfügbar sein, damit die Speicherzonen Version 5.0 oder höher ordnungsgemäß funktionieren.

Anforderungen

Unterstützte Dateitypen für die 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

  • Standard-Zonen
  • Mehrmandanten-Zonen
  • Webanwendung

Positivlisten/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 in der Lage sein, OOS Server zu erreichen https://\<Customer OOS / OWA Endpoint\>/hosting/discovery (z. B. https://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 ShareFile Web App-Einstellungen wirkt sich nicht auf die Möglichkeit aus, lokale Dateien zu bearbeiten. Dieser spezifische Umschalter steuert nicht Ihre Fähigkeit, lokale Dateien zu bearbeiten, sondern gilt für die Bearbeitung von Dateien, die in einer öffentlichen Cloud gespeichert sind. Das Aktivieren der Bearbeitung von On-Prem-Dateien wird ausschließlich durch den Storage Zones Controller Admin gesteuert, indem die unten beschriebenen Schritte ausgeführt werden.

Microsoft-Server-Kompatibilität

  • Microsoft Server 2016: unterstützt die Möglichkeit, Dateien zu bearbeiten und in der Vorschau anzuzeigen. Die Bearbeitung kann auch deaktiviert werden.

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

Architektur- und Netzwerkdiagramm

ShareFile Vorschauablauf

  1. Authentifizierter Benutzer fordert eine Dateivorschau in ShareFile an.
  2. ShareFile gibt eine Umleitung zum Clientgerät mit Office Online Server-FQDN aus
  3. Clientgerät leitet an Office Online Server-FQDN um. Hinweis: HTTPS-Verbindung, DNS sollte entweder einen Datensatz für interne Server-IP oder einen Datensatz für Load Balancer VIP mit anwendbarem Routing zwischen Clientgerät und jeder Firewall auf Port 443 haben.
  4. Office Online Server verarbeitet Anforderung, macht API-Aufrufe an StorageZones Controller-Server. Hinweis: HTTPS-Verbindung, DNS sollte entweder einen Datensatz für interne Server-IP oder einen Datensatz für Load Balancer VIP mit anwendbarem Routing zwischen Clientgerät und jeder Firewall auf Port 443 haben.
  5. StorageZones Controller Prüfungen https://\<DNSname\>/hosting/discovery sind erreichbar. Nur wenn erreichbar, sendet SZC API-Antworten zurück an Office Online Server. Hinweis: Der StorageZones Controller muss eine Verbindung mit dem 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 jede Firewall, Proxy oder ausgehende Routing-Appliance. Stellen Sie sicher, dass der StorageZones Controller-Server ausgehend über HTTPS/443 mit den oben dokumentierten IP-Adressen kommunizieren kann.
  7. Office Online Server stellt ausgehend mit ShareFile API her. Hinweis: Dies ist eine obligatorische ausgehende Verbindung über jede Firewall, Proxy oder 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 momentan falschist. Ä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.

Wenn Sie diese Option verwenden, wäre es richtig, wenn Sie angeben, dass kein eingehender Verkehr von der Steuerebene zu OOS vorhanden wäre?

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

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

Gibt es Vor- oder Nachteile der Verwendung einer Methode im Vergleich zur anderen?

In diesem Ansatz lädt OOS Dateiinhalte nicht direkt herunter. Der StorageZones Controller lädt die Dateibytes zu OOS herunter und streamt sie. Somit erhöht es die Last auf den StorageZones Controller-Servern.

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 StorageZones Controller-Servern.

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 StorageZones Controller Konsole auf die Registerkarte ShareFile Daten.

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

  3. Geben Sie die externe URL Ihres Microsoft Office Web Apps-Servers (OWA) 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 auf die OWA-URL extern zugegriffen werden kann.

  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 von lokalen Dateien Dateiversionierung muss für das ShareFile Konto aktiviert sein. Wenn die Dateiversionierung für das Konto deaktiviert ist, funktioniert die lokale Bearbeitung nicht.

Wichtig:

Synchronisierung der Uhr konfigurieren:

Ändern von 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 Browservorschauen.

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 Storage Zones Controller.

Fehlerbehebung bei OWA und OOS Problemen

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

Melden Sie sich zunächst 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 die http://localhost/hosting/discovery Seite in einem neuen Browser. 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 in der Antwort eine WARNUNG oder FEHLER angezeigt wird, überprüfen Sie Ihre Konfigurationseinstellungen auf Fehler.

Überlegungen zum Netzwerk:

  • 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 in der Lage sein, OOS Server zu erreichen https://<CustomerOOS/OWAEndpoint\>/hosting/discovery. Beispiel: https://oos.sharefileexample.com/hosting/discovery.
Konfigurieren des StorageZones Controller für Web App-Vorschauen, Miniaturansichten und schreibgeschütztes Sharing