| |
L`une des méthodes d`accès à eMBox consiste à utiliser son client à ligne de commande Java. Celui-ci dispose de deux modes : interactif et traitement par lots. En mode interactif, vous exécutez une commande eMBox une à la fois. En mode de traitement par lots, vous pouvez exécuter un groupe de commandes sans surveillance. Le client à ligne de commande dispose d`un service de consignation pour ces deux modes.
Le client à ligne de commande est une application Java. Pour l`exécuter, vous devez avoir accès à Java Runtime Environment (JRE), installé avec eDirectory. Vous devez également avoir accès, au-delà du pare-feu, aux serveurs que vous souhaitez gérer. Vous pouvez exécuter des tâches pour plusieurs serveurs à partir d`un serveur ou d`un poste de travail.
Dans cette section :
Pour afficher l`aide générale sur la ligne de commande eMBox avant d`accéder au client eMBox, procédez comme suit :
Pour afficher l`aide interactive sur la ligne de commande eMBox lorsque vous êtes en mode interactif, à l`invite du client eMBox, saisissez un point d`interrogation (?). Par exemple,
eMBox Client> ?
Vous obtenez des informations sur les options de la ligne de commande telles que celles qui figurent dans Options du client à ligne de commande eMBox
Le mode interactif vous permet d`exécuter une commande eMBox à la fois.
Dans cette section :
Le client eMBox et JVM 1.3.1 de Sun sont installés avec eDirectory. Pour ouvrir le client eMBox en mode interactif sur un serveur eDirectory, procédez comme suit :
Le fichier edirutil constitue un raccourci pour exécuter le client eMBox. Il pointe vers l`exécutable Java et l`emplacement par défaut où le client eMBox est installé avec eDirectory ; pour NetWare, il inclut l`option -ns nécessaire (il s`agit d`une option Java pour NetWare qui signifie "new screen", ou nouvel écran). (Vous pouvez également entrer les informations manuellement, comme indiqué dans Configuration du chemin et du chemin d`accès de la classe pour le client eMBox.)
Vous devez avoir un accès au-delà du pare-feu afin d`utiliser le client de ligne à commande eMBox sur les serveurs que vous souhaitez gérer ; ainsi, si vous êtes un utilisateur distant, vous avez besoin d`un accès de type VPN.
Pour utiliser le client eMBox sur une machine autre qu`un serveur eDirectory :
Sur un poste de travail, vous ne pouvez pas utiliser la commande edirutil comme raccourci pour accéder au client eMBox en mode interactif, comme cela est possible sur un serveur. Vous devez soit configurer l`environnement une fois dans le chemin et le chemin d`accès de la classe, soit l`entrer chaque fois manuellement. Reportez-vous à Configuration du chemin et du chemin d`accès de la classe pour le client eMBox.
Si vous exécutez le client eMBox sur un serveur eDirectory et que vous n`avez pas modifié l`emplacement de Java ou du fichier eMBoxClient.jar, vous pouvez utiliser edirutil comme raccourci pour l`exécution. (Reportez-vous à Exécution du client eMBox sur un serveur eDirectory.)
Toutefois, si vous avez changé les emplacements par défaut, si vous exécutez le fichier eMBoxClient.jar sur une machine autre qu`un serveur ou si vous souhaitez entrer manuellement le chemin d`accès de la classe, vous devez configurer le chemin et le chemin de la classe du client eMBox comme indiqué ci-après.
En procédant ainsi, vous pouvez exécuter le client eMBox depuis n`importe quel emplacement de votre machine :
Si vous êtes sur un serveur, cette opération a probablement été déjà effectuée. Sur des serveurs Windows et UNIX, le répertoire doit être dans votre chemin d`accès. Sous NetWare, il suffit que Java soit en cours d`exécution.
Sur un poste de travail, il se peut que vous deviez procéder vous-même à la configuration. Par exemple, sous Windows, cliquez sur Démarrer > Paramètres > Panneau de configuration > Système. Dans l`onglet Avancé, cliquez sur Variables d`environnement et ajoutez le chemin d`accès à la variable Path.
Pour entrer ces données manuellement : Si le chemin d`accès à l`exécutable Java n`a pas été ajouté à votre chemin, vous devrez d`abord, sur la ligne de commande, changer le répertoire contenant l`exécutable afin de pouvoir exécuter eMBox. Par exemple, sous Windows, entrez
cd c:\novell\nds\embox\jre\bin
Serveur NetWare : Serveur ou poste de travail Windows : Serveur ou poste de travail Unix : Pour entrer ces données manuellement : Un moyen de préciser le chemin d`accès de la classe consiste à utiliser l`indicateur -cp pour Java chaque fois que vous voulez exécuter eMBox : Par exemple, sous Windows, entrez AVERTISSEMENT : Sur un serveur NetWare uniquement, pour éviter un abend, vous devez inclure -ns (option Java pour NetWare qui signifie "new screen", ou nouvel écran). Par exemple,
set ENVSET=chemin\eMBoxClient.jar
set CLASSPATH=chemin\eMBoxClient.jar
export CLASSPATH=chemin/eMBoxClient.jarjava -cp chemin/eMBoxClient.jar embox -i
java -cp c:\novell\nds\embox\eMBoxClient.jar embox -i
java -ns -cp sys:\system\embox\eMBoxClient.jar embox -i
Une fois cette procédure terminée, vous pouvez exécuter le client en mode interactif depuis n`importe quel emplacement de votre machine, en utilisant la commande suivante :
java embox -i
AVERTISSEMENT : Sur un serveur NetWare uniquement, pour éviter un abend, vous devez inclure -ns (option Java pour NetWare qui signifie "new screen", ou nouvel écran). Par exemple,
java -ns embox -i
Pour plus d`informations sur les commandes Java, reportez-vous à la documentation Java sur le site Web de Sun.
Pour vous loguer à un serveur, vous devez spécifier son nom ou son adresse IP et le numéro du port de connexion. Pour les logins publics, le nom d`utilisateur et le mot de passe ne sont pas nécessaires.
Par exemple, après avoir ouvert le client eMBox en mode interactif, entrez :
login -s 137.65.123.244 -p 8008 -u admin.ma_société -w mon_mot_de_passe -n
Pour plus d`informations, reportez-vous à Recherche des numéros de port eDirectory.
La langue par défaut est la langue système du client ; le plus souvent, il donc est inutile de définir explicitement une langue. De même, le timeout par défaut convient à la plupart des situations. Pour définir le fichier journal, spécifiez le nom du fichier et le mode d`ouverture (annexion ou écrasement).
Le tableau suivant propose des exemples de commande.
Après vous être logué à un serveur, vous pouvez utiliser la commande list pour afficher la liste des services disponibles sur ce serveur.
Cette commande affiche de façon dynamique les outils eMTools suivants et leurs services :
Utilisez l`option -r pour rafraîchir la liste. Utilisez -t pour lister les détails des services. Utilisez -f pour afficher uniquement le format de la commande.
Le tableau suivant propose des exemples de commande.
Après vous être logué à un serveur, vous pouvez exécuter des tâches à l`aide des services eMTool. Par exemple :
| Commande | Description |
|---|---|
dsrepair.rld |
Répare la base de données locale. |
backup.getconfig |
Obtient des informations de configuration de sauvegarde. |
Pour plus d`informations, reportez-vous au Guide d`administration de eDirectory 8.7 sur le site Web de documentation Novell.
Pour vous déloguer de la session en cours, utilisez la commande suivante :
logout
Si vous vous loguez à un autre serveur, vous n`avez pas besoin d`utiliser cette commande, car vous êtes automatiquement délogué du serveur actuel.
Pour quitter le client, utilisez l`une des commandes suivantes :
exit
ou
quit
Il existe trois méthodes d`exécution du client eMBox en mode de traitement par lots :
Pour une souplesse accrue et pour organiser et réutiliser les commandes fréquemment exécutées, vous pouvez combiner des fichiers de traitement par lots internes et propres au système.
Vous pouvez exécuter une seule tâche eMBox en mode de traitement par lots : entrez la commande avec l`option -t pour spécifier l`outil et la tâche, en omettant l`option -i (mode interactif). Par exemple :
java embox -s 137.65.123.244 -p 8008 -u admin.ma_société -w mon_mot_de_passe -l mylog.txt -t dsrepair.rld
Dans le cas de plusieurs tâches exécutées sur des serveurs différents ou de tâches fréquemment exécutées, il est préférable d`utiliser un fichier de traitement par lots interne. Pour plus d`informations, reportez-vous à Fichier de traitement par lots interne ci-après.
Pour exécuter le client eMBox en mode de traitement par lots, vous devez créer un fichier qui contient un groupe de commandes eMBox similaires à celles que vous exécutez en mode interactif.
Un fichier eMBox de traitement par lots interne vous permet d`exécuter automatiquement toutes les commandes qu`il contient. Vous pouvez exécuter plusieurs tâches sur le même serveur au moyen d`outils eMBox sans devoir vous loguer et vous déloguer pour chaque tâche. À partir d`un serveur, vous pouvez également exécuter plusieurs tâches sur plusieurs serveurs au moyen d`outils eMBox.
Les fichiers de traitement par lots internes vous permettent d`organiser et de réutiliser les commandes fréquemment exécutées, ce qui vous évite de les entrer systématiquement sur la ligne de commande.
Vous pouvez accéder à la ligne de commande et exécuter le fichier de traitement par lots interne au moyen d`une commande du client eMBox. Par exemple, cette commande se logue à un serveur et exécute les commandes listées dans le fichier mybatch.mbx :
java embox -s 137.65.123.244 -p 8008 -u admin.ma_société -w mon_mot_de_passe -l mylog.txt -o -b mybatch.mbx -n
AVERTISSEMENT : Sous NetWare uniquement : pour éviter un abend, vous devez inclure -ns (une option Java sous NetWare qui signifie "new screen", ou nouvel écran). Par exemple,
java -ns embox -s 137.65.123.244 -p 8008 -u admin.ma_société -w mon_mot_de_passe -l mylog.txt -o -b mybatch.mbx -n
Une autre solution consiste à inclure le même type de commande dans un fichier système de traitement par lots, ce qui vous permet de programmer l`exécution sans surveillance de ce fichier sur le serveur. Reportez-vous à Fichier système de traitement par lots ci-après.
Voici un exemple de fichier de traitement par lots interne eMBox. Il contient des exemples de commandes exécutables et un exemple de logage à un autre serveur. Dans cet exemple, nous partons du principe que vous vous êtes logué à un serveur au moment de l`ouverture du client eMBox. (Chaque commande doit figurer sur une ligne distincte. Les lignes qui commencent par le signe # sont des commentaires.)
# Le nom de ce fichier est mybatch.mbx.
# Il s`agit `un exemple de commandes exécutables dans
# un fichier de traitement par lots interne eMBox.
# Commandes Backup
backup.getconfig
backup.backup -b -f mybackup.bak -l backup.log -t -e -w
# Commandes DSRepair
dsrepair.rld
# Logage à un autre serveur
login -s 137.65.123.255 -p 8008 -u admin.ma_société -w mon_mot_de_passe -n
# Commandes DSMerge
dsmerge.pr -u admin.ma_société -p admin.ma_société -n mon_mot_de_passe # Opérations du schéma
dsschema.rst
dsschema.dse
dsschema.rls
dsschema.gsu
dsschema.scc
dsschema.irs -n LocalTree
# Commandes DSService
service.serviceList
# Fin de l`exemple.
Comme avec les outils de ligne de commande, vous pouvez créer des fichiers système de traitement par lots qui contiennent des commandes du client eMBox et les exécuter manuellement sur la ligne de commande ou programmer leur exécution sans surveillance sur le serveur.
À partir d`un serveur, vous pouvez également exécuter plusieurs tâches sur plusieurs serveurs au moyen d`outils eMBox.
Dans un fichier système de traitement par lots, vous pouvez combiner des commandes spécifiques du client eMBox et des fichiers de traitement par lots internes pour bénéficier d`une souplesse accrue et organiser et réutiliser les commandes fréquemment exécutées. Pour plus d`informations, reportez-vous à Fichier de traitement par lots interne ci-dessus.
| Option | Description |
|---|---|
-? ou -h |
Affiche l`aide. |
-i |
Exécute les commandes eMBox une à une et en mode interactif. |
-s serveur |
Nom ou adresse IP du serveur eMBox. Valeur par défaut=127.0.0.1 |
-p port |
Numéro de port du serveur eMBox. Valeur par défaut=80 |
-u utilisateur |
DN de l`utilisateur. Par exemple, admin.ma_société. Valeur par défaut=anonyme |
-w mot_de_passe |
Mot de passe associé à l`utilisateur spécifié avec l`option -u. |
-m mode |
Mode de login. Valeur par défaut=dclient |
-n |
Ne tentez pas d`établir une connexion SSL sécurisée. Utilisez une connexion non sécurisée. Si vous n`utilisez pas cette option, le client eMBox cherche à établir une connexion SSL et vous devez disposer des fichiers JSSE dans votre chemin d`accès de la classe, sinon vous obtenez une erreur. Pour plus d`informations, reportez-vous à Établissement d`une connexion sécurisée avec le client eMBox. |
-l fichier journal |
Nom du fichier journal. |
-o |
Écrase le fichier journal lors de son ouverture. |
-T timeout |
Délai d`attente, en secondes, des réponses du serveur. |
-L langue |
Liste des langues admises (séparées par une virgule), par ordre de préférence ; par exemple, en-US,de_DE. Par défaut, cette option affiche la langue système du client. |
-t [outil.]tâche options |
Exécute un seul service avec cette connexion. La chaîne qui suit -t doit être une commande eMBox valide. |
-b fichier de traitement par lots eMBox |
Exécute un groupe de services indiqués dans le fichier de traitement par lots. Les commandes eMBox du fichier de traitement par lots doivent figurer sur des lignes distinctes. Les lignes qui commencent par le signe # sont des commentaires. |
Si vous utilisez une connexion non sécurisée, toutes les informations que vous entrez, telles que les noms d`utilisateur et les mots de passe, sont envoyées en texte clair sur le réseau.
Si vous voulez établir une connexion sécurisée au moyen de SSL, procédez comme suit :
S`ils sont absents, le client eMBox renvoie une erreur. Pour obtenir des informations sur JSSE et ces fichiers, reportez-vous au site Web de Sun.
Lorsque vous vous loguez à un serveur depuis le client eMBox, vous devez spécifier un numéro de port.
Si vous avez indiqué un numéro de port lors de l`installation de eDirectory, utilisez-le.
Les ports par défaut sont les suivants :
Vous trouverez ci-après des conseils supplémentaires pour trouver le port assigné à eDirectory:
Cliquez sur Démarrer > Paramètres > Panneau de configuration.
Double-cliquez sur l`icône Services eDirectory de Novell, puis cliquez sur l`onglet Transport.
Recherchez le port sécurisé ou non sécurisé.
Cliquez sur le signe plus placé en regard de Transports liés pour afficher le numéro de port.
La propriété Adresse réseau d`un objet Serveur affiche les ports.
Vous pouvez consulter la propriété Adresse réseau d`un objet Serveur dans les outils suivants :
Recherchez celles qui commencent par http: ou https: et qui se terminent par " /portal ". Ce sont les ports sécurisés et non sécurisés utilisés pour les outils eMBox.
Méthode permettant de connaître le numéro de port :
Par exemple, http://137.65.188.1:8008/portal/ indique qu`un serveur Web utilisait probablement le port par défaut 80 au moment de l`installation de eDirectory sur une plate-forme non-NetWare ; le port 8008 est donc utilisé à la place.
Par exemple, https://137.65.188.1/portal n`affiche pas de numéro de port après l`adresse IP, ce qui signifie que le numéro de port sécurisé par défaut est utilisé pour les outils eMBox : 8009 sous NetWare et 443 pour les autres plates-formes.
Vous pouvez utiliser cette commande pour afficher la liste des ports :
ndsconfig get | grep http
Recherchez les lignes qui contiennent la mention http.server.interface suivie d`un numéro de port.
Vous pouvez aussi rechercher le numéro de port dans iManager ou ConsoleOne en appliquant la même méthode que pour NetWare. Pour plus d`informations, reportez-vous à Sous NetWare.
| |