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 tout détail sur les paramètres a, columns, f et t, reportez-vous à Paramètres et indicateurs prédéfinis.

agentPort

La valeur du paramètre agentPort est le 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 le port par défaut.

arch

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

domain

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

family

La valeur du paramètre family est la famille d'objets de l'objet topologique.

fullDesc

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

isPolled

La valeur du paramètre isPolled peut être true ou false. Si sa valeur est true, l'entité procède aux interrogations sur les informations de statut selon le type d'interrogation ( pollType).

pollType

La valeur du paramètre pollType est le type d'interrogation pour cette entité. Les valeurs suivantes sont autorisées pour le paramètre pollType  :

• ahost – Identifie un hôte sur lequel un agent actif est installé et en cours d'exécution.

• amod – Identifie un module qui a un agent actif.

• aprox – Identifie un agent qui exécute un module proxy SNMP.

• dummy – Identifie un périphérique qui n'est pas surveillé.

• ping – Identifie un hôte à surveiller en utilisant la commande ICMP ping.

• snmp — Identifie un hôte à surveiller en utilisant la commande SNMP ping.

readInfo

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

targetHost

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

targetIp

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

topoCfg

La valeur du paramètre topoCfg est les informations de configuration pour la représentation topologique d'une entité gérée.

topoType

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

url

La valeur du paramètre url est 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

writeInfo

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

Commandes relatives à la topologie

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

createEntity

La commande createEntity crée une entité gérée. Les propriétés de l'entité gérée sont spécifiées avec les paramètres suivants : agentPort , arch, family, fullDesc, isPolled, pollType , readInfo, targetHost, targetIP, topoCfg, topoType , url, columns, f et t.

Si le paramètre url ou agentPort est spécifié, le port par défaut, 161, n'est pas utilisé.

createGroup

La commande createGroup crée un domaine ou un groupe topologique. Si l'entité créée est un groupe, les propriétés de ce groupe sont spécifiées avec les paramètres suivants : family et fullDesc. La commande createGroup accepte également les paramètres suivants : columns, f et t.

Si l'entité créée est un domaine, les paramètres family et fullDesc sont ignorés.

delTopoObjects

La commande delTopoObjects 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. La commande delTopoObjects accepte les paramètres suivants : columns, f et t.

getAgentPort

La commande getAgentPort retourne un numéro de port de l'agent de 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. La commande getAgentPort accepte les paramètres suivants : columns, f et t.

Si t n'est pas spécifié, le domaine par défaut est utilisé.

getAllTopoObjects

La commande getAllTopoObjects retourne la liste de tous les objets gérés de la hiérarchie topologique gérée qui réunissent certaines conditions spécifiées dans les paramètres arch, family ou pollType. La commande getAllTopoObjects accepte également les paramètres suivants : columns, f et t.

getCurrentDomain

La commande getCurrentDomain retourne le nom du domaine courant.

getDomains

La commande getDomains retourne la liste de tous les domaines gérés.

getTopoObject

La commande getTopoObject retourne la liste de tous les objets groupe/entité se trouvant directement sous l'objet topologique spécifié par le paramètre t qui satisfont les conditions spécifiées par le paramètre arch, family ou pollType. La commande getTopoObject accepte également les paramètres suivants : columns et f.

setCurrentDomain

La commande setCurrentDomain fixe le domaine d'accueil à la valeur spécifiée dans le paramètre domain.

Pour toute information sur l'exportation et l'importation des informations relatives à la topologie depuis l'ILC, reportez-vous à Interface ILC d'importation et d'exportation.

Exemples de commandes relatives à la topologie

La commande suivante retourne la liste de tous les hôtes d'agents de Sun Management Center sur la famille sun4u dans le groupe building12 dans le domaine menlo_park qui exécutent le logiciel SunOS 5.7 :

> getTopoObject t=/menlo_park/building12 pollType=ahost \
arch="SunOS 5.7" family=sun4u

La commande suivante crée un groupe nommé bâtiment19 sous un domaine existant appelé test_siège :

> createGroup t=/test_siège/bâtiment19 \
fullDesc="test du domaine siège" family=building-location

La commande suivante crée une entité gérée nommée monHôte dans le groupe bâtiment12 dans le domaine domaine_ test. L'objet topologique est un hôte Sun Ultra-2 où l'agent s'exécute sur le port 1161.

> createEntity t=/domaine_test/bâtiment12/monHôte \
fullDesc="mon hôte test" family=ultra-2 topoType="" \
topoCfg="" isPolled=false pollType=ahost readInfo="" \
writeInfo="" targetHost=osftserv targetIp="" agentPort=1161