Il est entre autres possible d'accéder à eMBox à l'aide de son client Java à ligne de commande. Ce client 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.
Ce client 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 pouvoir accéder derrière le pare-feu aux 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.
Cette section fournit les informations suivantes :
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 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 la section Options du client à ligne de commande eMBox.
Le mode interactif permet d'exécuter les commandes eMBox l'une après l'autre.
Cette section fournit les informations suivantes :
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 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 sous NetWare qui signifie « new screen » (« nouvel écran »). (Vous pouvez également entrer les informations manuellement, comme expliqué dans la section Configuration du chemin et du chemin de classe pour le client eMBox.)
L'utilisation du client à ligne de commande eMBox nécessite un accès derrière le pare-feu pour les serveurs que vous voulez gérer. 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 à la section Configuration 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 de Java ou du fichier eMBoxClient.jar, vous pouvez utiliser edirutil comme raccourci pour l'exécution. (Reportez-vous à la section 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 pour vous. Sur des serveurs Windows, Linux 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 se peut que vous deviez effectuer vous-même cette opération. 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 Linux ou Unix :
export CLASSPATH=chemin/eMBoxClient.jar
Pour procéder manuellement : un autre moyen de spécifier le chemin de classe consiste à utiliser le drapeau -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
WARNING: 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
WARNING: 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, consultez 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 8028 -u admin.ma_société
-w mon_mot_de_passe -n
Pour plus d'informations sur les numéros de port, reportez-vous à la section 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 son 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 des différents services eMTool. 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 aux sections suivantes :
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.
Dans 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 8028 -u admin.ma_société
-w mon_mot_de_passe -l monjournal.txt -t dsrepair.rld -n
WARNING: 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 8028 -u admin.ma_société -w mon_mot_de_passe -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 interne de traitement par lots. Pour plus d'informations, reportez-vous à la section suivante, Fichier interne de traitement par lots.
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écuteriez 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 internes de traitement par lots aident à organiser et à réutiliser les commandes fréquemment exécutées, ce qui évite de les entrer à chaque fois manuellement dans la ligne de commande.
Vous pouvez accéder à la ligne de commande et exécuter le fichier interne de traitement par lots à l'aide d'une commande du client eMBox. Par exemple, la commande suivante effectue le login à un serveur et exécute les commandes listées dans le fichier monlot.mbx :
java embox -s 137.65.123.244 -p 8028 -u admin.ma_société -w mon_mot_de_passe -l monjournal.txt -o -b monlot.mbx -n
WARNING: 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 8028 -u admin.ma_société -w mon_mot_de_passe -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 à la section Fichier système de traitement par lots.
Voici un exemple de fichier interne de traitement par lots eMBox. 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 de commandes utilisables dans
# un fichier interne de traitement par lots eMBox.
# 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 8028 -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 sur le schéma
dsschema.rst
dsschema.dse
dsschema.rls
dsschema.gsu
dsschema.scc
dsschema.irs -n Arborescence_Locale
# 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 dans 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 à la section 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 internes de traitement par lots 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 à la section Fichier interne de traitement par lots ci-dessus.
Pour des instructions sur l'exécution de fichiers de traitement par lots sans surveillance, consultez la documentation de votre système d'exploitation ou de votre logiciel de planification tiers.
NOTE: 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 sur le site du support technique de Novell.
| Option | Description |
|---|---|
-? ou -h |
Affiche l'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.ma_société. Valeur par défaut = anonymous (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 tente pas d'établir une connexion SSL sécurisée. Utilise 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 de classe. Pour plus d'informations, reportez-vous à la section É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.]options_ tâche |
Exécute un service unique avec cette connexion. La chaîne qui suit l'option -t doit être une commande eMBox valide. |
-b fichier_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 Novell eDirectory, 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 cette propriété 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:8028/portal signifie que le port 8028 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 à la section Sous NetWare.