Fichier de configuration (server)

De Wiki1000
(Différences entre les versions)
(Section Servers)
(HTTP)
 
(133 révisions intermédiaires par 3 utilisateurs sont masquées)
Ligne 1 : Ligne 1 :
 
===Introduction===
 
===Introduction===
Le Serveur d'application Sage 1000 est configuré par un fichier de configuration situé dans le répertoire du serveur.
+
Le Serveur d'application Sage 1000 utilise un fichier de configuration situé dans le répertoire du serveur.
  
 
{{info|Le nom du fichier est serverl1000.ini}}
 
{{info|Le nom du fichier est serverl1000.ini}}
Ligne 9 : Ligne 9 :
  
 
===Structure===
 
===Structure===
Le fichier peut configurer plusieurs services exécuté sur le même serveur, chaque service à au moins deux sections :
+
Le fichier peut configurer plusieurs services exécutés sur le même serveur, chaque service comporte au moins deux sections :
  
 
* [\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SERVICE_NAME]
 
* [\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SERVICE_NAME]
Ligne 40 : Ligne 40 :
 
</pre>
 
</pre>
  
Chaque section à une liste de variable composé de paire Nom=Valeur, les types de données des variables sont :
+
Chaque section est composée d'une liste de variables (NomVariable=ValeurVariable), les types de données des variables sont :
  
 
{|class="wikitable"
 
{|class="wikitable"
 +
|-
 +
!Variable
 +
!Type
 
|-
 
|-
 
|String
 
|String
Ligne 60 : Ligne 63 :
  
 
{|class="wikitable"
 
{|class="wikitable"
 +
|-
 +
!Variable
 +
!Type
 +
!Contexte
 +
!Usage
 
|-
 
|-
 
|ipcMode
 
|ipcMode
Ligne 148 : Ligne 156 :
  
 
{|class="wikitable"
 
{|class="wikitable"
 +
|-
 +
!Variable
 +
!Type
 +
!Usage
 
|-
 
|-
 
|IPC Profil
 
|IPC Profil
Ligne 163 : Ligne 175 :
 
* Vous utilisez un serveur HTTP externe (IIS ou Apache).
 
* Vous utilisez un serveur HTTP externe (IIS ou Apache).
 
* Vous utilisez la Console des Processus Métiers pour dialoguer avec ce Service.
 
* Vous utilisez la Console des Processus Métiers pour dialoguer avec ce Service.
 +
* Vous utilisez le Contrôleur des services.
 
* Ce Service exécute des tâches de traitement déléguées par un autre Service.
 
* Ce Service exécute des tâches de traitement déléguées par un autre Service.
  
 
Si vous n'utilisez pas les services IPC il est conseillé de ne pas les démarrer.
 
Si vous n'utilisez pas les services IPC il est conseillé de ne pas les démarrer.
 +
 +
{{tip|Ce paramètre n'est pas modifiable depuis la console des services car si vous désactivez les services IPC le contrôleur n'est plus opérationnel}}
  
 
====Sessions====
 
====Sessions====
Ligne 177 : Ligne 192 :
  
 
{|class="wikitable"
 
{|class="wikitable"
 +
|-
 +
!Variable
 +
!Type
 +
!Défaut
 +
!Min
 +
!Usage
 
|-
 
|-
 
|SESSIONS Profil
 
|SESSIONS Profil
 
|String
 
|String
 +
|
 +
|
 
|Référence un nom de section SESSIONS contenant la configuration
 
|Référence un nom de section SESSIONS contenant la configuration
 
|-
 
|-
 
|CheckInterval
 
|CheckInterval
 
|Entier
 
|Entier
 +
|1 minute
 +
|1 minute
 
|Délai entre chaque test d'expiration en seconde.
 
|Délai entre chaque test d'expiration en seconde.
 
|-
 
|-
 
|ExpireInterval
 
|ExpireInterval
 
|Entier
 
|Entier
 +
|15 minutes
 +
|
 
|Délai d'expiration des sessions en seconde.
 
|Délai d'expiration des sessions en seconde.
 
|}
 
|}
Ligne 201 : Ligne 228 :
  
 
{|class="wikitable"
 
{|class="wikitable"
 +
|-
 +
!Variable
 +
!Type
 +
!Usage
 
|-
 
|-
 
|Master Profil
 
|Master Profil
Ligne 216 : Ligne 247 :
 
|Master OS Authentication
 
|Master OS Authentication
 
|Boolean
 
|Boolean
|Utiliser l'autentification du sytème d'exploitation.
+
|Utiliser l'authentification du système d'exploitation.
 
|-
 
|-
 
|Master user
 
|Master user
Ligne 231 : Ligne 262 :
  
 
{|class="wikitable"
 
{|class="wikitable"
 +
|-
 +
!Variable
 +
!Type
 +
!Version
 +
!Usage
 
|-
 
|-
 
|Server Societies
 
|Server Societies
 
|String
 
|String
 +
|
 
|Liste des sociétés/dossiers servies par le service.
 
|Liste des sociétés/dossiers servies par le service.
 
|-
 
|-
 
|Server Application
 
|Server Application
 
|String
 
|String
 +
|
 
|Nom de l'application servie par le service.
 
|Nom de l'application servie par le service.
 
|-
 
|-
 
|Server User
 
|Server User
 
|String
 
|String
 +
|
 
|Nom de l'utilisateur du service.
 
|Nom de l'utilisateur du service.
 
|-
 
|-
 
|Server Password
 
|Server Password
 
|String
 
|String
 +
|
 
|Mot de passe de l'utilisateur du service.
 
|Mot de passe de l'utilisateur du service.
 
|-
 
|-
 
|Server User Group
 
|Server User Group
 
|String
 
|String
 +
|
 
|Nom du groupe de l'utilisateur du service.
 
|Nom du groupe de l'utilisateur du service.
 
|-
 
|-
 
|Server Authentication
 
|Server Authentication
 
|String
 
|String
 +
|
 
|Annuaire utilisé pour l'authentification.
 
|Annuaire utilisé pour l'authentification.
 +
|-
 +
|Authentication Directories
 +
|liste de chaîne
 +
|8.00
 +
|Annuaires disponibles pour ce service.(code des annuaires séparés par ";")
 
|}
 
|}
  
Ligne 261 : Ligne 308 :
  
 
{|class="wikitable"
 
{|class="wikitable"
 +
|-
 +
!Variable
 +
!Type
 +
!Version
 +
!Usage
 
|-
 
|-
 
|Server Name
 
|Server Name
 
|String
 
|String
 +
|
 
|Nom du service.
 
|Nom du service.
 
|-
 
|-
|Public Folder
+
|Cache Folder
 
|String
 
|String
 +
|
 +
|Répertoire où stocker les fichiers temporaires et les fichiers en cache.
 +
|-
 +
|[[Zone publique (server)|Public Folder]]
 +
|String
 +
|
 
|[[Zone_publique_(server)|Racine des répertoires partagés du service]].
 
|[[Zone_publique_(server)|Racine des répertoires partagés du service]].
 +
|-
 +
|[[Public links (server)|Public Links]]
 +
|Liste de chaîne
 +
|
 +
|Liste de répertoires réseaux (séparés par un ;) pour lesquels des [[Stockage_des_documents|documents peuvent être associés]].
 
|-
 
|-
 
|Send Alert To
 
|Send Alert To
 
|String
 
|String
 +
|
 
|Liste d'adresses emails (séparées par un ;) auxquelles seront envoyés les messages d'alertes.
 
|Liste d'adresses emails (séparées par un ;) auxquelles seront envoyés les messages d'alertes.
 
|-
 
|-
 
|Scripts
 
|Scripts
 
|Liste de chaîne
 
|Liste de chaîne
 +
|
 
|Liste de références CSS ajouté aux pages HTML
 
|Liste de références CSS ajouté aux pages HTML
 +
|-
 +
|MaxDatagridRowCount
 +
|Integer
 +
|
 +
|Limite le nombre de lignes affichées dans les grilles (par défaut à 5000).
 +
|-
 +
|[[Security mode (server)|Security Mode]]
 +
|String
 +
|7.00
 +
|Valeurs possibles : Intranet (valeur par défaut) / Internet [[Service_exposé_sur_internet|Voir Service exposé sur internet]]
 +
|-
 +
|Enable Remember User
 +
|boolean
 +
|7.10
 +
|Permet à l'utilisateur d'avoir son nom pré-renseigné dans la page d'authentification (par défaut à vrai)
 +
|-
 +
|MaxPreviewPageCount
 +
|Integer
 +
|
 +
|Limite le nombre de pages affichées dans les aperçus des éditions (par défaut à 50).
 +
|-
 +
|Preview max page
 +
|Integer
 +
|10.00
 +
|Limite le nombre de pages affichées dans les aperçus des éditions (par défaut à 50).
 +
|-
 +
|Preview blocking
 +
|Boolean
 +
|10.00
 +
|1:Les aperçus sont affichés directement en onglet 0:les aperçus sont envoyés dans la bam.
 +
|-
 +
|Preview timeout
 +
|Integer
 +
|10.00
 +
|Délai d'attente de fin d'aperçu si Preview blocking=1.
 +
|-
 +
|Printer Filter
 +
|chaine
 +
|
 +
|Noms des imprimantes ne pas proposer, séparées par des points virgules (9.20)
 +
 
|}
 
|}
  
 
====Automates====
 
====Automates====
Ces variables configurent le serveur d'automate inclu dans le serveur.
+
Ces variables configurent le serveur d'automate inclus dans le serveur.
  
 
Ces variables peuvent être renseignées dans une section AUTOMATE  
 
Ces variables peuvent être renseignées dans une section AUTOMATE  
Ligne 286 : Ligne 393 :
 
  [\SOFTWARE\Sage\Ligne 1000\Administration\AUTOMATE\nom_de_profil]  
 
  [\SOFTWARE\Sage\Ligne 1000\Administration\AUTOMATE\nom_de_profil]  
  
puis référencée par la variable "Automate Profil"
+
puis référencées par la variable "Automate Profil"
  
 
{|class="wikitable"
 
{|class="wikitable"
 +
|-
 +
!Variable
 +
!Type
 +
!Version
 +
!Usage
 
|-
 
|-
 
|Automate Profil
 
|Automate Profil
 
|String
 
|String
|Version
+
|
 
|Référence une section AUTOMATE.
 
|Référence une section AUTOMATE.
 
|-
 
|-
Ligne 298 : Ligne 410 :
 
Process Server Started
 
Process Server Started
 
|Boolean
 
|Boolean
|Toute
+
|
|Démarre le serveur d'automate. (défaut)<br>
+
|Démarre le serveur d'automate. (défaut) (*)<br>
 
|-
 
|-
 
|Automate Name<br>
 
|Automate Name<br>
 
Process Server Name
 
Process Server Name
 
|String
 
|String
|Toute
+
|
|Nom du serveur d'automate à démarrer.
+
|Nom du serveur d'automate à démarrer. (*)
 
|-
 
|-
 
|Automate Message Box<br>
 
|Automate Message Box<br>
 
Process Server Message Box
 
Process Server Message Box
 
|String
 
|String
|Toute
+
|
 
|Boite à messages utilisé par le serveur d'automate.
 
|Boite à messages utilisé par le serveur d'automate.
 
|-
 
|-
Ligne 316 : Ligne 428 :
 
Process Task Service
 
Process Task Service
 
|String
 
|String
|Toute
+
|
|Nom du Service 1000 exécutant les tâches du serveur d'automate.
+
|Nom du Service 1000 exécutant les tâches du serveur d'automate.(hostname.servicename)
 
|-
 
|-
 
|Automate Task Count<br>
 
|Automate Task Count<br>
 
|Integer
 
|Integer
|Tahoe
+
|6.50
|Nombre maximum de tâches automates simultanées (défaut 1).
+
|Nombre maximal de tâches automates simultanées (défaut 1).
 +
|-
 +
|Automate Debug<br>
 +
|Boolean
 +
|7.00 Patch
 +
|Active le mode debug verbose (**).
 
|}
 
|}
 +
 +
{{Version700}} (*) Ces valeurs peuvent être modifiées sur la ligne de commande
 +
 +
{{Version700}} (**) A utiliser conjointement avec la console de trap snmp
  
 
====Processus métiers====
 
====Processus métiers====
Ces variables configurent le service de Processus Métiers inclu dans le serveur.
+
Ces variables configurent le service de Processus Métiers inclus dans le serveur.
  
 
{|class="wikitable"
 
{|class="wikitable"
 +
|-
 +
!Variable
 +
!Type
 +
!Usage
 
|-
 
|-
 
|BP Started
 
|BP Started
Ligne 334 : Ligne 459 :
 
|Démarre le service de Processus Métiers (défault).
 
|Démarre le service de Processus Métiers (défault).
 
|}
 
|}
 +
 +
{{Version700}} Cette valeur peut être modifiée sur la ligne de commande
  
 
====Système====
 
====Système====
Ligne 345 : Ligne 472 :
  
 
{|class="wikitable"
 
{|class="wikitable"
 +
|-
 +
!Variable
 +
!Type
 +
!Usage
 
|-
 
|-
 
|Process Profil
 
|Process Profil
Ligne 352 : Ligne 483 :
 
|ProcessAffinity
 
|ProcessAffinity
 
|String
 
|String
|Détermine les cores utilisés par le processus sur une machine multi-cores<br>
+
|Détermine les coeurs utilisés par le processus sur une machine multi-coeurs<br>
ex : 1,3 pour utilisé les cores 1 et 3 d'une machine multi-cores.
+
ex : 1,3 pour utiliser les coeurs 1 et 3 d'une machine multi-coeurs.
 
|-
 
|-
 
|ThreadPoolSize
 
|ThreadPoolSize
 
|Integer
 
|Integer
 
|Taille du pool de thread (20)
 
|Taille du pool de thread (20)
 +
|-
 +
|FormCacheSize
 +
|Integer
 +
|Taille du cache pour un écran (défaut:20, 0:désactive l'utilisation du cache)
 
|-
 
|-
 
|FormCacheLimit
 
|FormCacheLimit
 
|Integer
 
|Integer
|Taille du cache d'écran (256)
+
|Taille du cache pour l'ensemble des écrans (256)
 
|-
 
|-
|Start Performance Counters
+
|FormCacheReuse
|Boolean
+
|Integer
|Démarre les compteurs de performance
+
|Nombre de fois qu'un écran peut être réutilisé (-1 : pas de limite)
 
|}
 
|}
  
 
*ProcessAffinity
 
*ProcessAffinity
:Le Processus du serveur est un processus multi-threadé, sur une machine multi-cores il utilise tous les cores disponibles sur le système d'exploitation. Dans certain cas il est souhaitable de restreindre l'exécution à certains cores.
+
:Le Processus du serveur est un processus multi-threadé, sur une machine multi-coeurs il utilise tous les coeurs disponibles sur le système d'exploitation. Dans certain cas il est souhaitable de restreindre l'exécution à certains coeurs.
  
 
*ThreadPoolsize
 
*ThreadPoolsize
:Chaque requête sur le service est exécuté par une thread allouée d'un pool ; lorsque le pool est plein la requête est suspendue juste à ce qu'une thread se libère dans le pool. Cette variable limite la taille du pool de thread et par conséquence limite les contentions et les "context switches" provoqués par le processus.
+
:Chaque requête sur le service est exécutée par une thread allouée d'un pool ; lorsque le pool est plein la requête est suspendue jusqu'à ce qu'une thread se libère dans le pool. Cette variable limite la taille du pool de thread et par conséquence limite les contentions et les "context switches" provoqués par le processus.
 +
 
 +
*FormCacheSize
 +
:L'opération d'ouverture d'un écran est une opération coûteuse, pour cette raison les écrans fermés sont placés dans un cache pour être réutilisés. Cette variable limite le nombre d'instance d'un écran dans le cache.
  
 
*FormCacheLimit
 
*FormCacheLimit
:L'opération d'ouverture d'un écran est une opération couteuse, pour cette raison les écrans fermés sont placés dans un cache pour être réutilisés. Cette variable limite la taille du cache et en conséquence de la mémoire utilisée par le cache d'écran.
+
:L'opération d'ouverture d'un écran est une opération coûteuse, pour cette raison les écrans fermés sont placés dans un cache pour être réutilisés. Cette variable limite le nombre maximal d'écran dans le cache et par conséquent la mémoire utilisée par le cache d'écran.
  
*Start Performance Counters
+
*FormCacheReuse
:Le serveur inclus un certain nombre de [[Compteurs de performance (server)|compteurs de performance]] interrogeables par les outils d'administration Windows (WMI) ou par le protocole SNMP.  
+
:Indique le nombre de fois qu'un écran en cache peut être réutilisé.  
  
 
{{info|Pour pouvoir utiliser WMI la dll serviceL1000perf.dll doit être présente dans le répertoire du serveur.}}
 
{{info|Pour pouvoir utiliser WMI la dll serviceL1000perf.dll doit être présente dans le répertoire du serveur.}}
 +
{{info|Pour désactiver le cache, définir la valeur de FormCacheSize à 0}
 +
 +
====Files d'attente====
 +
Ces variables configurent le service de consommation de file d'attente.
 +
 +
Ces variables peuvent être renseignées dans une section PERF.
 +
 +
[\SOFTWARE\Sage\Ligne 1000\Administration\QUEUELISTENER\nom_de_profil]
 +
 +
puis référencée par la variable "Queue listener Profil"
 +
 +
{|class="wikitable"
 +
|-
 +
!Variable
 +
!Type
 +
!Usage
 +
|-
 +
|Queue listener Started
 +
|Boolean
 +
|Démarre le service de consommation de file d'attente.
 +
|-
 +
|Queue listener queues
 +
|Liste de chaînes séparées par des ,
 +
|Liste des files d'attente à consommer.
 +
|-
 +
|Queue listener Task count
 +
|Entier
 +
|Nombre maximal de tâches simultanées par service.
 +
|}
 +
 +
Les paramètres de scrutation d'une file d'attente peuvent être configurés à la suite du nom de la file d'attente en séparant les paramètres par un caractère ":"
 +
 +
{|class="wikitable"
 +
|-
 +
!Paramètre
 +
!Valeur par défaut (ms)
 +
!Usage
 +
|-
 +
|Initial
 +
|1000
 +
|Délai initial de scrutation (ms)
 +
|-
 +
|Max
 +
|10000
 +
|Délai maximal de scrutation (ms)
 +
|-
 +
|Increment
 +
|1000
 +
|Incrément du délai jusqu'au délai maximal si aucun message n'est disponible (ms)
 +
|}
 +
 +
Exemple :
 +
<pre>
 +
Queue listener queues=MyQueue1:2000:10:20000,MyQueue2,MyQueue3:100:10:1000
 +
</pre>
 +
 +
Avec les valeurs par défaut, une file d'attente est lue initialement toutes les secondes, puis si aucun message n'est reçu, ce délai monte jusqu'à 10 secondes. Lorsque un message est reçu le délai est réinitialisé à 1 seconde et ainsi de suite.
 +
 +
====Compteurs de performance====
 +
 +
Ces variables configurent le Processus du serveur.
 +
 +
Ces variables peuvent être renseignées dans une section PERF
 +
 +
[\SOFTWARE\Sage\Ligne 1000\Administration\PERF\nom_de_profil]
 +
 +
puis référencée par la variable "Performance Counters Profil"
 +
 +
{|class="wikitable"
 +
|-
 +
!Variable
 +
!Type
 +
!Usage
 +
|-
 +
|Start Performance Counters
 +
|Boolean
 +
|Démarre les compteurs de performance
 +
|-
 +
|Start Performance Clock
 +
|Boolean
 +
|Démarre l'horloge de performance
 +
|-
 +
|Performance Clock Delay
 +
|Cardinal
 +
|Période de l'horloge de performance (ms)
 +
|-
 +
|HTTP PerfServer Start
 +
|Boolean
 +
|Démarre le serveur HTTP de performance
 +
|-
 +
|HTTP PerfServer Port
 +
|Integer
 +
|Port du serveur HTTP de performance
 +
|-
 +
|HTTP PerfServer Protocol
 +
|String
 +
|Protocole du serveur HTTP de performance
 +
|}
 +
 +
*Start Performance Counters
 +
:Le serveur inclus un certain nombre de [[Compteurs de performance (monitoring)|compteurs de performance]] interrogeables par le [[Serveur de performance (monitoring)|serveur de performance]].
 +
 +
*Start Performance Clock
 +
: Démarre une horloge permettant de générer un évènement de monitoring.
 +
 +
*Performance Clock Delay
 +
: Période de l'horloge de performance. (défaut 1000)
 +
 +
*HTTP PerfServer Start
 +
: Démarre le server HTTP de performance.
 +
 +
*HTTP PerfServer Port
 +
: Port du serveur HTTP de performance. (défaut 9999)
 +
 +
*HTTP PerfServer Protocol
 +
:Protocole du serveur HTTP de performance (défaut http)
 +
 +
Voir la catégorie [[:Category:Monitoring]]
  
 
====HTTP====
 
====HTTP====
Ligne 392 : Ligne 648 :
  
 
{|class="wikitable"
 
{|class="wikitable"
 +
|-
 +
!Nom de variable
 +
!Type
 +
!Version
 +
!Par défaut
 +
!Usage
 
|-
 
|-
 
|HTTP Protocol
 
|HTTP Protocol
 
|String
 
|String
|Protocole HTTP utilisé par le service (http: ou https:)
+
|Toute
 +
|http:
 +
|Protocole HTTP publique du Service (http: ou https:)
 +
|-
 +
|HTTP Port
 +
|Integer
 +
|Toute
 +
|80
 +
|Port HTTP publique du Service
 
|-
 
|-
 
|HTTP HostName
 
|HTTP HostName
 
|String
 
|String
|Nom réseau du serveur HTTP utilisé par le service
+
|Toute
 +
|Nom local de la machine
 +
|Domaine publique du serveur HTTP frontal
 
|-
 
|-
|HTTP Port
+
|HTTP ServiceName
|Integer
+
|String
|Port HTTP du serveur HTTP
+
|6.51
 +
|Nom du service
 +
|
 +
Nom du service load-balancé utilisé par le service<br>
 +
Ce nom peut différer du nom du service dans une configuration load balancée.<br>
 +
C'est ce nom qui est enregistrée dans les URLs de la registry SDATA<br>
 +
Implémenté pour SOAP à partir de la version 7 <br>
 
|}
 
|}
  
Les variables suivantes configurent le service HTTP interne inclus dans le serveur.
+
Les variables suivantes configurent [[Serveur HTTP (server)|le service HTTP interne]] inclus dans le serveur.
 +
 
 +
{{Version700}}
  
 
{|class="wikitable"
 
{|class="wikitable"
 +
|-
 +
!Nom de variable
 +
!Type
 +
!Usage
 
|-
 
|-
 
|HTTP Started
 
|HTTP Started
Ligne 414 : Ligne 698 :
 
|Démarre le serveur HTTP
 
|Démarre le serveur HTTP
 
|-
 
|-
|HTTP Port
+
|HTTP Listen Protocol
 +
|String
 +
|Protocole HTTP écouté par le serveur HTTP embarqué<br>
 +
Si cette variable n'est pas défini le protocole est défini par HTTP Protocol
 +
|-
 +
|HTTP Listen Port
 
|Integer
 
|Integer
|Port HTTP du serveur HTTP
+
|Port HTTP écouté par le serveur HTTP embarqué<br>
 +
Si cette variable n'est pas défini le port est défini par HTTP Port
 
|-
 
|-
 
|HTTP Site
 
|HTTP Site
Ligne 425 : Ligne 715 :
 
|String
 
|String
 
|Nom de section des alias de répertoire du serveur HTTP
 
|Nom de section des alias de répertoire du serveur HTTP
 +
|-
 +
|HTTP CertFile
 +
|String
 +
|Si le protocole est https, représente le fichier certificat (.pem)
 +
|-
 +
|HTTP RootCertFile
 +
|String
 +
|Si le protocole est https, représente le fichier certificat de l'autorité intermédiaire qui a signé le certificat "CertFile" (.pem).<br>
 +
Ce paramètre est optionnel, il est utile si l'autorité intermédiaire n'est pas directement reconnue par le navigateur.
 +
|-
 +
|HTTP KeyFile
 +
|String
 +
|Si le protocole est https, représente le fichier clef privée (.pem ou .key) qui est liée au certificat
 +
|-
 +
|HTTP KeyPassword
 +
|String
 +
|Si le protocole est https, représente le mot de passe qui permet de décoder la clef privée
 
|-
 
|-
 
|HTTP CertIssuer
 
|HTTP CertIssuer
 
|String
 
|String
|Si le port est 443 (https), représente l'émetteur du certificat du site permettant de l'identifier dans le magasin Windows
+
|Si le protocole est https, représente l'émetteur du certificat du site permettant de l'identifier dans le magasin Windows
 
|-
 
|-
 
|HTTP CertSerial
 
|HTTP CertSerial
 
|String
 
|String
|Si le port est 443 (https), représente le numéro de série du certificat du site permettant de l'identifier dans le magasin Windows
+
|Si le protocole est https, représente le numéro de série du certificat du site permettant de l'identifier dans le magasin Windows
 +
|-
 +
|HTTP SSLVersion
 +
|String
 +
|Version du protocole SSL à utiliser: sslvTLSv1_1, sslvTLSv1_2, sslvTLSv1_3 (par défaut :sslvTLSv1_2)
 +
|-
 +
|HTTP SSLCipherList
 +
|String
 +
|Sceaux proposés par le serveur (par défaut "HIGH:!aNULL:!MD5:!RC4") [https://www.openssl.org/docs/manmaster/apps/ciphers.html en savoir plus] Version 7.10
 +
|-
 +
|HTTP KeepAlive
 +
|Boolean
 +
|Détermine la valeur du paramètre KeepAlive des réponses du serveur HTTP.<br>
 +
La valeur est True (1) par défaut et le serveur renvoi KeepAlive dans ses réponses.<br>
 +
Cette valeur doit être false (0) pour une configuration load balancée.
 +
|-
 +
|HTTP Private Started
 +
|Boolean
 +
|Permet de démarrer un service http "privé", utile dans le cadre d'une configuration load balancée.<br>
 +
Ce service n'est adressé que par les autres services, et permet d'économiser la partie SSL des échanges.<br>
 +
Le port de ce service ne doit pas être exposé au clients web.
 +
|-
 +
|HTTP Private Port
 +
|Integer
 +
|Détermine la valeur du port http privé.
 +
|-
 +
|HTTP Log
 +
|Booléen
 +
|Active la journalisation des flux http (Version 10)
 +
|}
  
 +
{{tip|TLS 1.3 supporté à partir de la version 10 en utilisant OpenSSL 3.0}}
 +
 +
{{tip|Le protocole/port publique peuvent être différent du protocole/port d'écoute si un load balancer est utilisé.}}
 +
 +
Voir aussi :
 +
* [[Serveur HTTP (server)|Serveur HTTP interne]]
 +
* [[Configuration_du_Serveur_HTTPS|Configuration du serveur en HTTPs]]
 +
* [[Configuration_du_Serveur_HTTP_derrière_un_répartiteur_de_charge|Configuration derrière un répartiteur de charge]]
 +
 +
 +
Certains de ces paramètres peuvent être remplacés par [[Service_1000_(server)|les paramètres de la ligne de commande]] :
 +
 +
{|class="wikitable"
 +
|-
 +
!Paramètre
 +
!Paramètre de la ligne de commande
 +
|-
 +
|HTTP Listen Port
 +
|HTTPPORT
 +
|-
 +
|HTTP KeepAlive
 +
|HTTPKEEPALIVE
 
|}
 
|}
 +
 +
====HTTP ACLs====
 +
{{version710}}
 +
 +
{|class="wikitable"
 +
|-
 +
!Nom de variable
 +
!Type
 +
!Usage
 +
|-
 +
|HTTP ACL
 +
|string
 +
|Liste de règles séparées par une virgule, par ordre de priorité
 +
|}
 +
 +
La syntaxe d'une règle ACL :
 +
<pre>
 +
action-IP/Nob
 +
</pre>
 +
 +
*action
 +
: Type de règle, doit être accept ou deny
 +
*IP
 +
: Addresse IP en notation pointé
 +
*Nob (facultatif)
 +
:Nombre de bits du masque de sous réseau, par exemple 29 correspond au masque 255.255.255.248 et défini un sous réseau de 8 adresses.
 +
 +
[http://jodies.de/ipcalc Calculateur de masque]
 +
 +
Exemple 1 :
 +
 +
Autorise les adresses 192.168.1.0 ... 192.168.1.7 à l’exception de 192.168.1.5
 +
 +
<pre>
 +
deny-192.168.1.5
 +
accept-192.168.1.0/29
 +
</pre>
 +
 +
Exemple 2 :
 +
 +
Autorise seulement l'adresse 192.168.1.1
 +
 +
<pre>
 +
accept-192.168.1.1
 +
deny-0.0.0.0/0
 +
</pre>
 +
 +
====HTTP Web Worker====
 +
{{version800}}
 +
 +
Le Web Worker est un mécanisme de notification asynchrone permettant au client Web d'être notifié des événements survenant coté serveur.
 +
 +
Il permet de gérer les notifications de boîte à message ainsi que les notifications de traitement.
 +
 +
L'utilisation du web worker améliore l'expérience utilisateur.
 +
 +
{|class="wikitable"
 +
|-
 +
!Nom de variable
 +
!Type
 +
!Usage
 +
|-
 +
|Web worker started
 +
|Integer
 +
|Active (1) ou désactive (0) l'utilisation du web worker
 +
|}
 +
 +
{{Tip|Lorsque le web worker est activé, le client génère des requêtes msg.pending périodiques.}}
 +
 +
====HTTP Web Socket====
 +
{{version800}}
 +
 +
Les WebSockets utilisent un protocole permettant de créé des canaux de communication full-duplex à l'intérieur d'une connexion TCP.
 +
 +
L'utilisation des WebSockets améliore l'expérience utilisateur par une meilleur fluidité des échanges.
 +
 +
{|class="wikitable"
 +
|-
 +
!Nom de variable
 +
!Type
 +
!Usage
 +
|-
 +
|Web socket started
 +
|Integer
 +
|Active (1) ou désactive (0) l'utilisation de WebSocket
 +
|}
 +
 +
{{Tip|
 +
 +
#Les WebSocket ne sont prises en charge que par le serveur HTTP embarqué et en mode '''HTTPs uniquement'''.
 +
#Les WebSockets sont activées par défaut.
 +
#Les WebSocket peuvent ne pas fonctionner ou provoquer des problèmes dans le cas d'utilisation du serveur Sage 1000 derrière un load balancer qui ne supporterait pas le protocole WebSocket.
 +
#L'url utilisée doit correspondre au domaine du certificat SSL. Par exemple, en entreprise, si votre serveur est myhost sur le domaine interne xxx.yyy.zzz le nom de domaine du certificat auto-généré sera myhost.xxx.yyy.zzz. Vous devez utiliser https://myhost.xxx.yyy.zzz comme url d'accès même si https://myhost est valide sur votre réseau. A défaut l'établissement des connexions websockets échoueront.}}
 +
 +
{{Tip|Lorsque les websockets sont actives, le dialogue d'attente n'est pas affiché.}}
 +
 +
====HTTP CSP====
 +
La [https://developer.mozilla.org/fr/docs/Web/HTTP/CSP stratégie de sécurité du contenu] permet d'améliorer la sécurité des sites web.
 +
 +
{{version1000}}
 +
{|class="wikitable"
 +
|-
 +
!Nom de variable
 +
!Type
 +
!Usage
 +
|-
 +
|HTTP CSP
 +
|Liste de chaines
 +
|Liste des règles séparées par ";"
 +
|}
 +
 +
Exemple
 +
 +
HTTP CSP = default-src 'self'; script-src https://example.com
 +
 +
La valeur par défaut est ''default-src 'self'''
 +
 +
====HTTP CORS====
 +
Le [https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS CORS] permet d'autoriser des requêtes provenant d'autre domaine.
 +
 +
{{version800}}
 +
{|class="wikitable"
 +
|-
 +
!Nom de variable
 +
!Type
 +
!Usage
 +
|-
 +
|HTTP CORS Allow origin
 +
|Liste de chaines
 +
|Liste des domaines autorisés
 +
|}
 +
 +
La liste des domaines doit être séparée par des virgules, utilisez * pour autoriser tous les domaines.
 +
 +
Les domaines doivent être qualifié par le protocole, par exemple http://origin.com
 +
 +
Les domaines indiqués ici seront comparés à la valeur du champ d'entête Origin
 +
 +
Lorsque le domain est autorisé, le service retourne dans la réponse :
 +
 +
{| class="wikitable"
 +
|-
 +
!Champ
 +
!Valeur
 +
|-
 +
|Access-Control-Allow-Origin
 +
|Valeur du chanmp Origin de la requête
 +
|-
 +
|Vary
 +
|Origin
 +
|-
 +
|Access-Control-Allow-Credentials
 +
|true
 +
|-
 +
|Access-Control-Allow-Methods
 +
|POST,PUT,DELETE,GET,OPTION
 +
|-
 +
|Access-Control-Allow-Headers
 +
|Valeur de Access-Control-Request-Headers de la requête
 +
|-
 +
|Access-Control-Max-Age
 +
|86400
 +
|}
 +
 +
====FTPs====
 +
Ces variables configurent le serveur FTPs inclu dans le servcice.
 +
Le serveur FTP peut être utilisé sur les containeurs.
 +
 +
[\SOFTWARE\Sage\Ligne 1000\Administration\FTP\nom_de_profil]
 +
 +
puis référencée par la variable "FTP Profil"
 +
 +
{|class="wikitable"
 +
|-
 +
!Nom de variable
 +
!Type
 +
!Usage
 +
|-
 +
|FTP Profil
 +
|string
 +
|Référence une section FTP
 +
|-
 +
|FTP Start
 +
|1 ou 0
 +
|Démarre le service FTP
 +
|-
 +
|FTP ACL
 +
|Chaîne
 +
|Définit une liste d'ACL optionnelle
 +
|}
 +
 +
====WEB====
 +
Ces variables configurent le service WEB inclu dans le service.
 +
 +
Ces variables peuvent être renseignées dans une section WEB
 +
 +
[\SOFTWARE\Sage\Ligne 1000\Administration\WEB\nom_de_profil]
 +
 +
puis référencée par la variable "WEB Profil"
 +
 +
{|class="wikitable"
 +
|-
 +
!Nom de variable
 +
!Type
 +
!Usage
 +
|-
 +
|WEB Profil
 +
|string
 +
|Référence une section WEB
 +
|-
 +
|MaxDatagridRowCount
 +
|Entier
 +
|Détermine le nombre maximal de lignes chargées dans une grille (défaut 5000)
 +
|-
 +
|GridWindowSize
 +
|Entier
 +
|Détermine le nombre maximal de lignes affichées dans une page de grille. (Défaut 25)
 +
|-
 +
|MDIForms
 +
|1 ou 0
 +
|Défaut 0
 +
|-
 +
|MDIAssistants
 +
|1 ou 0
 +
|Défaut 1
 +
|-
 +
|UseTreeBookClassic
 +
|1 ou 0
 +
|Défaut 0
 +
|-
 +
|SavePortalTabForms
 +
|1 ou 0
 +
|Défaut 1
 +
|-
 +
|DebugJS
 +
|1 ou 0
 +
|Utilise les javascript en mode debug (Défaut 0)
 +
|-
 +
|RecordMode
 +
|1 ou 0
 +
|Active le mode enregistrement pour JMeter (Défaut 0)
 +
|-
 +
|FormRedirect
 +
|1 ou 0
 +
|Active la redirection des urls d'écran, pour IIS cette redirection doit être désactivée. (défaut 1, ativé)
 +
|}
 +
 +
====Mise au point, debugger {{Version700}}====
 +
Ces variables configurent le remote debugger inclus dans le service.
 +
 +
Le remote debugger permet à un poste client desktop de visualiser, modifier et poser des points d'arrêt dans le code métier exécuté par le service.
 +
 +
Ces variables peuvent être renseignées dans une section DEBUGGER
 +
 +
[\SOFTWARE\Sage\Ligne 1000\Administration\DEBUGGER\nom_de_profil]
 +
 +
puis référencée par la variable "DEBUGGER Profil"
 +
 +
{|class="wikitable"
 +
|-
 +
!Nom de variable
 +
!Type
 +
!Usage
 +
|-
 +
|DEBUGGER Profil
 +
|string
 +
|Référence une section DEBUGGER
 +
|-
 +
|DEBUGGER Started
 +
|Boolean
 +
|Démarre le service de Remote debugging
 +
|-
 +
|DEBUGGER Users
 +
|Strings
 +
|Liste des utilisateurs autorisés à utiliser le service de remote debugging
 +
|-
 +
|DEBUGGER Handlers
 +
|Strings
 +
|Liste des handlers des évènements de trace qui seront interceptés et redirigés vers le journal d'évènement, ceci vous permet de visualiser en temps réel ces traces dans la console SNMP. Les handlers possibles sont:
 +
* script
 +
: Evènements générés par la fonction dbgMsg() du code métier
 +
* queries
 +
: Evènements de trace des requêtes SQL
 +
|}
 +
 +
{{warning|L'utilisation de DEBUGGER Handlers peut provoquer une forte consommation de mémoire}}
 +
{{warning|Ces fonctionnalités ne doivent pas être activés sur un serveur de production}}
  
 
====LDAP====
 
====LDAP====
Ligne 446 : Ligne 1 091 :
  
 
{|class="wikitable"
 
{|class="wikitable"
 +
|-
 +
!Nom de variable
 +
!Type
 +
!Usage
 
|-
 
|-
 
|LDAP Profil
 
|LDAP Profil
 
|string
 
|string
|Référence une secion LDAP
+
|Référence une section LDAP
 
|-
 
|-
 
|LDAP Started
 
|LDAP Started
Ligne 471 : Ligne 1 120 :
 
  [\SOFTWARE\Sage\Ligne 1000\Administration\SOAP\nom_de_profil]  
 
  [\SOFTWARE\Sage\Ligne 1000\Administration\SOAP\nom_de_profil]  
  
puis référencée par la variable "SOAP Profil"
+
puis référencées par la variable "SOAP Profil"
  
 
{|class="wikitable"
 
{|class="wikitable"
 +
|-
 +
!Nom de variable
 +
!Type
 +
!Usage
 
|-
 
|-
 
|SOAP Profil
 
|SOAP Profil
Ligne 496 : Ligne 1 149 :
  
 
====SMTP====
 
====SMTP====
Ces variables configure le client SMTP utilisé par le service pour envoyer des EMails.
+
Ces variables configurent le client SMTP utilisé par le service pour envoyer des EMails.
  
 
Ces variables peuvent être renseignées dans une section SMTP
 
Ces variables peuvent être renseignées dans une section SMTP
Ligne 502 : Ligne 1 155 :
 
  [\SOFTWARE\Sage\Ligne 1000\Administration\SMTP\nom_de_profil]  
 
  [\SOFTWARE\Sage\Ligne 1000\Administration\SMTP\nom_de_profil]  
  
puis référencée par la variable "SMTP Profil"
+
puis référencés par la variable "SMTP Profil"
  
 
{|class="wikitable"
 
{|class="wikitable"
 +
|-
 +
!Nom de variable
 +
!Type
 +
!Usage
 
|-
 
|-
 
|SMTP Profil
 
|SMTP Profil
Ligne 540 : Ligne 1 197 :
 
  [\SOFTWARE\Sage\Ligne 1000\Administration\SNMP\nom_de_profil]  
 
  [\SOFTWARE\Sage\Ligne 1000\Administration\SNMP\nom_de_profil]  
  
puis référencée par la variable "SNMP Profil"
+
puis référencés par la variable "SNMP Profil"
  
Ces variables configurent l'agent SNMP inclu dans le serveur.  
+
Ces variables configurent l'agent SNMP inclus dans le serveur.  
  
 
{|class="wikitable"
 
{|class="wikitable"
 +
|-
 +
!Nom de variable
 +
!Type
 +
!Usage
 
|-
 
|-
 
|SNMP Profil
 
|SNMP Profil
Ligne 580 : Ligne 1 241 :
  
 
{|class="wikitable"
 
{|class="wikitable"
 +
|-
 +
!Nom de variable
 +
!Type
 +
!Usage
 
|-
 
|-
 
|SNMP Trap Host
 
|SNMP Trap Host
 
|string
 
|string
|Nom réseau du point découte
+
|Nom réseau du point d'écoute
 
|-
 
|-
 
|SNMP Trap Port
 
|SNMP Trap Port
Ligne 597 : Ligne 1 262 :
  
 
{|class="wikitable"
 
{|class="wikitable"
 +
|-
 +
!Nom de catégorie
 +
!Type de message
 
|-
 
|-
 
|Service
 
|Service
Ligne 618 : Ligne 1 286 :
 
SNMP Start=1
 
SNMP Start=1
 
SNMP Port=161
 
SNMP Port=161
SNMP sysContact = sylvain.frere@sage.com
+
SNMP sysContact = toto@sage.com
SNMP sysName = syfre
+
SNMP sysName = toto
 
SNMP sysLocation = Paris,France
 
SNMP sysLocation = Paris,France
 
SNMP Traps=Service,Automate
 
SNMP Traps=Service,Automate
Ligne 635 : Ligne 1 303 :
  
 
====PROXY====
 
====PROXY====
Ces variables configure le PROXY utilisé par le client HTTP.
+
 
 +
{{tip|Déprécié, utiliser le paramétrage dans la console d'administration.}}
 +
 
 +
Ces variables configurent le PROXY utilisé par le client HTTP.
  
 
Ces variables peuvent être renseignées dans une section PROXY
 
Ces variables peuvent être renseignées dans une section PROXY
Ligne 644 : Ligne 1 315 :
  
 
{|class="wikitable"
 
{|class="wikitable"
 +
|-
 +
!Nom de variable
 +
!Type
 +
!Usage
 
|-
 
|-
 
|PROXY Profil
 
|PROXY Profil
Ligne 671 : Ligne 1 346 :
  
 
====Exceptions====
 
====Exceptions====
Ces variables configurent l'engregistrement des exceptions du service.
+
Ces variables configurent l'enregistrement des exceptions du service.
  
 
Ces variables peuvent être renseignées dans une section EXCEPTIONS
 
Ces variables peuvent être renseignées dans une section EXCEPTIONS
Ligne 680 : Ligne 1 355 :
  
 
{|class="wikitable"
 
{|class="wikitable"
 +
|-
 +
!Nom de variable
 +
!Type
 +
!Usage
 
|-
 
|-
 
|Exceptions logs Profil
 
|Exceptions logs Profil
Ligne 687 : Ligne 1 366 :
 
|Exceptions logs Started
 
|Exceptions logs Started
 
|boolean
 
|boolean
|Enregistrer les exceptions.
+
|Enregistrer les exceptions. Vrai par défaut.
 
|-
 
|-
 
|Exceptions logs path
 
|Exceptions logs path
Ligne 696 : Ligne 1 375 :
 
|Liste de chaîne
 
|Liste de chaîne
 
|Liste d'exception à ignorer.
 
|Liste d'exception à ignorer.
 +
|-
 +
|Exceptions logs write file
 +
|booléen
 +
|Un fichier d'exception est écrit. Vrai par défaut. Il peut être inutile d'écrire un fichier d'exception si les exceptions sont transmises à un gestionnaire de log (voir LOG MANAGER) et permet dans ce cas ne ne pas encombrer le disque.(V8)
 
|}
 
|}
 +
 +
====Captcha====
 +
 +
Dans le cadre d'un service public, les utilisateurs souhaitant s'enregistrer peuvent être soumis à un captcha.
 +
 +
Si l'utilisateur commet trois erreurs lors de l'authentification, il devra saisir un captcha.
 +
 +
voir http://www.google.com/recaptcha
 +
 +
{|class="wikitable"
 +
|-
 +
!Nom de variable
 +
!Type
 +
!Usage
 +
|-
 +
|Recaptcha Public Key
 +
|string
 +
|Clef publique Recaptcha
 +
|-
 +
|Recaptcha Private Key
 +
|String
 +
|Clef privée Recaptcha
 +
|}
 +
 +
====Quotas====
 +
 +
Dans le cadre d'un service public, les utilisateurs téléversent des fichiers dans un répertoire propres à la session.
 +
 +
Ces fichiers doivent avoir une extension prévue pour des questions de sécurité.
 +
 +
La taille totale du répertoire est définie pour éviter un manque de place sur le disque.
 +
 +
{|class="wikitable"
 +
|-
 +
!Nom de variable
 +
!Type
 +
!Usage
 +
|-
 +
|Upload Document Size
 +
|integer
 +
|Taille maximale en Mb d'un fichier uploadé; valeur par défaut : 0 (non limité)
 +
|-
 +
|Upload User Quota
 +
|integer
 +
|Taille maximale en Mb du répertoire upload de l'utilisateur par session; valeur par défaut : 50
 +
|-
 +
|Upload Ext Allowed
 +
|String
 +
|Extensions autorisées; valeur par défaut : vide (tout est autorisé)
 +
|-
 +
|Auto delete messages
 +
|Entier
 +
|Durée de conservation en jours des messages
 +
|}
 +
 +
{{tip|La liste des extensions suivantes n'est jamais filtrée car le service est susceptible de créer des fichiers de ce type (xlsx,ods,xml,pdf,,csv,sxc,xls,,jpg,jpeg,png,asice)}}
 +
 +
====Clefs====
 +
 +
Le stockage de certaines clefs peut être externalié
 +
 +
{|class="wikitable"
 +
|-
 +
!Nom de variable
 +
!Type
 +
!Usage
 +
|-
 +
|Key Cookie
 +
|chaine
 +
|[[keyvault_url|url d'un stockage sécurisé externe]], si la clef est non trouvée, elle y sera créée
 +
|}
 +
 +
 +
===Sections SDATA===
 +
Ces sections permettent de configurer les points d'accès SDATA qui seront exposés par le service.
 +
 +
Les noms de ces sections sont
 +
 +
[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\<<nom du service>>\SData\<<incrément 1...>>]
 +
 +
{|class="wikitable"
 +
|-
 +
!Variable
 +
!Type
 +
!Usage
 +
|-
 +
|DataSetName
 +
|string
 +
|Nom du dataset dans l'URL SDATA
 +
|-
 +
|Title
 +
|string
 +
|Libellé informatif sur l'usage du point d'accès
 +
|-
 +
|Contract
 +
|string
 +
|Nom du paquet de service SDATA
 +
|-
 +
|Version
 +
|string
 +
|Numéro de version, peut être utilisé pour supporté plusieurs version du même contrat
 +
|-
 +
|Folder
 +
|string
 +
|Nom du dossier utilisé par ce point d'accès
 +
|-
 +
|Database
 +
|string
 +
|Nom de la base de donnée utilisé pour ce point d'accès (multi-bases)
 +
|-
 +
|Society
 +
|string
 +
|Nom de la société pour ce point d'accès (multi-société)
 +
|-
 +
|Restitution
 +
|string
 +
|Nom de la famille de restitution pour ce point d'accès (multi-société)
 +
|}
 +
 +
Exemple :
 +
 +
<pre>
 +
[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SYFRE\SData\1]
 +
DataSetName=iphone
 +
Title=syfre iphone
 +
Contract=ndfContract
 +
Version=1
 +
Folder=Test Syfre iPhone
 +
Database=dbTestIPhone
 +
Society=
 +
Restitution=
 +
</pre>
  
 
===Section Export===
 
===Section Export===
Ligne 704 : Ligne 1 519 :
  
 
*ftp
 
*ftp
: Dans ce mode les vignettes sont générées et copiées dans un répertoire publique accessible par ftp.
+
: Dans ce mode les vignettes sont générées et copiées dans un répertoire public accessible par ftp.
  
 
*file
 
*file
: Dans ce mode les vignettes sont générées et copiées dans un répertoire local du serveur. Ce mode n'est utile que si le répertoire est un répertoire du Site et que celui-ci est publique.
+
: Dans ce mode les vignettes sont générées et copiées dans un répertoire local du serveur. Ce mode n'est utile que si le répertoire est un répertoire du Site et que celui-ci est public.
  
 
{|class="wikitable"
 
{|class="wikitable"
 +
|-
 +
!Nom de variable
 +
!Type
 +
!Usage
 
|-
 
|-
 
|Protocol
 
|Protocol
Ligne 723 : Ligne 1 542 :
  
 
{|class="wikitable"
 
{|class="wikitable"
 +
|-
 +
!Nom de variable
 +
!Type
 +
!Usage
 
|-
 
|-
 
|FTP host
 
|FTP host
Ligne 748 : Ligne 1 571 :
  
 
{|class="wikitable"
 
{|class="wikitable"
 +
|-
 +
!Nom de variable
 +
!Type
 +
!Usage
 
|-
 
|-
 
|Directory
 
|Directory
Ligne 766 : Ligne 1 593 :
 
FTP Directory=sage
 
FTP Directory=sage
 
</pre>
 
</pre>
 +
 +
===Section ConfigServer===
 +
 +
Cette section permet d'utiliser un fichier de configuration disponible sur une url.
 +
 +
 +
{|class="wikitable"
 +
|-
 +
!Nom de variable
 +
!Type
 +
!Usage
 +
|-
 +
|url
 +
|String
 +
|Cette URL permet de récupérer le fichier de configuration.
 +
|}
 +
 +
 +
Un POST HTTP est effectué sur cette url avec les données suivantes :
 +
 +
<source lang="javascript">
 +
{"deploymentId":"nom_système_de_la_machine"}
 +
</source>
 +
 +
Le résultat attendu est
 +
 +
<source lang="javascript">
 +
{"config":"contenu_du_fichier_de_configuration"},
 +
{"certificate":"certificat_au_format_pfx"}
 +
</source>
  
  
Voir aussi :
 
  
 
*[[Exemple de configuration (server)|Exemple de configuration]]
 
*[[Exemple de configuration (server)|Exemple de configuration]]
 +
*[[Service_1000_(server)|Ligne de commande]]
  
 
{{Footer|Serveur}}
 
{{Footer|Serveur}}
 
[[category:Serveur]]
 
[[category:Serveur]]

Version actuelle en date du 7 novembre 2023 à 11:01

Sommaire

Introduction

Le Serveur d'application Sage 1000 utilise un fichier de configuration situé dans le répertoire du serveur.

Info-20px.png Note : Le nom du fichier est serverl1000.ini

Ce fichier peut être soit modifié à l'aide de la console d'administration des services, soit manuellement par un éditeur de texte.

Tip-20px.png Tip : Le fichier est chargé au démarrage du service.

Structure

Le fichier peut configurer plusieurs services exécutés sur le même serveur, chaque service comporte au moins deux sections :

  • [\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SERVICE_NAME]
Cette entrée détermine la configuration réseau du service.
  • [\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SERVICE]
Cette entrée détermine la configuration logicielle du service.
  • [\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SERVICE\Export]
Cette entrée configure la fonction d'exportation du service.


Exemple :

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\MYSERVICE]
ipcMode=ipcSHM
tcpPort=8090
shmAddress=SYFRE

[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\MYSERVICE]
Master base=orasql://myhost/DBMASTER_ORA?prefix="DBMASTERT_ORA."
Master driver=orasql
Master OS Authentication=0
Master user=DBMASTER_ORA
Master password=DBMASTER_ORA
Server Societies=Société de démonstration GCF 1000
Server Application=Sage 1000 Suite Financière
...

Chaque section est composée d'une liste de variables (NomVariable=ValeurVariable), les types de données des variables sont :

Variable Type
String Chaîne de caractère
Boolean Valeur logique 0:Non 1:Oui
Integer Valeur entière
Liste de chaîne Liste de chaîne de caractère séparée par des virgules.

Section IPC

Variable Type Contexte Usage
ipcMode enumération Client/Serveur
  • ipcTCP
Mode de communication par TCP/IP
  • ipcSHM
Mode de communication par mémoire partagée (dépréciée)
tcpPort Integer Client/Serveur Port de communication TCP
tcpAddress string Client/Serveur Adresse de communication TCP
shmAddress string Client/Serveur Nom du segment de mémoire partagé
serverList Serveur String list Configuration de Cluster

Liste des services associés à cet identifiant de service.

Exemple :

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\TRESO]
ipcMode=ipcTCP
tcpPort=8090
tcpAddress=localhost

Exemple de configuration Cluster :

fichier du configuration des services :

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE]
serverList=SYFRE1,SYFRE2

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE1]
ipcMode=ipcTCP
tcpPort=8091
tcpAddress=syfre

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE2]
ipcMode=ipcTCP
tcpPort=8092
tcpAddress=syfre

fichier du configuration du client HTTP :

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE]
serverList=SYFRE1,SYFRE2

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE1]
ipcMode=ipcTCP
tcpPort=8091
tcpAddress=syfre

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE2]
ipcMode=ipcTCP
tcpPort=8092
tcpAddress=syfre

Section Servers

IPC

Ces variables configurent la gestion des services IPC.

La configuration des services IPC peut être renseignée dans une section IPC

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\nom_de_profil] 

puis référencée par la variable "IPC Profil"

Variable Type Usage
IPC Profil String Référence un nom de section IPC contenant la configuration
IPC Started boolean Démarre les services IPC (défaut true)

Les services IPC sont les services permettant de communiquer via RPC.

Vous avez besoins des services IPC si :

  • Vous utilisez un serveur HTTP externe (IIS ou Apache).
  • Vous utilisez la Console des Processus Métiers pour dialoguer avec ce Service.
  • Vous utilisez le Contrôleur des services.
  • Ce Service exécute des tâches de traitement déléguées par un autre Service.

Si vous n'utilisez pas les services IPC il est conseillé de ne pas les démarrer.

Tip-20px.png Tip : Ce paramètre n'est pas modifiable depuis la console des services car si vous désactivez les services IPC le contrôleur n'est plus opérationnel

Sessions

Ces variables configurent la gestion des sessions.

La configuration des sessions peut être renseignée dans une section SESSIONS

[\SOFTWARE\Sage\Ligne 1000\Administration\SESSIONS\nom_de_profil] 

puis référencée par la variable "SESSIONS Profil"

Variable Type Défaut Min Usage
SESSIONS Profil String Référence un nom de section SESSIONS contenant la configuration
CheckInterval Entier 1 minute 1 minute Délai entre chaque test d'expiration en seconde.
ExpireInterval Entier 15 minutes Délai d'expiration des sessions en seconde.

Base master

Ces variables configurent la base Master utilisée par le service.

La configuration de la base master peut être renseignée dans une section MASTER

[\SOFTWARE\Sage\Ligne 1000\Administration\MASTER\nom_de_profil] 

puis référencée par la variable "Master Profil"

Variable Type Usage
Master Profil String Référence un nom de section MASTER contenant la configuration
Master base String Nom de la base de données Master
Master driver String Nom du driver de la base de données Master
Master OS Authentication Boolean Utiliser l'authentification du système d'exploitation.
Master user String Nom d'utilisateur utilisé pour la connexion à la base Master
Master password String Mot de passe utilisé pour la connexion à la base Master

Application et Sociétés

Ces variables configurent l'application et les sociétés servies par le service.

Variable Type Version Usage
Server Societies String Liste des sociétés/dossiers servies par le service.
Server Application String Nom de l'application servie par le service.
Server User String Nom de l'utilisateur du service.
Server Password String Mot de passe de l'utilisateur du service.
Server User Group String Nom du groupe de l'utilisateur du service.
Server Authentication String Annuaire utilisé pour l'authentification.
Authentication Directories liste de chaîne 8.00 Annuaires disponibles pour ce service.(code des annuaires séparés par ";")

Service

Ces variables configurent le service.

Variable Type Version Usage
Server Name String Nom du service.
Cache Folder String Répertoire où stocker les fichiers temporaires et les fichiers en cache.
Public Folder String Racine des répertoires partagés du service.
Public Links Liste de chaîne Liste de répertoires réseaux (séparés par un ;) pour lesquels des documents peuvent être associés.
Send Alert To String Liste d'adresses emails (séparées par un ;) auxquelles seront envoyés les messages d'alertes.
Scripts Liste de chaîne Liste de références CSS ajouté aux pages HTML
MaxDatagridRowCount Integer Limite le nombre de lignes affichées dans les grilles (par défaut à 5000).
Security Mode String 7.00 Valeurs possibles : Intranet (valeur par défaut) / Internet Voir Service exposé sur internet
Enable Remember User boolean 7.10 Permet à l'utilisateur d'avoir son nom pré-renseigné dans la page d'authentification (par défaut à vrai)
MaxPreviewPageCount Integer Limite le nombre de pages affichées dans les aperçus des éditions (par défaut à 50).
Preview max page Integer 10.00 Limite le nombre de pages affichées dans les aperçus des éditions (par défaut à 50).
Preview blocking Boolean 10.00 1:Les aperçus sont affichés directement en onglet 0:les aperçus sont envoyés dans la bam.
Preview timeout Integer 10.00 Délai d'attente de fin d'aperçu si Preview blocking=1.
Printer Filter chaine Noms des imprimantes ne pas proposer, séparées par des points virgules (9.20)

Automates

Ces variables configurent le serveur d'automate inclus dans le serveur.

Ces variables peuvent être renseignées dans une section AUTOMATE

[\SOFTWARE\Sage\Ligne 1000\Administration\AUTOMATE\nom_de_profil] 

puis référencées par la variable "Automate Profil"

Variable Type Version Usage
Automate Profil String Référence une section AUTOMATE.
Automate Started

Process Server Started

Boolean Démarre le serveur d'automate. (défaut) (*)
Automate Name

Process Server Name

String Nom du serveur d'automate à démarrer. (*)
Automate Message Box

Process Server Message Box

String Boite à messages utilisé par le serveur d'automate.
Automate Task Service

Process Task Service

String Nom du Service 1000 exécutant les tâches du serveur d'automate.(hostname.servicename)
Automate Task Count
Integer 6.50 Nombre maximal de tâches automates simultanées (défaut 1).
Automate Debug
Boolean 7.00 Patch Active le mode debug verbose (**).

version700-32x32.png (*) Ces valeurs peuvent être modifiées sur la ligne de commande

version700-32x32.png (**) A utiliser conjointement avec la console de trap snmp

Processus métiers

Ces variables configurent le service de Processus Métiers inclus dans le serveur.

Variable Type Usage
BP Started Boolean Démarre le service de Processus Métiers (défault).

version700-32x32.png Cette valeur peut être modifiée sur la ligne de commande

Système

Ces variables configurent le Processus du serveur.

Ces variables peuvent être renseignées dans une section PROCESS

[\SOFTWARE\Sage\Ligne 1000\Administration\PROCESS\nom_de_profil] 

puis référencée par la variable "Process Profil"

Variable Type Usage
Process Profil string Référence une section PROCESS
ProcessAffinity String Détermine les coeurs utilisés par le processus sur une machine multi-coeurs

ex : 1,3 pour utiliser les coeurs 1 et 3 d'une machine multi-coeurs.

ThreadPoolSize Integer Taille du pool de thread (20)
FormCacheSize Integer Taille du cache pour un écran (défaut:20, 0:désactive l'utilisation du cache)
FormCacheLimit Integer Taille du cache pour l'ensemble des écrans (256)
FormCacheReuse Integer Nombre de fois qu'un écran peut être réutilisé (-1 : pas de limite)
  • ProcessAffinity
Le Processus du serveur est un processus multi-threadé, sur une machine multi-coeurs il utilise tous les coeurs disponibles sur le système d'exploitation. Dans certain cas il est souhaitable de restreindre l'exécution à certains coeurs.
  • ThreadPoolsize
Chaque requête sur le service est exécutée par une thread allouée d'un pool ; lorsque le pool est plein la requête est suspendue jusqu'à ce qu'une thread se libère dans le pool. Cette variable limite la taille du pool de thread et par conséquence limite les contentions et les "context switches" provoqués par le processus.
  • FormCacheSize
L'opération d'ouverture d'un écran est une opération coûteuse, pour cette raison les écrans fermés sont placés dans un cache pour être réutilisés. Cette variable limite le nombre d'instance d'un écran dans le cache.
  • FormCacheLimit
L'opération d'ouverture d'un écran est une opération coûteuse, pour cette raison les écrans fermés sont placés dans un cache pour être réutilisés. Cette variable limite le nombre maximal d'écran dans le cache et par conséquent la mémoire utilisée par le cache d'écran.
  • FormCacheReuse
Indique le nombre de fois qu'un écran en cache peut être réutilisé.
Info-20px.png Note : Pour pouvoir utiliser WMI la dll serviceL1000perf.dll doit être présente dans le répertoire du serveur.

{{info|Pour désactiver le cache, définir la valeur de FormCacheSize à 0}

Files d'attente

Ces variables configurent le service de consommation de file d'attente.

Ces variables peuvent être renseignées dans une section PERF.

[\SOFTWARE\Sage\Ligne 1000\Administration\QUEUELISTENER\nom_de_profil] 

puis référencée par la variable "Queue listener Profil"

Variable Type Usage
Queue listener Started Boolean Démarre le service de consommation de file d'attente.
Queue listener queues Liste de chaînes séparées par des , Liste des files d'attente à consommer.
Queue listener Task count Entier Nombre maximal de tâches simultanées par service.

Les paramètres de scrutation d'une file d'attente peuvent être configurés à la suite du nom de la file d'attente en séparant les paramètres par un caractère ":"

Paramètre Valeur par défaut (ms) Usage
Initial 1000 Délai initial de scrutation (ms)
Max 10000 Délai maximal de scrutation (ms)
Increment 1000 Incrément du délai jusqu'au délai maximal si aucun message n'est disponible (ms)

Exemple :

Queue listener queues=MyQueue1:2000:10:20000,MyQueue2,MyQueue3:100:10:1000

Avec les valeurs par défaut, une file d'attente est lue initialement toutes les secondes, puis si aucun message n'est reçu, ce délai monte jusqu'à 10 secondes. Lorsque un message est reçu le délai est réinitialisé à 1 seconde et ainsi de suite.

Compteurs de performance

Ces variables configurent le Processus du serveur.

Ces variables peuvent être renseignées dans une section PERF

[\SOFTWARE\Sage\Ligne 1000\Administration\PERF\nom_de_profil] 

puis référencée par la variable "Performance Counters Profil"

Variable Type Usage
Start Performance Counters Boolean Démarre les compteurs de performance
Start Performance Clock Boolean Démarre l'horloge de performance
Performance Clock Delay Cardinal Période de l'horloge de performance (ms)
HTTP PerfServer Start Boolean Démarre le serveur HTTP de performance
HTTP PerfServer Port Integer Port du serveur HTTP de performance
HTTP PerfServer Protocol String Protocole du serveur HTTP de performance
  • Start Performance Counters
Le serveur inclus un certain nombre de compteurs de performance interrogeables par le serveur de performance.
  • Start Performance Clock
Démarre une horloge permettant de générer un évènement de monitoring.
  • Performance Clock Delay
Période de l'horloge de performance. (défaut 1000)
  • HTTP PerfServer Start
Démarre le server HTTP de performance.
  • HTTP PerfServer Port
Port du serveur HTTP de performance. (défaut 9999)
  • HTTP PerfServer Protocol
Protocole du serveur HTTP de performance (défaut http)

Voir la catégorie Category:Monitoring

HTTP

Ces variables peuvent être renseignées dans une section HTTP

[\SOFTWARE\Sage\Ligne 1000\Administration\HTTP\nom_de_profil] 

puis référencée par la variable "HTTP Profil"

Les variables suivantes configurent le protocole HTTP utilisé par le service, elles sont utilisées pour construire des URL pointant sur le service.

Nom de variable Type Version Par défaut Usage
HTTP Protocol String Toute http: Protocole HTTP publique du Service (http: ou https:)
HTTP Port Integer Toute 80 Port HTTP publique du Service
HTTP HostName String Toute Nom local de la machine Domaine publique du serveur HTTP frontal
HTTP ServiceName String 6.51 Nom du service

Nom du service load-balancé utilisé par le service
Ce nom peut différer du nom du service dans une configuration load balancée.
C'est ce nom qui est enregistrée dans les URLs de la registry SDATA
Implémenté pour SOAP à partir de la version 7

Les variables suivantes configurent le service HTTP interne inclus dans le serveur.

version700-32x32.png

Nom de variable Type Usage
HTTP Started boolean Démarre le serveur HTTP
HTTP Listen Protocol String Protocole HTTP écouté par le serveur HTTP embarqué

Si cette variable n'est pas défini le protocole est défini par HTTP Protocol

HTTP Listen Port Integer Port HTTP écouté par le serveur HTTP embarqué

Si cette variable n'est pas défini le port est défini par HTTP Port

HTTP Site String Répertoire du site utilisé par le serveur HTTP
HTTP Alias String Nom de section des alias de répertoire du serveur HTTP
HTTP CertFile String Si le protocole est https, représente le fichier certificat (.pem)
HTTP RootCertFile String Si le protocole est https, représente le fichier certificat de l'autorité intermédiaire qui a signé le certificat "CertFile" (.pem).

Ce paramètre est optionnel, il est utile si l'autorité intermédiaire n'est pas directement reconnue par le navigateur.

HTTP KeyFile String Si le protocole est https, représente le fichier clef privée (.pem ou .key) qui est liée au certificat
HTTP KeyPassword String Si le protocole est https, représente le mot de passe qui permet de décoder la clef privée
HTTP CertIssuer String Si le protocole est https, représente l'émetteur du certificat du site permettant de l'identifier dans le magasin Windows
HTTP CertSerial String Si le protocole est https, représente le numéro de série du certificat du site permettant de l'identifier dans le magasin Windows
HTTP SSLVersion String Version du protocole SSL à utiliser: sslvTLSv1_1, sslvTLSv1_2, sslvTLSv1_3 (par défaut :sslvTLSv1_2)
HTTP SSLCipherList String Sceaux proposés par le serveur (par défaut "HIGH:!aNULL:!MD5:!RC4") en savoir plus Version 7.10
HTTP KeepAlive Boolean Détermine la valeur du paramètre KeepAlive des réponses du serveur HTTP.

La valeur est True (1) par défaut et le serveur renvoi KeepAlive dans ses réponses.
Cette valeur doit être false (0) pour une configuration load balancée.

HTTP Private Started Boolean Permet de démarrer un service http "privé", utile dans le cadre d'une configuration load balancée.

Ce service n'est adressé que par les autres services, et permet d'économiser la partie SSL des échanges.
Le port de ce service ne doit pas être exposé au clients web.

HTTP Private Port Integer Détermine la valeur du port http privé.
HTTP Log Booléen Active la journalisation des flux http (Version 10)
Tip-20px.png Tip : TLS 1.3 supporté à partir de la version 10 en utilisant OpenSSL 3.0
Tip-20px.png Tip : Le protocole/port publique peuvent être différent du protocole/port d'écoute si un load balancer est utilisé.

Voir aussi :


Certains de ces paramètres peuvent être remplacés par les paramètres de la ligne de commande :

Paramètre Paramètre de la ligne de commande
HTTP Listen Port HTTPPORT
HTTP KeepAlive HTTPKEEPALIVE

HTTP ACLs

version710-32x32.png

Nom de variable Type Usage
HTTP ACL string Liste de règles séparées par une virgule, par ordre de priorité

La syntaxe d'une règle ACL :

 action-IP/Nob
  • action
Type de règle, doit être accept ou deny
  • IP
Addresse IP en notation pointé
  • Nob (facultatif)
Nombre de bits du masque de sous réseau, par exemple 29 correspond au masque 255.255.255.248 et défini un sous réseau de 8 adresses.

Calculateur de masque

Exemple 1 :

Autorise les adresses 192.168.1.0 ... 192.168.1.7 à l’exception de 192.168.1.5

deny-192.168.1.5
accept-192.168.1.0/29

Exemple 2 :

Autorise seulement l'adresse 192.168.1.1

accept-192.168.1.1
deny-0.0.0.0/0

HTTP Web Worker

version800-32x32.png

Le Web Worker est un mécanisme de notification asynchrone permettant au client Web d'être notifié des événements survenant coté serveur.

Il permet de gérer les notifications de boîte à message ainsi que les notifications de traitement.

L'utilisation du web worker améliore l'expérience utilisateur.

Nom de variable Type Usage
Web worker started Integer Active (1) ou désactive (0) l'utilisation du web worker
Tip-20px.png Tip : Lorsque le web worker est activé, le client génère des requêtes msg.pending périodiques.

HTTP Web Socket

version800-32x32.png

Les WebSockets utilisent un protocole permettant de créé des canaux de communication full-duplex à l'intérieur d'une connexion TCP.

L'utilisation des WebSockets améliore l'expérience utilisateur par une meilleur fluidité des échanges.

Nom de variable Type Usage
Web socket started Integer Active (1) ou désactive (0) l'utilisation de WebSocket
Tip-20px.png Tip :
  1. Les WebSocket ne sont prises en charge que par le serveur HTTP embarqué et en mode HTTPs uniquement.
  2. Les WebSockets sont activées par défaut.
  3. Les WebSocket peuvent ne pas fonctionner ou provoquer des problèmes dans le cas d'utilisation du serveur Sage 1000 derrière un load balancer qui ne supporterait pas le protocole WebSocket.
  4. L'url utilisée doit correspondre au domaine du certificat SSL. Par exemple, en entreprise, si votre serveur est myhost sur le domaine interne xxx.yyy.zzz le nom de domaine du certificat auto-généré sera myhost.xxx.yyy.zzz. Vous devez utiliser https://myhost.xxx.yyy.zzz comme url d'accès même si https://myhost est valide sur votre réseau. A défaut l'établissement des connexions websockets échoueront.
Tip-20px.png Tip : Lorsque les websockets sont actives, le dialogue d'attente n'est pas affiché.

HTTP CSP

La stratégie de sécurité du contenu permet d'améliorer la sécurité des sites web.

Version1000-32x32.png

Nom de variable Type Usage
HTTP CSP Liste de chaines Liste des règles séparées par ";"

Exemple

HTTP CSP = default-src 'self'; script-src https://example.com

La valeur par défaut est default-src 'self'

HTTP CORS

Le CORS permet d'autoriser des requêtes provenant d'autre domaine.

version800-32x32.png

Nom de variable Type Usage
HTTP CORS Allow origin Liste de chaines Liste des domaines autorisés

La liste des domaines doit être séparée par des virgules, utilisez * pour autoriser tous les domaines.

Les domaines doivent être qualifié par le protocole, par exemple http://origin.com

Les domaines indiqués ici seront comparés à la valeur du champ d'entête Origin

Lorsque le domain est autorisé, le service retourne dans la réponse :

Champ Valeur
Access-Control-Allow-Origin Valeur du chanmp Origin de la requête
Vary Origin
Access-Control-Allow-Credentials true
Access-Control-Allow-Methods POST,PUT,DELETE,GET,OPTION
Access-Control-Allow-Headers Valeur de Access-Control-Request-Headers de la requête
Access-Control-Max-Age 86400

FTPs

Ces variables configurent le serveur FTPs inclu dans le servcice. Le serveur FTP peut être utilisé sur les containeurs.

[\SOFTWARE\Sage\Ligne 1000\Administration\FTP\nom_de_profil] 

puis référencée par la variable "FTP Profil"

Nom de variable Type Usage
FTP Profil string Référence une section FTP
FTP Start 1 ou 0 Démarre le service FTP
FTP ACL Chaîne Définit une liste d'ACL optionnelle

WEB

Ces variables configurent le service WEB inclu dans le service.

Ces variables peuvent être renseignées dans une section WEB

[\SOFTWARE\Sage\Ligne 1000\Administration\WEB\nom_de_profil] 

puis référencée par la variable "WEB Profil"

Nom de variable Type Usage
WEB Profil string Référence une section WEB
MaxDatagridRowCount Entier Détermine le nombre maximal de lignes chargées dans une grille (défaut 5000)
GridWindowSize Entier Détermine le nombre maximal de lignes affichées dans une page de grille. (Défaut 25)
MDIForms 1 ou 0 Défaut 0
MDIAssistants 1 ou 0 Défaut 1
UseTreeBookClassic 1 ou 0 Défaut 0
SavePortalTabForms 1 ou 0 Défaut 1
DebugJS 1 ou 0 Utilise les javascript en mode debug (Défaut 0)
RecordMode 1 ou 0 Active le mode enregistrement pour JMeter (Défaut 0)
FormRedirect 1 ou 0 Active la redirection des urls d'écran, pour IIS cette redirection doit être désactivée. (défaut 1, ativé)

Mise au point, debugger version700-32x32.png

Ces variables configurent le remote debugger inclus dans le service.

Le remote debugger permet à un poste client desktop de visualiser, modifier et poser des points d'arrêt dans le code métier exécuté par le service.

Ces variables peuvent être renseignées dans une section DEBUGGER

[\SOFTWARE\Sage\Ligne 1000\Administration\DEBUGGER\nom_de_profil] 

puis référencée par la variable "DEBUGGER Profil"

Nom de variable Type Usage
DEBUGGER Profil string Référence une section DEBUGGER
DEBUGGER Started Boolean Démarre le service de Remote debugging
DEBUGGER Users Strings Liste des utilisateurs autorisés à utiliser le service de remote debugging
DEBUGGER Handlers Strings Liste des handlers des évènements de trace qui seront interceptés et redirigés vers le journal d'évènement, ceci vous permet de visualiser en temps réel ces traces dans la console SNMP. Les handlers possibles sont:
  • script
Evènements générés par la fonction dbgMsg() du code métier
  • queries
Evènements de trace des requêtes SQL
Exclam-20px.png Attention : L'utilisation de DEBUGGER Handlers peut provoquer une forte consommation de mémoire
Exclam-20px.png Attention : Ces fonctionnalités ne doivent pas être activés sur un serveur de production

LDAP

Ces variables configurent le serveur LDAP inclus dans le service.

Ces variables peuvent être renseignées dans une section LDAP

[\SOFTWARE\Sage\Ligne 1000\Administration\LDAP\nom_de_profil] 

puis référencée par la variable "LDAP Profil"

Nom de variable Type Usage
LDAP Profil string Référence une section LDAP
LDAP Started Boolean Démarre le service LDAP (défaut false).
LDAP Port Integer Port d'écoute du service LDAP
LDAP Password String Mot de passe administrateur du compte system du serveur LDAP ('uid=admin,ou=system')

SOAP

Ces variables configurent le service SOAP inclus dans le serveur.

Ces variables peuvent être renseignées dans une section SOAP

[\SOFTWARE\Sage\Ligne 1000\Administration\SOAP\nom_de_profil] 

puis référencées par la variable "SOAP Profil"

Nom de variable Type Usage
SOAP Profil string Référence une section SOAP
SOAP Log Documents Boolean Active la journalisation des documents SOAP
SOAP Log Messages Boolean Active la journalisation des messages SOAP
SOAP 5.5x Boolean Utilise l'implémentation SOAP des versions 5.5x
  • SOAP 5.5x
L'implémentation de SOAP a été récrite en version 5.6x, en cas de problème de compatibilité avec des développements existant il est possible d'utiliser l'ancienne implémentation.

SMTP

Ces variables configurent le client SMTP utilisé par le service pour envoyer des EMails.

Ces variables peuvent être renseignées dans une section SMTP

[\SOFTWARE\Sage\Ligne 1000\Administration\SMTP\nom_de_profil] 

puis référencés par la variable "SMTP Profil"

Nom de variable Type Usage
SMTP Profil string Référence une section SMTP
SMTP Host String Adresse du serveur SMTP.
SMTP Port Integer Port du serveur SMTP.
SMTP Login String Utilisateur de connexion du serveur SMTP.
SMTP Password String Mot de passe de connexion du serveur SMTP.
SMTP From String Adresse EMail de l'expéditeur.
SMTP UseTLS Boolean Utilise une sécurisation TLS

SNMP

Ces variables peuvent être renseignées dans une section SNMP

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMP\nom_de_profil] 

puis référencés par la variable "SNMP Profil"

Ces variables configurent l'agent SNMP inclus dans le serveur.

Nom de variable Type Usage
SNMP Profil string Référence une section SNMP
SNMP Started Boolean Démarre l'agent SNMP
SNMP Port Integer Port UDP de l'agent SNMP (161)
SNMP sysName String Valeur de la variable sysName pour la MIB2
SNMP sysContact String Valeur de la variable sysContact pour la MIB2
SNMP sysLocation String Valeur de la variable sysLocation pour la MIB2
SNMP Traps liste de chaîne Référence des sections SNMPTRAP

Les sections SNMPTRAP permettent de définir des points d'écoute SNMP auquels seront envoyés les messages de traps.

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMPTRAP\nom_de_profil] 
Nom de variable Type Usage
SNMP Trap Host string Nom réseau du point d'écoute
SNMP Trap Port Integer Numéro du port du point d'écoute
SNMP Trap Categories Liste de chaîne Catégories des traps à envoyer à ce point d'écoute

La liste des catégories de trap est la suivante :

Nom de catégorie Type de message
Service Messages relatifs au processus du service.
Automate Messages relatifs aux exécutions de l'automate.
BP Messages relatifs aux exécutions des Processus métiers.
Authenticate Messages relatifs aux erreurs d'authentification.

Exemple de configuration SNMP :

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMP\CONFIG_SNMP_1]
SNMP Started=1
SNMP Start=1
SNMP Port=161
SNMP sysContact = [email protected]
SNMP sysName = toto
SNMP sysLocation = Paris,France
SNMP Traps=Service,Automate

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMPTRAP\Service]
SNMP Trap Host=localhost
SNMP Trap Port=162
SNMP Trap Categories=Service,Authenticate

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMPTRAP\Automate]
SNMP Trap Host=localhost
SNMP Trap Port=162
SNMP Trap Categories=Automate,BP

PROXY

Tip-20px.png Tip : Déprécié, utiliser le paramétrage dans la console d'administration.

Ces variables configurent le PROXY utilisé par le client HTTP.

Ces variables peuvent être renseignées dans une section PROXY

[\SOFTWARE\Sage\Ligne 1000\Administration\PROXY\nom_de_profil]

puis référencée par la variable "PROXY Profil"

Nom de variable Type Usage
PROXY Profil string Référence une section PROXY
PROXY Host String Adresse du serveur PROXY.
PROXY Port Integer Port du serveur PROXY (défaut 8080).
PROXY Login String Utilisateur de connexion du serveur PROXY.
PROXY Password String Mot de passe de connexion du serveur PROXY.
PROXY Timeout Integer Délai d'expiration du PROXY. (défaut 60 secondes)

Exceptions

Ces variables configurent l'enregistrement des exceptions du service.

Ces variables peuvent être renseignées dans une section EXCEPTIONS

[\SOFTWARE\Sage\Ligne 1000\Administration\EXCEPTIONS\nom_de_profil]

puis référencées par la variable "Exceptions logs Profil"

Nom de variable Type Usage
Exceptions logs Profil string Référence une section EXCEPTIONS
Exceptions logs Started boolean Enregistrer les exceptions. Vrai par défaut.
Exceptions logs path String Répertoire dans lequel seront créés les fichiers d'exception.
Exceptions logs ignore Liste de chaîne Liste d'exception à ignorer.
Exceptions logs write file booléen Un fichier d'exception est écrit. Vrai par défaut. Il peut être inutile d'écrire un fichier d'exception si les exceptions sont transmises à un gestionnaire de log (voir LOG MANAGER) et permet dans ce cas ne ne pas encombrer le disque.(V8)

Captcha

Dans le cadre d'un service public, les utilisateurs souhaitant s'enregistrer peuvent être soumis à un captcha.

Si l'utilisateur commet trois erreurs lors de l'authentification, il devra saisir un captcha.

voir http://www.google.com/recaptcha

Nom de variable Type Usage
Recaptcha Public Key string Clef publique Recaptcha
Recaptcha Private Key String Clef privée Recaptcha

Quotas

Dans le cadre d'un service public, les utilisateurs téléversent des fichiers dans un répertoire propres à la session.

Ces fichiers doivent avoir une extension prévue pour des questions de sécurité.

La taille totale du répertoire est définie pour éviter un manque de place sur le disque.

Nom de variable Type Usage
Upload Document Size integer Taille maximale en Mb d'un fichier uploadé; valeur par défaut : 0 (non limité)
Upload User Quota integer Taille maximale en Mb du répertoire upload de l'utilisateur par session; valeur par défaut : 50
Upload Ext Allowed String Extensions autorisées; valeur par défaut : vide (tout est autorisé)
Auto delete messages Entier Durée de conservation en jours des messages
Tip-20px.png Tip : La liste des extensions suivantes n'est jamais filtrée car le service est susceptible de créer des fichiers de ce type (xlsx,ods,xml,pdf,,csv,sxc,xls,,jpg,jpeg,png,asice)

Clefs

Le stockage de certaines clefs peut être externalié

Nom de variable Type Usage
Key Cookie chaine url d'un stockage sécurisé externe, si la clef est non trouvée, elle y sera créée


Sections SDATA

Ces sections permettent de configurer les points d'accès SDATA qui seront exposés par le service.

Les noms de ces sections sont

[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\<<nom du service>>\SData\<<incrément 1...>>]
Variable Type Usage
DataSetName string Nom du dataset dans l'URL SDATA
Title string Libellé informatif sur l'usage du point d'accès
Contract string Nom du paquet de service SDATA
Version string Numéro de version, peut être utilisé pour supporté plusieurs version du même contrat
Folder string Nom du dossier utilisé par ce point d'accès
Database string Nom de la base de donnée utilisé pour ce point d'accès (multi-bases)
Society string Nom de la société pour ce point d'accès (multi-société)
Restitution string Nom de la famille de restitution pour ce point d'accès (multi-société)

Exemple :

[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SYFRE\SData\1]
DataSetName=iphone
Title=syfre iphone
Contract=ndfContract
Version=1
Folder=Test Syfre iPhone
Database=dbTestIPhone
Society=
Restitution=

Section Export

Cette section permet de configurer la fonction d'exportation des vignettes de portail des Services.

Deux mode d'exportation sont possibles :

  • ftp
Dans ce mode les vignettes sont générées et copiées dans un répertoire public accessible par ftp.
  • file
Dans ce mode les vignettes sont générées et copiées dans un répertoire local du serveur. Ce mode n'est utile que si le répertoire est un répertoire du Site et que celui-ci est public.
Nom de variable Type Usage
Protocol String ftp ou file
Export URL String Cette URL référence le répertoire où la vignette a été générée.

Si le protocole est 'ftp' les variables suivantes sont utilisées :

Nom de variable Type Usage
FTP host String Addresse du serveur FTP
FTP Port Integer Numéro du port du serveur FTP
FTP Login String Utilisateur de connexion du serveur FTP
FTP Password String Mot de passe de connexion du serveur FTP
FTP Directory String Répertoire d'exportation sur le serveur FTP

Si le protocole est 'file' les variables suivantes sont utilisées :

Nom de variable Type Usage
Directory String Répertoire d'exportation sur le serveur.

Exemple de configuration ftp utilisant une zone publique Free :

[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SYFRE\Export]
Protocol=ftp
Export URL=http://syfre.free.fr/sage/
FTP Host=ftpperso.free.fr
FTP Port=21
FTP Login=syfre
FTP Password=XXXXXXXXXX
FTP Directory=sage

Section ConfigServer

Cette section permet d'utiliser un fichier de configuration disponible sur une url.


Nom de variable Type Usage
url String Cette URL permet de récupérer le fichier de configuration.


Un POST HTTP est effectué sur cette url avec les données suivantes :

{"deploymentId":"nom_système_de_la_machine"}

Le résultat attendu est

{"config":"contenu_du_fichier_de_configuration"},
{"certificate":"certificat_au_format_pfx"}


ServeurDéveloppement DSM

Outils personnels