sscontrol advisor

Mit dem Befehl sscontrol advisor steuern Sie den Advisor.

Syntax

Syntaxdiagramm lesenSyntaxdiagramm überspringen
>>-sscontrol--file--+-delete--Dateiname.Erweiterung------------------------+-><
                    +-appendload--Dateiname.Erweiterung--------------------+   
                    +-report-----------------------------------------------+   
                    +-save--Dateiname.Erweiterung--------------------------+   
                    +-logsize--Name--+-Port---------+--+-unlimited-------+-+   
                    |                '-Cluster@Port-'  '-Anzahl_Einträge-' |   
                    +-receivetimeout--Name--+-Port---------+--Sekunden-----+   
                    |                       '-Cluster@Port-'               |   
                    +-report--save--Dateiname.Erweiterung------------------+   
                    '-force--newload--Dateiname.Erweiterung----------------'   

Syntaxdiagramm lesenSyntaxdiagramm überspringen
>>-connecttimeout--Name--Port--Sitename@Port--Sekunden---------->

>--interval--Name--Port--Sitename@Port--Sekunden--list---------->

>--loglevel--Name--Port--Sitename@Port--Stufe--logsize--Name---->

>--Port--Sitename@Port--size | unlimited--Byte------------------>

>--receivetimeout--Name--Port--Sitename@Port--Sekunden---------->

>--report--Name--Port--Sitename@Port--retries--Name--Port------->

>--Sitename@Port--Anzahl_Wiederholungen--start--Name--Port------>

>--Sitename@Port--Protokolldatei--status--Name--Port------------>

>--Sitename@Port--stop--Name--Port--Sitename@Port--timeout------>

>--Name--Port--Sitename@Port--version--Name--Port--------------->

>--Sitename@Port--Sekunden-------------------------------------><

Parameter

connecttimeout
Definiert, wie lange ein Advisor wartet, bevor er meldet, dass zu einem bestimmten Port eines Servers (einem Service) keine Verbindung hergestellt werden kann. Weitere Informationen finden Sie im Artikel über das Verbindungszeitlimit und das Empfangszeitlimit des Advisors für Server.
  • Name

    Der Name des Advisors. Gültige Werte sind http, https, ftp, sip, ssl, smtp, imap, pop3, ldap, ldaps, nntp, telnet, connect, ping, WLM und WTE. Die Namen angepasster Advisor haben das Format xxxx, wobei ADV_xxxx der Name der Klasse ist, die den angepassten Advisor implementiert.

  • Port

    Die Nummer des Ports, der vom Advisor überwacht wird.

  • Sekunden

    Eine positive ganze Zahl, die das Zeitlimit in Sekunden angibt, nach dessen Ablauf der Advisor meldet, dass zu einem Server keine Verbindung hergestellt werden kann. Dieser Wert liegt standardmäßig beim Dreifachen des für das Advisorintervall angegebenen Wertes.

interval
Legt fest, wie oft der Advisor Informationen von den Servern abfragt.
  • Sekunden

    Eine positive ganze Zahl, die die Zeit zwischen den an die Server gerichteten Statusabfragen in Sekunden angibt. Der Standardwert ist 7.

list
Zeigt eine Liste der Advisor an, die derzeit Informationen an den Manager liefern.
loglevel
Legt die Protokollstufe für ein Advisorprotokoll fest.
  • Stufe
    Die Nummer der Stufe (0 bis 5). Der Standardwert ist 1. Je größer die Zahl ist, desto mehr Informationen werden in das Advisorprotokoll geschrieben. Gültige Werte:
    • 0 entspricht keiner Protokollierung
    • 1 entspricht einer minimalen Protokollierung
    • 2 entspricht einer Basisprotokollierung
    • 3 entspricht einer normalen Protokollierung
    • 4 entspricht einer erweiterten Protokollierung
    • 5 entspricht einer ausführlichen Protokollierung.
logsize
Legt die maximale Größe eines Advisorprotokolls fest. Wenn Sie eine maximale Größe für die Protokolldatei festlegen, wird die Datei wiederverwendet, d. h., wenn die Datei die angegebene Größe erreicht, werden alle weiteren Einträge wieder an den Anfang der Datei geschrieben und die dort befindlichen Einträge überschrieben. Die Protokollgröße kann nicht auf einen geringeren Wert als die aktuelle Dateigröße gesetzt werden. Protokolleinträge sind mit einer Zeitmarke versehen, damit Sie die Reihenfolge, in der sie geschrieben wurden, erkennen können. Je höher Sie die Protokollstufe setzen, desto vorsichtiger müssen Sie die Protokollgröße auswählen, da die Protokolldatei sehr schnell voll ist, wenn Sie eine Protokollierung auf einer höheren Stufe wählen.
  • Größe | unlimited

    Die maximale Größe der Advisorprotokolldatei in Bytes. Sie können entweder eine positive Zahl, die größer als 0 sein muss, oder unlimited (unbegrenzt) angeben. Da die Protokolleinträge unterschiedlich lang sind, wird mit dem Überschreiben von Einträgen unter Umständen schon vor Erreichen der exakten maximalen Größe begonnen. Der Standardwert ist 1 MB.

receivetimeout
Definiert, wie lange ein Advisor wartet, bevor er meldet, dass von einem bestimmten Port eines Servers (einem Service) keine Daten empfangen werden können.
  • Sekunden

    Eine positive ganze Zahl, die das Zeitlimit in Sekunden angibt, nach dessen Ablauf der Advisor meldet, dass von einem Server keine Daten empfangen werden können. Dieser Wert liegt standardmäßig beim Dreifachen des für das Advisorintervall angegebenen Wertes.

report
Anzeigen eines Berichts zum Advisorstatus.
retries
Legt die Wiederholungsversuche eines Advisors fest, bevor dieser einen Server als inaktiv markiert.
  • Anzahl_Wiederholungen

    Eine ganze Zahl größer als oder gleich null. Dieser Wert sollte nicht größer als 3 sein. Wenn das Schlüsselwort für Wiederholungen nicht konfiguriert ist, wird standardmäßig von null Wiederholungsversuchen ausgegangen.

start
Den Advisor starten. Für alle Protokolle stehen Advisor zur Verfügung. Folgende Standardports werden verwendet:
Tabelle 1. Standardports für Advisor
Advisorname Protokoll Port
connect nicht zutreffend benutzerdefiniert
db2 privat 50000
ftp FTP 21
http HTTP 80
https SSL 443
imap IMAP 143
ldap LDAP 389
nntp NNTP 119
ping PING nicht zutreffend
pop3 POP3 110
sip SIP 5060
smtp SMTP 25
ssl SSL 443
telnet Telnet 23
Name

Der Name des Advisors.

Sitename@Port

Der Wert Sitename ist in den Advisorbefehlen optional. Der Wert "Port" ist jedoch erforderlich. Wenn der Wert Sitename nicht angegeben ist, wird der Advisor für alle konfigurierten Sitenamen, die verfügbar sind, ausgeführt. Wenn Sie einen Sitenamen angeben, wird der Advisor nur für den angegebenen Sitenamen ausgeführt. Zusätzliche Sitenamen werden durch ein Pluszeichen (+) getrennt.

  • Protokolldatei

    Der Name der Datei, in die die Verwaltungsdaten geschrieben werden. Jeder Eintrag des Protokolls ist mit einer Zeitmarke versehen.

    Die Standarddatei ist Advisorname_Port.log, z. B. http_80.log. Wenn Sie das Verzeichnis ändern möchten, in dem die Protokolldateien gespeichert werden, lesen Sie die Informationen im Artikel über das Ändern der Protokolldateipfade.

    Sie können für jeden Sitenamen nur einen Advisor starten.

status
Zeigt den aktuellen Status aller Werte in einem Advisor an, die global gesetzt werden können. Zudem werden die Standardwerte dieser Werte angezeigt.
stop
Den Advisor stoppen.
Zeitlimit
Legt die Anzahl von Sekunden fest, in denen der Manager von dem Advisor erhaltene Informationen als gültig ansieht. Stellt der Manager fest, dass die Advisorinformationen älter als dieses Zeitlimit sind, verwendet der Manager diese Informationen nicht zum Festlegen der Wertigkeiten für die Server am Port, die vom Advisor überwacht werden. Dieses Zeitlimit gilt nicht, wenn der Advisor den Manager darüber informiert hat, dass ein bestimmter Server inaktiv ist. Der Manager verwendet diese Information über den Server auch nach Überschreitung des Informationszeitlimits für den Advisor weiter.
  • Sekunden

    Eine positive Zahl, die die Anzahl von Sekunden darstellt, oder das Wort "unlimited" (uneingeschränkt). Der Standardwert ist unlimited.

version
Zeigt die aktuelle Advisorversion an.

Beispiele

  • Festlegen der Zeit (30 Sekunden), nach deren Ablauf ein HTTP-Advisor (für Port 80) meldet, dass zu einem Server keine Verbindung hergestellt werden kann:
    sscontrol advisor connecttimeout http 80 30
  • Festlegen des Intervalls für den FTP-Advisor (für Port 21) auf 6 Sekunden:
    sscontrol advisor interval ftp 21 6
  • Anzeigen einer Liste der Advisor, die derzeit Informationen an den Manager liefern:
    sscontrol advisor list
    Dieser Befehl erzeugt eine Ausgabe ähnlich der folgenden:
    --------------------------------------- 
    | ADVISOR | SITENAME@PORT |  TIMEOUT  |
    ---------------------------------------
    |  http   |            80 | unlimited |
    |  ftp    |            21 | unlimited |
    --------------------------------------- 
  • Ändern der Protokollstufe für das Protokoll des Advisors http für den Sitenamen mysite in 0, um eine bessere Leistung zu erzielen:
    sscontrol advisor loglevel http mysite@80 0
  • Ändern der Protokollgröße für den Advisor ftp für den Sitenamen mysite in 5000 Byte:
    sscontrol advisor logsize ftp mysite@21 5000
  • Festlegen der Zeit (60 Sekunden), nach deren Ablauf der HTTP-Advisor (für Port meldet, dass von einem Server keine Daten empfangen werden können:
    sscontrol advisor receivetimeout http 80 60
  • Anzeigen eines Berichts zum Status des Advisors ftp (für Port 21):
    sscontrol advisor report ftp 21
    Dieser Befehl erzeugt eine Ausgabe ähnlich der folgenden:
    Advisorbericht:
    ---------------
    Advisorname .............. http
    Portnummer  .............. 80
    Sitename ................. mySite
    Serveradresse ............ 9.67.129.230
    Last ..................... 8
  • Starten des Advisors mit der Datei ftpadv.log:
    sscontrol advisor start ftp 21 ftpadv.log
  • Anzeigen des aktuellen Status der Werte, die dem Advisor http zugeordnet sind:
    sscontrol advisor status http 80
    Dieser Befehl erzeugt eine Ausgabe, die ungefähr wie folgt aussieht:
    Advisorstatus:
    ---------------
    Intervall (Sekunden) ............ 7
    Zeitlimit für Inaktivität (Sek.)..Unlimited
    Zeitlimit für Verbindungen (Sek.).21
    Zeitlimit für Empfang (Sek.) .....21
    Dateiname des Advisorprotokolls.. Http_80.log
    Protokollstufe .................. 1
    Max. Protokollgröße (Bytes) ..... Unlimited
    Anzahl der Wiederholungen ....... 0
  • Stoppen des Advisors http am Port 80:
    sscontrol advisor stop http 80
  • Festlegen eines Zeitlimits für Advisorinformationen von 5 Sekunden:
    sscontrol advisor timeout ftp 21 5
  • Ermitteln der aktuellen Versionsnummer für den Advisor ssl:
    sscontrol advisor version ssl 443
Reference topic    

Terms and conditions for information centers | Feedback

Last updated: May 30, 2013 07:18 AM EDT
File name: rcmd_sscontroladvisor.html