Comment modifier l'emplacement de stockage par défaut dans ONLYOFFICE Workspace

Réponse courte : dans ONLYOFFICE Workspace, le panneau de configuration permet de déplacer les données statiques du portail du disque local par défaut vers un service de stockage tiers compatible. Le guide d’administration officiel actuel mentionne Amazon S3, Google Cloud Storage, Rackspace Cloud Storage et Selectel Cloud Storage à cet effet. Il ne décrit cependant pas de champ dans le panneau de configuration permettant de saisir un chemin local arbitraire /mnt/storage.

Ce guide utilise un exemple purement hypothétique. Imaginez une petite agence de design nommée Northstar Studio. Son serveur ONLYOFFICE Workspace, hébergé sur son propre serveur, manque d'espace disque local car le nombre de fichiers téléchargés et autres données statiques du portail a augmenté de façon constante. L'administrateur souhaite déplacer le stockage du portail vers un compartiment Amazon S3 tout en conservant le portail Workspace lui-même sur le même serveur. Northstar Studio n'est qu'un exemple, et non un cas réel ou un résultat client.

Avant toute modification, il est utile de distinguer deux tâches différentes souvent décrites comme « modification de l'emplacement de stockage par défaut ». La première consiste à déplacer le stockage des données statiques du portail du disque local vers un fournisseur de stockage objet compatible via le panneau de configuration. La seconde consiste à déplacer le répertoire du système de fichiers hôte utilisé par une installation Docker auto-hébergée. ONLYOFFICE documente ces opérations comme des couches distinctes ; les étapes ci-dessous se concentrent donc d'abord sur la méthode prise en charge par le panneau de configuration, puis expliquent séparément le cas du disque local.

Qu’est-ce qui change lorsque vous choisissez un nouveau fournisseur de stockage ?

Par défaut, ONLYOFFICE Workspace stocke les données du portail sur le disque local de la machine où Workspace est installé. La page officielle de stockage indique qu'un service tiers connecté peut être utilisé pour les données statiques du portail. Après avoir choisi et connecté un nouveau fournisseur, la page se recharge et un processus de migration des données démarre. Selon le volume de données, cette migration peut prendre un certain temps.

Pour Northstar Studio, l'objectif n'est donc pas d'« obliger chaque utilisateur à enregistrer ses futurs documents dans un dossier spécifique », mais de « migrer le système de stockage du portail du disque par défaut vers un compartiment S3 ». Cette distinction est importante car l'organisation des dossiers utilisateur, les dossiers tiers connectés au sein du module Documents, les destinations de sauvegarde et le système de stockage d'administration sont des fonctionnalités distinctes.

Référence officielle : Centre d'aide ONLYOFFICE : Connexion de stockages tiers .

Étape 1 : Sauvegardez le portail avant de modifier le stockage

Toute modification du stockage entraîne une migration ; il est donc impératif de créer au préalable une sauvegarde récupérable. ONLYOFFICE propose des commandes de sauvegarde et de restauration dans le Panneau de configuration. Une sauvegarde peut être stockée temporairement dans le module Documents, sur un chemin d’accès de l’ordinateur ou sur un service de stockage tiers compatible, selon le déploiement et la configuration.

Pour le serveur hypothétique Northstar Studio, l'administrateur effectuerait une nouvelle sauvegarde et vérifierait l'emplacement de l'archive avant d'accéder à la page Stockage. Cette procédure ne garantit pas l'échec de la migration ; elle offre simplement à l'administrateur une solution de repli en cas de problème d'identifiants, de stratégie de compartiment, d'accès réseau ou autre dépendance.

Référence officielle : Centre d'aide ONLYOFFICE : Sauvegarde et restauration du panneau de configuration .

Étape 2 : Ouvrez le panneau de configuration et vérifiez l’intégration.

Connectez-vous avec un compte disposant des droits d'administrateur du portail. Depuis la page d'accueil de l'espace de travail, ouvrez le panneau de configuration, ou accédez aux paramètres du portail et suivez le lien « Panneau de configuration » situé à gauche. Le service tiers doit être préalablement connecté dans la section « Intégration » du portail ; à défaut, son option de stockage est désactivée sur la page « Stockage ».

Northstar Studio prévoit d'utiliser Amazon S3 ; l'administrateur doit donc vérifier au préalable qu'Amazon S3 est configuré comme service tiers. Cette même condition s'applique au choix de Google Cloud Storage, Rackspace Cloud Storage ou Selectel Cloud Storage.

Étape 3 : Ouvrir les paramètres généraux → Stockage

Dans le Panneau de configuration, accédez à la page Stockage sous Paramètres communs . L'option Disque par défaut est sélectionnée initialement. C'est ici que vous choisissez le système de stockage compatible qui hébergera les données statiques du portail.

Si vous souhaitez uniquement conserver les données sur le disque local du serveur, ne sélectionnez pas de fournisseur cloud. L'option « Disque par défaut » reste le choix pour le stockage local. Si vous devez déplacer ces données locales vers un autre point de montage sur le même serveur, passez à la section concernant Docker et les chemins d'accès hôtes ci-dessous ; la page « Stockage » n'est pas un sélecteur de chemin de système de fichiers générique.

Étape 4 : Saisir les paramètres spécifiques au fournisseur

Sélectionnez le fournisseur souhaité et renseignez les informations de connexion requises. Pour Amazon S3, la documentation ONLYOFFICE actuelle décrit les champs « Compartiment » et « Région », ainsi que les options facultatives « URL du service », « Forcer le style de chemin », « Utiliser HTTP » et les paramètres de chiffrement. Google Cloud Storage utilise le nom du compartiment ; Rackspace et Selectel utilisent leurs propres champs « Conteneur » et « Région ».

Dans l'exemple de Northstar Studio, l'administrateur doit indiquer un compartiment S3 dédié et la région AWS appropriée. Il doit conserver l'URL du service, sauf s'il a besoin d'un point de terminaison différent. Les informations d'identification et les autorisations doivent être limitées aux besoins de Workspace, et l'accès réseau entre le serveur et le service de stockage doit être vérifié avant de lancer la migration.

Vérifications pratiques avant de cliquer sur Connecter

• Vérifiez que le seau ou le conteneur existe bien dans la région prévue.
• Vérifiez que les informations d'identification d'intégration sont valides et autorisées pour les opérations sur l'objet requises.
• Vérifiez que le serveur Workspace peut atteindre le point de terminaison du fournisseur.
• Conservez la sauvegarde récente en dehors des données en cours de migration.
• Planifiez la modification à une période durant laquelle vous pourrez surveiller le portail et le service de stockage afin de détecter d'éventuelles erreurs ou une utilisation inattendue de la capacité.

Étape 5 : Connectez le stockage et laissez la migration se terminer.

Cliquez sur « Se connecter » . Conformément au guide officiel d'ONLYOFFICE, la page se recharge et le processus de migration des données démarre. Ne considérez pas la modification comme terminée simplement parce que le fournisseur a été accepté. Attendez que la page « Stockage » s'affiche avec le nouveau stockage sélectionné, puis vérifiez le bon fonctionnement du portail.

Pour Northstar Studio, une validation pertinente consiste à ouvrir plusieurs documents existants, à charger un nouveau fichier, à prévisualiser des images ou d'autres contenus statiques et à vérifier la présence de nouveaux objets dans le compartiment S3. L'organisation exacte des objets relève de l'implémentation ; l'important est que le contenu du portail fonctionne correctement et que le nouveau système de gestion des données soit utilisé. Si le portail signale des erreurs, vérifiez les identifiants, la politique du compartiment, la région, l'accessibilité du point de terminaison et les journaux du serveur avant d'apporter des modifications supplémentaires.

Que faire si vous préférez utiliser un autre disque local ou un autre point de montage ?

C’est là que de nombreux tutoriels sur l’« emplacement de stockage par défaut » peuvent induire en erreur. L’option « Disque par défaut » du panneau de configuration ne permet pas de sélectionner un répertoire hôte arbitraire. Pour les déploiements Workspace basés sur Docker, la documentation de migration d’ONLYOFFICE indique que les données du portail sont stockées sur /app/onlyofficel’hôte. La documentation d’installation manuelle de Docker crée également des répertoires de composants sous cette arborescence, tels que CommunityServer, DocumentServer, MailServer, ControlPanel et les répertoires liés à la base de données.

Si vous devez déplacer ces répertoires côté hôte vers un disque plus grand, considérez cela comme une migration de déploiement plutôt que comme un paramètre du panneau de contrôle. Sauvegardez l'installation, arrêtez les conteneurs concernés, copiez les données en préservant les droits d'accès et les permissions, mettez à jour les points de montage côté hôte ou les définitions de volumes Docker Compose utilisés par votre déploiement, puis redémarrez la pile. Le fichier Compose et le mappage de volumes exacts dépendent de la méthode d'installation de Workspace ; copier une commande générique depuis un autre déploiement peut donc endommager le portail.

Pour les installations Docker Compose, consultez les fichiers de déploiement que vous utilisez actuellement et comparez-les avec le guide d'installation officiel : Installation d'ONLYOFFICE Workspace Community avec Docker Compose . Pour connaître l'emplacement des données hôtes utilisé par la configuration officielle Workspace basée sur Docker, consultez le guide de migration Docker d'ONLYOFFICE Workspace .

En quoi la modification du stockage du portail diffère-t-elle de la modification du stockage de sauvegarde ?

Il s'agit de deux options distinctes. La page Stockage détermine l'emplacement de stockage des données statiques du portail. La page Sauvegarde détermine l'emplacement d'écriture des archives de sauvegarde. Vous pouvez, par exemple, conserver les données du portail sur le disque par défaut tout en écrivant les sauvegardes ailleurs, ou déplacer les données statiques du portail vers S3 tout en conservant les sauvegardes ailleurs. Pour une meilleure résilience, il est généralement plus simple de séparer logiquement les sauvegardes du système de stockage principal lors d'une restauration.

Quelle option convient le mieux à votre situation ?

Liste de vérification finale

• Le fournisseur souhaité est sélectionné sur la page Stockage.
• La migration est terminée, elle n'a pas seulement commencé.
• Les fichiers existants s'ouvrent et se téléchargent normalement.
• Les nouveaux téléchargements fonctionnent.
• Les utilisateurs peuvent toujours accéder au portail sans erreurs liées au stockage.
• Le nouveau compartiment ou conteneur indique une activité cohérente avec l'utilisation du portail.
• Une sauvegarde récente reste disponible et n'a pas été stockée par erreur uniquement dans l'ensemble de données que vous venez de déplacer.

Dans l'exemple de Northstar Studio, la modification du stockage n'est réussie que si le portail fonctionne normalement après la migration et que l'administrateur a confirmé que le serveur S3 sélectionné est actif. Cette définition pratique est plus pertinente que de considérer le simple fait de cliquer sur le bouton « Se connecter » comme preuve de la réussite de l'opération.