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 dans une zone de stockage gérée par Citrix, les aperçus sont rendus par des serveurs OWA gérés par Citrix ou gérés par Microsoft.

Important :

Exigences relatives à la liste blanche :

*.sf-api.com doit être accessible par votre serveur Office Online pour la prévisualisation 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 de fichier local

  • 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 locale de fichiers

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

Environnements pris en charge

  • Zones standard
  • Zones multilocataires
  • Application Web

Liste blanche/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 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, Gestion des versions 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 ShareFile Web App n’affecte pas la possibilité de modifier des fichiers locaux. Ce basculement spécifique ne contrôlera pas votre capacité à modifier des fichiers locaux, mais s’appliquera à l’édition 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é des serveurs Microsoft

  • Microsoft Server 2016 : prend en charge la possibilité de modifier et de prévisualiser les fichiers. La modification peut également être désactivée.

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

Schéma 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. Le périphérique client redirige vers le nom de domaine complet Office Online Server. Remarque : connexion HTTPS, DNS doit avoir soit un enregistrement pour IP du serveur interne, soit un enregistrement pour VIP d’équilibrage de charge, avec un routage applicable entre le périphérique 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 un enregistrement pour l’IP du serveur interne ou un enregistrement pour l’équilibreur de charge VIP, avec le routage applicable entre le périphérique client et n’importe quel 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 d’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 false . Changez la clé sur 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’établit 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 sont une tâche gourmande 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 locale

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 Configurer les aperçus des 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 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 la connectivité du serveur OWA comporte une coche verte.

Remarque :

La modification des fichiers locaux requiert que lq Gestion des versions de fichiers soit activée pour le compte ShareFile. Si la gestion des versions de fichiers est désactivée 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 l’édition dans le navigateur.
  • Les connecteurs ne prennent pas en charge les aperçus dans le navigateur.

Les aperçus WOPI 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 lecture seule, consultezConfigurez Citrix ADC pour le StorageZones Controller.

Résolution des problèmes OWA et OOS

Si vous rencontrez des problèmes pour prévisualiser ou modifier des 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.