Agent UNIX

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

Le nom d'hôte est utilisé si ce paramètre n'est pas défini. Les minuscules sont converties en majuscules.

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=

Le nom du système AE.
Cette entrée doit correspondre à celle du fichier INI de Automation Engine.

Les caractères xxx du nom de fichier sont des caractères de remplacement. Ils représentent le code à trois caractères de la version d'UNIX.See: Terminology

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, ainsi le fichier log le plus récent porte toujours le numéro "00".

Langue utilisée pour le log. Vous pouvez spécifier une langue primaire et secondaire.

Valeurs autorisées : "E", "D", "F"
Par défaut : "E,D" (langue primaire anglais, langue secondaire allemand)

S'il n'existe pas de message dans la langue primaire, un message est recherché dans la langue secondaire.

Sets the users 'open file descriptor' limit. A value of 0 forces the agent to set the users soft limit to the existing users hard limit. A value not equal to 0 forces the agent to set the soft limit and the hard limit to that value. If the value exceeds the users existing hard limit, the agent even sets that value, if it is operated with root privileges. If the value exceeds the users existing hard limit and the agent is not operated with root privileges, the agent cannot exceed the hard limit and sets the users soft limit to the users hard limit.

Default value: 32768

Valeurs autorisées : INCL, EXCL (valeur par défaut)

INCL : l'accès doit être autorisé pour chaque utilisateur de la section [USERID].
EXCL : aucun accès n'est accordé aux utilisateurs spécifiés sous [USERID]. Tous les autres utlisateurs peuvent démarrer des jobs.

Valeurs autorisées : INCL, EXCL (valeur par défaut)

INCL : l'accès doit être autorisé pour chaque utilisateur sous [UC_USER].
EXCL : aucun accès n'est accordé aux utilisateurs spécifiés sous [UC_USER]. Tous les autres utlisateurs peuvent démarrer des jobs.

Valeur par défaut : 30 secondes

login_check=

Vérification du mot de passe.

Valeurs autorisées : yes et no (valeur par défaut)

Rubriquesconnexes : Reportez-vous aux paramètres ANONYMOUS_FT ou ANONYMOUS_JOB de la variable UC_HOSTCHAR_DEFAULT).

ReportMode=

Masque, à trois chiffres au format octal que vous pouvez utiliser pour accorder des autorisations supplémentaires pour le fichier du rapport du job.

Valeur par défaut : 600

La valeur par défaut est la valeur minimale. La valeur 6 est utilisée même si vous indiquez un niveau d'autorisation du propriétaire d'une valeur plus faible.

JobFileMode=

Masque, à trois chiffres au format octal que vous pouvez utiliser pour accorder des autorisations supplémentaires pour le fichier du job.

Valeur par défaut : 700

La valeur par défaut est la valeur minimale. La valeur 7 est utilisée même si vous indiquez un niveau d'autorisation du propriétaire d'une valeur plus faible.

FT_Owner=

Propriétaire des fichiers de transferts de fichiers.

Valeurs autorisées : "user" (valeur par défaut) et "directory"

"user" : l'utilisateur défini dans l'objet Login est le propriétaire de fichier (ID utilisateur) pour le(s) fichier(s) transféré(s). Le propriétaire des fichiers existants qui peuvent être écrasés est conservé. "directory" : le(s) fichier(s) transféré(s) reçoivent le propriétaire du dossier cible. La même règle est appliquée pour les fichiers existants qui sont remplacés.

Ce paramètre n'affecte pas les droits du fichier ni le groupe.

Le nouveau protocole de transfert de fichier (l'agent source et l'agent cible en version 9 ou supérieure) ignore ce paramètre. Dans ce cas, le propriétaire est toujours l'utilisateur défini dans l'objet Login.

ReadUserAlways=

Le paramètre userid_type= et la section [USERID] permet d'autoriser ou de rejeter des ID utilisateurs. Vous pouvez utiliser le paramètre ReadUserAlways= pour spécifier si cette section doit toujours être lue avant le démarrage d'un job ou une seule fois au démarrage de l'agent. La lecture de cette section accroît la performance de votre système et représente donc la valeur par défaut.

Valeurs autorisées : yes et no (valeur par défaut)

yes : l'agent lit la section [USERID] avant chaque démarrage de job.
no : la section est lue uniquement au démarrage de l'agent.

KillSignal=

Signal envoyé au job s'il est interrompu par l'interface utilisateur.

Valeurs autorisées : "SIGTERM", "SIGABRT" et "SIGKILL" (valeur par défaut)

"SIGTERM" : le job est terminé (15)
"SIGABRT" : le job est interrompu (6)
"SIGKILL" : le job s'arrête immédiatement (9)

ft_temp_file=

Ce paramètre crée des fichiers temporaires dans les transferts de fichiers de .

Valeurs autorisées : yes (valeur par défaut) ou no

yes : le fichier obtien un nom temporaire composé de la lettre "T" suivie du RunID converti en chaîne de caractères. Le nouveau protocole de transfert de fichier ajoute un ID de fichier afin d'obtenir un nom de fichier unique car fondamentalement, seul un RunID est fourni. Le fichier est renommé après qu'il ait été transféré avec succès.
no : l'agent assigne le nom de fichier final dès le début du transfert de fichier.

Utilisation de l'algorithme de Nagle pour les transferts de Transfert de Fichier ou pour tous les autres Sockets des Agents.

Valeurs autorisées : "yes" (valeur par défaut) et "no"

"no" - Activation de l'algorithme de Nagle
"yes" - le processus n'est pas employé

Grâce à l'activation de l'algorithme de Nagle, la performance de Transfert de Fichier peut être améliorée. Ceci est principalement remarquable lorsque de nombreux petits fichiers sont transférés.

L'Agent BS2000 utilise toujours l'algorithme de Nagle et ne possède d'ailleurs pas ce paramètre INI.

Ce paramètre ne doit être défini qu'après accord définitif du support !

Limite de temps en secondes pour la recherche de fichiers des Evènements du système de Fichiers

Si la limite de temps indiquée est atteinte, la recherche de fichiers de l'exécution actuelle de l'évènement est annulée.

Si le paramètre est défini sur "0" (valeur par défaut) ou "-1", il n'y aucune limite de temps.

Le paramètre est important pour les Evènements du système de Fichiers avec les paramètres FILE_SIZE, FILE_STABLE, FILE_CHANGED.

Niveau maximal de sous-répertoires pour les Evènements du système de Fichiers

Ce paramètre vous permet de définir l'étendue de la recherche de la structure du répertoire lors de la recherche de fichiers des Evènements du système de fichiers. Le niveau maximal de sous-répertoires, en partant du répertoire de recherche, doit alors être indiqué.

Une restriction du niveau de répertoires peut permettre d'améliorer la performance des Evènements du système de fichiers, en particulier pour une structure de dossiers profondément imbriquée avec de nombreux fichiers.

Valeurs autorisées :
"0" (valeur par défaut) = aucune restriction
"1" = Les fichiers sont recherchés uniquement dans le répertoire de recherche, les sous-répertoires ne sont pas pris en compte.
"2" = Répertoire de recherche et un niveau de répertoires vers le Bas
"3" = Répertoire de recherche plus deux niveaux de sous-répertoires
, etc.

Le paramètre est important pour les Evènements du système de Fichiers avec les paramètres FILE_SIZE, FILE_STABLE, FILE_CHANGED.

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.

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é.

[USERID]

Définition des utilisateurs UNIX autorisés au format :
Nom d'utilisateur=START

Définition des utilisateurs UNIX interdits au format :
Nom d'utilisateur=NO_START

Valeur par défaut : root=NO_START

Définition des utilisateurs AE interdits au format :
Nom d'utilisateur=NO_START

L'ID utilisateur (OH_IDNR) de chaque Utilisateur est spécifié dans la table OH de la base de données AE.

Ce paramètre vérifie l'espace disque disponible avant le traitement du transfert de fichier.

Valeurs autorisées :
"yes" : le système vérifie si l'espace disque disponible est suffisant pour les fichiers à transférer. Les fichiers ne sont transférés que si l'espace est suffisant. Sinon, le transfert de fichier s'interrompt et affiche un message approprié.
"no" (valeur par défaut) : pas de vérification.

La vérification de l'espace disponble sur des lecteurs réseau peut par fois produire un résultat erroné.

Le paramètre FT_Linkfiles permet de contrôler si l'agent doit transférer les fichiers liés de la source ou les ignorer.

Valeurs autorisées :
"yes" : les liens seront déréférencés et les fichiers pointés par les liens seront transférés.
"no" (valeur par défaut) : les liens seront ingnorés.

Faire un transfert de fichier avec des caractères génériques avec la valeur "no" aura pour conséquence que le transfert sera défini à ENDED_EMPTY si le répertoire source ne contient que des liens.

[VARIABLES]

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

Les caractères xxx du nom de fichier sont des caractères de remplacement. Ils représentent le code à trois caractères de la version d'UNIX.See:Terminology

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 en cours ait toujours le numéro "00".

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

Les indicateurs de trace ne doivent être utilisés qu'en coopération avec le support Automic.

[HOSTS]

Attribution du nom d'un Agent en fonction de son adresse (Nom DNS ou adresse TCP/IP), lorsque celle-ci n'est pas accessible directement par l'Agent avec l'adresse connue dans le serveur. Plusieurs attributions sont indiquées en fonction de lignes; il n'y a aucune restriction pour le nombre.

Le AutomationEngine envoie à un Agent l'adresse interne de l'Agent partenaire lors du Transfert de Fichier. Celui-ci la remplace par l'adresse externe définie ici.

Ce paramètre n'est alors uniquement utile lorsque des Transferts de Fichiers sont exécutés avec des Agents qui ne peuvent pas créer entre eux de connexion TCP/IP directe grâce à l'adresse obtenue du serveur. Cette condition peut par exemple se produire lorsque les Agents impliqués dans le Transfert de Fichier se trouvent dans différents réseaux ou si un pare-feu est utilisé.

[TCP/IP]

Les autres agents et le messager de job établissent une connexion avec l'agent en utilisant ce numéro de port.

bindaddr=

Adresse IP ou nom d'hôte pour la connexion à l'agent.

Utilisez ce paramètre si une adresse IP spécifique doit être utilisée pour la connexion (par exemple si l'ordinateur possède plus d'une carte réseau).

Sinon, vous pouvez aussi indiquer l'adresse IP ou le nom de l'hôte avec port=

(format : port=adresse IP:port ounom DNS:port). Les spécifications saisies dans bindaddr= sont ignorées dans ce cas.

bindlocal=

Prise en compte de l'hôte local (127.0.0.1)

Ce paramètre doit être utilisé en relation avec bindaddr=.

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

0 : aucun socket d'écoute n'est créé.
1 : un socket d'écoute supplémentaire est créé sur l'hôte local.

connect=

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

Pour des raisons de compatibilité, le nom de paramètre précédent alarme = est encore valide.

Valeur par défaut : 60 secondes

maxrepcnt=

Nombre maximal de blocs de rapport qui doivent être transférés aux Automation Engine simultanément .

Valeur par défaut : 8 blocs

Longueur maximale des messages en octets qui accepte l'Agent.

Valeur par défaut : 500 000

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

Envoi des signaux de vie afin que toutes les connexions agent restent actives.

Valeurs autorisées : "N" et "Y" (valeur par défaut)
"Y" : les signaux de vie sont envoyés

Le paramètre est uniquement évalué si l'agent s'exécute sous Linux.

Intervalle de temps en secondes pendant lequel les signaux sont envoyés pour conserver les connexions.

La valeur par défaut qui dépend de l'environnement système est utilisée si le paramètre n'est pas spécifié ou s'il est défini à 0.

SendBufferSize=

Taille en octets du cache TCP/IP pour les messages à envoyer en Mo, Ko ou octets.

Les octets sont utilisés par défaut. Vous pouvez aussi ajouter au nombre la lettre "K" pour kilooctets ou "M" pour mégaoctets. Vous pouvez utiliser des lettres majuscules ou majuscules.

Exemples (les définitions suivantes sont identiques) :
Spécification en octets : 1048576
Spécification en Ko : 1024K ou 1024k
Spécification en Mo : 1M ou 1m

Valeur par défaut : 1 Mo

RecvBufferSize=

Taille en octets du cache TCP/IP pour les messages à recevoir (Mo, Ko ou octets).

Les octets sont utilisés par défaut. Vous pouvez aussi ajouter au nombre la lettre "K" pour kilooctets ou "M" pour mégaoctets. Vous pouvez utiliser des lettres majuscules ou majuscules.

Valeur par défaut : 1 Mo

[MISC]

FileBufferSize=

Taille du cache pour les fichiers qui sont transférés par l'objet transfert de fichier (Mo, Ko ou octets).

Les octets sont utilisés par défaut. Vous pouvez aussi ajouter au nombre la lettre "K" pour kilooctets ou "M" pour mégaoctets. Vous pouvez utiliser des lettres majuscules ou majuscules.

Exemples (les définitions suivantes sont identiques) :
Spécification en octets : 1048576
Spécification en Ko : 1024K ou 1024k
Spécification en Mo : 1M ou 1m

Valeur par défaut : 0 (le paramètre du système d'exploitation est utilisé)

Authentification=

Méthode d'authentification pour les données de connexion dans l'objet Login du job et des transferts de fichiers.

Valeurs autorisées : local (valeur par défaut) et PAM

local : appels du système d'exploitation
PAM : Pluggable Authentication Modules (voir également le paramètre Libname=)

L'authentification PAM n'est prise en charge que pour l'agent sous Sun Solaris, AIX et LINUX.

TraceFileSize=

Taille maximale d'un fichier de trace. Si cette valeur est dépassée, l'agent crée un nouveau fichier.

Les octets sont utilisés par défaut. Vous pouvez aussi ajouter au nombre la lettre "K" pour kilooctets ou "M" pour mégaoctets. Vous pouvez utiliser des lettres majuscules ou majuscules.

Ajoute un retour à la ligne (LF) à la fin des fichiers textes qui ont été transférés via le transfert de fichier.

Valeurs autorisées : yes et no (valeur par défaut)

yes : lors du transfert de fichier, l'agent insère toujours un retour à la ligne (LF) à la fin des fichiers texte s'il est le destinataire, même si les fichiers se terminent déjà par un LF.
no : les fichiers sont transférés sans modification.

Collecte des informations des processus

Valeurs autorisées : yes (valeur par défaut) et no

yes : l'agent récupère les informations de traitement de tous les processus AE et les envoie au Automation Engine lors de la vérification périodique des jobs. Le temps CPU écoulé est donc actualisé dans l'interface utilisateur. Notez que cela peut affecter la CPU et donc réduire les performances si beaucoup de processus sont impliqués.
no : les informations des processus ne sont pas collectées. Ce n'est qu'à la fin du job que le temps CPU est récupéré et envoyé au Automation Engine.

Ce paramètre n'est pas disponible pour AIX.

Affichage du logging dans le terminal utilisé pour démarrer l'agent.

Valeurs autorisées : yes et no (valeur par défaut)

yes : les données de logging de l'agent sont affichées dans la console. Des données sont également écrites dans le fichier log.
no : les données de logging sont écrites uniquement dans le fichier log.

Vérification de l'autorisation avant la suppression du fichier source

Valeurs autorisées : yes (valeur par défaut) et no

yes : l'autorisation permettant à l'utilisateur de supprimer des fichiers est vérifiée.
no : l'autorisation n'est pas vérifiée, le fichier est supprimé. L'utilisateur UNIX sous lequel l'agent est exécuté est utilisé (généralement root).

[PAM]

Libname=

Nom de fichier et chemin d'accès de la bibliothèque PAM.

Spécifiez le nom de la bibliothèque si la méthode d'authentification PAM doit être utilisée (voir aussi au paramètre authentification=).

Par défaut, le fichier libpam.so est recherché dans le répertoire de l'agent.

Ce paramètre est uniquement important pour les agents Sun Solaris, LINUX et AIX.

Si activé et si l'authentification PAM est est utilisée, une session d'utilisateur PAM est ouverte pour chaque job utilisant également les identifications de session par PAM (par exemple, les limites définies dans /etc/security/limits.conf). Ce paramètre s'applique aux jobs, mais pas aux transferts de fichier ni aux événements de fichier.

Valeurs autorisées : yes et no (valeur par défaut)

[STARTCMD]

Valeurs autorisées : fork (valeur par défaut), batch

fork : le job est démarré à l'aide de la fonction fork.
batch : le job est démarré à l'aide de la commande batch.

Other_Shell=

Options du shell pour le début des jobs sous tous les Shell.
Vous pouvez utiliser cette ligne lorsque les jobs sont démarrés à l'aide d'une commande batch.

Spécifie le chemin d'accès au Shell spécifié

La variable d'environnement PATH est utilisée si le paramètre n'est pas défini. Si cette variable n'existe pas, le système utilise le répertoire "/bin".

[CP_LIST]

Liste des processus de communication

La liste est créée au démarrage de l'agent et étendue quand de nouveaux processus de communication sont activés. You will find more detailed information about establishing a connection in the chapter Multi-Server Operation.

Le processus de communication qui est défini dans le paramètre cp= (section [TCP/IP]) n'est pas inclus dans la liste.

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