Manuel d'administration > Configuration > Organisation des fichiers de configuration > Agent RA

Agent RA

Des valeurs par défaut ont été attribuées à la plupart des paramètres. Vous pouvez les modifier si nécessaire. Les paramètres que vous devez en tous cas adapter à l'environnement de votre système sont mis en évidence en caractères rouges.

Structure du fichier UCXJJMX.INI

Section/paramètre

Description

[GLOBAL]

 

name=

Nom de l'agent

Le nom de l'agent peut contenir jusqu'à 32 caractères. Les caractères suivants sont autorisés : "A-Z", "0-9", "_", ".", "$", "@", "-" et "#".

L'utilisation du tiret "-" est uniquement possible dans le nom des Agents ! Ce caractère n'est pas autorisé dans le nom des autres objets.

Bien que les noms de l'agent soient limités à 32 caractères, ils ne doivent pas dépasser 25 caractères. Les sept derniers caractères sont utilisés pour l'ajout du suffixe '.NEW.nn' when a new agent is created from its template.

system=

Nom du système AE.
Cette entrée doit être identique à l'entrée dans le fichier INI du Automation Engine.

language=

Langue dans laquelle le logging est exécuté.

Valeurs autorisées : "E" (valeur par défaut), "D", "F"

logging=

Chemin et nom de fichier du fichier log.

Les caractères numériques servent de caractère de remplacement pour une numérotation croissante. Au démarrage de l'agent, les fichiers de logging sont renommés de telle manière que le fichier de logging actuel porte toujours le numéro "00".

logcount=

Nombre de fichiers log sauvegardés.

max_logging_kb=

Taille maximale du fichier log

Si le fichier log atteint la taille spécifiée ici, un nouveau fichier est créé.

helplib=

Chemin et nom du fichier des messages.

checkRegisteredFile=

This optional field is available for OEBS agents used in a multi node system with different operating systems. In this case, this variable should be set to 0 and no check will be performed. Therefore, the RA agent can register files that may not be valid file names on the OS where the RA agent runs.

Allowed values: "0" and "1" (default value)

"0" = Registered files are not checked.
"1" = Registered files are checked.

[AUTHORIZATION]  
InitialPackage=

Chemin et nom du fichier contenant le package d'authentification (Clé Société).

Le paramètre doit être indiqué lorsque vous utilisez la méthode d'authentification "Serveur" ou "Serveur et Agent". Si la Clé Société est introuvable, la connexion échoue.

L'Agent lit le fichier au démarrage et enregistre les informations du fichier que vous indiquez dans le paramètre KeyStore=. Ensuite, il supprime le premier.

KeyStore=

Le chemin et le nom du fichier contenant les informations relatives au package d’authentification (voir le paramètre InitialPackage=).

Si le nom du fichier et/ou le chemin ne sont pas indiqués, le système utilise le nom (fichier d’extension *.kstr) ou le chemin du fichier INI de l’agent. Si vous saisissez un nom de fichier, l’extension .kstr n’est pas automatiquement ajoutée.

Le fichier de certificat est créé lorsque l’agent démarre pour la première fois. Le fichier ne doit ensuite pas être supprimé, renommé ni déplacé. Quelle que soit la méthode d’authentification utilisée, toute tentative de connexion échouera si l'agent ne trouve pas ce fichier au démarrage. Dans ce cas, vous devez ouvrir le menu "Renouveler la clé de transfert" dans la Supervision système de l'agent concerné.

Les Agents Java (SAP, RA, base de données et JMX) exécutés sous UNIX créent le fichier de certificat avec l'autorisation "-rw-r--r—". D'autres utilisateurs du système d'Exploitation peuvent ainsi éventuellement accéder à ce fichier !

[RA]

 

cache_directory=

Répertoire dans lequel l'agent enregistre les Solutions RA.

[TCP/IP]

 

bindaddr=

Adresse IP ou nom d'hôte pour la connexion au processus de communication.

Utilisez ce paramètre si la connexion doit se faire via une adresse IP donnée (par exemple si l'ordinateur possède plus d'une carte réseau).

connect=

Intervalle de temps en secondes durant lequel l'agent tente d'établir une connexion au Automation Engine. Concerne l'établissement d'une connexion lors d'un redémarrage ou après une perte de connexion.

Valeur par défaut : 60 secondes

Ce paramètre est valide uniquement jusqu'à la première connexion réussie de l'agent au système AE. Ensuite, le paramètre RECONNECT_TIME de la caractéristique de l'hôte est utilisé.

cp=

Adresse du processus de communication du système AE auquel l'agent doit se connecter.

Formats autorisés :
nom DNS:numéro de port
adresse TCP/IP:numéro de port

[VARIABLES]

Dans cette section se trouvent des variables d'agent contenant des informations et des paramètres pour l'agent.

[TRACE]

 

file=

Chemin et nom du fichier de trace.

Les caractères numériques servent de caractère de remplacement pour une numérotation croissante. Lors du démarrage d'une trace, les fichiers de trace sont renommés de manière à ce que le fichier de trace actuel porte toujours le numéro "00".

trccount=

Nombre des fichiers de trace sauvegardés

max_trace_kb=

Taille maximale du fichier de trace

Si le fichier atteint la taille spécifiée ici, un nouveau fichier de trace est créé.

tcp/ip=

Indicateur de trace de l'agent.

Valeurs autorisées : "0" (valeur par défaut) à "9"

Les indicateurs de trace ne doivent être définis qu'après accord définitif du support !

ra=

Indicateur de trace de l'agent Rapid Automation

Valeurs autorisées : "0" (valeur par défaut) à "12"

"0" = L'écriture du fichier de trace Rapid Automation est désactivée.
"1" - "9" = L'écriture automatique rapide du fichier de trace est activée au niveau indiqué. "1" est le niveau le plus bas, "9" est une trace complète. Lorsque vous devez définir la trace de l'agent Rapid Automation, devez presque toujours le définir à "9".
"10" - "12" = La trace complète est configurée, un traçage de bibliothèque de tiers parti est configuré s'il existe. L'agent Web Service dispose d'une trace de tierce partie. Un traçage de bibliothèque de tiers parti ne peut être effectué que dans ce fichier. Elle ne peut être configurée dans l'UserInterface comme pour tous les autres agents.

[CP_LIST]

Liste des processus de communication

La liste est créée au démarrage de l'agent et étendue quand que de nouveaux processus de communication sont activés. Vous trouverez de plus amples informations sur l'établissement de connexion au chapitre Fonctionnement en mode multi-serveur.

La liste ne contient aucune entrée pour le processus de communication qui est défini dans le paramètre cp= (section [TCP/IP]).

Format :
numéro de port
=nom DNS
ou
numéro de port
=adresse TCP/IP

Exemple de fichier INI

[GLOBAL]
system=AE name=RA01 logcount=10 logging=../temp/CIT_LOGG_##.TXT max_logging_kb=50 language=E helplib=uc.msl


[AUTHORIZATION]
InitialPackage=
KeyStore=


[RA] cache_directory=cache


[TCP/IP] connect=20 cp=localhost:2217


[VARIABLES] uc_host_jcl_var=CIT


[TRACE] file=../temp/CIT_TRACE_##.TXT trccount=10 max_trace_kb=1000 tcp/ip=0 ra=12


[CP_LIST]
2218=PC01

 

Rubriques connexes :

Conseils d'adaptation des fichiers de configuration