Guide des commandes Cisco CSS Controller

Le présent chapitre explique comment utiliser les commandes ccocontrol pour Cisco CSS Controller :

Vous pouvez utiliser une version abrégée des paramètres de la commande ccocontrol en entrant simplement la ou les quelques lettres d'identification des paramètres. Ainsi, pour obtenir de l'aide sur la commande file save, vous pouvez entrer ccocontrol he f au lieu de ccocontrol help file.

Pour afficher l'invite de la commande de ccocontrol, entrez : ccocontrol.

Pour fermer l'interface de ligne de commande, entrez exit or quit.

Remarque :
Utilisez les lettres de l'anglais pour toutes les valeurs des paramètres des commandes. Les seules exceptions s'appliquent aux noms d'hôte (utilisés dans les commandes server) et aux noms de fichiers (utilisés dans les commandes file).

ccocontrol consultant — Configuration et contrôle d'un consultant

Lire le diagrammeSauter le diagramme>>-ccocontrol--consultant--+-add--IDcc--address--AdrIPcom--community--NomCommunauté-+-><
                           +-binarylog--IDcc+ID2cc...;;--+-report--------------+------+
                           |                           +-set--+-intervalle-+-+      |
                           |                           |      '-rétention--' |      |
                           |                           +-start---------------+      |
                           |                           '-stop----------------'      |
                           +-remove--IDcc+ID2cc...;;----------------------------------+
                           +-report--IDcc+ID2cc...;;----------------------------------+
                           +-set--+-loglevel--niveau---------------------+----------+
                           |      +-logsize--+-taille----+---------------+          |
                           |      |          '-unlimited-'               |          |
                           |      +-sensitivity--pourcentage pondération-+          |
                           |      '-sleeptime--sec-----------------------'          |
                           +-start--IDcc+ID2cc...;;-----------------------------------+
                           '-stop--IDcc+ID2cc...;;------------------------------------'
 

add
Ajoute un consultant de commutateur.
IDcc (ID du consultant du commutateur)
Chaîne définie par l'utilisateur, qui désigne le consultant.
address
Adresse IP à laquelle Cisco CSS Switch fournit des pondérations.
AdrIPCom (Adresse IP du commutateur)
Adresse IP du commutateur.
community
Nom utilisé dans SNMP pour établir et définir des communications avec Cisco CSS Switch.
NomCommunauté
Nom de communauté en lecture/écriture de Cisco CSS Switch.
binarylog
Contrôle la consignation binaire d'un consultant.
report
Rapports concernant les caractéristique de la consignation binaire.
set
Fixe l'intervalle, en secondes, entre chaque enregistrement d'informations dans les journaux binaires. L'option de consignation binaire permet d'enregistre dans des fichiers journaux binaires des informations concernant tous les services de la configuration. Les informations ne sont écrites dans les journaux que si l'intervalle de consignation indiqué a expiré depuis l'écriture du dernier enregistrement dans le journal. L'intervalle par défaut de consignation binaire est de 60 secondes.
intervalle
Intervalle, en secondes, entre chaque entrée dans le journal binaire.
rétention
Nombre d'heures pendant lesquelles les fichiers journaux binaires sont conservés.
start
Lance la consignation binaire.
stop
Arrête la consignation binaire.
remove
Supprime un consultant de commutateur.
report
Rapports concernant les caractéristique des consultants de commutateur.
set
Définit les caractéristique des consultants de commutateur.
loglevel
Définit le niveau auquel le consultant de commutateur consigne les activités. La valeur par défaut est 1.
niveau
Niveau compris entre 0 et 5. La valeur par défaut est 1. Les valeurs admises sont les suivantes :
  • 0 = Aucun
  • 1 = Minimal
  • 2 = De base
  • 3 = Modéré
  • 4 = Avancé
  • 5 = Prolixe
logsize
Nombre maximal d'octets consignés dans le journal. La valeur par défaut est 1 048 576. Lorsque vous attribuez une taille maximale au fichier journal, ce dernier fonctionne en boucle. Lorsque le fichier atteint la taille indiquée, les entrées suivantes sont écrites à partir du haut du fichier et remplacent les entrées existantes. La valeur indiquée par logsize ne peut pas être inférieure à la taille actuelle du fichier journal. Les entrées du journal sont horodatées, ce qui permet de déterminer l'ordre dans lequel elles ont été enregistrées. Plus le niveau de consignation est élevé, plus la taille du journal doit être choisie avec soin car l'espace peut être saturé rapidement.
taille
Nombre maximal d'octets consignés dans le journal du consultant. Vous pouvez indiquer un nombre positif supérieur à zéro, ou le mot unlimited. Il est possible que le fichier journal n'atteigne pas la taille maximale exacte avant le remplacement des entrées existantes, car la taille des entrées de journal elles-même varie.
sensitivity
Quantité de modifications requises entre la nouvelle et l'ancienne pondérations pour que la pondération soit changée. La différence entre la nouvelle et l'ancienne pondérations doit être supérieure au pourcentage de sensibilité afin que la pondération puisse changer. Les valeurs admises vont de 0 à 100, la valeur par défaut étant 5.
pourcentage de pondération
Nombre compris entre 1 et 100 correspondant à la sensibilité.
sleeptime
Nombre de secondes entre chaque cycle de définition des pondérations. Valeur par défaut : 7.
sec
Entier correspondant au nombre de secondes d'inactivité. Les valeurs admises vont de 0 à 2 147 460.
start
Lance la collecte de mesures et la définition de pondérations.
stop
Arrête la collecte de mesures et la définition de pondérations.

Exemples

ccocontrol controller — Gestion du contrôleur

Lire le diagrammeSauter le diagramme>>-ccocontrol--controller--+-report--------------------------+-><
                           '-set--+------------------------+-'
                                  +-loglevel--niveau-------+
                                  '-logsize--+-taille----+-'
                                             '-unlimited-'
 

report
Affiche les caractéristiques du contrôleur. Ce rapport affiche également les informations relatives à la version.
set
Définit les caractéristiques du contrôleur.
loglevel
Définit le niveau auquel le contrôleur consigne les activités. La valeur par défaut est 1.
niveau
Niveau compris entre 0 et 5. La valeur par défaut est 1. Les valeurs admises sont les suivantes :
  • 0 = Aucun
  • 1 = Minimal
  • 2 = De base
  • 3 = Modéré
  • 4 = Avancé
  • 5 = Prolixe
logsize
Nombre maximal d'octets consignés dans le journal. La valeur par défaut est 1 048 576. Lorsque vous attribuez une taille maximale au fichier journal, ce dernier fonctionne en boucle. Lorsque le fichier atteint la taille indiquée, les entrées suivantes sont écrites à partir du haut du fichier et remplacent les entrées existantes. La valeur indiquée par logsize ne peut pas être inférieure à la taille actuelle du fichier journal. Les entrées du journal sont horodatées, ce qui permet de déterminer l'ordre dans lequel elles ont été enregistrées. Plus le niveau de consignation est élevé, plus la taille du journal doit être choisie avec soin car l'espace peut être saturé rapidement.
taille | unlimited
Nombre maximal d'octets consignés dans le journal du consultant. Vous pouvez indiquer un nombre positif supérieur à zéro, ou le mot unlimited. Il est possible que le fichier journal n'atteigne pas la taille maximale exacte avant le remplacement des entrées existantes, car la taille des entrées de journal elles-même varie.

Exemples

ccocontrol file — Gestion des fichiers de configuration

Lire le diagrammeSauter le diagramme>>-ccocontrol--file--+-delete--nom_fichier----------+----------><
                     +-load--nom_fichier------------+
                     +-report-----------------------+
                     '-save--nom_fichier--+-------+-'
                                          '-force-'
 

delete
Supprimer le fichier de configuration indiqué.
nomfichier
Fichier de configuration. L'extension doit être .xml. Si cette extension n'est pas indiquée, elle est ajoutée par défaut.
load
Charge la configuration enregistrée dans le fichier indiqué.
Remarque :
Le chargement d'un fichier ajoute la configuration stockée dans ce fichier à la configuration en cours. Si vous voulez charger une nouvelle configuration, vous devez arrêter puis redémarrer le serveur avant de charger le fichier de la nouvelle configuration.
report
Liste des fichiers de configuration.
save
Sauvegarde la configuration en cours dans le fichier indiqué.
Remarque :
Les fichiers sont sauvegardés dans les répertoires suivants et chargés à partir de ces mêmes répertoires :
  • Systèmes AIX, HP-UX, Linux et Solaris : /opt/ibm/edge/lb/servers/configurations/cco
  • Systèmes Windows : <root_install>ibm\edge\lb\servers\configurations\cco
force
Sauvegarde dans un fichier existant.

Exemples

ccocontrol help — Affichage ou impression de l'aide relative à cette commande

Lire le diagrammeSauter le diagramme>>-ccocontrol--help--+-controller-------+----------------------><
                     +-consultant-------+
                     +-file-------------+
                     +-help-------------+
                     +-highavailability-+
                     +-metriccollector--+
                     +-ownercontent-----+
                     '-service----------'
 

Exemples

ccocontrol highavailability — Contrôle de la haute disponibilité

Lire le diagrammeSauter le diagramme>>-ccocontrol--highavailability--+-add--+-address--adresse-------------------+-+-><
                                 |      +-partneraddress--adresse_partenaire-+ |
                                 |      +-port--port-------------------------+ |
                                 |      '-role--+-principal--+---------------' |
                                 |              '-secondaire-'                 |
                                 +-dropreach--adresse--------------------------+
                                 +-remove--------------------------------------+
                                 +-report--------------------------------------+
                                 +-set--+-beatinterval--heure-----+------------+
                                 |      +-takeoverinterval--heure-+            |
                                 |      +-loglevel--niveau--------+            |
                                 |      '-logsize--+-taille----+--'            |
                                 |                 '-unlimited-'               |
                                 +-start--+-auto---+---------------------------+
                                 |        '-manuel-'                           |
                                 +-stop----------------------------------------+
                                 +-takeover------------------------------------+
                                 '-usereach--adresse---------------------------'
 

add
Configure un noeud de haute disponibilité, un partenaire et des cibles à contacter.
address
Adresse pour la réception des signaux de présence.
adresse
Adresse IP du noeud à haute disponibilité.
partneraddress
Adresse pour l'envoi des signaux de présence. Il s'agit de l'adresse IP ou du nom d'hôte configuré sur le noeud partenaire. Cette adresse permet de communiquer avec la machine haute disponibilité partenaire.
adresse
Adresse IP du partenaire.
port
Port utilisé pour communiquer avec le partenaire. La valeur par défaut est 12345.
port
Numéro du port.
role
Rôle de haute disponibilité.
principal | secondaire
Rôles principal et secondaire de haute disponibilité.
dropreach
Supprime cette cible à contacter des critères de haute disponibilité.
adresse
Adresse IP de la cible à contacter.
remove
Supprime le noeud, le partenaire et la cible à contacter de la configuration de haute disponibilité. Vous devez arrêter la haute disponibilité avant de lancer cette commande.
report
Affiche les informations de haute disponibilité.
set
Définit les caractéristiques de la haute disponibilité.
beatinterval
Définit l'intervalle, en millisecondes, au bout duquel les signaux de présence sont envoyés au partenaire. La valeur par défaut est 500.
heure
Entier positif correspondant à l'écart, en millisecondes, entre chaque signal de présence.
takeoverinterval
Définit la durée, en millisecondes, qui doit s'écouler (pendant laquelle aucun signal de présence n'est reçu) avant qu'une reprise ne se produise. La valeur par défaut est 2000.
heure
Entier positif correspondant à l'écart, en millisecondes, entre chaque reprise.
loglevel
Définit le niveau auquel les activités sont consignées. La valeur par défaut est 1.
niveau
Niveau compris entre 0 et 5. La valeur par défaut est 1. Les valeurs admises sont les suivantes :
  • 0 = Aucun
  • 1 = Minimal
  • 2 = De base
  • 3 = Modéré
  • 4 = Avancé
  • 5 = Prolixe
logsize
Nombre maximal d'octets consignés dans le journal de haute disponibilité. La valeur par défaut est 1 048 576. Lorsque vous attribuez une taille maximale au fichier journal, ce dernier fonctionne en boucle. Lorsque le fichier atteint la taille indiquée, les entrées suivantes sont écrites à partir du haut du fichier et remplacent les entrées existantes. La valeur indiquée par logsize ne peut pas être inférieure à la taille actuelle du fichier journal. Les entrées du journal sont horodatées, ce qui permet de déterminer l'ordre dans lequel elles ont été enregistrées. Plus le niveau de consignation est élevé, plus la taille du journal doit être choisie avec soin car l'espace peut être saturé rapidement.
taille | unlimited
Nombre maximal d'octets consignés dans le journal de haute disponibilité. Vous pouvez indiquer un nombre positif supérieur à zéro, ou le mot unlimited. Il est possible que le fichier journal n'atteigne pas la taille maximale exacte avant le remplacement des entrées existantes, car la taille des entrées de journal elles-même varie.
start
Active la haute disponibilité. Avant d'utiliser cette commande, vous devez configurer un noeud de haute disponibilité, un partenaire et une cible à contacter.
auto | manuel
Détermine si la haute disponibilité démarre avec une stratégie de reprise automatique ou manuelle.
stop
Arrête la haute disponibilité.
takeover
Reprend le contrôle au noeud de haute disponibilité actif.
usereach
Adresse de la cible à contacter qui commencer à utiliser la haute disponibilité. Ajoutez une cible à contacter à l'aide de ping de sorte que les partenaires de haute disponibilité puissent déterminer dans quelle mesure leurs cibles sont accessibles.
adresse
Adresse IP de la cible à contacter.

Exemples

ccocontrol metriccollector — Configuration du programme de collecte de mesures

Lire le diagrammeSauter le diagramme>>-ccocontrol--metriccollector--+-report--IDcc+ID2cc+...;;:mN+mN2...;;--------------------------+-><
                                '-set--IDcc+ID2cc+...;;:mN+mN2...;;--+-timeoutconnect--sec----+-'
                                                                 +-loglevel--niveau-------+
                                                                 +-logsize--+-taille----+-+
                                                                 |          '-unlimited-' |
                                                                 +-timeoutreceive--sec----+
                                                                 '-sleeptime--sec---------'
 

report
Affiche les caractéristiques du programme de collecte de mesures.
IDcc (ID du consultant du commutateur)
Chaîne définie par l'utilisateur, qui désigne le consultant.
Nm (nom de la mesure)
Nom qui identifie la mesure personnalisée ou fournie.
set
Définit les caractéristiques du programme de collecte de mesures.
timeoutconnect
Délai d'attente observé par le programme de collecte de mesures avant de signaler l'échec d'une connexion.
sec
Entier positif correspondant au nombre de secondes à l'expiration desquelles le programme de collecte de mesures signale qu'une connexion à un service a échoué.
loglevel
Définit le niveau auquel le consultant indiqué consigne les activités. Valeur par défaut : 1.
niveau
Numéro du niveau. La valeur par défaut est 1. Plus le numéro est élevé, plus la quantité d'informations consignée dans le journal du consultant est importante. Les valeurs admises sont les suivantes :
  • 0 = Aucun
  • 1 = Minimal
  • 2 = De base
  • 3 = Modéré
  • 4 = Avancé
  • 5 = Prolixe
logsize
Nombre maximal d'octets consignés dans le journal. La valeur par défaut est 1 048 576. Lorsque vous attribuez une taille maximale au fichier journal, ce dernier fonctionne en boucle. Lorsque le fichier atteint la taille indiquée, les entrées suivantes sont écrites à partir du haut du fichier et remplacent les entrées existantes. La valeur indiquée par logsize ne peut pas être inférieure à la taille actuelle du fichier journal. Les entrées du journal sont horodatées, ce qui permet de déterminer l'ordre dans lequel elles ont été enregistrées. Plus le niveau de consignation est élevé, plus la taille du journal doit être choisie avec soin car l'espace peut être saturé rapidement.
taille | unlimited
Nombre maximal d'octets consignés dans le journal du consultant. Vous pouvez indiquer un nombre positif supérieur à zéro, ou le mot unlimited. Il est possible que le fichier journal n'atteigne pas la taille maximale exacte avant le remplacement des entrées existantes, car la taille des entrées de journal elles-même varie.
timeoutreceive
Délai d'attente observé par un consultant avant de signaler l'échec d'une procédure de réception.
sec
Il s'agit d'un entier positif qui représente le délai en secondes à l'expiration duquel le consultant signale que la réception d'un envoi provenant d'un service a échoué.
sleeptime
Nombre de secondes d'inactivité du programme de collecte de mesures entre chaque cycle de collecte de mesures.
Entier positif correspondant au nombre de secondes d'inactivité.

Exemples

ccocontrol ownercontent — Contrôle du nom de propriétaire et de la règle de contenu

Lire le diagrammeSauter le diagramme>>-ccocontrol--ownerContent--+-add--IDcc:Ncp--ownername--Np--contentrule--Nc------------------------------+-><
                             +-metrics--IDcc+ID2cc...;;:Ncp+N2cp...;;--Nm--importance--Nm2--i2----------------+
                             +-refresh--IDcc+ID2cc...;;:Ncp+N2cp...;;-----------------------------------------+
                             +-remove--IDcc+ID2cc...;;:Ncp+N2cp...;;------------------------------------------+
                             +-report--IDcc+ID2cc...;;:Ncp+N2cp...;;------------------------------------------+
                             '-set--IDcc+ID2cc...;;:Ncp+N2cp...;;----metric--Nm--+------------------------+---'
                                                                             +-requeststring--chaîne--+
                                                                             +-responsestring--chaîne-+
                                                                             '-retry--nbrtentatives---'
 

add
Ajoute un contenu de propriétaire au consultant désigné.
IDcc (ID du consultant du commutateur)
Chaîne, définie par l'utilisateur, qui représente le consultant.
Nomcp (nom du contenu de propriétaire)
Chaîne, définie par l'utilisateur, qui représente le nom de propriétaire et la règle de contenu définis sur le commutateur.
ownername
Nom configuré sur le commutateur, qui identifie la configuration du propriétaire.
Np (nom du propriétaire)
Chaîne de texte unique ne contenant aucun espace. Le nom de propriétaire indiqué ici doit être identique à celui spécifié sur le commutateur Cisco.
contentrule
Nom configuré sur le commutateur, qui identifie la configuration de la règle de contenu du propriétaire.
Nc (nom du contenu)
Chaîne de texte unique ne contenant aucun espace. Le nom de contenu indiqué ici doit être identique à celui spécifié sur le commutateur Cisco.
metrics
Désigne l'ensemble des mesures utilisées pour calculer les pondérations et l'importance de chaque mesure. L'importance est exprimée en pourcentage du total. Par conséquent, la somme des valeurs d'importance doit toujours être égale à 100. Les mesures peuvent être toute combinaison de mesures de données de connexion, mesures de conseiller d'application et mesures de serveur de mesures. Par défaut il s'agit du nombre de connexions actives (activeconn) et du débit de la connexion (connrate) avec une importance équivalente de 50/50.
Nm (nom de la mesure)
Nom qui identifie le programme chargé de collecter les mesures afin de déterminer la pondération du serveur.

Voici la liste des noms de mesure admis et des ports qui leur sont associés.

Nom du conseiller Protocole Port
connexion ICMP 12345
db2 privé 50000
dns DNS 53
ftp FTP 21
http HTTP 80
https SSL 443
cachingproxy HTTP (via Caching Proxy) 80
imap IMAP 143
ldap LDAP 389
ldaps SSL 443
nntp NNTP 119
ping PING 0
pop3 POP3 110
sip SIP 5060
smtp SMTP 25
ssl SSL 443
telnet Telnet 23
WLM privé 10,007
activeconn n/a n/a
connrate n/a n/a
cpuload n/a n/a
memload n/a n/a
importance
Nombre compris entre 0 et 100 qui correspond à l'importance de la mesure dans le calcul des pondérations du serveur.
refresh
Actualise les services configurés avec la configuration issue de Cisco CSS Switch.
remove
Supprime un contenu de propriétaire.
report
Répertorie les caractéristiques des contenus de propriétaire.
set
Définit les caractéristiques des contenus de propriétaire.
metric
Définit les caractéristique d'une mesure.
Nm
Nom de la mesure souhaitée.
requeststring
Définit une chaîne de demande pour la mesure désignée. Cette chaîne correspond à la demande envoyée par un programme de collecte de mesures pour rassembler des informations de mesure.
chaîne
Chaîne de demande envoyée au serveur par le programme de collecte de mesures.
responsestring
Définit une chaîne de réponse pour la mesure désignée. Le programme de collecte de mesures utilise cette chaîne pour comparer les réponses qu'il reçoit des serveurs et déterminer ainsi la disponibilité du serveur.
chaîne
Chaîne de réponse à laquelle le programme de collecte de mesures compare les réponses reçues du serveur.
retry
Nombre de tentatives accordées avant qu'un serveur ne soit déclaré arrêté.
nbrtentatives
Entier supérieur ou égal à zéro. Il est préférable que le nombre de tentatives ne dépasse pas 3. Par défaut, le nombre de tentatives est égal à zéro.

Exemples

ccocontrol service — Configuration d'un service

Lire le diagrammeSauter le diagramme>>-ccocontrol--service--+-report--IDcc+ID2cc...;;:Ncp+N2cp...;;:svc+svc2...;;----------------------------------+-><
                        '---set--IDcc+ID2cc...;;:Ncp+N2cp...;;:svc+svc2...;;--+----------------------------+---'
                                                                        +-fixedweight--+-entier-+----+
                                                                        |              '-off----'    |
                                                                        +-requestsourceip--AdrIP-----+
                                                                        +-metricserveraddress--AdrIP-+
                                                                        '-metricserverport--Nport----'
 

report
Affiche les caractéristiques des services.
IDcc (ID du consultant du commutateur)
Chaîne, définie par l'utilisateur, qui représente le consultant.
Nomcp (nom du contenu de propriétaire)
Chaîne, définie par l'utilisateur, qui représente le nom de propriétaire et la règle de contenu définis sur le commutateur.
svc (service)
Chaîne, définie par l'utilisateur sur le commutateur, qui représente le service.
set
Définit les caractéristiques des services.
fixedweight
Affecte une pondération fixe au service. La valeur par défaut est off.
entier | off
Entier positif, compris entre 0 et 10, correspondant à la pondération fixe du service ou le mot off si aucune pondération fixe ne doit être définie.
requestsourceip
Définit l'adresse à partir de laquelle contacter le service pour les demandes d'application.
AdrIP (adresse IP)
Adresse IP à partir de laquelle le service doit être contacté, sous forme d'adresse symbolique ou d'adresse IP.
metricserveraddress
Définit l'adresse à partir de laquelle contacter le service pour les demandes de serveur de mesures.
AdrIP (adresse IP)
Adresse IP du serveur de mesures, sous forme d'adresse symbolique ou d'adresse IP.
metricserverport
Définit le port à utiliser pour contacter le serveur de mesures.
Nport (numéro de port)
Numéro du port utilisé pour contacter le serveur de mesures.

Exemples