Manuel d'administration > Installation > Nouvelle installation > Installation du ServiceManager (Windows)

Installation du ServiceManager (Windows)

Ce document présente la procédure d'installation de correctif pour le ServiceManager (Windows).

Installez impérativement le ServiceManager ainsi que son programme de dialogue dans des répertoires distincts (par exemple : C:\AE\SERVICEMANAGER\BIN et C:\AE\SERVICEMANAGERDIALOG\BIN).

Fichiers fournis

Les fichiers du ServiceManager sont répartis dans deux répertoires distincts du CD AE. Les fichiers requis par le ServiceManager se trouvent dans le répertoire IMAGE:SERVICEMANAGER\WINDOWS.

Nom du fichier	Description
UCYBSMGR.EXE	ServiceManager
UCYBSMGR.INI	Fichier d'initialisation pour le ServiceManager
UC4.SMD	Fichier de définition pour les services UC4 à démarrer
ZU00132.DLL	Bibliothèque d'exécution pour fonctions communes
SETUP.EXE	Programme d'installation

Le répertoire IMAGE:SERVICEMANAGERDIALOG\WINDOWS contient les fichiers requis par le programme de dialogue et l'interface de ligne de commande du ServiceManager.

Nom du fichier	Description
UCYBSMDI.EXE	Programme de dialogue du ServiceManager
UCYBSMDI.INI	Fichier d'initialisation pour le programme de dialogue
UCYBSMCL.EXE	Programme de ligne de commande pour le ServiceManager
SETUP.EXE	Programme d'installation

Les autres fichiers de ces sous-répertoires font partie du programme d'installation et du système d'exécution UC4. Rubrique connexe : Base de connaissances.

Déroulement

Sur l'ordinateur concerné (Serveur ou hôte).

	1.	Installation de Microsoft Visual C++ 2010 Redistributable Package

Si le package est déjà installé dans la version nécessaire, vous pouvez passer cette étape de l'installation. Pour savoir si cette version est présente, et si oui dans quelle version, consultez Panneau de configuration -> Logiciels.

Hôte (32 bits)
Installez le package à partir du répertoire IMAGE:CRTS\WINDOWS\X86.

Hôte (64 bits)
Installez le package à partir du répertoire IMAGE:CRTS\WINDOWS\X64 ou IMAGE:CRTS\WINDOWS\IA64.

	2.	Installation du ServiceManager

Hôte (32 bits)
Démarrage du programme SETUP.EXE dans le sous-répertoire adéquat de IMAGE:SERVICEMANAGER\WINDOWS\X86.
Adaptez le fichier INI UCYBSMGR.INI à l'environnement système.
Adaptez le Fichier de définition (fichier SMD) en conséquence.

Hôte (64 bits)
Démarrage du programme SETUP.EXE dans le sous-répertoire adéquat de IMAGE:SERVICEMANAGER\WINDOWS\X64 ou de IMAGE:SERVICEMANAGER\WINDOWS\IA64.
Adaptez le fichier INI UCYBSMGR.INI à l'environnement système.
Adaptez le Fichier de définition (fichier SMD) en conséquence.

	3.	Installation du programme de dialogue et de ligne de commande du ServiceManager

Hôte (32 bits)
Démarrage du programme SETUP.EXE dans le sous-répertoire adéquat de IMAGE:SERVICEMANAGERDIALOG\WINDOWS\X86.
Adaptez le fichier INI UCYBSMDI.INI à l'environnement système.
Les programmes peuvent également être installés sur des ordinateurs sur lesquels aucun ServiceManager ne s'exécute. Le ServiceManager peut alors être utilisé depuis ces postes.

Hôte (64 bits)
Démarrage du programme SETUP.EXE dans le sous-répertoire adéquat de IMAGE:SERVICEMANAGERDIALOG\WINDOWS\X64 ou de IMAGE:SERVICEMANAGERDIALOG\WINDOWS\IA64.
Adaptez le fichier INI UCYBSMDI.INI à l'environnement système.
Les programmes peuvent également être installés sur des ordinateurs sur lesquels aucun ServiceManager ne s'exécute. Le ServiceManager peut alors être utilisé depuis ces postes.

	4.	Installation de ServiceManager comme service

Ouvrez une fenêtre MS-DOS.
Démarrez le programme UCYBSMGR.EXE avec la commande :

UCYBSMGR[.EXE] -install phrase [-ichemin et nom du fichier INI ]

De cette façon, le ServiceManager et saisi comme service dans Windows. Choisissez une chaîne de caractères pour définir la phrase.
Dans panneau de configuration - Outils d'administration - Services, contrôlez que le service a été correctement installé. Son nom est formé de la manière suivante : "Automic ServiceManager [Phrase]"
Définissez, si désiré, le type de démarrage sur "automatique".
Par défaut, le nom de la phrase est "UC4". Si vous avez sélectionné une autre désignation, vous devez adapter la section suivante du fichier INI UCYBSMGR.INI :

[Destination Phrase]
deffile=Chemin vers le fichier SMD
cmdfile=Chemin vers le fichier SMD

Exemple :

[Destination UC4PROD]
deffile=C:\AE\SMgr\bin\UC4PROD.smd
cmdfile=C:\AE\SMgr\bin\UC4PROD.smc

Démarrez le service.

Il est possible d'installer le ServiceManager plusieurs fois comme service. Cela permet d'élaborer divers environnements ServiceManager, par exemple pour un test et un système de production. Lorsqu'il existe plusieurs de ces services, on les distingue à l'aide du nom de l'environnement ServiceManager (le nom par défaut est UC4).

Veillez à démarrer le service ServiceManager sous un utilisateur Windows qui disposent des autorisations administrateur. Raison : des composants qui devraient à leur tour pouvoir démarrer des processus pour différents utilisateurs sont démarrés avec le ServiceManager.

	5.	Démarrage des services avec le ServiceManager

Pour que le Automation Engine (programmes UCSRVCP.EXE et UCSRVWP.EXE) puisse fonctionner comme service, la source de données ODBC doit être créée comme système DSN (Data Source Name).

Démarrez le programme de dialogue du ServiceManager.
Sélectionnez l'ordinateur et l'environnement ServiceManager (phrase).
Vous voyez maintenant les services prévus, mais dans le statut "Stoppé".
En cliquant avec le bouton droit sur une ligne, vous pouvez :
* démarrer le service ou
* modifier ses propriétés (démarrage automatique avec démarrage du système, délai lors du démarrage, etc.).

Problèmes possibles

Tous les environnements ServiceManager (phrases) ne sont pas affichés :
Si vous voulez rendre plus d'un ServiceManager visible dans le programme de dialogue, saisissez une plage de numéros de port? Entrez celle-ci dans le fichier INI du programme de dialogue. Attention : l'intervalle ne peut pas comprendre plus de 10 numéros de port.
Tous les services ne sont pas affichés :
Spécifiez les valeurs correctes dans le fichier de définition (fichier SMD). Chaque service doit être représenté par une ligne donnée. Entrez également le chemin du fichier SMD dans le fichier INI du ServiceManager.
Un service ne démarre pas :

Vérifiez le chemin dans les propriétés du service (affichez ces dernières à l'aide du menu contextuel dans le programme de dialogue).
Pour un Automation Engine sur UNIX, il faut veiller à ce que le fichier "syntax.bin" se trouve dans le même répertoire que le fichier INI.

Consulter le fichier Log du ServiceManager vous sera toujours utile (nom par défaut du fichier le plus récent : SMgr_LOGG_00.txt). Il est sauvegardé dans le dossier Temp. Il s'y trouve de plus amples informations sur les processus.

Désinstallation du ServiceManager

Dans certains cas, il peut être nécessaire de désinstaller un environnement de ServiceManager (phrase) donné.

Ouvrez une fenêtre MS-DOS.
Démarrez le programme UCYBSMGR.EXE avec l'instruction :
UCYBSMGR -remove Phrase
L'environnement du ServiceManager est alors désinstallé comme service sous Windows.
Dans Panneau de configuration – Outils d'administration – Services, contrôlez que le service a été correctement supprimé.

Rubriques connexes :

ServiceManager - Service
ServiceManager - Programme de dialogue
ServiceManager - Interface de ligne de commande
Configuration du Debugger en cas d'interruptions de programmes