Manuel d'administration > Configuration > Organisation des fichiers de configuration > Structure du fichier SMD

Structure du fichier SMD

Notez que les modifications effectuées dans le programme de dialogue du gestionnaire de services sont automatiquement reportées dans ce fichier. Les interventions manuelles ne sont donc pas forcément nécessaires.

Le fichier de définition (par défaut UC4.SMD) contient tous les paramètres de démarrage des services AE. Pour chaque service, il existe une ligne commençant par le mot-clé DEFINE. Chacun des paramètres de démarrage est séparé par un point-virgule. Les lignes de commentaires commencent par un point d'exclamation.

Syntaxe

DEFINE service; fichier INI du composant ; répertoire de travail [; -svc%port%] [; LOGON=(nom d'utilisateur, mot de passe, domaine )] [; Start1=() ; Start2=(); Start3=() etc.]

Syntaxe

Description / format

Service

Désignation du service.

Il est également possible d'utiliser des espaces.

Composant

Chemin et nom de fichier du programme AE qui doit être démarré.

Le chemin peut être absolu ou relatif. "*OWN" signifie que le programme doit se trouver dans le répertoire du gestionnaire de services l'exécutant.

Avec les agents pour SAP, JMX, les bases de données et Rapid Automation, il faut indiquer l'exécution Java.
Exemple : java -jar ucxjr3x.jar

Agents Java : Comme le ServiceManager sous UNIX ne lit pas toutes les variables d'environnement, pour les Agents Java il faut également indiquer le chemin Java.
Exemple : /usr/java/latest/bin/java -jar ucxjsqlx.jar

 

Un espace doit se trouver entre les paramètres composant et fichier INI.

Fichier INI

Nom de fichier du fichier INI devant être utilisé.

Ici aussi, il est possible de saisir le chemin absolu ou relatif (ce dernier se rapporte au programme à démarrer).

Répertoire de travail

Répertoire de travail pour le programme AE à démarrer

Si le programme à démarrer est un Agent basé sur Java (SAP, bases de données, JMX, Rapid Automation), le chemin vers le fichier JAR doit être indiqué comme répertoire de travail.

-svc%port%

Option d'affichage supplémentaire pour les processus serveur.

Si vous spécifiez ce paramètre de démarrage, le nom du processus serveur et le nombre de connexions s'affichent en plus du nom du service dans le programme de dialogue du gestionnaire de services.

LOGON=

Données de connexion au programme AE.

Ce paramètre ne peut être utilisé que pour le gestionnaire de services sous Windows.

Start1=
Start2=
etc.

Diverses méthodes de démarrage pour un processus serveur (WP).

Syntaxe :
START1=(nom,commande)
START2=(nom,commande)
START3=(nom,commande)

Nom : le nom du mode de démarrage que vous pouvez définir à l'aide du paramètre de démarrage du gestionnaire de services -sm.
Commande = La commande de démarrage complète d'un WP (chemin et nom de fichier) comprenant le paramètre du mode de démarrage (-parm).

Pour démarrer le WP avec un mode spécifique, vous devez ajouter le paramètre suivant :
-parm"StartMode=Valeur;SystemStop=Valeur"
Les valeurs autorisées pour StartMode= sont "NORMAL" (démarrage normal) et "COLD" (démarrage à froid).
Les valeurs "NORMAL" (le statut du client reste inchangé) et "YES" (tous les clients sont arrêtés) sont autorisées pour le paramètre SystemStop=.

Par exemple :
ce qui suit est l'extrait d'un fichier SMD qui comporte la définition d'un service que vous pouvez utiliser pour démarrer un WP avec un autre mode de démarrage.

VAR SRV_STARTPATH;*OWN\..\..\Server\bin
VAR WP_STARTCMD;*SRV_STARTPATH\UCsrvwp.exe *SRV_STARTPATH\ucsrv.ini -svc%port%
VAR WP_STARTCMD_COLD;*WP_STARTCMD -parm"StartMode=Cold"
VAR WP_STARTCMD_STOP;*WP_STARTCMD -parm"SystemStop=Yes"
VAR WP_STARTCMD_COLDSTOP;*WP_STARTCMD -parm"StartMode=Cold;SystemStop=Yes"

DEFINE UC4 WP2;*WP_STARTCMD;*SRV_STARTPATH;START1=(Coldstart,*WP_STARTCMD_COLD);START2=(Systemstop,*WP_STARTCMD_STOP);START3=(Coldstart with Systemstop,*WP_STARTCMD_COLDSTOP)

Comme chacune des lignes peut être très longue, il est possible de définir des Variables afin d'accroître la lisibilité.
Par exemple :

VAR Nom de la Variable;Valeur de la Variable

Le fichier SMD se compose de deux parties. Au début doivent se trouver toutes les instructions VAR, suivent ensuite toutes les instructions DEFINE.

Pour insérer une Variable dans la ligne DEFINE, saisissez un "*" suivi du nom de la Variable.

Exemple d'un fichier SMD

! Variables
VAR SRV_PATH;*OWN\..\..\Server\bin\
VAR CP_STARTCMD;*OWN\..\..\Server\bin\UCsrvcp.exe *OWN\..\..\Server\bin\ucsrv.ini -svc%port%
VAR WP_STARTCMD;*OWN\..\..\Server\bin\UCsrvwp.exe *OWN\..\..\Server\bin\ucsrv.ini -svc%port%
VAR WP_START1;*WP_STARTCMD -parm"StartMode=COLD"
VAR WP_START2;*WP_STARTCMD -parm"SystemStop=YES"
VAR WP_START3;*WP_STARTCMD -parm"StartMode=COLD;SystemStop=YES"


! Server processes
DEFINE UC4 CP1;*CP_STARTCMD;*SRV_PATH
DEFINE UC4 WP1;*WP_STARTCMD;*SRV_PATH;START1=(Coldstart,*WP_START1);START2=(Systemstop,*WP_START2);START3=(Coldstart with Systemstop,*WP_START3)


! Windows agents
DEFINE WIN01;*OWN\..\..\AgentWin\bin\UCXJWI3.exe;*OWN\..\..\AgentWin\bin\
DEFINE UC4MAIL;C:\AUTOMIC\Agents\win\bin\UCXJWI3.exe UC4MAIL.ini;C:\AUTOMIC\Agents\win\bin;LOGON=(uc4mail,­­10D888EA16FE7D2C0FE,)


! SAP agent
DEFINE SAP01;java -jar -Xrs -Xmx256M ucxjr3x.jar;*OWN\..\..\Agents\SAP\bin