Pour une présentation des différents types de commandes et concepts associés, reportez-vous à Présentation des commandes et des paramètres de la CLI. Pour plus de détails concernant les paramètres utilisés par les commandes de base de la CLI, reportez-vous à Paramètres et indicateurs prédéfinis.
La liste suivante décrit les commandes de base de la CLI.
Description
La commande alias permet de créer un alias pour les commandes fréquemment utilisées ou celles qui sont associées à des paramètres compliqués. Un alias ne peut pas être identique au nom d'une commande de la CLI existante. Si une définition contient des blancs, ils doivent être mis entre guillemets anglo-saxons doubles (", caractère ASCII 0x22).
Quand l'utilisateur ferme une session de CLI, les alias qu'il a créés sont stockés dans un fichier qui se trouve dans le répertoire aliases. Ces alias seront ainsi de nouveau disponibles lors de la session de CLI suivante ouverte par l'utilisateur.
Syntaxe
alias [<pseudonyme>="commande [paramètres]"]
Exemples
> alias assign=set > alias alarmes="getAlarms severity=dwn" |
Si elle est appelée sans argument, la commande alias imprime la liste des alias définis et leur valeur respective. L'exemple suivant montre le résultat de la commande alias quand cette commande est appelée sans argument.
> alias assign - set alarmes - getAlarms severity=dwn |
La commande attrib extrait les attributs d'un objet topologique.
Syntaxe
attrib [groupe=nomGroupe [nom=nomAttribut] [-key]]
La commande browse active le mode d'exploration de la topologie.
Syntaxe
browse
Description
La commande cd permet de changer le chemin topologique courant. Si aucun chemin n'est spécifié, le chemin courant est défini comme domaine par défaut. Si un nombre (n) est spécifié, le chemin courant est défini comme étant le nième chemin enfant, comme indiqué par la commande list.
Syntaxe
cd [chemin|nombre]
Description
La commande clear supprime tous les paramètres définis au cours de la session courante. Cependant, cette commande ne supprime pas les paramètres définis à partir de la ligne de commande. Elle est similaire à la commande unset, mais ne requiert pas la spécification de noms de paramètres en tant qu'arguments.
Syntaxe
clear
La commande data affiche les informations détaillées relatives à un objet topologique. Si un nombre est spécifié (n), le chemin est défini comme étant le nième chemin enfant, comme indiqué par la commande list.
Syntaxe
data [chemin|nombre|-key]
La commande end désactive le mode d'exploration de la topologie.
Syntaxe
end
Description
La commande exit met fin à la connexion avec le serveur et ferme la session de CLI.
Syntaxe
exit [-onError]
Paramètre
onError
Le paramètre onError est utilisé pour mettre fin à la session de CLI si une exception survient pendant l'exécution de la commande précédente. Ce paramètre est uniquement utilisé en mode différé.
La commande exit et la commande quit sont identiques.
La commande goto lance une recherche sensible à la casse d'un chemin topologique correspondant au modèle et l'active. Si plusieurs chemins correspondent au modèle, l'utilisateur est invité à choisir celui à utiliser.
Syntaxe
goto <modèle>
Description
La commande help affiche des informations sur les commandes de la CLI et leurs paramètres. Les informations d'aide sont formatées pour être affichées sur un écran de terminal non-bitmap. Lorsque la commande help est exécutée sans argument, l'aide affiche une liste classée par ordre alphabétique et une brève description des commandes de CLI disponibles. Les commandes de base sont listées en premier suivies des commandes étendues. Lorsque la commande help est appelée avec le nom d'une commande de CLI comme argument, help affiche les informations spécifiques à cette commande. Appelée avec le paramètre about, la commande help affiche la version de Sun Management Center.
Syntaxe
help [<commande>|about]
Paramètres
commande et about.
Exemple
L'exemple suivant affiche l'aide pour la commande getAlarms.
> help getAlarms getAlarms [a=hôte[,hôte]+] [liste_filtre_alarmes] - Affiche les informations sur les alarmes d'un agent ou une listes d'agents en fonction d'un ensemble de conditions de filtrage. Si aucun agent n'est fourni, toutes les alarmes sont affichées. Toutes les conditions de filtrage sont liées par un "ET" logique pour l'obtention du résultat. Les conditions de filtrage spécifiées dans liste_filtre_alarmes peuvent être les : domain=domaine et/ou m=module[+instance] et/ou managed_object=obet_géré et/ou property=propriété et/ou property_instance=instance_propriété et/ou qualifier=qualificateur et/ou severity=[DIS,DWN,ERR,OFF,INF,IRR,WRN] et/ou state=[C,F,O] et/ou ack=[A,N] |
Description
La commande history répertorie ou exécute les commandes précédemment entrées au cours de la session de CLI. Si elle est appelée sans argument alors qu'un historique a précédemment été défini, toutes les commandes entrées plus tôt au cours de la session de CLI sont affichées. Si elle appelée avec un argument numérique alors qu'un historique a été précédemment défini, la commande correspondant à l'argument spécifié est exécutée.
Syntaxe
history [num]
Description
La commande kill met fin à toute commande en cours d'exécution en arrière-plan.
Syntaxe
kill
Description
La commande list affiche la liste des objets pour un chemin donné. Si un nombre (n) est spécifié, le chemin est défini comme étant le nième chemin enfant, comme indiqué par cette commande.
Syntaxe
list [chemin|nombre]
Description
La commande locate permet de rechercher tous les chemins topologiques correspondant au modèle spécifié. Le modèle est sensible à la casse.
Syntaxe
locate <modèle>
Description
La commande login établit une connexion avec un serveur Sun Management Center. Vous pouvez spécifier le paramètre serverHost et, en option, le paramètre serverPort comme arguments. Si aucun hôte n'est spécifié, vous êtes invité à en entrer un. Si aucun port n'est spécifié, le port 2099 est utilisé. La commande login vous demande également votre nom d'utilisateur et votre mot de passe.
Syntaxe
login [serverHost=hôte] [serverPort=numéroPort] [user=nomUtilisateur] [password=motDePasseUtilisateur]
Paramètres
serverHost, serverPort, user et password
Description
La commande logout met fin à votre connexion au serveur Sun Management Center, mais pas à votre session de CLI.
Syntaxe
logout
Description
La commande print dirige la sorite de la dernière commande étendue dans le format spécifié et sur la destination indiquée. Par défaut, print dirige cette sortie sur l'écran du terminal en texte clair. Si les paramètres append ou o sont définis, la sortie est dirigée sur le fichier spécifié par ces paramètres. La sortie n'apparaît pas à l'écran. Si le paramètre ncols n'est pas spécifié, le nombre de colonnes par défaut est fixé à 4.
La commande print n'est pas enregistrée dans l'historique des commandes.
Syntaxe
print [f=plain|xml|html] [style=table|list|<custom>] [columns= columnList] [ncols=num] [o=outputFile | append=appendFile]
Paramètres
f, style, columns, ncols, o et append
Description
La commande quit met fin à la connexion avec le serveur et ferme la session de CLI.
Il n'y a pas de différence entre les commandes quit et exit.
Syntaxe
quit
Description
La commande reset ramène les valeurs de tous les paramètres qui sont spécifiés sur la ligne de commande aux valeurs qui avaient été spécifiées au début de la session de CLI. Les paramètres qui ont été définis pendant la session mais pas sur la ligne de commande restent inchangés. Si le nom d'un paramètre spécifique est fourni en tant qu'argument à reset et que la valeur de ce paramètre avait été spécifiée sur la ligne de commande, la valeur de ce paramètre est ramenée à sa valeur d'origine. Sinon, la valeur de ce paramètre reste inchangée.
La commande reset n'est pas enregistrée dans l'historique des commande.
Syntaxe
reset [<paramètre>]*
Description
La commande set vous permet de spécifier ou d'afficher des valeurs de paramètres. Les paramètres dont les valeurs sont spécifiées avec la commande set sont des paramètres globaux de la session courante. Les commandes globales sont disponibles pour toutes les commandes pendant cette session. Si vous exécutez set sans argument, la valeur de tous les paramètres définis pendant la session courante s'affiche. Si vous exécutez set avec un paramètre spécifié sous la forme d'un argument, la valeur de ce paramètre s'affiche.
Syntaxe
set [<paramètre>[=valeur]]* [height=num] [history=num] [log=fichier] [logmode=detailed|commande|"from n"] [more=on|off] [prompt=invite]
Exemple
L'exemple suivant montre les trois variantes de cette commande.
> set height=10 > set height=10 > set height height=10 |
Description
La commande status affiche l'état de toute commande en cours d'exécution en arrière-plan.
Syntaxe
status
Description
La commande unalias supprime l'alias ou la liste d'alias qui avait été spécifiée en tant qu'argument.
Syntaxe
unalias [<pseudonyme>]*
Description
La commande unset supprime le(s) paramètre(s) spécifié(s) de la session courante.
Syntaxe
unset [<paramètre>]*
La commande unset n'est pas enregistrée dans l'historique des commandes.
Description
La commande where affiche le chemin topologique courant.
Syntaxe
where
Plusieurs types de commandes étendues disponibles dans la CLI sont décrits dans ces sections :
les commandes d'importation et d'exportation de topologie décrites dans Interface CLI d'importation et d'exportation
Il existe sept commandes étendues pour la gestion des modules.
Les paramètres suivants peuvent être utilisés par les commandes relatives aux modules. Pour plus d'informations concernant les paramètres a et m, reportez-vous à Paramètres et indicateurs prédéfinis.
Nom international du module
Texte descriptif du module
Liste des paramètres associés aux commandes relatives aux modules séparés par des virgules
Valeurs par défaut du module
Description
La commande disableModule désactive un ou plusieurs modules dans un ou plusieurs agents.
Syntaxe
disableModule a=hôte[:port][,hôte[:port]]* m=module[+instance][,module[+instance]]*
Paramètres
a et m
Description
La commande enableModule active un ou plusieurs modules dans un ou plusieurs agents.
Syntaxe
enableModule a=hôte[:port][,hôte[:port]]* m=module[+instance][,module[+instance]]*
Paramètres
a et m
Description
La commande getLoadedModules affiche la liste des modules chargés dans un ou plusieurs agents.
Syntaxe
getLoadedModules a=hôte[:port][,hôte[:port]]*
Paramètre
a
Description
La commande getModule obient des informations relatives à un module spécifique dans un ou plusieurs agents.
Syntaxe
getModule a=hôte[:port][,hôte[:port]]* m=module[+instance]
Paramètres
a et m
Description
La commande getModules obtient la liste de tous les modules disponibles pour un ou plusieurs agents.
Syntaxe
getModules a=hôte[:port][,hôte[:port]]*
Paramètre
a
Description
La commande loadModule charge un module dans un ou plusieurs agents.
Syntaxe
loadModule a=hôte[:port][,hôte[:port]]* m=module[+instance] [moduleName= nom] [moduleDesc=description] [moduleParams= key=valeur[,key=valeur]*] [-default]
Paramètres
a, m, moduleName, moduleDesc, moduleParams et -default.
Description
La commande unloadModule décharge un ou plusieurs modules d'un ou plusieurs agents.
Syntaxe
unloadModule a=hôte[:port][,hôte[:port]]* m=module[+instance][,module[+instance]]*
Paramètres
a et m
Si vous voulez savoir quels modules sont chargés sur un hôte dont le nom agentHost est paris, vous devez taper la commande qui suite à l'invite de la CLI :
> getLoadedModules a=paris |
Pour charger le module Lecteur de noyau sur l'hôte paris sur le port 1776, vous devez taper la commande suivante :
> loadModule a=paris:1776 m=Lecteur de noyau |
Il existe quatre commandes étendues pour la gestion des attributs des objets et les valeurs de ces attributs.
Les paramètres suivants peuvent être utilisés par les commandes relatives aux attributs des objets. Pour plus d'informations sur les paramètres a et m, reportez-vous à Paramètres et indicateurs prédéfinis.
La valeur du paramètre mgtObj correspond au nom de l'objet géré dont les attributs et les propriétés sont en cours de définition ou de récupération.
La valeur de property correspond au nom de la propriété dont les attributs et les valeurs sont en cours de définition ou de récupération.
La valeur de propInst correspond au nom de l'instance de la propriété dont les attributs et les valeurs sont en cours de définition ou de récupération.
La valeur de rowValues est une liste de couples nom-valeur séparés par des virgules. nom correspond au nom d'une colonne de la ligne. valeur est la valeur qui figure dans cette colonne.
La valeur du paramètre attribute est une liste de noms d'attributs séparés par des virgules qui associés à la propriété dont les attributs et les valeurs sont en cours de définition ou de récupération. Quand il est utilisé avec la commande setAttributes, tout nom d'attribut figurant dans le paramètre attribute doit être associé à une valeur correspondante dans le paramètre value.
La valeur du paramètre value est une liste de valeurs séparées par des virgules qui correspondent aux attributs spécifiés dans le paramètre attribute. Quand il est utilisé avec la commande setAttributes, ce paramètre doit comporter une valeur pour chacun des attributs spécifiés.
Vous pouvez définir ou récupérer des attributs d'objets et des valeurs d'attributs au moyen des commandes suivantes :
Description
La commande addRow ajoute une ligne comportant les valeurs spécifiées à une table.
Syntaxe
addRow a=hôte[:port][,hôte[:port]]* m=module[+instance] mgtObj=objetGéré [property=propriété] [propInst=instancePropriété] rowValues=name=valeur[,name=valeur]
Paramètres
a, m, mgtObj, property, propInst et rowValues.
Description
La commande delRow supprime une ligne et les valeurs spécifiées d'une table.
Syntaxe
delRow a=hôte[:port][,hôte[:port]]* m=module[+instance] mgtObj=objetGéré [property=propriété] [propInst=instancePropriété] rowValues=name=valeur[,name=valeur]
Paramètres
a, m, mgtObj, property, propInst et rowValues.
Description
La commande getAttributes récupère les informations pour une propriété ou récupère les attributs spécifiés d'un agent ou d'une liste d'agent.
Syntaxe
getAttributes a=hôte[:port][,hôte[:port]]* m=module[+instance] mgtObj=objetGéré property=propriété [propInst=instancePropriété] [attribute=attribut[,attribut]*]
Paramètres
a, m, mgtObj, property, propInst et attribute.
Description
La commande setAttributes définit une propriété ou des valeurs pour les attributs spécifiés dans un agent ou une liste d'agents.
Syntaxe
setAttributes a=hôte[:port][,hôte[:port]]* m=module[+instance] mgtObj=objetGéré property=propriété [propInst=instancePropriété] [attribute=attribut[,attribut]*] value=valeur[,valeur]*
Paramètres
a, m, mgtObj, property, propInst, attribute et value.
Il doit y avoir pour chaque attribut spécifié dans le paramètre attribute une valeur correspondante dans le paramètre value.
La commande suivante récupère tous les attributs pour la propriété size dans l'objet géré totalstats dans le module stats-agent sur le port 1161 et sur l'hôte haiku :
> getAttributes a=haiku:1161 m=stats-agent mgtObj=totalstats \ property=size |
La commande suivante définit l'attribut alarmlimits.error-gt à la valeur 2 dans la propriété size spécifiée à l'exemple précédent :
> setAttributes a=haiku:1161 m=stats-agent mgtObj=totalstats \ property=size attribute=alarmlimits.error-gt value=2 |
La commande suivante supprime la ligne spécifiée dans le paramètre rowValues de l'objet géré spécifié dans mgtObj:
> delRow a=haiku:1161 \ m=filemon mgtObj=filemonstats/filemonTable/filemonEntry \ rowValues="name=test,desc=this,filename=/etc/passwd" |
Il existe cinq commandes étendues permettant de gérer les alarmes.
Les paramètres suivants peuvent etre utilisés par les commandes étendues relatives aux alarmes. Pour plus d'informations sur les paramètres a et m, reportez-vous à Paramètres et indicateurs prédéfinis.
La valeur du paramètre ack est une liste de valeurs séparées par des virgules qui indiquent si les alarmes qui sont gérées ont été reconnues. Les valeurs autorisées pour le paramètre ack sont ACK (reconnue) et NOACK (non reconnue).
La valeur du paramètre command correspond à l'action en cas d'alarme à effectuer.
La valeur du paramètre domain correspond au nom du domaine Sun Management Center pour lequel les alarmes vont etre gérées. Si aucun domaine n'est spécifié, le Domaine par défaut est utilisé.
La valeur du paramètre mgtObj correspond au nom de l'objet géré pour lequel les alarmes vont être gérées.
La valeur du paramètre note est un texte de remarque relatif à la commande en cours d'exécution.
La valeur du paramètre property correspond au nom de la propriété pour laquelle les alarmes vont être gérées.
La valeur du paramètre propInst correspond au nom d'une instance de propriété spécifique pour laquelle les alarmes vont être gérées.
La valeur du paramètre qualifier correspond au nom du qualificateur qui est associé à la propriété gérée dont les alarmes vont être gérées.
La valeur du paramètre severity est une liste de valeurs de gravité séparées par des virgules pour les alarmes gérées. Les valeurs suivantes sont autorisées pour le paramètre severity :
La valeur du paramètre state est une liste de valeurs d'état séparées par des virgules pour les alarmes gérées. Les valeurs autorisées pour le paramètre state sont Open, Closed et Fixed.
Vous pouvez examiner les valeurs d'alarme et définir des actions en cas d'alarme au moyen des commandes suivantes :
Description
La commande ackAlarms reconnait les alarmes dans un agent ou une liste d'agents.
Syntaxe
ackAlarms a=hôte[:port][,hôte[:port]]* [domain=domaine] [m=module[+instance][mgtObj=objetGéré [property=propriété [propInst=instancePropriété] [qualifier=qualificateur]]]] [severity=DIS|DWN|ERR|INF|IRR|OFF|WRN] [state=OPEN|CLOSED|FIXED] [note=motif]
Paramètres
a, domain, m, mgtObj, property, propInst, qualifier, severity, state et note.
Si aucune valeur n'est spécifiée pour le paramètre state, la valeur Open est utilisée par défaut.
Description
La commande delAlarms supprime les alarmes d'un agent ou d'une liste d'agents.
Syntaxe
delAlarms a=hôte[:port][,hôte[:port]]* [domain=domaine] [m=module[+instance][mgtObj=objetGéré [property=propriété [propInst=instancePropriété] [qualifier=qualificateur]]]] [severity=DIS|DWN|ERR|INF|IRR|OFF|WRN] [state=OPEN|CLOSED|FIXED] [ack=ACK|NOACK] [note=motif]
Paramètres
a, domain, m, mgtObj, property, propInst, qualifier, severity, state, ack et note.
Si aucune valeur n'est spécifiée pour le paramètre state, la valeur Closed est utilisée par défaut.
Description
La commande getAlarms récupère des informations sur les alarmes pour un agent ou un ensemble d'agents.
Syntaxe
getAlarms a=hôte[:port][,hôte[:port]]* [domain=domaine] [m=module[+instance][mgtObj=objetGéré [property=propriété [propInst=instancePropriété] [qualifier=qualificateur]]]] [severity=DIS|DWN|ERR|INF|IRR|OFF|WRN] [state=OPEN|CLOSED|FIXED] [ack=ACK|NOACK]
Paramètres
a, domain, m, mgtObj, property, propInst, qualifier, severity, state et ack.
Si aucun paramètre n'est spécifié, getAlarms affiche toutes les informations relatives aux alarmes.
Description
La commande runAlarmAction exécute une action en cas d'alarme manuelle ou différée pour toutes les alarmes associées à un domaine d'un agent ou d'une liste d'agents.
Syntaxe
runAlarmAction a=hôte[:port][,hôte[:port]]* [domain=domaine] [m=module[+instance][mgtObj=objetGéré [property=propriété [propInst=instancePropriété] [qualifier=qualificateur]]]] [severity=DIS|DWN|ERR|INF|IRR|OFF|WRN] [state=OPEN|CLOSED|FIXED] [ack=ACK|NOACK]
Paramètres
a, domain, m, mgtObj, property, propInst, qualifier, severity, state et ack.
Description
La commande setAlarmAction définit une action en cas d'alarme manuelle ou différée pour toutes les alarmes associées à un domaine d'un agent ou d'une liste d'agents.
Syntaxe
setAlarmAction a=hôte[:port][,hôte[:port]]* command=commande [domain=domaine] [m=module[+instance][mgtObj=objetGéré [property=propriété [propInst=instancePropriété] [qualifier=qualificateur]]]] [severity=DIS|DWN|ERR|INF|IRR|OFF|WRN] [state=OPEN|CLOSED|FIXED] [ack=ACK|NOACK]
Paramètres
a, command, domain, m, mgtObj, property, propInst, qualifier, severity, state et ack.
La commande suivante récupère toutes les alarmes de gravité ERR ou DWN de l'hôte haiku :
> getAlarms a=haiku severity=ERR,DWN |
Il existe neuf commandes étendues pour la gestion de la topologie
Les paramètres suivants peuvent être utilisés par les commandes étendues relatives à la topologie. Pour plus d'informations sur les paramètres a et t, reportez-vous à Paramètres et indicateurs prédéfinis.
La valeur du paramètre agentPort correspond au numéro de port de l'agent. Si agentPort n'est pas spécifié, la valeur par défaut 161 est utilisée. Le paramètre agentPort est optionnel. Ce paramètre n'est spécifié que si le paramètre url n'est pas spécifié et si vous ne voulez pas utiliser le port par défaut.
La valeur du paramètre arch correspond à l'architecture de l'objet topologique.
La valeur du paramètre domain correspond au nom du domaine Sun Management Center que vous devez spécifier pour la commande setCurrentDomain.
La valeur du paramètre domainmode peut être follow ou ignore. Si sa valeur est follow, la commande import importe à la fois les informations sur le groupe et le domaine du fichier dans le domaine cible spécifié. Si sa valeur est ignore, la commande import ignore les informations relatives au domaine.
La valeur du paramètre family correspond à la famille d'objets de l'objet topologique. Si cette valeur n'est pas spécifiée, elle est obtenue automatiquement.
La valeur du paramètre filename correspond au nom du fichier. Ce paramètre est utilisé par les commande export et import pour l'exportation et l'importation des informations relatives à la topologie.
La valeur du paramètre fullDesc est un texte descriptif de l'entité ou du groupe en cours de création.
La valeur du paramètre isPolled peut être true ou false. Si sa valeur est true, l'entité interroge les informations d'état en fonction du type d'interrogation ( pollType). La valeur par défaut de ce paramètre est true.
La valeur du paramètre mode peut être append ou overwrite. Si sa valeur est append, la commande export ajoute les données relatives à la topologie à la fin du fichier. Si sa valeur est overwrite, la commande export écrase le fichier en remplaçant les données existantes par les nouvelles informations relatives à la topologie.
La valeur du paramètre nodemode peut être replace ou ignore. Si les données du fichier ne correspondent pas à celles du domaine, la valeur replace remplace les données du domaine par celles du fichier. La valeur ignore ignore tout défaut de concordance des données.
La valeur du paramètre pollType correspond au type d'interrogation pour cette entité. Les valeurs suivantes sont autorisées pour le paramètre pollType :
agroup – Identifie un groupe pour lequel un agent actif est installé et en cours d'exécution
ahost – Identifie un hôte sur lequel un agent actif est installé et en cours d'exécution.
amod – Identifie un module associé à un agent actif.
aprox – Identifie un agent qui exécute un module proxy SNMP.
dummy – Identifie un périphérique qui n'est pas contrôlé.
ping – Identifie un hôte à contrôler en utilisant la commande ICMP ping.
snmp – Identifie un hôte à contrôler en utilisant la commande SNMP ping.
La valeur du paramètre readInfo correspond au nom de la communauté de lecture SNMPv1 pour les objets interrogés via SNMP.
La valeur du paramètre targetHost correspond au nom de l'hôte cible.
La valeur du paramètre targetIP correspond à l'adresse IP de l'hôte cible.
La valeur du paramètre topoCfg correspond aux informations de configuration pour la représentation topologique de l'entité gérée.
La valeur du paramètre topoType correspond au type de représentation topologique d'une entité gérée.
La valeur du paramètre url correspond à l'URL de l'entité à interroger. La valeur du paramètre url peut être spécifiée dans les formats suivants :
ping://nom_hôte snmp://nom_hôte:port/oid/#.#.#.# snmp://nom_hôte:port/[mod,sym]/chemin
La valeur du paramètre validity correspond à la durée (en jours) de validité souhaitée pour les informations exportées relatives à la topologie. La valeur du paramètre validity peut être Unlimited, 7, 15, 30 ou 90.
La valeur du paramètre writeInfo correspond au nom de la communauté d'écriture SNMPv1 pour les objets interrogés via SNMP.
Il existe neuf commandes étendue pour la gestion de la topologie.
Description
La commande createEntity crée une entité gérée.
Syntaxe
createEntity t=topoObject pollType=ahost|amod|aprox|dummy|ping|snmp [fullDesc=text] [targetHost=host] [agentPort=port] [targetIp=ip] [family=family] [isPolled=true|false] [topoType=text] [topoCfg=text] [readInfo=text] [writeInfo=text] [url=url]
Paramètres
t, pollType, fullDesc, targetHost, agentPort, targetIp, family, isPolled, topoType, topoCfg, readInfo, writeInfo et url.
Si le paramètre url ou agentPort est spécifié, le port par défaut 161 n'est pas utilisé.
Description
La commande createGroup crée un domaine ou un groupe topologique.
Syntaxe
createGroup t=topoObject [family=base|building-view|campus-view|network-view|subnetwork-view] [fullDesc=desc]
Paramètres
t, family et fullDesc.
Si l'entité créée est un groupe, le paramètre family est obligatoire.
Si l'entité créée est un domaine, les paramètres family et fullDesc sont ignorés.
Description
La commande delTopoObject supprime un objet topologique géré dans la hiérarchie topologique gérée. Tous les objets se trouvant sous l'objet topologique mentionné sont également supprimés.
Syntaxe
delTopoObject t=objetTopo
Paramètre
t
Description
La commande export exporte les informations relatives à la topologie d'un ou plusieurs domaines dans un fichier.
Syntaxe
export filename=nomfichier domain=domaine|"All Domains" mode=append|overwrite validity=Unlimited|7|15|30|90 [comment=texte]
Paramètres
filename, domain, mode, validity et comment.
Description
La commande getAgentPort retourne un numéro de port de l'agent Sun Management Center s'exécutant sur l'hôte spécifié dans un domaine topologique. S'il y a plusieurs agents, une liste de numéros de ports est retournée.
Syntaxe
getAgentPort a=hôte[,hôte]* [t=objetTopo]
Paramètres
a et t.
Si le paramètre t n'est pas spécifié, le domaine par défaut est utilisé.
Description
La commande getAllTopoObjects retourne la liste de tous les objets gérés de la hiérarchie topologique gérée qui remplissent les conditions spécifiées par les paramètres arch, family ou pollType.
Syntaxe
getAllTopoObjects t=objetTopo [arch=os] [family=platform] [pollType=aview|ahost|amod|aprox|dummy|ping|snmp]
Paramètres
t, arch, family et pollType.
Description
La commande getCurrentDomain retourne le nom du domaine courant.
Syntaxe
getCurrentDomain
Paramètres
Aucune
Description
La commande getDomains retourne la liste de tous les domaines gérés dans le contexte serveur courant.
Syntaxe
getDomains
Paramètres
Aucune
Description
La commande getTopoObject retourne la liste des objets topologiques gérés directement sous l'objet topologique spécifié par le paramètre t qui remplissent les conditions spécifiées par les paramètres arch, family ou pollType.
Syntaxe
getTopoObject t=objetTopot [arch=os] [family=platform] [pollType=aview|ahost|amod|aprox|dummy|ping|snmp]
Paramètres
t, arch, family et pollType.
Description
La commande export importe les informations relatives à la topologie d'un fichier dans un domaine.
Syntaxe
import filename=nomfichier domainmode=follow|ignore nodemode=replace|ignore [domain=domaine]
Paramètres
filename, domainmode, nodemode et domain.
Description
La commande setCurrentDomain définit le domaine d'accueil à la valeur spécifiée pour le paramètre domain.
Syntaxe
setCurrentDomain domain=nomDomaine
Paramètre
domain
La commande suivante retourne la liste de tous les hôtes d'agents de Sun Management Center pour la famille sun4u du groupe building12 dans le domaine menlo_park qui utilisent SunOS 5.7 :
> getTopoObject t=/menlo_park/building12 pollType=ahost \ arch="SunOS 5.7" family=sun4u |
La commande suivante crée un groupe appelé building19 sous un domaine existant appelé test_siège :
> createGroup t=/test_siège/building19 \ fullDesc="test headquarters domain" family=building-location |
La commande suivante crée en entité gérée appelée monHôte dans le groupe building12 du domaine domaine_test. L'objet topologique est un hôte dont l'agent s'exécute sur le port 1161.
> createEntity t=/domaine_test/building12/monHôte \ fullDesc="mon hôte de test" family=ultra-2 topoType="" \ topoCfg="" isPolled=false pollType=ahost readInfo="" \ writeInfo="" targetHost=osftserv targetIp="" agentPort=1161 |