Befehlsreferenz für Site Selector
Dieses Kapitel beschreibt die Verwendung der folgenden sscontrol-Befehle für Site Selector:
Sie können eine Minimalversion der Parameter für den Befehl sscontrol eingeben.
Sie müssen nur die eindeutigen Buchstaben der Parameter
eingeben. Beispiel:
Wenn Sie Hilfe für den Befehl zum Speichern von Dateien aufrufen möchten,
können Sie sscontrol he f an Stelle
von sscontrol help file eingeben.
Anmerkung:
Die Werte der Befehlsparameter müssen in englischen Zeichen eingegeben werden. Die einzige Ausnahme hiervon bilden
Hostnamen (die in den Befehlen cluster und server verwendet werden)
und (die in Dateibefehlen verwendeten) Dateinamen.
sscontrol advisor — Advisor steuern

>>-sscontrol--advisor--+-connecttimeout--Name--+-Port----------+--Sekunden-------+-><
| '-Sitename:Port-' |
+-interval--Name--+-Port----------+--Sekunden-------------+
| '-Sitename:Port-' |
+-list----------------------------------------------------+
+-loglevel--Name--+-Port----------+--Stufe----------------+
| '-Sitename:Port-' |
+-logsize--Name--+-Port----------+--+-Größe | unlimited-+-+
| '-Sitename:Port-' '-Bytes-------------' |
+-receivetimeout--Name--+-Port----------+--Sekunden-------+
| '-Sitename:Port-' |
+-report--Name--+-Port----------+-------------------------+
| '-Sitename:Port-' |
+-retries--Name--+-Port----------+--Anzahl_Wiederholungen-+
| '-Sitename:Port-' |
+-start--Name--+-Port----------+--+----------------+------+
| '-Sitename:Port-' '-Protokolldatei-' |
+-status--Name--+-Port----------+-------------------------+
| '-Sitename:Port-' |
+-stop--Name--+-Port----------+---------------------------+
| '-Sitename:Port-' |
+-timeout--Name--+-Port----------+------------------------+
| '-Sitename:Port-' |
'-version--Name--+-Port----------+--Sekunden--------------'
'-Sitename:Port-'
- connecttimeout
- Definiert, wie lange ein Advisor wartet, bevor er meldet, dass zu einem
Server keine Verbindung hergestellt werden kann. Weitere Informationen hierzu finden Sie im Abschnitt Serververbindungs- und -empfangszeitlimit des Advisors.
- 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 der angepasste Advisor
implementiert.
- Port
- Die Nummer des Ports, der vom Advisor überwacht wird.
- Sekunden
- Eine positive ganze Zahl, die die Zeit in Sekunden angibt, nach deren 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 für die Protokolldatei eine maximale Größe festlegen, werden bei Erreichen
der Größe die vorherigen Protokolleinträ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 sorgfältiger 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
eines Server keine Daten empfangen werden können. Weitere Informationen hierzu finden Sie im Abschnitt Serververbindungs- und -empfangszeitlimit des Advisors.
- Sekunden
- Eine positive ganze Zahl, die die Zeit in Sekunden angibt, nach deren 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. Die Standardports sind:
Advisorname |
Protokoll |
Port |
connect |
nicht anwendbar |
benutzerdefiniert |
db2 |
private |
50000 |
ftp |
FTP |
21 |
http |
HTTP |
80 |
https |
SSL |
443 |
imap |
IMAP |
143 |
ldap |
LDAP |
389 |
ldaps |
SSL |
443 |
nntp |
NNTP |
119 |
PING |
PING |
nicht anwendbar |
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 advisor-Befehlen optional, der Wert "Port" jedoch erforderlich. Wird der Wert "Sitename" nicht angegeben, wird der Advisor für alle verfügbaren konfigurierten Sitenamen ausgeführt. Bei Angabe eines Sitenamens
wird der Advisor nur für den von Ihnen angegebenen Sitenamen ausgeführt. Zusätzliche Sitenamen werden durch ein
Pluszeichen (+) voneinander getrennt.
- Protokolldatei
- Der Name der Datei, in die die Verwaltungsdaten geschrieben werden.
Jeder Eintrag des Protokolls ist mit einer Zeitmarke
versehen.
Die Standarddatei ist Advisor-Name_Port.log, z. B. http_80.log. Informationen zum Ändern
des Verzeichnisses, in dem Protokolldateien gespeichert werden, finden Sie
im Abschnitt Pfade für die Protokolldatei ändern.
Sie können nur einen Advisor
pro Sitenamen starten.
- status
- Anzeigen des aktuellen Status sowie der Standardeinstellungen für alle globalen Werte eines
Advisors.
- stop
- Den Advisor stoppen.
- timeout
- Legt die Zeit in Sekunden fest,
in der der Manager vom Advisor
erhaltene Informationen als gültig ansieht. Stellt der Manager
fest, dass die Advisor-Informationen älter als dieses Zeitlimit
sind, verwendet der Manager diese Informationen nicht
zum Bestimmen von 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
Informationen über den Server auch nachdem die Advisor-Informationen das
Zeitlimit überschritten haben.
- Sekunden
- Eine positive Zahl, die die Sekunden angibt, oder unlimited. 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
Die Ausgabe dieses Befehls sieht etwa wie folgt aus:
---------------------------------------
| ADVISOR | SITENAME:PORT | ZEITLIMIT |
---------------------------------------
| http | 80 | unlimited |
| ftp | 21 | unlimited |
---------------------------------------
- Ändern der Protokollstufe für das Protokoll des Advisors http für den Sitenamen "meineSite" in 0, um
einen höheren Durchsatz zu erreichen:
sscontrol advisor loglevel http meineSite:80 0
- Ändern der Protokollgröße des Advisors ftp für den Sitenamen "meineSite" in 5000 Bytes:
sscontrol advisor logsize ftp mysite:21 5000
- Festlegen der Zeit (60 Sekunden), nach deren Ablauf
ein HTTP-Advisor (für Port 80)
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
Die Ausgabe dieses Befehls sieht etwa wie folgt aus:
Advisorbericht:
---------------
Advisor-Name ............. http
Portnummer .............. 80
Sitename ................. meineSite
Serveradresse ............ 9.67.129.230
Last ..................... 8
- Geben Sie den folgenden Befehl ein,
um den Advisor mit der
Datei ftpadv.log zu starten:
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:
Advisor-Status:
---------------
Intervall (Sekunden) .................... 7
Zeitlimit (Sekunden) .................... Unlimited
Zeitlimit für Verbindung (Sekunden) ..... 21
Zeitlimit für Empfang (Sekunden) ........ 21
Advisor-Protokolldateiname .............. Http_80.log
Protokollstufe .......................... 1
Maximale Managerprotokollgröße (Bytes)... Unlimited
Anzahl Wiederholungen ................... 0
- Stoppen des Advisors http am
Port 80:
sscontrol advisor stop http 80
- Festlegen eines Zeitlimits für Advisor-Informationen
von 5 Sekunden:
sscontrol advisor timeout ftp 21 5
- Ermitteln der aktuellen Versionsnummer für den Advisor
ssl:
sscontrol advisor version ssl 443
sscontrol file — Konfigurationsdateien verwalten

>>-sscontrol--file--+-delete--Dateiname.erw----------+---------><
+-appendload--Dateiname.erw------+
+-report-------------------------+
+-save--Dateiname.erw--+-------+-+
| '-force-' |
'-newload--Dateiname.erw---------'
- delete
- Die Datei löschen.
- Dateiname.erw
- Eine Konfigurationsdatei.
Die Dateierweiterung (.erw) ist optional und kann beliebig
gewählt werden.
- appendload
- Hinzufügen einer Konfigurationsdatei zur aktuellen Konfiguration und Laden der Datei in Site Selector.
- report
- Bericht über die verfügbare(n) Datei(en).
- save
- Sichern der aktuellen Konfiguration für Site Selector in der
Datei.
Anmerkung:
Dateien werden in den nachfolgend genannten Verzeichnissen gespeichert und aus diesen geladen:
- AIX, HP-UX, Linux und Solaris: /opt/ibm/edge/lb/servers/configurations/ss
- Windows: <Installationsstammverzeichnis>ibm\edge\lb\servers\configurations\Komponente
- force
- Wenn Sie Ihre Datei in einer vorhandenen Datei mit demselben Namen speichern möchten,
verwenden Sie force, um die vorhandene Datei vor dem Speichern der neuen Datei zu löschen. Bei Nichtverwendung
der Option force wird die vorhandene Datei nicht überschrieben.
- newload
- Laden einer neuen Konfigurationsdatei in Site Selector. Die neue
Konfigurationsdatei ersetzt die aktuelle Konfiguration.
Beispiele
- Löschen einer Datei:
sscontrol file delete Datei3
Datei (Datei3) wurde gelöscht.
- Laden einer neuen Konfigurationsdatei,
die die aktuelle Konfiguration ersetzt:
sscontrol file newload Datei1.sv
Datei (Datei1.sv) wurde in den Dispatcher geladen.
- Geben Sie den folgenden Befehl ein,
um eine Konfigurationsdatei an die aktuelle Konfiguration anzuhängen und
zu laden:
sscontrol file appendload Datei2.sv
Datei (Datei2.sv) wurde an die aktuelle Konfiguration angehängt und geladen.
- Anzeigen eines Berichts Ihrer
Dateien (der Dateien, die zuvor gesichert wurden):
sscontrol file report
DATEIBERICHT:
Datei1.save
Datei2.sv
Datei3
- Speichern der Konfiguration
in einer Datei mit dem Namen Datei3 zu sichern:
sscontrol file save Datei3
Die Konfiguration wurde in Datei (Datei3) gesichert.
sscontrol help — Hilfetext für diesen Befehl anzeigen oder drucken

>>-sscontrol--help--+-advisor----+-----------------------------><
+-file-------+
+-help-------+
+-host-------+
+-logstatus--+
+-manager----+
+-metric-----+
+-nameserver-+
+-rule-------+
+-server-----+
+-set--------+
+-sitename---+
'-status-----'
Beispiele
- Hilfetext zum Befehl sscontrol abrufen:
sscontrol help
Die Ausgabe dieses Befehls sieht etwa wie folgt aus:
ARGUMENTE BEFEHL HELP:
---------------------------------
Verwendung: help <Hilfeoption>
Beispiel: help name
help - vollständigen Hilfetext drucken
advisor - Hilfe zum Befehl advisor
file - Hilfe zum Befehl file
host - Hilfe zum Befehl host
manager - Hilfe zum Befehl manager
metric - Hilfe zum Befehl metric
sitename - Hilfe zum Befehl sitename
nameserver - Hilfe zum Befehl nameserver
rule - Hilfe zum Befehl rule
server - Hilfe zum Befehl server
set - Hilfe zum Befehl set
status - Hilfe zum Befehl status
logstatus - Hilfe zum Befehl logstatus
Parameter
innerhalb von < > sind Variablen.
- Manchmal enthält der Hilfetext Optionen für die Variablen, die durch das Zeichen | voneinander getrennt
sind:
logsize <Bytezahl | unlimited>
-Maximale Anzahl Bytes für Protokolldatei festlegen
sscontrol logstatus — Protokolleinstellungen des Servers anzeigen

>>-sscontrol--logstatus----------------------------------------><
- logstatus
- Zeigt die Einstellungen des Serverprotokolls (Name der Protokolldatei, Protokollstufe und -größe) an.
sscontrol manager — Manager steuern

>>-sscontrol--manager--+-interval--Sekunden---------------------+-><
+-loglevel--Stufe------------------------+
+-logsize--+-unlimited-+-----------------+
| '-Bytes-----' |
+-metric set--+-loglevel--Stufe--------+-+
| '-logsize--+-unlimited-+-' |
| '-Bytes-----' |
+-reach set--+-interval--Sekunden-----+--+
| +-loglevel--Stufe--------+ |
| '-logsize--+-unlimited-+-' |
| '-Bytes-----' |
+-report--Sitename+Sn2+...+SnN-----------+
+-restart--Nachricht---------------------+
+-sensitivity--Wertigkeit----------------+
+-smoothing--Glättungsfaktor-------------+
+-start--+----------------------------+--+
| '-Protokolldatei--Metrikport-' |
+-status---------------------------------+
+-stop-----------------------------------+
'-version--------------------------------'
- interval
- Legt fest, wie oft
der Manager die Wertigkeit der Server
aktualisiert.
- Sekunden
- Eine positive Zahl, die in Sekunden darstellt,
wie oft der Manager Wertigkeiten
aktualisiert. Der Standardwert ist 2.
- loglevel
- Legt die Protokollstufe für das Protokoll des Managers fest.
- Stufe
- Die Nummer der Stufe (0 bis 5). Je größer die Zahl, desto mehr Informationen werden in das
Managerprotokoll geschrieben. Der Standardwert ist 1. 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 des Protokolls des Managers
fest. Wenn Sie für die Protokolldatei eine maximale Größe festlegen, wird die Protokollierung bei Erreichen
der Größe am Anfang der Datei fortgesetzt, so dass die vorherigen Protokolleinträge überschrieben
werden. 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 sorgfältiger 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.
- Bytes
- Die maximale Größe in Bytes für die
Protokolldatei des Managers. 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.
- metric set
- Legt die Werte loglevel und logsize für das Metriküberwachungsprotokoll fest. Der Wert für loglevel ist die Stufe
für die Protokollierung der
Metriküberwachung (0 - keine Protokollierung, 2 - Basisprotokollierung, 3 -
moderate Protokollierung, 4 - erweiterte Protokollierung oder 5 - ausführliche Protokollierung).
Die Standardprotokollstufe ist 1. Der Wert für logsize ist die Datenmenge (in Bytes), die maximal in der Protokolldatei für Metriküberwachung
erfasst wird. Sie können entweder eine
positive Zahl, die größer als 0 sein muss,
oder unlimited (unbegrenzt) angeben. Die Standardprotokollgröße ist 1.
- reach set
- Legt das Intervall, die Protokollstufe und die Protokollgröße für den Advisor reach fest.
- report
- Zeigt eine statistische Momentaufnahme an.
- Sitename
- Der Sitename, der im Bericht angezeigt werden soll. Dies ist ein nicht auflösbarer Hostname, den
der Client abfragt. Der Sitename muss ein vollständig qualifizierter Domänenname
sein.
Anmerkung:
Zusätzliche Sitenamen werden durch ein
Pluszeichen (+) voneinander getrennt.
- restart
- Startet alle Server (die nicht inaktiv sind)
mit der Standardwertigkeit (1/2 der maximalen Wertigkeit).
- Nachricht
- Eine Nachricht, die in die Protokolldatei des
Managers gestellt werden soll.
- sensitivity
- Legt die Mindestsensitivität für die Aktualisierung
von Wertigkeiten fest. Diese Einstellung definiert,
wann der Manager seine Serverwertigkeit ausgehend von
externen Informationen ändern sollte.
- Wertigkeit
- Eine Zahl von 0 bis 100, die als
prozentuale Wertigkeit verwendet wird. Der Standardwert 5
bewirkt eine Mindestsensitivität von 5 %.
- smoothing
- Festlegen eines Faktors, der Wertigkeitsabweichungen während
des Lastausgleichs glättet.
Ein höherer Glättungsfaktor führt zu einer weniger drastischen Änderung
von Serverwertigkeiten bei Veränderten Netzwerkbedingungen. Ein geringerer
Glättungsfaktor führt zu einer drastischeren Änderung
der Serverwertigkeiten.
- Glättungsfaktor
- Eine positive Gleitkommazahl. Der Standardwert ist 1,5.
- start
- Den Manager starten.
- Protokolldatei
- Der Name der Datei, in der die Daten des Managers protokolliert
werden. Jeder Eintrag des Protokolls ist mit einer Zeitmarke
versehen.
Die Standarddatei
ist im Verzeichnis logs installiert. Weitere Informationen finden Sie in Anhang C. Beispielkonfigurationsdateien.
Wollen Sie das Verzeichnis
ändern, in dem die Protokolldateien gespeichert werden, lesen Sie die Informationen
im Abschnitt Pfade für die Protokolldatei ändern.
- Metrikport
- Der Port, an dem Metric Server Systemlasten meldet. Wenn
Sie einen Metrikport angeben, müssen Sie auch einen
Protokolldateinamen angeben. Der Standardmetrikport ist
10004.
- status
- Anzeigen des aktuellen Status sowie der Standardeinstellungen für alle globalen Werte des
Managers.
- stop
- Den Manager stoppen.
- version
- Zeigt die aktuelle Version des Managers an.
Beispiele
- Das Aktualisierungsintervall
für den Manager auf 5 Sekunden setzen:
sscontrol manager interval 5
- Die
Stufe der Protokollierung zwecks Verbesserung der Leistung
auf 0 setzen:
sscontrol manager loglevel 0
- Die Größe des Managerprotokolls
auf 1.000.000 Byte setzen:
sscontrol manager logsize 1000000
- Eine statistische Momentaufnahme
des Managers abrufen:
sscontrol manager report
Die Ausgabe dieses Befehls sieht etwa wie folgt aus:
----------------------------------
| SERVER | STATUS |
----------------------------------
| 9.67.129.221| AKTIV |
| 9.67.129.213| AKTIV |
| 9.67.134.223| AKTIV |
----------------------------------
--------------------------
|LEGENDE ZUM MANAGERBERICHT |
--------------------------
| CPU | CPU-Last |
| MEM | Speicherlast |
| SYS | Systemmetrik |
|JETZT | Aktuelle Gewichtung|
| NEU | Neue Gewichtung |
|GWT | Gewichtung |
--------------------------
------------------------------------------------------------------------
| meineSite | GWT | CPU 49 % | MEM 50 % | PORT 1 % | SYS 0 % |
------------------------------------------------------------------------
| |JETZT NEU |GWT LAST |GWT LAST |GWT LAST |GWT LAST |
------------------------------------------------------------------------
| 9.37.56.180 | 10 10 |-99 -1|-99 -1|-99 -1| 0 0|
------------------------------------------------------------------------
| SUMMEN:| 10 10 | -1| -1| -1| 0|
------------------------------------------------------------------------
-----------------------------------------
| ADVISOR | SITENAME:PORT | ZEITLIMIT |
-----------------------------------------
| http | 80 | unlimited |
-----------------------------------------
- Neustart aller Server mit Standardwertigkeit und Schreiben einer
Nachricht in die Managerprotokolldatei:
sscontrol manager restart Neustart des Managers für Codeaktualisierung
Die Ausgabe dieses Befehls sieht etwa wie folgt aus:
320-14:04:54 Neustart des Managers für Codeaktualisierung
- Festlegen der Sensitivität für Wertigkeitsänderungen auf 10:
sscontrol manager sensitivity 10
- Festlegen des
Glättungsfaktors auf 2,0:
sscontrol manager smoothing 2.0
- Geben Sie den folgenden
Befehl ein, um den Manager zu starten und die Protokolldatei
ndmgr.log anzugeben
(Pfade können nicht angegeben werden):
sscontrol manager start ndmgr.log
- Aktuellen Status der dem Manager zugeordneten
Werte anzeigen:
sscontrol manager status
Dieser
Befehl erzeugt eine Ausgabe, die ungefähr wie folgt
aussieht:
Managerstatus:
=============
Metrik-Port ............................................ 10004
Name der Managerprotokolldatei ......................... manager.log
Managerprotokollstufe .................................. 1
Max. Managerprotokollgröße (Bytes) ..................... unlimited
Sensitivitätsstufe ..................................... 5
Glättungsfaktor ........................................ 1,5
Aktualisierungsintervall (Sekunden) .................... 2
Gewichtungsaktualisierungszyklus ....................... 2
Erreichbarkeit - Protokollstufe ........................ 1
Erreichbarkeit - Max. Protokollgröße (Bytes) ........... unlimited
Erreichbarkeit - Aktualisierungsintervall (Sekunden) ... 7
- Stoppen des Managers:
sscontrol manager stop
- Anzeigen der
aktuellen Versionsnummer des Managers:
sscontrol manager version
sscontrol metric — Systemmetriken konfigurieren

>>-sscontrol--metric--+-add--Sitename+Sn2+...+SnN:Metrik+Metrik1+...+MetrikN--------------+-><
+-remove--Sitename+Sn2+...+SnN:Metrik+Metrik1+...+MetrikN-----------+
+-proportions--Sitename+Sn2+...+SnN:Proportion1 Prop2 Prop3...PropN-+
'-status--Sitename+Sn2+...+SnN Metrik+Metrik1+...+MetrikN-----------'
- add
- Hinzufügen der angegebenen Metrik.
- Sitename
- Der konfigurierte Sitename. Zusätzliche Sitenamen werden durch ein
Pluszeichen (+) voneinander getrennt.
- Metrik
- Name der Systemmetrik. Es muss sich um den Namen einer ausführbaren Datei oder Scriptdatei im Scriptverzeichnis
des Metric Server handeln.
- remove
- Entfernen der angegebenen Metrik.
- proportions
- Der Parameter proportions gibt die Gewichtung an,
die jeder Metrik verglichen mit anderen beigemessen wird, wenn
die Metriken kombiniert werden, um die Systemlast eines Servers zu ermitteln.
- status
- Anzeigen der aktuellen Serverwerte für diese Metrik.
Beispiele
- Hinzufügen einer Systemmetrik:
sscontrol metric add Site1:Metrik1
- Festlegen der Proportionen für einen Sitenamen mit zwei Systemmetriken:
sscontrol metric proportions Site1 0 100
- Anzeigen des aktuellen Status der zugeordneten Metriken:
sscontrol metric status Site1:Metrik1
Dieser
Befehl erzeugt eine Ausgabe, die ungefähr wie folgt aussieht:
Metrikstatus:
------------
Sitename ..................... Site1
Metrikname ................... Metrik1
Metrikproportion ............. 50
Server ......... 9.37.56.100
Metrikdaten .... -1
sscontrol nameserver — Namensserver steuern

>>-sscontrol--nameserver--+-start--+----------------------+-+--><
| '-bindaddress--Adresse-' |
+-stop----------------------------+
'-status--------------------------'
- start
- Starten des Namensservers.
- bindaddress
- Startet den Namensserver, der an die angegebene Adresse gebunden ist. Der Namensserver antwortet nur auf Anfragen, die an diese
Adresse gerichtet sind.
- Adresse
- Eine auf der Maschine mit Site Selector konfigurierte Adresse (IP-Adresse oder symbolischer Name).
- stop
- Stoppt den Namensserver.
- status
- Zeigt den Status des Namensservers an.
sscontrol rule — Regeln konfigurieren

>>-sscontrol--rule--+-add--Sitename+Sn2+...+SnN:Regel+R2+...+RN--Typ--Wert--| Wert |--| Optionen |-+-><
+-dropserver--Sitename+Sn2+...+SnN:Regel+R2+...+RN--Server+S2+...+SnN----------+
+-remove--Sitename+Sn2+...+SnN:Regel+R2+...+RN---------------------------------+
+-set--Sitename+Sn2+...+SnN:Regel+R2+...+RN--| Wert |--| Optionen |------------+
+-status--Sitename+Sn2+...+SnN:Regel+R2+...+RN---------------------------------+
'-useserver--Sitename+Sn2+...+SnN:Regel+R2+...+RN--Server+S2+...+SnN-----------'
Optionen:
|--+----------------------------------------------------+-------|
+-beginrange--Bereichsanfang--endrange--Bereichsende-+
+-priority--Wert-------------------------------------+
'-metricname--Wert-----------------------------------'
- add
- Diese Regel zu einem Sitenamen hinzufügen.
- Sitename
- Ein nicht auflösbarer Hostname, den
der Client abfragt. Der Sitename muss ein vollständig qualifizierter Domänenname
sein. Zusätzliche Sitenamen werden durch ein
Pluszeichen (+) voneinander getrennt.
- Regel
- Der für die Regel ausgewählte Name.
Dieser Name kann eine beliebige Kombination aus alphanumerischen Zeichen, Unterstreichungszeichen,
Silbentrennungsstrichen und Punkten sein. Der Name kann 1 bis 20
Zeichen lang sein und darf keine Leerzeichen enthalten.
Anmerkung:
Zusätzliche Regeln werden durch ein
Pluszeichen (+) voneinander getrennt.
- Typ
- Der Regeltyp.
- Typ
- Die Auswahlmöglichkeiten für Typ sind:
- ip
- Die Regel basiert auf der Client-IP-Adresse.
- metricall
- Die Regel basiert auf dem aktuellen Metrikwert für alle Server der Gruppe.
- metricavg
- Die Regel basiert auf dem Durchschnitt der aktuellen Metriken für alle Server der Gruppe.
- time
- Die Regel basiert auf der Uhrzeit.
- true
- Diese Regel ist immer wahr. Sie kann mit der Anweisung ELSE in der
Programmierlogik verglichen werden.
- beginrange
- Der untere Wert des Bereichs, mit dem bestimmt wird, ob die Regel wahr ist
oder nicht.
- Bereichsanfang
- Hängt von der Art der Regel ab. Die Art des Werts und der Standardwert werden
nachfolgend nach der Art der Regel aufgelistet:
- ip
- Die Adresse des Clients als symbolischer Name oder
im IP-Adressenformat. Der Standardwert ist 0.0.0.0.
- time
- Eine ganze Zahl. Der Standardwert ist 0. Er stellt Mitternacht dar.
- metricall
- Eine ganze Zahl. Der Standardwert ist 100.
- metricavg
- Eine ganze Zahl. Der Standardwert ist 100.
- endrange
- Der obere Wert des Bereichs, mit dem bestimmt wird, ob die Regel wahr ist
oder nicht.
- Bereichsende
- Hängt von der Art der Regel ab. Die Art des Werts und der Standardwert werden
nachfolgend nach der Art der Regel aufgelistet:
- ip
- Die Adresse des Clients als symbolischer Name oder
im IP-Adressenformat. Der Standardwert ist 255.255.255.254.
- time
- Eine ganze Zahl. Der Standardwert ist 24. Er stellt Mitternacht dar.
Anmerkung:
Beim Definieren des Bereichsanfangs (beginrange) und Bereichsendes
(endrange) der Zeitintervalle ist darauf zu achten, dass jeder Wert eine
ganze Zahl sein muss, die nur den Stundenteil der Uhrzeit darstellt. Es werden keine
Teilwerte einer Stunde angegeben. Soll beispielsweise die
Stunde von 3 Uhr bis 4 Uhr angegeben werden, geben Sie für
beginrange 3 und für endrange ebenfalls 3 an. Damit werden alle Minuten von 3 Uhr bis
3 Uhr 59 angegeben. Wird für beginrange 3 und für
endrange 4 angegeben, wird die zweistündige Periode von
3 Uhr bis 4 Uhr 59 angegeben.
- metricall
- Eine ganze Zahl. Der Standardwert ist 2 hoch 32 minus 1.
- metricavg
- Eine ganze Zahl. Der Standardwert ist 2 hoch 32 minus 1.
- priority
- Die Reihenfolge, in der die Regeln überprüft werden.
- Stufe
- Eine ganze Zahl. Wenn Sie für die erste Regel, die Sie hinzufügen, keine Priorität angeben, setzt
Site Selector die Priorität standardmäßig auf 1. Wird eine weitere Regel hinzugefügt, wird deren Priorität standardmäßig
mit der folgenden Formel errechnet: 10 + derzeit niedrigste Priorität für alle vorhandenen Regeln. Beispiel:
Sie haben eine Regel mit der Priorität 30.
Sie fügen nun eine neue Regel hinzu und setzen deren Priorität auf
25 (also auf eine höhere Priorität als 30). Anschließend fügen Sie eine
dritte Regel ohne Angabe einer Priorität hinzu. Als Priorität der dritten Regel wird
40 ermittelt (30 + 10).
- metricname
- Name der für eine Regel gemessenen Metrik.
- dropserver
- Einen Server aus einem Regelsatz entfernen.
- Server
- Die IP-Adresse der TCP-Servermaschine als symbolischer Name
oder im IP-Adressenformat.
Anmerkung:
Zusätzliche Sitenamen werden durch ein
Pluszeichen (+) voneinander getrennt.
- remove
- Eine oder mehrere Regeln, die durch Pluszeichen voneinander getrennt
sind, entfernen.
- set
- Werte für diese Regel festlegen.
- status
- Anzeigen aller Werte für eine oder mehrere Regel(n).
- useserver
- Server in einen Regelsatz einfügen.
Beispiele
- Hinzufügen einer Regel, die immer wahr ist, ohne Angabe von Bereichsanfang oder -ende:
sscontrol rule add Sitename:Regelname type true priority 100
- Erstellen einer Regel, die den Zugriff auf einen Bereich von IP-Adressen unterbindet, der in diesem Fall mit
“9” beginnt:
sscontrol rule add Sitename:Regelname type ip b 9.0.0.0 e 9.255.255.255
- Soll eine Regel erstellt werden, die die Verwendung eines bestimmten Servers
in der Zeit von 11 Uhr bis 15 Uhr angibt, geben Sie den folgenden Befehl ein:
sscontrol rule add Sitename:Regelname type time beginrange 11 endrange 14
sscontrol rule useserver Sitename:Regelname Server05
sscontrol server — Server konfigurieren

>>-sscontrol--server--+-add--Sitename+Sn2+...+SnN:Server+S2+...+SN--+------------------------+-+-><
| +-metricaddress--Adresse-+ |
| '-weight--Wert-----------' |
+-down--Sitename+Sn2+...+SnN:Server+S2+...+SN----------------------------+
+-remove--Sitename+Sn2+...+SnN:Server+S2+...+SN--------------------------+
+-set--Sitename+Sn2+...+SnN:Server+S2+...+SN--+------------------------+-+
| +-metricaddress--Adresse-+ |
| '-weight--Wert-----------' |
+-status--Sitename+Sn2+...+SnN:Server+S2+...+SN--------------------------+
'-up--Sitename+Sn2+...+SnN:Server+S2+...+SN------------------------------'
- add
- Diesen Server hinzufügen.
- Sitename
- Ein nicht auflösbarer Hostname, den
der Client abfragt. Der Sitename muss ein vollständig qualifizierter Domänenname
sein. Zusätzliche Sitenamen werden durch ein
Pluszeichen (+) voneinander getrennt.
- Server
- Die IP-Adresse der TCP-Servermaschine als symbolischer Name
oder im IP-Adressenformat.
Anmerkung:
Zusätzliche Server werden durch ein
Pluszeichen (+) voneinander getrennt.
- metricaddress
- Die Adresse des Metric-Servers.
- Adresse
- Die Adresse des Servers als symbolischer Name oder
im IP-Adressenformat.
- weight
- Eine Zahl von 0 bis 100 (die den Wert für die Wertigkeitsobergrenze des
angegebenen Sitenamens nicht überschreiten
darf) zur Angabe der Gewichtung dieses Servers. Wird die Wertigkeit auf 0 gesetzt, werden keine neuen
Anforderungen an den Server gesendet. Der Standardwert ist die Hälfte des angegebenen Maximalwerts für die
Gewichtungsgrenze des Sitenamens.
Ist der
Manager aktiv, wird diese Einstellung schnell überschrieben.
- Wert
- Die Wertigkeit des Servers.
- down
- Diesen Server als inaktiv markieren. Dieser Befehl verhindert, das weitere Anforderungen an
diesen Server übergeben werden.
- remove
- Diesen Server entfernen.
- set
- Werte für diesen Server festlegen.
- status
- Status der Server anzeigen.
- up
- Diesen Server als aktiv markieren. Site Selector übergibt neue Anforderungen an
diesen Server.
Beispiele
- Hinzufügen des Servers 27.65.89.42 zum Sitenamen Site1:
sscontrol
server add Site1:27.65.89.42
- Den
Server an 27.65.89.42 als inaktiv (down) markieren:
sscontrol server down Site1:27.65.89.42
- Den Server 27.65.89.42 für alle Sitenamen entfernen:
sscontrol server remove :27.65.89.42
- Den
Server an 27.65.89.42 als aktiv (up) zu markieren:
sscontrol server up Site1:27.65.89.42
sscontrol set — Serverprotokoll konfigurieren

>>-sscontrol--set--+-loglevel--Stufe--------+------------------><
'-logsize--+-unlimited-+-'
'-Größe-----'
- loglevel
- Die Stufe für die Protokollierung von ssserver-Aktivitäten.
- Stufe
- Der Standardwert für loglevel ist 0. Gültige
Werte sind:
- 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
- Die maximale Anzahl von Byte, die in der
Protokolldatei protokolliert werden können.
- Größe
- Der Standardwert für logsize ist 1 MB.
sscontrol sitename — Sitenamen konfigurieren

>>-sscontrol--sitename--+-add--Sitename+Sn2+...+SnN--+------------------------------------------+-+-><
| +-cachelife--Wert--------------------------+ |
| +-networkproximity--yes | no---------------+ |
| +-proportions--CPU--Speicher--Port--Metrik-+ |
| +-proximitypercentage--Wert----------------+ |
| +-stickytime--Zeit-------------------------+ |
| +-ttl--Zeit--------------------------------+ |
| +-waitforallresponses--yes | no------------+ |
| '-weightbound--Wertigkeit------------------' |
+-remove--Sitename+Sn2+...+SnN--------------------------------------------+
+-set--Sitename+Sn2+...+SnN--+------------------------------------------+-+
| +-cachelife--Wert--------------------------+ |
| +-networkproximity--yes | no---------------+ |
| +-proportions--CPU--Speicher--Port--Metrik-+ |
| +-proximitypercentage--Wert----------------+ |
| +-stickytime--Zeit-------------------------+ |
| +-ttl--Zeit--------------------------------+ |
| +-waitforallresponses--yes | no------------+ |
| '-weightbound--Wertigkeit------------------' |
'-status--Sitename+Sn2+...+SnN--------------------------------------------'
- add
- Hinzufügen eines neuen Sitenamens.
- Sitename
- Ein nicht auflösbarer Hostname, der vom Client angefragt wird. Zusätzliche Sitenamen werden durch ein
Pluszeichen (+) voneinander getrennt.
- cachelife
- Die Zeitperiode, während der eine Proximitätsantwort gültig und im Cache gespeichert ist.
Der Standardwert ist 1800. Weitere Informationen hierzu finden Sie im Abschnitt Netzproximität verwenden.
- Wert
- Eine positive Zahl, die angibt, wie viele Sekunden eine Proximitätsantwort gültig ist
und im Cache gespeichert wird.
- networkproximity
- Legt die Netzproximität des Servers zum anfordernden Client fest.
Verwenden Sie diese Proximitätsantwort bei der Lastausgleichsentscheidung.
Die Proximität ist "Ein" oder "Aus". Weitere Informationen hierzu finden Sie im Abschnitt Netzproximität verwenden.
- Wert
- Zur Auswahl stehen yes oder no. Der Standardwert no bedeutet, dass die Netzproximität inaktiviert ist.
- proportions
- Festlegen der proportionalen Gewichtung
von CPU, Speicher, Port (Advisor-Informationen)
und Systemmetriken für den Metric Server. Anhand dieser Proportionen legt der Manager
die Serverwertigkeiten fest. Jeder dieser Werte wird als Prozentsatz der Summe
angegeben, die immer bei 100 liegt.
- CPU
- Prozentsatz der auf jeder am Lastausgleich beteiligten Servermaschine genutzten CPU
(Vorgabe vom Agenten Metric Server).
- Speicher
- Prozentsatz des auf jeder am Lastausgleich beteiligten Servermaschine genutzten Speichers
(Vorgabe vom Agenten Metric Server).
- Port
- Vorgaben von den am Port empfangsbereiten Advisor.
- Metrik
- Vorgaben von Metric Server.
- proximitypercentage
- Legt die Gewichtung
der Proximitätsantwort gemessen am Status des Servers (Wertigkeit vom Manager) fest.
Weitere Informationen hierzu finden Sie im Abschnitt Netzproximität verwenden.
- Wert
- Der Standardwert ist 50.
- stickytime
- Das Intervall, in dem ein Client dieselbe Server-ID empfängt, die zuvor auf die erste Anfrage
zurückgegeben wurde. Der Standardwert für stickytime ist 0 und bedeutet,
dass für den Sitenamen keine Haltezeit gilt.
- Zeit
- Eine positive Zahl ungleich null, die die Zeit in Sekunden angibt, in der der Client dieselbe Server-ID
empfängt, die zuvor auf die erste Anfrage zurückgegeben wurde.
- ttl
- Legt die Lebensdauer fest. Dieser Parameter gibt an, wie lange ein anderer Namensserver
die aufgelöste Antwort zwischenspeichert. Der Standardwert ist 5.
- Wert
- Eine positive Zahl, die angibt, wie viele Sekunden der Namensserver die aufgelöste Antwort
zwischenspeichert.
- waitforallresponses
- Legt fest, ob vor der Beantwortung der Clientanforderungen
auf alle Proximitätsantworten der Server
gewartet werden soll. Weitere Informationen hierzu finden Sie im Abschnitt Netzproximität verwenden.
- Wert
- Zur Auswahl stehen yes oder no. Der Standardwert ist yes.
- weightbound
- Eine Zahl, die die maximale Wertigkeit angibt, die für Server dieser Site festgelegt werden kann. Der für den Sitenamen
festgelegte weightbound-Wert kann mit
server weight für einzelne Server überschrieben werden.
Der Standardwert für sitename weightbound ist 20.
- Wertigkeit
- Die Wertigkeitsgrenze.
- set
- Festlegen der Eigenschaften für den Sitenamen.
- remove
- Entfernen dieses Sitenamens.
- status
- Anzeigen des aktuellen Status für einen bestimmten Sitenamen.
Beispiele
- Hinzufügen eines Sitenamens:
sscontrol sitename add 130.40.52.153
- Aktivieren der Netzproximität:
sscontrol sitename set meineSite networkproximity yes
- Festlegen einer Caching-Zeit von 1900000 Sekunden:
sscontrol sitename set meineSite cachelife 1900000
- Festlegen eines Proximitätsprozentsatzes von 45:
sscontrol sitename set meineSeite proximitypercentage 45
- Festlegen, dass ein Sitename nicht auf alle Antworten warten soll, bevor er antwortet:
sscontrol
sitename set meineSite waitforallresponses no
- Festlegen einer Lebensdauer von 7 Sekunden:
sscontrol sitename set meineSite ttl 7
- Festlegen der proportionalen Gewichtung von CPU-Belastung, Speicherauslastung, Port und Systemmetrik:
sscontrol sitename
set meineSite proportions 50 48 1 1
- Entfernen eines Sitenamens:
sscontrol sitename remove 130.40.52.153
- Anzeigen des Status für den Sitenamen meineSite:
sscontrol sitename status meineSite
Die Ausgabe dieses Befehls sieht etwa wie folgt aus:
Status des Sitenamens:
---------------
Sitename ........................... meineSite
Gewichtungsgrenze .................. 20
TTL ................................ 5
Haltezeit .......................... 0
Anzahl Server ...................... 1
Proportion für CpuLoad ............. 49
Proportion für MemLoad ............. 50
Proportion für Port ................ 1
Proportion für Systemmetrik ........ 0
Advisor am Port .................... 80
Verwendete Proximität .............. N
sscontrol status — Aktivitätsanzeige für Manager und Advisor

>>-sscontrol--status-------------------------------------------><
Beispiele