Les options du tableau suivant permettent de configurer un chargeur distant.
Tableau B-1 Options du chargeur distant
|
Option |
Autre nom |
Paramètre |
Description |
|---|---|---|---|
|
adresse |
|
adresse IP |
Un paramètre facultatif. Spécifie que le chargeur distant écoute à partir d'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. Vous disposez de trois options : address=address number address=’localhost’ N'utilisez pas ce paramètre. Si vous n'utilisez pas l'option -address, le chargeur distant écoute sur toutes les adresses IP locales. Exemple : address=137.65.134.83 |
|
-class |
-cl |
Nom de la classe Java |
Spécifie le nom de la classe Java du module d'interface d'application Identity Manager à héberger. Par exemple, pour un pilote Java, saisissez un des éléments suivants : -class com.novell.nds.dirxml.driver.ldap.LDAPDriverShim -cl com.novell.nds.dirxml.driver.ldap.LDAPDriverShim Java utilise un keystore pour lire les certificats. L'option -class et l'option -module s'excluent mutuellement. La liste des noms de classe Java est présentée dans le Tableau B-2. |
|
-commandport |
-cp |
Numéro de port |
Spécifie le port TCP/IP utilisé par l'instance du chargeur distant à des fins de contrôle. Si l'instance du chargeur distant héberge un module d'interface pilote de l'application, le port de commande est un port utilisé par une autre instance du chargeur distant pour communiquer avec l'instance qui héberge le module d'interface pilote. Si l'instance du chargeur distant envoie une commande à une instance qui héberge un module d'interface d'application, le port de commande est le port utilisé par cette dernière instance. Si le port de commande n'est pas spécifié, le port 8000 est utilisé par défaut. Plusieurs instances du chargeur distant peuvent être exécutées sur le même serveur qui héberge différentes instances de pilote ; il suffit de spécifier des ports de connexion et des ports de commande différents. Exemple : -commandport 8001 -cp 8001 |
|
-config |
Aucun |
nom_fichier |
Spécifie un fichier de configuration. Le fichier de configuration peut contenir toutes les options de ligne de commande à l'exception de l'option config. Les options spécifiées sur la ligne de commande remplacent celles spécifiées dans le fichier de configuration. Exemple : -config config.txt |
|
-connection |
-conn |
Chaîne de configuration de connexion |
Spécifie les paramètres de connexion à utiliser pour la connexion au serveur méta-annuaire sur lequel est exécuté le module d'interface pilote distant Identity Manager. Par défaut, la méthode de connexion utilisée pour le chargeur distant est TCP/IP avec SSL. Le port TCP/IP par défaut pour cette connexion est 8090. Plusieurs instances du chargeur distant peuvent s'exécuter sur le même serveur. Chaque instance du chargeur distant héberge une instance du module d'interface pilote de l'application Identity Manager. Différenciez les multiples instances du chargeur distant en spécifiant des ports de connexion et des ports de commande différents pour chaque instance du chargeur distant. Exemple : -connection "port=8091 rootfile=server1.pem" -conn "port=8091 rootfile=server1.pem" |
|
-description |
-desc |
brève description |
Spécifiez une chaîne de description abrégée (par exemple, SAP) pour le titre de la fenêtre de trace et pour la consignation dans Novell® Audit. Exemple : -description SAP -desc SAP La console du chargeur distant place les formes longues des options dans les fichiers de configuration. Vous pouvez utiliser soit la forme longue (par exemple, -description), soit la forme abrégée (par exemple, -desc). |
|
-help |
-? |
Aucun |
Affiche l'aide. Exemple : -help -? |
|
-java |
-j |
Aucun |
Spécifie que les mots de passe doivent être définis pour une instance de module d'interface Java. Cette option n'est utile qu'en association avec l'option de définition de mots de passe (setpasswords). Si -class est spécifié avec -setpasswords, cette option n'est pas nécessaire. |
|
-javadebugport |
-jdp |
Numéro de port |
Spécifie que l'instance du chargeur distant doit activer le débogage Java sur le port spécifié. Cela est particulièrement utile pour les développeurs de modules d'interface d'application Identity Manager. Exemple : -javadebugport 8080 -jdp 8080 |
|
keystore |
|
|
Paramètres conditionnels. Cette option est utilisée uniquement pour les modules d'interface d'application DirXML contenus dans les fichiers .JAR. 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. Il s'agit en général de l'autorité de certification de l'arborescence eDirectory™ qui héberge le module d'interface pilote distant. Si vous exécutez SSL et si vous souhaitez que le chargeur distant communique avec un pilote Java, saisissez une paire clé-valeur : keystore='keystorename' storepass='password' |
|
-module |
-m |
Nom de module |
Spécifie le module qui contient le module d'interface d'application Identity Manager à héberger. Par exemple, pour un pilote natif, saisissez un des éléments suivants : -module "c:\Novell\RemoteLoader\Exchange5Shim.dll" -m "c:\Novell\RemoteLoader\Exchange5Shim.dll" ou -module "usr/lib/dirxml/NISDriverShim.so" -m "usr/lib/dirxml/NISDriverShim.so" L'option -module utilise un certificat rootfile. L'option -module et l'option -class s'excluent mutuellement. |
|
-password |
-p |
password |
Spécifie le mot de passe d'authentification des commandes. Ce mot de passe doit être identique au premier mot de passe spécifié dans setpasswords pour l'instance de chargeur qui fait l'objet de la commande. Si une option de commande (déchargement, modification du niveau de trace, etc.) est spécifiée et si l'option password ne l'est pas, l'utilisateur est invité à entrer le mot de passe du chargeur représentant la cible de la commande. Exemple : -password novell4 -p novell4 |
|
port |
|
Numéro de port décimal |
Un paramètre requis. Il spécifie le port TCP/IP sur lequel le chargeur distant écoute des connexions du module d'interface pilote distant. Exemple : port=8090 |
|
rootfile |
|
|
Un paramètre conditionnel. Si vous exécutez SSL et si vous souhaitez que le chargeur distant communique avec un pilote natif, saisissez rootfile='trusted certname' |
|
-service |
-serv |
Aucun, ou install/uninstall |
Pour installer une instance en tant que service, utilisez l'argument install avec les autres arguments requis pour l'hébergement du module d'interface d'application. Par exemple, les arguments utilisés doivent inclure -module, mais tous les arguments peuvent inclure -connection, ‑commandport, etc. Cette option installe le service Win32 mais ne le démarre pas. Pour désinstaller une instance en tant que service, utilisez l'argument uninstall en avec les autres arguments requis pour l'hébergement du module d'interface d'application. La version sans argument de cette option n'est utilisée au niveau de la ligne de commande que pour une instance exécutée en tant que service Win32. Cette fonctionnalité est automatiquement configurée au moment de l'installation d'une instance en tant que service. Exemple : -service install -serv uninstall Cette option n'est pas disponible sur le chargeur distant Java ou rdxml. |
|
-setpasswords |
-sp |
Mot de passe Mot de passe |
Spécifie le mot de passe de l'instance du chargeur distant et celui de l'objet Pilote Identity Manager du module d'interface pilote distant avec lequel le chargeur distant va communiquer. Le premier mot de passe de l'argument est celui du chargeur distant. Le deuxième, dans les arguments facultatifs, est celui de l'objet Pilote Identity Manager associé au module d'interface pilote distant sur le serveur méta-annuaire. Aucun mot de passe ne doit être spécifié ou les deux doivent l'être. Si aucun mot de passe n'est spécifié, le chargeur distant demande les mots de passe. Il s'agit d'une option de configuration. Elle permet de configurer l'instance du chargeur distant à l'aide des mots de passe spécifiés, mais ne permet pas de charger le module d'interface pilote de l'application Identity Manager ni de communiquer avec une autre instance du chargeur. Exemple : -setpasswords novell4 staccato3 -sp novell4 staccato3 |
|
-storepass |
|
storepass |
Cette option est utilisée uniquement pour les modules d'interface d'application DirXML contenus dans les fichiers .JAR. Spécifie le mot de passe du fichier keystore Java indiqué par le paramètre keystore. Exemple : storepass=mypassword Cette option ne s'applique qu'au chargeur distant Java. |
|
-trace |
-t |
Nombre entier |
Spécifie le niveau de trace. Cette option est utilisée uniquement lorsqu'un module d'interface d'application est hébergé. Les niveaux de trace correspondent à ceux utilisés sur le serveur de méta-annuaire. Exemple : -trace 3 -t 3 |
|
-tracechange |
-tc |
Nombre entier |
Commande à une instance du chargeur distant qui héberge un module d'interface pilote de l'application de modifier son niveau de trace. Les niveaux de trace correspondent à ceux utilisés sur le serveur de méta-annuaire. Exemple : -tracechange 1 -tc 1 |
|
-tracefile |
tf |
nom_fichier |
Spécifie le fichier dans lequel consigner les messages de trace. Les messages de trace sont consignés si le niveau de trace est supérieur à zéro, que la fenêtre de trace soit ouverte ou non. Exemple : -tracefile c:\temp\trace.txt -tf c:\temp\trace.txt |
|
-tracefilechange |
tfc |
Aucun, ou Nom de fichier |
Commande à une instance du chargeur distant qui héberge un module d'interface pilote de l'application de commencer à utiliser un fichier de trace ou de fermer celui qui est en cours d'utilisation pour en utiliser un autre. L'utilisation de la version sans argument de cette option entraîne la fermeture, par l'instance qui héberge le module, de tout fichier de trace utilisé. Exemple : -tracefilechange c:\temp\newtrace.txt tfc c:\temp\newtrace.txt |
|
-tracefilemax |
-tfm |
taille |
Spécifie la taille maximum que les données du fichier de trace peuvent occuper sur le disque. Si vous spécifiez cette option, il y a un fichier de trace avec le nom spécifié via l'option tracefile et jusqu'à 9 fichiers de purge supplémentaires. Ces fichiers sont nommés en utilisant la base du nom de fichier de trace principal plus “_n”, avec n allant de 1 à 9. Le paramètre de taille est le nombre d'octets. Spécifiez la taille en utilisant les suffixes K, M ou G pour kilo-octets, mégaoctets ou gigaoctets. 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 Exemple : -tracefilemax 1000M -tfm 1000M Dans cet exemple, le fichier de trace ne peut pas dépasser 1 Go. |
|
-unload |
-u |
Aucun |
Décharge l'instance du chargeur distant. Si le chargeur distant s'exécute comme un service Win32, cette commande arrête le service. Exemple : -unload -u |
|
-window |
-w |
On/Off |
Active ou désactive la fenêtre de trace d'une instance du chargeur distant. Exemple : -window on -w off Cette option n'est disponible que sur les plates-formes Windows. Elle n'est pas disponible sur le chargeur distant Java. |
|
-wizard |
-wiz |
Aucun |
Permet de lancer l'Assistant de configuration. Il est également possible de lancer l'assistant en exécutant dirxml_remote.exe sans paramètre de ligne de commande. Cette option est utile lorsqu'un fichier de configuration est également spécifié. Dans ce cas, l'assistant utilise les valeurs qui figurent dans le fichier de configuration, et cet assistant peut être utilisé pour modifier la configuration sans modifier directement le fichier de configuration. Exemple : -wizard -wiz Cette option n'est disponible que sur les plates-formes Windows. Elle n'est pas disponible sur le chargeur distant Java. |
Tableau B-2 Noms de classes Java