Configurer un fichier SMD

Le document suivant décrit le fichier de définitions de ServiceManager (UC4.SMD par défaut) qui définit les services devant être créés automatiquement.

Le fichier de définition contient tous les paramètres de démarrage des services Automation Engine. Chaque service est représenté dans sa propre ligne et commence 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.

Remarque : Ce fichier est adapté automatiquement si vous faites des modifications dans le programme de dialogue ServiceManager. Les interventions manuelles ne sont pas nécessaires.

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

Nom du service.

Vides.

Composant

Chemin et nom de fichier du programme Automation Engine qui doit démarrer.

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

Pour SAP, JMX, les bases de données et Rapid Automation, les agents requièrent un appel Java.
Par exemple : java -jar ucxjr3x.jar

Agents Java : Spécifiez aussi le chemin java car le ServiceManager sous UNIX ne lit pas toutes les variables d'environnement.
Exemple : /usr/java/latest/bin/java -jar ucxjsqlx.jar

 

Insérez un espace entre les paramètres composant et fichier INI.

Fichier INI

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

Vous pouvez aussi spécifier un 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 programme de dialogue du ServiceManager affiche le nom du processus serveur et le nombre de connexions en plus du nom du service.

LOGON=

Données de connexion pour le programme Automation Engine.

Ce paramètre ne s'applique que pour le ServiceManager sous Windows.

Start1=
Start2=
etc.

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

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

Nom : nom du mode de démarrage que vous pouvez définir via les Paramètres de démarrage - ServiceManager -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 autorisées pour le paramètre SystemStop= sont "NORMAL" (le statut du client reste inchangé) et "YES" (tous les clients sont arrêtés).

Par exemple :
Ce qui suit est un 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 WP2;*WP_STARTCMD;*SRV_STARTPATH;START1=(Coldstart,*WP_STARTCMD_COLD);START2=(Systemstop,*WP_STARTCMD_STOP);START3=(Coldstart with Systemstop,*WP_STARTCMD_COLDSTOP)

Vous pouvez structurer des variables pour améliorer la lisibilité car les lignes peut être très longues.

Exemple

VAR nom de la variable;valeur de la variable

Le début du fichier de définitions contient les définitions de variables (par exemple, SRV_STARTPATH indique le chemin de l'emplacement de ServiceManager). Veillez à ce que les chemins de la variable correspondent à la destination de votre installation.

La seconde partie du fichier liste les services ajoutés au fichier de définitions. Ces lignes commencent par une syntaxe DEFINE, suivie de la destination, puis du service. N'oubliez pas que la destination doit correspondre à celle définie dans le fichier INI.

Dans une ligne DEFINE, vous pouvez insérer une variable en spécifiant "*" suivi du nom de la variable.

Exemple

! Variables
VAR SRV_STARTPATH;*OWN\..\..\AutomationEngine\bin

VAR CP_STARTCMD;*SRV_STARTPATH\UCsrvcp.exe *SRV_STARTPATH\ucsrv.ini -svc%port%

VAR WP_STARTCMD;*SRV_STARTPATH\UCsrvwp.exe *SRV_STARTPATH\ucsrv.ini -svc%port%

VAR JWP_STARTCMD;java -Xrs -Xmx512M -jar ucsrvjp.jar -I*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"

! Services
DEFINE WP1;*WP_STARTCMD;*SRV_STARTPATH;START1=(Coldstart,*WP_STARTCMD_COLD);START2=(Systemstop,*WP_STARTCMD_STOP);START3=(Coldstart with Systemstop,*WP_STARTCMD_COLDSTOP)

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

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

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

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

DEFINE JWP;*JWP_STARTCMD;*SRV_STARTPATH

DEFINE CP1;*CP_STARTCMD;*SRV_STARTPATH

DEFINE CP2;*CP_STARTCMD;*SRV_STARTPATH

! Windows agents
DEFINE WIN01;*OWN\..\..\AgentWin\bin\UCXJWI3.exe;*OWN\..\..\AgentWin\bin\


! Database agenta
DEFINE DATABASE-AGENT01;java -jar -Xmx256M *OWN\..\..\Agents\sql\bin\ucxjsqlx.jar;*OWN\..\..\Agents\sql\bin

DEFINE DATABASE-SERVICE01;java -jar -Xmx256M *OWN\..\..\Agents\sql\bin\ucxjsqlx.jar -service -i*OWN\..\..\AutomationEngine\bin\ucsrv.ini;*OWN\..\..\Agents\sql\bin\

Voir aussi :