Guide de l'utilisateur de Sun Management Center 3.6

Commandes étendues relatives à la topologie

Il existe neuf commandes étendues pour la gestion de la topologie

Paramètres des commandes relatives à 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.

agentPort

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.

arch

La valeur du paramètre arch correspond à l'architecture de l'objet topologique.

domain

La valeur du paramètre domain correspond au nom du domaine Sun Management Center que vous devez spécifier pour la commande setCurrentDomain.

domainmode

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.

family

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.

filename

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.

fullDesc

La valeur du paramètre fullDesc est un texte descriptif de l'entité ou du groupe en cours de création.

isPolled

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.

mode

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.

nodemode

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.

pollType

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.

readInfo

La valeur du paramètre readInfo correspond au nom de la communauté de lecture SNMPv1 pour les objets interrogés via SNMP.

targetHost

La valeur du paramètre targetHost correspond au nom de l'hôte cible.

targetIp

La valeur du paramètre targetIP correspond à l'adresse IP de l'hôte cible.

topoCfg

La valeur du paramètre topoCfg correspond aux informations de configuration pour la représentation topologique de l'entité gérée.

topoType

La valeur du paramètre topoType correspond au type de représentation topologique d'une entité gérée.

url

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
validity

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.

writeInfo

La valeur du paramètre writeInfo correspond au nom de la communauté d'écriture SNMPv1 pour les objets interrogés via SNMP.

Commandes relatives à la topologie

Il existe neuf commandes étendue pour la gestion de la topologie.

createEntity

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é.

createGroup

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.

delTopoObject

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

export

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.

getAgentPort

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é.

getAllTopoObjects

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.

getCurrentDomain

Description

La commande getCurrentDomain retourne le nom du domaine courant.

Syntaxe

getCurrentDomain

Paramètres

Aucune

getDomains

Description

La commande getDomains retourne la liste de tous les domaines gérés dans le contexte serveur courant.

Syntaxe

getDomains

Paramètres

Aucune

getTopoObject

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.

import

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.

setCurrentDomain

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

Exemples de commandes relatives à la topologie

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