18.2 Présentation des paramètres de configuration du chargeur distant

Vous pouvez configurer une instance de pilote à partir de la ligne de commande ou dans un fichier de configuration. NetIQ fournit un exemple de fichier config8000.txt pour vous aider à configurer le chargeur distant et les pilotes à utiliser avec votre module d'interface d'application. Le fichier exemple se trouve par défaut dans le répertoire /opt/novell/dirxml/doc. Par exemple, le fichier de configuration peut contenir les lignes suivantes :

-commandport 8000
-connection "port=8090 rootfile=/dirxmlremote/root.pem"
-module $DXML_HOME/dirxmlremote/libcskeldrv.so.0.0.0
-trace 3

Utilisez les paramètres suivants :

-description valeur (-desc valeur)

(Facultatif) Indique une brève description au format de chaîne, par exemple, SAP, que l'application utilise pour le titre de la fenêtre de trace et pour la consignation de l'audit. Par exemple :

-description SAP

-desc SAP

-class nom (-cl nom)

(Conditionnel) Lorsque vous utilisez un pilote Java, spécifie le nom de la classe Java du module d'interface d'application Identity Manager à héberger. Cette option indique à l'application d'utiliser un fichier Keystore Java pour lire les certificats. Par exemple :

-class com.novell.nds.dirxml.driver.ldap.LDAPDriverShim -cl com.novell.nds.dirxml.driver.ldap.LDAPDriverShim

REMARQUE :

• Vous ne pouvez pas utiliser cette option si vous spécifiez une option -module.

• Si vous utilisez une tabulation comme séparateur dans l'option -class, le chargeur distant ne démarre pas automatiquement. À la place, vous devez le démarrer manuellement. Pour que le chargeur distant démarre correctement, vous pouvez utiliser un espace au lieu d'une tabulation.

• Pour plus d'informations sur les noms que vous pouvez spécifier pour cette option, reportez-vous à la section Présentation des noms du paramètre -class Java.

-commandport numéro_port (-cp numéro_port)

Spécifie le port TCP/IP utilisé par l'instance de pilote à des fins de contrôle. Par exemple, -commandport 8001 ou -cp 8001. La valeur par défaut est 8000.

Pour utiliser plusieurs instances de pilote avec le chargeur distant sur le même serveur, spécifiez des ports de connexion et de commande différents pour chaque instance.

Si l'instance de pilote héberge un module d'interface d'application, le port utilisé par la commande est celui sur lequel une autre instance communique avec l'instance qui héberge le module d'interface. Si l'instance de pilote envoie une commande à une instance qui héberge un module d'interface d'application, le port utilisé par la commande est celui sur lequel écoute l'instance d'hébergement.

Lorsque vous envoyez ce paramètre à partir de la ligne de commande à une instance qui héberge un module d'interface d'application, le port utilisé par la commande est celui sur lequel écoute l'instance d'hébergement. Vous pouvez envoyer cette commande lorsque le chargeur distant est en cours d'exécution.

-config nom_fichier

Spécifie un fichier de configuration pour l'instance de pilote. Par exemple :

-config config.txt

Le fichier de configuration peut contenir toutes les options de ligne de commande à l'exception de -config. Les options spécifiées sur la ligne de commande remplacent celles spécifiées dans le fichier de configuration.

Vous pouvez envoyer cette commande lorsque le chargeur distant est en cours d'exécution.

-connection “paramètres” (-conn “paramètres”)

Indique les paramètres de connexion au serveur qui héberge le moteur Identity Manager qui exécute le module d'interface distant Identity Manager. La méthode de connexion par défaut est TCP/IP avec SSL.

Pour utiliser plusieurs instances de pilote avec le chargeur distant sur le même serveur, spécifiez des ports de connexion et de commande différents pour chaque instance.

Entrez les paramètres de connexion en utilisant la syntaxe suivante :

-connection "parameter parameter parameter"

Par exemple :

-connection "port=8091 fromaddress=198.51.100.0 rootfile=server1.pem keystore=ca.pem localaddress=198.51.100.0 hostname=198.51.100.0 kmo=remote driver cert"

Utilisez les paramètres suivants pour spécifier les paramètres d'une connexion TCP/IP :

address=adresse_IP

(Facutlatif) Spécifie si le chargeur distant écoute sur une adresse IP locale spécifique. Cette information est utile si le serveur qui héberge le chargeur distant possède plusieurs adresses IP et si ce dernier doit utiliser une seule adresse. Les valeurs suivantes peuvent être utilisées :

• address=address number

• address='localhost'

Par exemple :

address=198.51.100.0

Si vous ne spécifiez aucune valeur, le chargeur distant écoute sur toutes les adresses IP locales.

fromaddress=adresse_IP

Indique le serveur à partir duquel le chargeur distant accepte les connexions. L'application ignore les connexions si elles proviennent d'autres adresses. Indiquez une adresse IP ou le nom DNS du serveur. Par exemple :

fromaddress=198.51.100.0

fromaddress=testserver1.company.com

handshaketimeout=millisecondes

(Conditionnel) Se produit lors d'un timeout de la reconnaissance mutuelle pour les connexions généralement valides de la part du moteur Identity Manager. Spécifie le délai d'attente (en millisecondes) pour la reconnaissance mutuelle entre le chargeur distant et le moteur Identity Manager. Par exemple :

handshaketimeout=1000

Vous pouvez indiquer un nombre entier supérieur ou égal à zéro. La valeur zéro signifie que la connexion n'expire jamais. La valeur par défaut est de 1000 millisecondes.

hostname=serveur

Spécifie l'adresse IP ou le nom du serveur sur lequel le chargeur distant s'exécute. Par exemple :

hostname=198.51.100.0

keystore=nom_fichier

(Conditionnel) S'applique lorsque les fichiers .jar contiennent les modules d'interface d'application Identity Manager. Spécifie le nom du fichier Keystore Java qui contient le certificat de racine approuvée de l'émetteur du certificat utilisé par le module d'interface distant. Par exemple :

keystore=ca.pem

Il s'agit en général de l'autorité de certification de l'arborescence qui héberge le module d'interface distant.

kmo=nom

Indique le nom clé de l'objet Matériel clé qui contient les clés et le certificat utilisés pour les connexions SSL. Par exemple :

kmo=remote driver cert

localaddress=adresse_IP

Indique l'adresse IP à laquelle vous souhaitez lier le socket pour une connexion client. Par exemple :

localaddress=198.51.100.0

port=numéro_port

Spécifie le port TCP/IP sur lequel le chargeur distant écoute des connexions à partir du module d'interface distant. Pour spécifier le numéro de port par défaut, entrez port=8090.

rootfile=nom_cert_approuvé

(Conditionnel) S'applique uniquement lorsque vous utilisez SSL et si vous souhaitez que le chargeur distant communique avec un pilote natif. Spécifie le fichier qui contient le certificat de racine approuvée de l'émetteur du certificat utilisé par le module d'interface distant. Le fichier de certificat doit être au format Base 64 (PEM). Par exemple :

rootfile=server1.pem

Il s'agit en général de l'autorité de certification de l'arborescence qui héberge le module d'interface distant.

storepass=mot_de_passe

(Conditionnel) S'applique uniquement au chargeur distant Java, lorsque les fichiers .jar contiennent les modules d'interface d'application Identity Manager. Spécifie le mot de passe du fichier Keystore Java que vous avez indiqué pour le paramètre keystore. Par exemple :

storepass=mypassword

REMARQUE :si vous utilisez SSL et si vous souhaitez que le chargeur distant communique avec un pilote Java, saisissez une paire valeur-clé en utilisant la syntaxe suivante :

keystore=keystorename storepass=password

-datadir répertoire (-dd répertoire)

Indique le répertoire qui contient les fichiers de données utilisés par le chargeur distant. Par exemple :

-datadir /var/opt/novell/dirxml/rdxml/data

Lorsque vous utilisez cette commande, le processus rdxml change de répertoire pour utiliser le répertoire spécifié. Les fichiers de trace et les autres fichiers pour lesquels aucun chemin n'est explicitement spécifié sont créés dans le répertoire des données.

-help (- h)

Indique à l'application d'afficher l'aide.

-java (- j)

(Conditionnel) Indique que vous souhaitez définir des mots de passe pour une instance de module d'interface pilote Java.

REMARQUE :utilisez cette option conjointement avec l'option -setpasswords lorsque vous n'indiquez pas non plus de valeur-class.

-javadebugport numéro_port (-jdp numéro_port)

Indique à l'instance d'activer le débogage Java sur le port spécifié. Par exemple :

-javadebugport 8080

Utilisez cette commande lorsque vous développez des modules d'interface d'application Identity Manager. Vous pouvez envoyer cette commande lorsque le chargeur distant est en cours d'exécution.

-javaparam paramètres (-jp paramètres)

Indique les paramètres de l'environnement Java. Entrez les paramètres d'environnement Java en utilisant la syntaxe suivante :

-javaparam parameter
-jp parameter
-jp parameter

Pour spécifier plusieurs valeurs pour un seul paramètre, placez le paramètre entre guillemets. Par exemple :

-javaparam DHOST_JVM_MAX_HEAP=512M
-jp DHOST_JVM_MAX_HEAP=512M
-jp "DHOST_JVM_OPTIONS=-Dfile.encoding=utf-8 -Duser.language=en"

Utilisez les paramètres suivants pour configurer l'environnement Java :

DHOST_JVM_ADD_CLASSPATH

Spécifie d'autres chemins dans lesquels la machine virtuelle Java peut rechercher des fichiers de paquetage (.jar) et de classe (.class). Pour spécifier plusieurs chemins de classe pour une machine virtuelle Java UNIX ou Linux, insérez le caractère deux-points entre chaque chemin. Pour une machine virtuelle Java Windows, insérez un point-virgule.

DHOST_JVM_INITIAL_HEAP

Indique la taille initiale (minimale) des segments de mémoire de la machine virtuelle Java en nombres d'octets au format décimal. Utilisez une valeur numérique suivie de G, M ou K pour représenter le type d'octet. Par exemple :

100M

Si vous ne précisez pas le type d'octet, la taille par défaut utilise les octets. Ce paramètre équivaut à la commande Java -Xms.

Il est prioritaire par rapport à l'option d'attribut Ensemble de pilotes. L'augmentation de la taille initiale des segments de mémoire peut réduire le temps de démarrage et améliorer le débit.

DHOST_JVM_MAX_HEAP

Indique la taille maximale des segments de mémoire de la machine virtuelle Java en nombres d'octets au format décimal. Utilisez une valeur numérique suivie de G, M ou K pour représenter le type d'octet. Par exemple :

100M

Si vous ne précisez pas le type d'octet, la taille par défaut utilise les octets.

Il est prioritaire par rapport à l'option d'attribut Ensemble de pilotes.

DHOST_JVM_OPTION

Indique les arguments que vous souhaitez utiliser lors du démarrage de l'instance JVM du pilote. Utilisez un espace pour séparer chaque chaîne d'option. Par exemple :

-Xnoagent -Xdebug -Xrunjdwp: transport=dt_socket,server=y, address=8000

L'option d'attribut Ensemble de pilotes est prioritaire par rapport à ce paramètre. Cette variable d'environnement est ajoutée au bas de la liste des pilotes. Pour plus d'informations sur les options valides, reportez-vous à la documentation de JVM.

-module “nom” (-m “nom”)

(Conditionnel) Si vous utilisez un lecteur natif, spécifie le module qui contient le module d'interface d'application Identity Manager à héberger. Cette option indique à l'application d'utiliser un certificat rootfile. Par exemple, pour un pilote natif, saisissez un des éléments suivants :

-module "c:\Novell\RemoteLoader\ADDriver.dll"
-m "c:\Novell\RemoteLoader\ADDriver.dll"

ou

-module "usr/lib/dirxml/NISDriverShim.so"
-m "usr/lib/dirxml/NISDriverShim.so"

REMARQUE :

• Vous ne pouvez pas utiliser cette option si vous spécifiez une option -class.

• Si vous utilisez une tabulation comme séparateur dans l'option -module, le chargeur distant ne démarre pas automatiquement. À la place, vous devez le démarrer manuellement. Pour que le chargeur distant démarre correctement, vous pouvez utiliser un espace au lieu d'une tabulation.

-password valeur (-p valeur)

Spécifie le mot de passe de l'instance de pilote lorsque vous émettez des commandes qui affectent le fonctionnement de l'instance ou modifient les paramètres. Vous devez indiquer le même mot de passe que celui spécifié dans setpasswords pour l'instance que vous souhaitez commander. Par exemple :

-password netiq4

Si vous n'envoyez pas le mot de passe avec vos commandes, l'instance de pilote vous invite à le saisir.

Vous pouvez envoyer cette commande lorsque le chargeur distant est en cours d'exécution.

-piddir répertoire (-pd répertoire)

Indique le chemin d'accès au répertoire du fichier d'ID de processus (pidfile) utilisé par le processus du chargeur distant. Par exemple :

-piddir /var/opt/novell/dirxml/rdxml/data

Le fichier pidfile est initialement destiné à être utilisé par les scripts d'initialisation SysV-style. La valeur par défaut est /var/run. Sinon, la valeur par défaut peut également être le répertoire actuel, si le chargeur distant est exécuté par un utilisateur ne disposant pas des droits suffisants pour ouvrir le fichier pidfile pour lecture et écriture à l'emplacement /var/run.

Ce paramètre est similaire à -datadir.

-service valeur (-serv valeur)

(Windows uniquement) Indique si vous souhaitez configurer une instance en tant que service Win32 sur un ordinateur Windows. Les valeurs valides sont install et uninstall ainsi que les autres paramètres requis pour héberger un module d'interface d'application. Par exemple, vous devez inclure -module et pouvez également ajouter -commandport ainsi que les paramètres de connexion.

Cette commande installe ou désinstalle simplement l'instance en tant que service. Elle ne démarre pas le service.

Vous pouvez envoyer cette commande lorsque le chargeur distant est en cours d'exécution. Toutefois, vous ne pouvez pas utiliser cette commande avec le chargeur distant Java ou rdxml.

-setpasswords mot_de_passe_chargeur_distant mot_de_passe_facultatif (-sp mot_de_passe_chargeur_distant mot_de_passe_facultatif)

Spécifie le mot de passe de l'instance de pilote et celui de l'objet Pilote Identity Manager du module d'interface distant avec lequel le chargeur distant communique.

Il n'est pas nécessaire de spécifier de mot de passe. En revanche, le chargeur distant vous invite à fournir les mots de passe. Toutefois, si vous spécifiez le mot de passe du chargeur distant, vous devez également indiquer le mot de passe de l'objet Pilote Identity Manager associé au module d'interface distant sur le serveur du moteur Identity Manager. Pour spécifier les mots de passe, utilisez la syntaxe suivante :

-setpasswords Remote_Loader_password driver_object_password

Par exemple :

-setpasswords netiq4 idmobject6

REMARQUE :cette option permet de configurer l'instance de pilote à l'aide des mots de passe spécifiés, mais ne permet pas de charger un module d'interface d'application ni de communiquer avec une autre instance.

Paramètres des fichiers de trace

(Conditionnel) Lors de l'hébergement d'un module d'interface d'application Identity Manager, vous devez définir les paramètres d'un fichier de trace contenant les messages d'information envoyés par le chargeur distant et le pilote pour cette instance.

Ajoutez les paramètres suivants au fichier de configuration :

-trace entier (-t entier)

Spécifie le niveau des messages que vous voulez afficher dans une fenêtre de trace. Par exemple :

-trace 3

Les niveaux de trace du chargeur distant correspondent à ceux utilisés sur le serveur qui héberge le moteur Identity Manager.

-tracefile chemin_fichier (-tf chemin_fichier)

Indique le chemin d'accès au fichier dans lequel les messages de trace sont consignés. Vous devez spécifier un fichier de trace par instance de pilote s'exécutant sur un ordinateur spécifique. Par exemple :

-tracefile c:\temp\trace.txt

L'application consigne des messages dans le fichier si le paramètre -trace est supérieur à zéro. La fenêtre de trace ne doit pas nécessairement être ouverte pour que les messages soient consignés dans le fichier.

-tracefilemax taille (-tf taille)

Indique une limite à la taille pour le fichier de trace de cette instance. Spécifiez la valeur en kilo-octets, méga-octets, giga-octets ou, à l'aide de l'abréviation correspondant au type d'octet. Par exemple :

• -tracefilemax 1000K

• -tf 100M

• -tf 10G

REMARQUE :

• Si la taille des données du fichier de trace est supérieure au maximum spécifié lorsque le chargeur distant est démarré, les données du fichier de trace restent supérieures au maximum spécifié jusqu'à ce que la purge soit terminée sur les 10 fichiers.

• Lorsque vous ajoutez cette option dans le fichier de configuration, l'application utilise le nom spécifié pour le fichier de trace et jusqu'à 9 fichiers « roll-over ». Ces fichiers sont nommés en utilisant la base du nom de fichier de trace principal plus “_n, où n peut être un chiffre de 1 à 9.

-tracechange entier (-tc entier)

(Conditionnel) Lorsqu'une instance de pilote existante héberge un module d'interface d'application, cette commande permet de définir un nouveau niveau de messages d'information. Les niveaux de trace correspondent à ceux utilisés sur le serveur Identity Manager. Par exemple :

-trace 3

Vous pouvez envoyer cette commande lorsque le chargeur distant est en cours d'exécution.

-tracefilechange chemin_fichier (-tfc chemin_fichier)

(Conditionnel) Lorsqu'une instance de pilote existante héberge un module d'interface d'application, cette commande indique à l'instance d'utiliser un fichier de trace ou de fermer un fichier en cours d'utilisation et d'utiliser ce nouveau fichier à la place. Par exemple :

-tracefilechange \temp\newtrace.txt

Vous pouvez envoyer cette commande lorsque le chargeur distant est en cours d'exécution.

-unload (-u)

Donne une instruction de déchargement à l'instance de pilote. Si le chargeur distant s'exécute comme un service Win32, cette commande arrête le service.

Vous pouvez envoyer cette commande lorsque le chargeur distant est en cours d'exécution.

-window valeur (-w) valeur

(Windows uniquement) Indique à l'application d'activer ou de désactiver la fenêtre de trace d'une instance de pilote sur un ordinateur Windows. Les valeurs valides sont on et off. Par exemple :

-window on

Vous pouvez envoyer cette commande lorsque le chargeur distant est en cours d'exécution. Toutefois, vous ne pouvez pas utiliser cette commande avec le chargeur distant Java.

-wizard (-wiz)

(Windows uniquement) Lance l'assistant de configuration du chargeur distant sur un ordinateur Windows. Vous pouvez également lancer l'assistant en exécutant le fichier dirxml_remote.exe sans utiliser de paramètres de ligne de commande.

Si vous exécutez cette commande et spécifiez un fichier de configuration (option -config), l'assistant démarre avec les valeurs du fichier de configuration. Vous pouvez utiliser l'assistant pour changer la configuration sans modifier le fichier de configuration directement. Par exemple :

-wizard -config config.txt

Vous ne pouvez pas utiliser cette commande avec le chargeur distant Java.

Lorsque vous utilisez le paramètre -class pour configurer une instance de pilote pour le chargeur distant et le chargeur distant Java, vous devez spécifier le nom de la classe Java du module d'interface d'application Identity Manager à héberger.