Configuration de M-Files Ground Link

Remarque : Ce contenu n’est plus mis à jour. Pour le contenu le plus récent, veuillez consulter le guide de l’utilisateur pour M-Files Online. Pour plus d’informations sur les versions de produit prises en charge, consultez notre politique de cycle de vie.

Avant de configurer la fonction Ground Link, assurez-vous que :

Les connexions gRPC sont autorisées sur le serveur M-Files.
Le serveur dispose d'un certificat TLS valide pour le cryptage des connexions gRPC.

Pour plus d'informations, reportez-vous au document de la base de connaissances Setting Up M-Files to Use gRPC.

Pour configurer la fonction Ground Link, vous devez d'abord installer des connecteurs de référentiel externe sur un proxy Ground Link. Vous devez ensuite configurer les connexions du référentiel dans le coffre. Par la suite, vous pourrez accéder aux données locales et les modifier directement depuis le coffre.

Activation de la connexion Ground Link

Pour configurer la fonction Ground Link, contactez notre service client à l'adresse [email protected] afin d'activer cette fonction pour votre environnement.

Exécutez les étapes suivantes pour activer la connexion de canal pour Ground Link dans un coffre :

Ouvrez M-Files Admin et accédez à un coffre.
1. Ouvrez M-Files Admin.
2. Dans l'arborescence de gauche, déployez une connexion au serveur M-Files.
3. Déployez Coffres.
4. Déployez un coffre.
Cliquez sur Configurations.
Dans la zone de navigation, déployez Advanced Vault Settings > Configuration.
Cliquez sur Ground Link.
Dans l'onglet Configuration, définissez Enabled sur Yes.
Cliquez sur Save.
Redémarrez le coffre pour que les paramètres entrent en vigueur.

Remarque : La mise hors ligne d’un coffre devrait toujours être réalisée de manière contrôlée et les utilisateurs de coffre devraient en être informés à l’avance.
Dans la zone de navigation grise, déployez External Repositories > Ground Link puis sélectionnez Configuration.

Dans l'onglet Configuration, indiquez les paramètres suivants :


Nom du paramètre		Description	Exemple de valeur
Enabled		Ce paramètre indique si Ground Link est activé ou non.	Yes
Remoting Service	Shared Secrets	Un secret partagé permet à un proxy Ground Link d'authentifier le coffre. Assurez-vous que le secret partagé est complexe et suffisamment long. Vous pouvez indiquer un ou plusieurs secrets partagés. Vous devez saisir le secret partagé lorsque vous configurez le proxy Ground Link.
	Timeouts	Les valeurs de délai d’attente indiquent la durée en secondes pendant laquelle les appels à distance vont attendre une réponse. Utilisez les valeurs par défaut.
	Timeouts > Quick	Cette valeur de délai d'attente est utilisée pour les appels à distance pour lesquels la réponse est rapide.	15 (valeur par défaut)
	Timeouts > Default	Il s'agit de la valeur de délai d’attente standard utilisée pour la plupart des appels à distance.	60 (valeur par défaut)
	Timeouts > Extended	Cette valeur de délai d'attente est utilisée pour les appels à distance pour lesquels la réponse va prendre du temps.	600 (valeur par défaut)
	Timeouts > Custom Timeouts	Vous pouvez ajouter des valeurs de délai d’attente personnalisées pour des appels de méthode à distance spécifiques si la méthode fonctionne correctement mais expire constamment. Ajoutez des valeurs de délai d'attente personnalisées uniquement si vous savez quoi faire.	Method Name: ICloudAgentV1.Ping() Timeout: 100
Keep Alive Interval		Ce paramètre indique la fréquence en secondes à laquelle le coffre vérifie que les services Ground Link sont connectés.	60 (valeur par défaut)

Cliquez sur Save.

Maintenant que le coffre utilise Ground Link, vous pouvez configurer le proxy Ground Link.

Configuration d'un proxy Ground Link

Avant de commencer, assurez-vous que :

Votre serveur proxy Ground Link a suffisamment de ressources matérielles. Reportez-vous à la configuration matérielle recommandée.
M-Files Server et M-Files Admin sont installés sur le serveur proxy Ground Link. Une licence distincte pour M-Files Server n'est toutefois pas nécessaire.
Vous êtes connecté à M-Files Server avec un compte de connexion ayant le rôle serveur Administrateur système. Pour créer un compte de connexion, reportez-vous à Créer un compte de connexion.

Pour configurer un proxy Ground Link :

Ouvrez M-Files Admin.
Dans l'arborescence de gauche, déployez une connexion au serveur M-Files.
Cliquez sur Proxies Ground Link.
Dans le volet droit, cliquez sur Nouveau proxy Ground Link.
Résultat :La boîte de dialogue Nouveau proxy Ground Link s'ouvre.
Saisissez un nom pour le proxy Ground Link.
Sélectionnez le moteur de base de données à utiliser pour le stockage des données du proxy Ground Link.
- Pour utiliser Firebird, sélectionnez Firebird.
  ou
- Pour utiliser Microsoft SQL Server, sélectionnez Microsoft SQL Server.
Pour davantage d'informations, veuillez vous reporter à Moteur de base de données et stockage des données.
Cliquez sur Définir.
Résultat :La boîte de dialogue des paramètres du moteur de base de données s'ouvre.

Effectuez l'une des opérations suivantes :

Option	Description
Dans la boîte de dialogue Proxy Ground Link - Firebird	Cliquez sur le bouton ... et sélectionnez l'emplacement de destination des données du proxy Ground Link. Cliquez sur OK pour fermer la boîte de dialogue.
Dans la boîte de dialogue Proxy Ground Link - Microsoft SQL Server	Suivez les étapes de 6 à 10 dans Migration de la base de données du proxy Ground Link vers Microsoft SQL Server.

Cliquez sur OK pour fermer la boîte de dialogue Nouveau proxy Ground Link.
Installez sur le proxy Ground Link qui vient d'être créé les connecteurs de référentiel externe que votre coffre va utiliser.

Remarque : Si une licence d'application de coffre valide est nécessaire pour un connecteur, la licence servira pour le coffre et pour le serveur contenant le coffre.

Pour davantage d'informations, veuillez vous reporter à Installer et gérer des applications pour coffre.

Exemple : Pour accéder aux dossiers de réseau local depuis M-Files Cloud, installez M-Files Network Folder Connector.

Résultat :Le proxy Ground Link est désormais prêt à être configuré.
Dans l'arborescence de gauche, sous Proxies Ground Link, sélectionnez le proxy Ground Link venant d'être créé.

Dans l'onglet Configuration, indiquez les paramètres suivants :


Nom du paramètre		Description	Exemple de valeur
Enabled		Ce paramètre indique si Ground Link est activé ou non.	Yes
Password		Saisissez un mot de passe que vous utiliserez lorsque vous appliquerez une configuration pour un service Ground Link dans le coffre.
Channel	Network Address	Saisissez l'emplacement réseau du serveur auquel se connecter.
	Port number	Saisissez le port que le serveur écoute. Si vous utilisez le protocole gRPC, utilisez le même numéro de port que celui utilisé par votre client M-Files pour se connecter au serveur. Pour davantage d'informations, veuillez vous reporter à Ajouter une connexion à un coffre. Vérifiez que les ports nécessaires sont ouverts sur le coupe-feu.	7766 ou 443
	Secure	Ce paramètre indique si une connexion de canal sécurisée (cryptée SSL) est utilisée. Les connexions non sécurisées ne sont pas recommandées dans les environnements de production.	Yes
	Vault GUID	Saisissez l'ID de votre coffre. Pour voir l'ID du coffre, cliquez, à l'aide du menu bouton droit, sur le coffre et sélectionnez Propriétés. L'ID s'affiche dans le champ ID unique de la boîte de dialogue Propriétés du Coffre.	{990827D8-8AF2-4A4EB1214C1A8AD8ECD0}
	Shared Secret	Copiez le secret partagé depuis la configuration du coffre. La connexion du canal ne peut pas être établie si le secret partagé ne correspond pas à l’un des secrets partagés indiqués pour Ground Link.
	Reconnect Interval	Cette valeur indique la fréquence en secondes à laquelle le proxy Ground Link essaie de se connecter lorsque le coffre est déconnecté.	60 (valeur par défaut)
	Keep Alive Interval	Cette valeur indique la fréquence en secondes à laquelle le proxy Ground Link vérifie que la connexion au coffre fonctionne correctement.	60 (valeur par défaut)
	Timeouts	Les valeurs de délai d’attente indiquent la durée en secondes pendant laquelle les appels à distance vont attendre une réponse. Utilisez les valeurs par défaut.
	Timeouts > Quick	Cette valeur de délai d'attente est utilisée pour les appels à distance pour lesquels la réponse est rapide.	15 (valeur par défaut)
	Timeouts > Default	Il s'agit de la valeur de délai d’attente standard utilisée pour la plupart des appels à distance.	60 (valeur par défaut)
	Timeouts > Extended	Cette valeur de délai d'attente est utilisée pour les appels à distance pour lesquels la réponse va prendre du temps.	600 (valeur par défaut)
	Timeouts > Custom Timeouts	Vous pouvez ajouter des valeurs de délai d’attente personnalisées pour des appels de méthode à distance spécifiques si la méthode fonctionne correctement mais expire constamment. Ajoutez des valeurs de délai d'attente personnalisées uniquement si vous savez quoi faire.	Method Name: ICloudAgentV1.Ping() Timeout: 100

Cliquez sur Save.

La connexion entre le coffre et le proxy Ground Link est établie. Vous pouvez ensuite configurer les connexions du référentiel dans le coffre.

Vous pouvez voir l’état de la connexion du coffre dans l’onglet Dashboard.

Configuration de connecteurs sur Ground Link

Cet exemple vous explique comment configurer M-Files Network Folder Connector dans un coffre en tant que service Ground Link. Pour obtenir des informations sur la prise en charge d’autres connecteurs, veuillez contacter le service clientèle M-Files à l’adresse [email protected] ou le fournisseur du connecteur.

Avant de commencer, assurez-vous que M-Files Network Folder Connector est installé sur le proxy Ground Link qui est connecté à votre coffre.

Ouvrez M-Files Admin et accédez à un coffre pour lequel vous avez activé la connexion Ground Link.
1. Ouvrez M-Files Admin.
2. Dans l'arborescence de gauche, déployez une connexion au serveur M-Files.
3. Déployez Coffres.
4. Déployez un coffre.
Cliquez sur Configurations.
Dans la zone de navigation, déployez External Repositories.
Cliquez sur Ground Link.

Dans l’onglet Dashboard, vous voyez les proxys Ground Link raccordés et les services Ground Link disponibles. Vérifiez que le service que vous souhaitez configurer, dans le cas présent Network Folder, est en ligne.
Dans la zone de navigation grise, déployez tout d’abord le nœud Ground Link, puis le proxy Ground Link dont vous souhaitez utiliser le service.
Dans la zone de navigation grise, sélectionnez le service Ground Link, dans le cas présent Network Folder.
Dans l'onglet Dashboard, sélectionnez Add Connection.
Dans la boîte de dialogue de confirmation qui s'ouvre, cliquez sur OK.
Dans l'onglet Dashboard , cliquez sur Configure pour configurer la nouvelle connexion.
Pour davantage d'informations, veuillez vous reporter à la section Installing and Configuring M-Files Network Folder Connector.
Cliquez sur Save.
Cliquez sur Apply.
Résultat :La boîte de dialogue Enter Password s’ouvre.
Saisissez le mot de passe qui est défini dans la configuration du proxy Ground Link.
Optionnelle : Authentifiez les utilisateurs d’arrière-plan. Après avoir indiqué les identifiants, enregistrez et appliquez de nouveau les paramètres.
Pour davantage d'informations, veuillez vous reporter à la section Installing and Configuring M-Files Network Folder Connector.
Cliquez sur Save.
Optionnelle : Effectuez de nouveau les étapes de 5 à 12 pour ajouter d’autres connexions.

Vous avez désormais accès aux dossiers de réseau local à partir du coffre. Les objets des dossiers de réseau sont affichés dans M-Files. Vous pouvez les modifier et leur donner des métadonnées de la même façon que pour les objets stockés dans le coffre.