Configurer le StorageZones Controller pour les aperçus Web App, les vignettes et le partage en lecture seule

Les aperçus de fichiers locaux sont rendus par votre serveur Microsoft Office Web Apps (OWA) local. Lors de l’aperçu des fichiers stockés sur une zone de stockage gérée par Citrix, les aperçus sont rendus par les serveurs OWA gérés par Citrix ou Microsoft.

Important :

Exigences relatives à la liste blanche :

*.sf-api.com doit être accessible par votre serveur Office Online pour l’aperçu et la modification afin de fonctionner correctement sur les zones de stockage version 5.0 ou ultérieure.

Exigences

Types de fichiers pris en charge pour l’aperçu des fichiers locaux

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

Types de fichiers pris en charge pour la modification de fichiers sur site

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

Environnements pris en charge

  • Zones standard
  • Zones multilocataires
  • Application Web

Considérations relatives à la liste blanche et au réseau

  • Le serveur OOS doit pouvoir atteindre https://\*.sf-api.com (ou .eu)
  • SZC Server doit pouvoir atteindre https://\*.sf-api.com et https://\*.sharefile.com (ou .eu)
  • SZC Server doit pouvoir atteindre le serveur OOS https://\<Customer OOS / OWA Endpoint\>/hosting/discovery(par exemple, https://oos.sharefileexample.com/hosting/discovery)

Pour modifier des fichiers locaux, Versionning de fichiers doit être activé sur votre compte ShareFile.

Le paramètre d’activation de l’édition en ligne de Microsoft Office dans le menu Préférences avancées de ShareFile Web App n’a pas d’incidence sur la possibilité de modifier des fichiers locaux. Cette option spécifique ne contrôlera pas votre capacité à modifier des fichiers locaux, mais s’appliquera à la modification de tous les fichiers stockés dans un nuage public. L’activation de l’édition des fichiers sur site est exclusivement contrôlée par le StorageZones Controller Admin en suivant les étapes décrites ci-dessous.

Compatibilité avec les serveurs Microsoft

  • Microsoft Server 2016 : prend en charge la possibilité de modifier et d’afficher un aperçu des fichiers. L’édition peut également être désactivée.

  • Microsoft Server 2013 : prend uniquement en charge la possibilité de prévisualiser les fichiers.

Diagramme architectural et réseau

Flux d'aperçu ShareFile

  1. L’utilisateur authentifié demande un aperçu de fichier dans ShareFile.
  2. ShareFile émet une redirection vers la machine cliente avec le nom de domaine complet Office Online Server
  3. L’appareil client redirige vers le nom de domaine complet Office Online Server. Remarque : connexion HTTPS, DNS doit avoir soit A Record for interne server IP, soit A Record for Load Balancer VIP, avec le routage applicable entre l’appareil client et n’importe quel pare-feu sur le port 443.
  4. Office Online Server traite la demande, effectue des appels d’API vers le serveur de StorageZones Controller. Remarque : Connexion HTTPS, DNS doit avoir soit A Record for interne server IP, soit A Record for Load Balancer VIP, avec le routage applicable entre le périphérique client et tout pare-feu sur le port 443.
  5. Les contrôles des StorageZones Controllerhttps://\<DNSname\>/hosting/discovery sont accessibles. Seulement lorsqu’il est accessible, SZC renvoie les réponses API à Office Online Server. Remarque : le Controller de zone de stockage doit se connecter à Office Online Server. Connexion HTTPS entre les deux serveurs hébergés en interne.
  6. StorageZones Controller se connecte sortant à l’API ShareFile (sf-api.com). Remarque : Il s’agit d’une connexion sortante obligatoire via un pare-feu, un proxy ou un dispositif de routage sortant. Assurez-vous que le serveur de StorageZones Controller peut communiquer sortant via HTTPS/443 aux adresses IP documentées ci-dessus.
  7. Office Online Server se connecte sortant à l’API ShareFile. Remarque : Il s’agit d’une connexion sortante obligatoire via un pare-feu, un proxy ou un dispositif de routage sortant. Assurez-vous que Office Online Server peut communiquer sortant via HTTPS/443 aux adresses IP documentées ci-dessus.
  8. L’aperçu se produit.

Pour avoir des zones de stockage Controller flux octets de fichier vers OOS plutôt que OOS appelant plan de contrôle ShareFile pour télécharger le contenu : Nous devons mettre à jour une clé dans l’un des fichiers de configuration sur le StorageZones Controller.

Le C:\inetpub\wwwroot\Citrix\StorageCenter\WopiServer\AppSettingsReleaseOnPrem.config doit être mis à jour.

Ce fichier de configuration a une clé DownloadFileFromSC qui est actuellement fausse. Changez la clé à true et redémarrez IIS.

Cela met à jour la configuration. OOS n’appelle plus le plan de contrôle ShareFile pour télécharger le contenu du fichier.

Lorsque vous utilisez cette option, serait-il correct d’indiquer qu’il n’y aurait pas de trafic entrant entre le plan de contrôle et OOS ?

Si l’option ci-dessus est utilisée, OOS n’effectue plus de connexions sortantes au plan de contrôle ShareFile.

Cependant, le plan de contrôle ShareFile effectue toujours des connexions sortantes à OOS, que l’option ci-dessus soit utilisée ou non.

Y a-t-il des avantages ou des inconvénients d’utiliser une méthode par rapport à l’autre ?

Dans cette approche, OOS ne télécharge pas directement le contenu du fichier. Le StorageZones Controller télécharge et diffuse les octets de fichier vers OOS. Ainsi, il augmentera la charge sur les serveurs de StorageZones Controller.

Le téléchargement et la diffusion en continu d’octets de fichiers est une tâche exigeante en ressources. En fonction du nombre d’utilisateurs et du nombre d’opérations de prévisualisation et de modification, la charge augmente sur les serveurs de StorageZones Controller.

Activer la prévisualisation et la modification sur site

Pour prendre en charge l’aperçu des documents et des images dans le navigateur, les vignettes, le partage en lecture seule des données stockées dans des zones de stockage gérées par le client et l’édition de fichiers locale, configurez le StorageZones Controller comme suit :

  1. Dans la console du StorageZones Controller, cliquez sur l’onglet Données ShareFile .

  2. Dans la section Configuration du partage réseau local, activez les aperçus de Configurer les applications Web Office.

  3. Entrez l’URL externe de votre serveur Microsoft Office Web Apps (OWA).
    • Les utilisateurs doivent télécharger et configurer le logiciel du serveur OWA via leur abonnement Microsoft Office MSDN.
  4. Sélectionnez Activer la modification Office Online (si nécessaire)

  5. Vérifiez que l’URL OWA est accessible en externe.

  6. Vérifiez que vos serveurs Office Online peuvent communiquer avec *.sf-api.com.

  7. Dans la console du StorageZones Controller, cliquez sur l’onglet Surveillance .

  8. Vérifiez que OWA Server Connectivity possède une coche verte.

Remarque :

La modification des fichiers locaux requiert que le Versionning de fichiers soit activé pour le compte ShareFile. Si le contrôle de version de fichier est désactivé pour le compte, la modification locale ne fonctionnera pas.

Important :

Configurer la synchronisation de l’horloge :

Modification de l’URAL OWA ou désactivation des aperçus :

  • L’une des actions ci-dessus nécessite que le service IIS soit redémarré pour chaque Controller principal et secondaire.

Limitations

  • Les applications mobiles ne prennent pas en charge la modification dans le navigateur.
  • Les connecteurs ne prennent pas en charge les aperçus dans le navigateur.

Les aperçus WOI ne sont pas pris en charge pour les comptes VDR.

Pour plus d’informations sur la configuration de votre Citrix ADC pour le partage en affichage uniquement, consultez Configurez Citrix ADC pour le StorageZones Controller.

Résolution des problèmes OWA et OOS

Si vous rencontrez des problèmes lors de la prévisualisation ou de la modification de fichiers sur site, les étapes suivantes vous aideront à identifier et à corriger des problèmes spécifiques.

Pour résoudre les problèmes de configuration, connectez-vous d’abord à la machine OWA ou OOS.

  1. Vérifiez que les services Office WebApps ou OfficeOnline Windows s’exécutent dans services.msc.

  2. Dans un nouveau navigateur, ouvrez la page http://localhost/hosting/discovery. Si cette page se charge correctement, une réponse XML doit être renvoyée.

  3. Exécutez PowerShell en tant qu’administrateur et exécutez la commande suivante :

Get-OfficeWebAppsFarm

Si vous recevez un message d’AVERTISSEMENT ou d’ERREUR dans la réponse, vérifiez vos paramètres de configuration pour détecter toute erreur.

Considérations relatives au réseau :

  • Le serveur OOS doit pouvoir atteindre https://*.sf-api.com (ou .eu)
  • SZC Server doit pouvoir atteindre https://*.sf-api.com et https://*.sharefile.com (ou .eu)
  • SZC Server doit être en mesure d’atteindre le serveur OOS https://<CustomerOOS/OWAEndpoint\>/hosting/discovery. Par exemple, https://oos.sharefileexample.com/hosting/discovery.