Il est entre autres possible d'accéder à eMBox à l'aide de son client Java à ligne de commande. Le client à ligne de commande propose deux modes : interactif et traitement par lots. En mode interactif, vous exécutez une commande eMBox à la fois. En mode de traitement par lots, vous pouvez exécuter automatiquement un groupe de commandes. Le client à ligne de commande possède un service de consignation pour les deux modes.
Le client à ligne de commande est une application Java. Pour l'activer, vous devez avoir accès à l'environnement d'exécution Java (Java Runtime Environment), JVM 1.3.1 de Sun, installé avec eDirectory. Vous devez aussi accéder derrière le pare-feu pour les serveurs que vous voulez gérer. Vous pouvez effectuer des tâches pour plusieurs serveurs à partir d'un même serveur ou 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 Client, procédez comme suit :
Pour obtenir de l'aide sur la ligne de commande eMBox en mode interactif, entrez un point d'interrogation (?) à l'invite du client eMBox. Par exemple,
Client eMBox> ?
L'aide affiche des informations sur les options de ligne de commande similaires à celles de Options du client à ligne de commande eMBox.
Le mode interactif permet d'exécuter les commandes eMBox l'une après l'autre.
Dans cette section :
Le client eMBox et Sun JVM 1.3.1 sont installés avec eDirectory. Pour ouvrir le client eMBox en mode interactif sur un serveur eDirectory, procédez comme suit :
Le fichier edirutil est un raccourci pour l'exécution du client eMBox. Il pointe vers l'exécutable Java et l'emplacement d'installation par défaut du client eMBox avec eDirectory. Pour NetWare, il comprend l'option requise -ns. Il s'agit d'une option Java sur NetWare qui signifie " new screen " (" nouvel écran "). (Vous pouvez également entrer les informations manuellement, comme indiqué dans Définition du chemin et du chemin de classe pour le client eMBox.)
L'utilisation du client à ligne de commande eMBox pour les serveurs que vous voulez gérer nécessite un accès derrière le pare-feu. Si vous êtes à distance, vous devez donc disposer d'un accès via un réseau privé virtuel (VPN).
Pour exécuter le client eMBox sur une machine autre qu'un serveur eDirectory :
Contrairement à un serveur, un poste de travail ne permet pas d'employer la commande edirutil comme raccourci pour accéder au client eMBox en mode interactif. Vous devez soit configurer l'environnement après avoir accédé à votre chemin et votre chemin de classe, soit l'entrer chaque fois manuellement. Pour plus de détails, reportez-vous à Définition du chemin et du chemin de classe pour le client eMBox.
Si vous exécutez le client eMBox sur un serveur eDirectory sans avoir modifié l'emplacement du fichier Java ou eMBoxClient.jar, vous pouvez utiliser edirutil comme raccourci pour l'exécution. (voir Exécution du client eMBox sur un serveur eDirectory).
En revanche, si vous avez modifié les emplacements par défaut, si vous exécutez le fichier eMBoxClient.jar sur une machine autre qu'un serveur ou encore si vous voulez entrer le chemin de classe manuellement, vous devez configurer le chemin et le chemin de classe pour le client eMBox conformément aux indications de cette section.
Vous pouvez exécuter le client eMBox à partir de n'importe quel emplacement sur votre ordinateur si vous suivez la procédure ci-après :
Si vous êtes sur un serveur, cette opération a probablement déjà été effectuée. Sur des serveurs Windows et UNIX, le répertoire doit se trouver dans votre chemin. Sous NetWare, il n'est pas nécessaire d'ajouter le répertoire à un chemin d'accès, mais Java doit être en cours d'exécution.
Sur un poste de travail, il est possible que vous ayez à configurer Java vous-même. 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 à la variable Path.
Pour procéder manuellement : Si le chemin d'accès à l'exécutable Java n'a pas été ajouté à votre chemin, vous devez d'abord accéder, via la ligne de commande, au répertoire contenant cet exécutable avant de lancer eMBox. Par exemple, sous Windows, entrez
cd c:\novell\nds\embox\jre\bin
Serveur NetWare :
set ENVSET=chemin\eMBoxClient.jar
Serveur ou poste de travail Windows :
set CLASSPATH=chemin\eMBoxClient.jar
Serveur ou poste de travail Unix :
export CLASSPATH=chemin/eMBoxClient.jar
Pour procéder manuellement : Un autre moyen de spécifier le chemin de la classe consiste à utiliser l'indicateur -cp pour Java chaque fois que vous voulez exécuter eMBox :
java -cp chemin/eMBoxClient.jar embox -i
Par exemple, sous Windows, entrez
java -cp c:\novell\nds\embox\eMBoxClient.jar embox -i
AVERTISSEMENT :
sur les serveurs NetWare uniquement : pour éviter un abend, vous devez inclure -ns (option Java sous NetWare signifiant " new screen ", soit " nouvel écran "). Par exemple,
java -ns -cp sys:\system\embox\eMBoxClient.jar embox -i
Une fois ces deux opérations effectuées, vous pouvez exécuter le client en mode interactif à partir de n'importe quel emplacement de votre machine en utilisant la commande suivante :
java embox -i
AVERTISSEMENT :
sur les serveurs NetWare uniquement : pour éviter un abend, vous devez inclure -ns (option Java sous NetWare signifiant " new screen ", soit " 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 indiquer son nom ou son adresse IP, ainsi que le numéro du port de connexion spécifique. Pour les logins publics, il est inutile de préciser un nom d'utilisateur et un mot de passe.
Par exemple, une fois que le client eMBox est ouvert en mode interactif, entrez
login -s 137.65.123.244 -p 8008 -u admin.masociété
-w monmotdepasse -n
Pour plus d'informations sur les numéros de port, reportez-vous à Recherche des numéros de port eDirectory.
La langue par défaut est la langue du système client. Ainsi, dans la plupart des cas, vous n'avez pas besoin de définir explicitement une langue. De même, le timeout par défaut convient le plus souvent. Pour définir le fichier journal, indiquez son nom et le mode d'ouverture (annexer ou écraser).
Le tableau ci-après fournit des exemples de commandes.
Une fois logué à un serveur, vous pouvez utiliser la commande list pour afficher la liste des services disponibles sur ce serveur.
La commande list affiche dynamiquement tous les outils eMTools suivants et leurs services.
Utilisez -r pour forcer le rafraîchissement de la liste. Utilisez t pour lister les détails des services. Utilisez -f pour lister uniquement le format de la commande.
Le tableau ci-après fournit des exemples de commandes.
Une fois logué à un serveur, vous pouvez effectuer des tâches au moyen de ces différents services. Par exemple :
| Commande | Description |
|---|---|
dsrepair.rld |
Réparer la base de données locale |
backup.getconfig |
Obtenir des informations sur la configuration de la sauvegarde. |
Pour plus d'informations, reportez-vous à :
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 vous déloguez automatiquement du serveur actuel.
Pour quitter le client, utilisez l'une des commandes suivantes :
Quitter
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 système et internes de traitement par lots.
Sur la ligne de commande, vous pouvez n'exécuter qu'une seule tâche eMBox en mode de traitement par lots. Il suffit d'entrer la commande avec l'option -t pour spécifier l'outil et la tâche sans sélectionner l'option -i (mode interactif). Par exemple,
java embox -s 137.65.123.244 -p 8008 -u admin.masociété
-w monmotdepasse -l monjournal.txt -t dsrepair.rld -n
AVERTISSEMENT :
sous NetWare uniquement : pour éviter un abend, vous devez inclure -ns (option Java sous NetWare signifiant " new screen ", soit " nouvel écran "). Par exemple,
java -ns embox -s 137.65.123.244 -p 8008 -u admin.masociété -w monmotdepasse -l monjournal.txt -t dsrepair.rld -n
Pour des tâches multiples sur plusieurs serveurs, ou des tâches que vous exécutez fréquemment, il est recommandé d'utiliser un fichier de traitement par lots interne. Pour plus d'informations, reportez-vous à la section suivante, Fichier de traitement par lots interne.
Pour exécuter le client eMBox en mode de traitement par lots à l'aide d'un fichier de traitement par lots propre au client eMBox, vous devez créer un fichier contenant le groupe des commandes eMBox que vous exécutez en mode interactif.
Un fichier de traitement par lots propre au client eMBox permet l'exécution automatique de toutes les commandes qu'il contient. Vous pouvez effectuer des tâches multiples à l'aide de plusieurs outils eMBox sur le même serveur sans avoir à vous loguer et vous déloguer pour chaque tâche. À partir d'un serveur, vous pouvez également exécuter plusieurs tâches au moyen d'outils eMBox sur plusieurs serveurs.
Les fichiers de traitement par lots internes aident à organiser et à réutiliser les commandes fréquemment exécutées, ce qui évite de les entrer manuellement sur la ligne de commande à chaque fois.
Vous pouvez accéder à la ligne de commande et exécuter le fichier de traitement par lots interne à l'aide d'une commande du client eMBox. Par exemple, cette commande se logue à un serveur et exécute les commandes listées dans le fichier monlot.mbx :
java embox -s 137.65.123.244 -p 8008 -u admin.masociété -w monmotdepasse -l monjournal.txt -o -b monlot.mbx -n
AVERTISSEMENT :
sous NetWare uniquement : pour éviter un abend, vous devez inclure -ns (option Java sous NetWare signifiant " new screen ", soit " nouvel écran "). Par exemple,
java -ns embox -s 137.65.123.244 -p 8008 -u admin.masociété -w monmotdepasse -l monjournal.txt -o -b monlot.mbx -n
Une autre solution consiste à inclure le même type de commande dans un fichier système de traitement par lots, ce qui permet de planifier l'exécution sans surveillance de ce fichier sur le serveur. Pour plus de détails, reportez-vous à Fichier système de traitement par lots.
Voici un exemple de fichier de traitement par lots eMBox interne. Il contient des exemples de commandes exécutables et un exemple de login à un autre serveur. Dans cet exemple, nous partons du principe que vous êtes logué à un serveur lors 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 monlot.mbx.
# Il s'agit d'un exemple des commandes utilisables dans
# un fichier de traitement par lots eMBox interne.
# Commandes Backup
backup.getconfig
backup.backup -b -f masauvegarde.bak -l backup.log -t -e -w
# Commandes DSRepair
dsrepair.rld
# Login à un autre serveur
login -s 137.65.123.255 -p 8008 -u admin.masociété -w monmotdepasse -n
# Commandes DSMerge
dsmerge.pr -u admin.masociété -p admin. masociété -n monmotdepasse # Opérations sur le schéma
dsschema.rst
dsschema.dse
dsschema.rls
dsschema.gsu
dsschema.scc
dsschema.irs -n ArborescenceLocale
# Commandes DSService
service.serviceList
# Fin de l'exemple.
Comme avec d'autres 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 planifier leur exécution sans surveillance sur le serveur. Par exemple, vous pouvez effectuer des sauvegardes sans surveillance en utilisant des fichiers système de traitement par lots similaires à ceux des exemples décrits dans Sauvegardes sans surveillance à l'aide d'un fichier de traitement par lots et du client eMBox.
À partir d'un seul serveur, vous pouvez exécuter des tâches multiples à l'aide de plusieurs outils eMBox sur différents serveurs.
Dans un fichier système de traitement par lots, vous pouvez combiner des commandes individuelles du client eMBox et des fichiers de traitement par lots internes pour bénéficier d'une souplesse accrue et pour organiser et réutiliser les commandes que vous exécutez fréquemment. Pour plus d'informations, reportez-vous à Fichier de traitement par lots interne ci-dessus.
Consultez la documentation de votre système d'exploitation ou de votre logiciel de planification tiers relatif à l'exécution de fichiers de traitement par lots sans surveillance.
REMARQUE : sous NetWare, vous pouvez utiliser un logiciel de planification tiers ou CRON.NLM, un outil non pris en charge que vous pouvez télécharger auprès du support technique de Novell.
| Option | Description |
|---|---|
-? or -h |
Affiche les informations d'aide |
-i |
Exécute les commandes eMBox l'une après l'autre 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 utilisateur. Par exemple, admin.masociété. Valeur par défaut = anonyme |
-w mot_de_passe |
Mot de passe associé à l'utilisateur spécifié par -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 tente d'établir une connexion SSL et une erreur est renvoyée si vous ne disposez pas des fichiers JSSE dans votre chemin d'accès de classe. 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 à son ouverture. |
-T timeout |
Délai d'attente (en secondes) des réponses du serveur. |
-L langue |
Liste des langues admises classées par ordre de préférence et séparées par des virgules. Par exemple : en-US,de_DE. L'option par défaut est la langue du système client. |
-t [outil.]tâche options |
Exécute un service unique avec cette connexion. La chaîne qui suit l'option -t doit être une commande eMBox valide. |
-b fichier de traitement par lots eMBox |
Exécute un groupe de services tel qu'il est spécifié dans le fichier de traitement par lots. Les commandes eMBox du fichier de traitement par lots doivent être placées sur des lignes distinctes. Les lignes précédées du 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 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 :
Si ce n'est pas le cas, le client eMBox renvoie une erreur indiquant qu'il ne parvient pas à établir de connexion sécurisée.
Pour obtenir ces fichiers, ainsi que des informations sur JSSE, reportez-vous au site Web de Sun.
Lorsque vous vous loguez à un serveur du client eMBox, vous devez spécifier un numéro de port.
Si vous avez déjà indiqué un numéro de port lors de l'installation de eDirectory, utilisez ce numéro.
Les ports par défaut sont les suivants :
Les sections suivantes fournissent 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é d'adresse réseau d'un objet Serveur dans les outils suivants :
Recherchez les adresses qui commencent par http: ou https: et finissent par
" /portal ". Ce sont les ports non sécurisés et sécurisés utilisés par les outils eMBox.
Pour déterminer le numéro de port :
Par exemple, http://137.65.188.1:8008/portal signifie que le port 8008 est utilisé pour les outils eMBox.
Par exemple, https://137.65.188.1/portal n'affiche pas de numéro de port après l'adresse IP. Cela signifie que le numéro de portail sécurisé par défaut est utilisé pour les outils eMBox : 8009 sous NetWare, 8010 sur les autres plates-formes.
Vous pouvez utiliser la commande suivante pour afficher une liste de ports :
ndsconfig get | grep http
Recherchez les lignes qui contiennent http.server.interface suivi d'un numéro de port.
Vous pouvez également chercher le numéro de port dans iManager ou ConsoleOne, toujours en utilisant la méthode décrite dans Sous NetWare.