![]() |
Si vous utilisez PostgreSQL en tant que fournisseur de persistance, la file d'attente hors ligne est rendue persistante pour prendre en charge le basculement pour la haute disponibilité dans ThingWorx.
|
![]() |
La barre oblique (/) est le séparateur de chemin recommandé pour les référentiels de fichiers.
|
Paramètres de transfert de fichiers
|
Type de données
|
Par défaut
|
Remarques
|
||
---|---|---|---|---|---|
Nbre min. de threads alloués au pool de transfert de fichiers
|
NUMBER
|
10
|
Définit la taille du pool de base pour ThreadPoolExecutor. Ce pool de threads est utilisé pour coordonner la logique de transfert de fichiers contrôlée par la plateforme.
|
||
Nbre max. de threads alloués au pool de transfert de fichiers
|
NUMBER
|
10
|
Définit la taille maximale du pool de threads pour ThreadPoolExecutor.
Des transferts de fichiers asynchrones risquent d'être perdus si ThingWorx rencontre une erreur. Prenons par exemple le cas de 50 longs transferts de fichiers tandis que la valeur par défaut de ce paramètre est fixée à 10. Si ThingWorx échoue, 40 fichiers seront perdus.
|
||
Nombre max. d'entrées dans la file d'attente avant l'ajout d'un nouveau thread de travail
|
NUMBER
|
100
|
Définit la limite supérieure du nombre d'entrées de la file d'attente utilisées dans ThreadPoolExecutor.
Cela limite le nombre de transferts actifs autorisés à la fois.
|
||
Délai d'inactivité du thread (sec)
|
NUMBER
|
600000
|
Définit la durée de vie des threads inactifs dans ThreadPoolExecutor. Le pool interrompt les threads et revient à la taille des pools de base après le temps spécifié.
|
||
Délai d'inactivité du transfert de fichiers (sec)
|
NUMBER
|
30
|
Entre chaque étape du processus de transfert de fichiers (checksum, ReadFromBinaryFile, WriteToBinaryFile, validation), le délai d'inactivité est vérifié. Si l'étape prend plus de temps que le délai d'inactivité défini, le transfert est annulé.
|
||
Taille max. d'un bloc de transfert de fichiers (octets)
|
NUMBER
|
128000
|
Définit le nombre d'octets requis pour les opérations ReadFromBinaryFile et WriteToBinaryFile. Cela représente la taille des fragments de chaque écriture.
Cette variable impose une taille de bloc maximale pendant un transfert de fichiers au niveau système.
La configuration EMS prévaut en permanence. Cependant, si EMS est configuré avec une taille de buffer_size supérieure à celle définie pour cette variable, cette dernière limite cette taille de bloc. Si des tailles de bloc supérieures (128 Ko) sont configurées via EMS, cette valeur doit être augmentée. Le niveau de compilation maximal est de 1 Mo.
|
||
Taille max. du transfert de fichiers (octets)
|
NUMBER
|
100000000
|
Définit le nombre maximal d'octets qu'une opération de copie prend en charge.
Si la taille du fichier source est supérieure à cette valeur, le transfert échouera et un message d'erreur s'affichera.
|
||
Nbre max. de transferts de fichiers autorisés dans la file d'attente hors ligne
|
NUMBER
|
50000
|
Définit le nombre maximal de transferts de fichiers en file d'attente hors ligne autorisés dans le système.
|
||
Nbre max. de transferts de fichiers autorisés par objet dans la file d'attente hors ligne
|
NUMBER
|
10
|
Définit le nombre maximal de transferts de fichiers en file d'attente hors ligne autorisés par objet.
|
||
Durée de vie (sec) du transfert des fichiers dans une file d'attente
|
NUMBER
|
86400
|
Définit la durée maximale pendant laquelle un transfert de fichiers en attente peut rester dans la file d'attente hors ligne.
Un transfert de fichiers est supprimé de la file d'attente hors ligne lorsque le délai spécifié est dépassé.
|
||
Nbre max. de transferts de fichiers contrôlés par Edge autorisés
|
NUMBER
|
500
|
Définit le nombre maximal de transferts de fichiers actifs contrôlés par Edge autorisés sur le système.
Nombre total de transferts contrôlés par Edge simultanés sur la plateforme. Ce paramètre est différent du nombre maximal de transferts actifs en permanence autorisés, qui sont contrôlés par le paramètre Nombre max. d'entrées dans la file d'attente avant l'ajout d'un nouveau thread de travail.
La limite supérieure de cette propriété est contrôlée par MaxConcurrentFileTransfersEdgeCtrl dans le fichier platform-settings.json. La valeur par défaut est 1000.
|
||
Nbre max. de transferts de fichiers contrôlés par Edge autorisés par objet
|
NUMBER
|
2
|
Définit le nombre maximal de transferts simultanés autorisés vers ou depuis un objet contrôlé par Edge. Par exemple, pour une valeur de 2, un objet contrôlé par Edge ne peut avoir que deux transferts actifs (chargement ou téléchargement) en même temps. Les requêtes suivantes de retrait des transferts de fichiers de la file d'attente sont rejetées jusqu'à ce que la capacité le permette.
|
||
Délai d'inactivité pour les transferts de fichiers contrôlés par Edge (sec)
|
NUMBER
|
600
|
Définit le délai maximal pendant lequel une tâche peut demeurer active lorsqu'elle ne fait l'objet d'aucune action (par exemple, transfert de données ou mise à jour de l'état de la tâche). La plage est comprise entre 1 et 3 600 secondes. Ce paramètre est similaire au délai d'inactivité appliqué aux tâches de transfert actives en permanence. Le délai défini est cependant généralement plus long pour pouvoir prendre en compte le cycle de ping des périphériques de scrutation.
|
||
File Transfer Cleanup Frequency (sec)
|
NUMBER
|
10
|
Définit la fréquence de la tâche de nettoyage pour l'évaluation des opérations de transfert de fichiers.
La tâche de nettoyage supprime les tâches obsolètes et arrivées à expiration de la table des tâches actives. Cette action libère les emplacements de transfert de fichiers, ce qui facilite les autres opérations mises en file d'attente. Les valeurs minimale et maximale recommandées doivent être comprises respectivement entre 1 seconde et 60 secondes.
La valeur de ce paramètre doit être définie judicieusement. La valeur par défaut, 10 sec, devrait fonctionner dans la plupart des cas d'utilisation.
• Avec une valeur très faible, la tâche d'arrière-plan démarrera trop fréquemment. Elle récupérera toutes les tâches de transfert de fichiers actives depuis le cache et évaluera leur expiration. Cela ajoutera des calculs inutiles et une charge superflue sur les caches.
• Avec une valeur très élevée, cette tâche démarrera moins fréquemment et des transferts de fichiers contenant la réservation valide pourraient se retrouver bloqués et ne pas libérer la réservation en temps opportun. Cela peut avoir un impact sur l'ensemble des opérations de transfert de fichiers s'il existe de nombreuses opérations bloquées : réseau instable, périphérique qui ne se connecte pas, etc.
|