Fichier de configuration (server)

De Wiki1000

Version du 17 juillet 2013 à 13:54 par Jetas (discuter | contributions)

(diff) ← Version précédente | Voir la version courante (diff) | Version suivante → (diff)

Introduction

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

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

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

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"

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

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"

SESSIONS Profil	String	Référence un nom de section SESSIONS contenant la configuration
CheckInterval	Entier	Délai entre chaque test d'expiration en seconde.
ExpireInterval	Entier	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"

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.

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.

Server Name	String	Nom du service.
Public Folder	String	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	Value	Limite le nombre de lignes affichées dans les grilles.

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"

Automate Profil	String	Version	Référence une section AUTOMATE.
Automate Started Process Server Started	Boolean	Toute	Démarre le serveur d'automate. (défaut)
Automate Name Process Server Name	String	Toute	Nom du serveur d'automate à démarrer.
Automate Message Box Process Server Message Box	String	Toute	Boite à messages utilisé par le serveur d'automate.
Automate Task Service Process Task Service	String	Toute	Nom du Service 1000 exécutant les tâches du serveur d'automate.
Automate Task Count	Integer	6.50	Nombre maximum de tâches automates simultanées (défaut 1).

Processus métiers

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

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

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"

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)
FormCacheLimit	Integer	Taille du cache d'écran (256)
Start Performance Counters	Boolean	Démarre les compteurs de performance

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.

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 la taille du cache et par conséquent la mémoire utilisée par le cache d'écran.

Start Performance Counters

Le serveur inclus un certain nombre de compteurs de performance interrogeables par les outils d'administration Windows (WMI) ou par le protocole SNMP.

Note : Pour pouvoir utiliser WMI la dll serviceL1000perf.dll doit être présente dans le répertoire du serveur.

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.

HTTP Protocol	String	Protocole HTTP utilisé par le service (http: ou https:)
HTTP HostName	String	Nom réseau du serveur HTTP utilisé par le service
HTTP Port	Integer	Port HTTP du serveur HTTP

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

HTTP Started	boolean	Démarre le serveur HTTP
HTTP Port	Integer	Port HTTP du serveur HTTP
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 CertIssuer	String	Si le port est 443 (https), représente l'émetteur du certificat du site permettant de l'identifier dans le magasin Windows
HTTP CertSerial	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

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"

LDAP Profil	string	Référence une secion 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"

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"

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.

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]

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 :

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

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"

Exceptions logs Profil	string	Référence une section EXCEPTIONS
Exceptions logs Started	boolean	Enregistrer les exceptions.
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.

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.

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 :

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 :

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

Voir aussi :

Exemple de configuration

— Serveur — Développement DSM —