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 la prévisualisation de fichiers stockés sur 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 Server 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 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 des fichiers locaux

• .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, Gestion des versions de fichiers doit être activé sur votre compte ShareFile.

Le paramètre d’activation de Microsoft Office Online Edition 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 bascule 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.

Diagramme architectural et réseau

1. L’utilisateur authentifié demande un aperçu de fichier dans ShareFile.
2. ShareFile émet une redirection vers la machine client 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 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 tout 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 tout pare-feu sur le port 443.
5. Les contrôles des StorageZones Controllerhttps://\<DNSname\>/hosting/discovery sont accessibles. Uniquement 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 à 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. Modifiez 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 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 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 du serveur OWA via leur abonnement MSDN Microsoft Office.

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 a une coche verte.

Remarque :

La modification des fichiers locaux requiert que le Gestion des versions 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 :

• Vérifiez que le Controller Heure sur vos zones de stockage est synchronisé avec time.windows.com ou un autre serveur NTP. Cliquez ici pour plus d’informations sur la configuration de la synchronisation de l’horloge. ? redirectedFrom=MSDN)

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 du 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 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 dépanner votre configuration, connectez-vous d’abord à l’ordinateur 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.