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

Agent JMX

Des valeurs par défaut ont été attribuées à la plupart des paramètres. Vous pouvez les modifier en fonction de vos besoins. 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 INI 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.

system=

Nom du système AE.
Cette entrée doit être identique à l'entrée dans le fichier INI de l'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 log sont renommés ; de cette manière, le fichier log le plus récent 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.

logToFile=

Création de fichiers log

Valeurs autorisées : "0", "1" (valeur par défaut)

"0" : aucun fichier log n'est créé.
"1" : des fichiers log sont créés.

loadOnStartup=

Paramètre de démarrage pour l'Agent

Valeurs autorisées : "0", "1" (valeur par défaut)

"0" : l'Agent doit être démarré manuellement.
"1" : lors du démarrage du Serveur Oracle Weblogic, l'Agent est également démarré.

[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 !

[JMX]

 

type=

Type de l'Agent JMX

Valeurs autorisées : "JBOSS", "NETWEAVER", "TOMCAT", "WEBLOGIC" et "WEBSPHERE".

En fonction de votre licence, entrez une de ces valeurs. Si le paramètre reste vide (valeur par défaut), l'Agent JMX est utilisé en mode "autonome".

search_all=

Prise en compte du Serveur MBean local

Valeurs possibles: "0" (valeur par défaut) et "1"

"0" : l'Agent recherche uniquement les MBeans du Serveur auquel il est connecté. Celui-ci est configuré dans l'onglet JMX de l'objet Job.
"1" : l'Agent recherche lors de l'exécution des fonctions JMX_INVOKE, JMX_GET_ATTRIBUTE, JMX_SET_ATTRIBUTE et JMX_GET_INFO tous les serveurs MBean locaux. La fonction JMX_QUERY_NAMES et le navigateur Mbean affichent cependant uniquement les MBeans du Serveur MBean actuel. Si un MBean apparaît sous le même nom sur plusieurs Serveurs MBean, seule la première occurrence est prise en compte.

Attention : ce paramètre n'a aucune influence lorsque la connexion au Serveur MBean s'effectue à distance.

[WEBSPHERE]  
soapTimeout=

Configurez à l'aide de ce paramètre le délai d'attente de réponse à l'exécution de la fonction MBean (en secondes). Le Job s'interrompt si le délai est dépassé.

L'Agent utilise la valeur WebSphere par défaut si vous ne configurez aucune valeur ou la valeur "0".

[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 telle manière que le fichier de trace actuel ait 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=

Indicateurs 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 !

[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 à l'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.

[CP_LIST]

Liste des processus de communication

La liste est établie au démarrage de l'Agent et étendue dès lors 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]).

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

Exemple de fichier INI

[GLOBAL]
name=JMX01
system=UC4
language=E
logging=../temp/UCXJJMX_LOGG_##.TXT
logcount=10
max_logging_kb=1000
helplib=uc.msl
log_to_file=1
loadonstartup=0


[AUTHORIZATION]
InitialPackage=
KeyStore=


[JMX]
type=
search_all=0


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


[TCP/IP]
connect=60
cp=PC01:2217


[VARIABLES]
UC_HOST_JCL_VAR=JMX
UC_EX_PATH_JOBREPORT=.


[CP_LIST]
2218=PC01

 

Rubriques connexes :