Voir la source de Fichier de configuration (server)

===Introduction===
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}}

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

{{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 : 

<pre>
[\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
...
</pre>

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

{|class="wikitable"
|-
!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===

{|class="wikitable"
|-
!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<br>
Liste des services associés à cet identifiant de service. 
|}

Exemple :

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

Exemple de configuration Cluster :

'''fichier du configuration des services :'''

<pre>
[\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
</pre>

'''fichier du configuration du client HTTP :'''

<pre>
[\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
</pre>

===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"

{|class="wikitable"
|-
!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|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"

{|class="wikitable"
|-
!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"

{|class="wikitable"
|-
!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.

{|class="wikitable"
|-
!Variable
!Type
!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.
|}

====Service====
Ces variables configurent le service.

{|class="wikitable"
|-
!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
|
|[[Zone_publique_(server)|Racine des répertoires partagés du service]].
|-
|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). 
|-
|MaxPreviewPageCount
|Integer
|
|Limite le nombre de pages affichées dans les aperçus des éditions (par défaut à 50). 
|-
|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) 
|}

====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"

{|class="wikitable"
|-
!Variable
!Type
!Version
!Usage
|-
|Automate Profil
|String
|
|Référence une section AUTOMATE.
|-
|Automate Started<br>
Process Server Started
|Boolean
|
|Démarre le serveur d'automate. (défaut) (*)<br>
|-
|Automate Name<br>
Process Server Name
|String
|
|Nom du serveur d'automate à démarrer. (*)
|-
|Automate Message Box<br>
Process Server Message Box
|String
|
|Boite à messages utilisé par le serveur d'automate.
|-
|Automate Task Service<br>
Process Task Service
|String
|
|Nom du Service 1000 exécutant les tâches du serveur d'automate.(hostname.servicename)
|-
|Automate Task Count<br>
|Integer
|6.50
|Nombre maximum 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====
Ces variables configurent le service de Processus Métiers inclus dans le serveur.

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|BP Started
|Boolean
|Démarre le service de Processus Métiers (défault).
|}

{{Version700}} 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"

{|class="wikitable"
|-
!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<br>
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 (20)
|-
|FormCacheLimit
|Integer
|Taille du cache pour l'ensemble des écrans (256)
|}

*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.

{{info|Pour pouvoir utiliser WMI la dll serviceL1000perf.dll doit être présente dans le répertoire du serveur.}}

====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====
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.

{|class="wikitable"
|-
!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 
|Nom réseau du serveur HTTP frontal
|-
|HTTP ServiceName
|String
|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 [[Serveur HTTP (server)|le service HTTP interne]] inclus dans le serveur.

{{Version700}}

{|class="wikitable"
|-
!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é<br>
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é<br>
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).<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
|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: sslvSSLv2, sslvSSLv23, sslvSSLv3, sslvTLSv1 (par défaut :sslvTLSv1)
|-
|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é.
|}

{{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 WebSocket====
{{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 
|}

Notes : 

#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.

====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 maximam de ligne chargées dans une grille (défaut 5000)
|-
|GridWindowSize
|Entier
|Détermine le nombre maximum de ligne 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 tant 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====
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"

{|class="wikitable"
|-
!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"

{|class="wikitable"
|-
!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"

{|class="wikitable"
|-
!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. 

{|class="wikitable"
|-
!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] 

{|class="wikitable"
|-
!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<br>
|}

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

{|class="wikitable"
|-
!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 : 

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\SNMP\CONFIG_SNMP_1]
SNMP Started=1
SNMP Start=1
SNMP Port=161
SNMP sysContact = toto@sage.com
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
</pre>

====PROXY====

{{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"

{|class="wikitable"
|-
!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"

{|class="wikitable"
|-
!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

{|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 User Quota
|integer
|Taille maximale en Mb du répertoire upload de l'utilisateur; 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 
|}

===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===
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.

{|class="wikitable"
|-
!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 :

{|class="wikitable"
|-
!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 : 

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Directory
|String
|Répertoire d'exportation sur le serveur.
|}

Exemple de configuration ftp utilisant une zone publique Free : 

<pre>
[\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
</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>



*[[Exemple de configuration (server)|Exemple de configuration]]
*[[Service_1000_(server)|Ligne de commande]]

{{Footer|Serveur}}
[[category:Serveur]]