Riferimenti sui comandi per Site Selector
Questo capitolo descrive come utilizzare i seguenti comandi sscontrol di Site Selector:
È possibile immettere una versione ridotta dei
parametri del comando sscontrol.
È sufficiente inserire le lettere che designano in modo univoco i parametri. Ad esempio, per richiamare la guida sul comando
di salvataggio file, è possibile digitare sscontrol
he f invece di sscontrol help file.
Nota:
i valori dei parametri del comando devono essere immessi
utilizzando l'alfabeto inglese. Le sole eccezioni sono rappresentate dai nomi
host (utilizzati nei comandi dei server e dei cluster) e dai nomi file
(utilizzati nei
comandi file).
sscontrol advisor -- controlla l'advisor

>>-sscontrol--advisor--+-connecttimeout--name--+-porta---------+--seconds-------+-><
| '-sitename:port-' |
+-interval--name--+-porta---------+--seconds-------------+
| '-sitename:port-' |
+-list---------------------------------------------------+
+-loglevel--name--+-porta---------+--level---------------+
| '-sitename:port-' |
+-logsize--name--+-porta---------+--+-size | unlimited-+-+
| '-sitename:port-' '-byte-------------' |
+-receivetimeout--name--+-porta---------+--seconds-------+
| '-sitename:port-' |
+-report--name--+-porta---------+------------------------+
| '-sitename:port-' |
+-retries--name--+-porta---------+--numretries-----------+
| '-sitename:port-' |
+-start--name--+-porta---------+--+----------+-----------+
| '-sitename:port-' '-log file-' |
+-stato--name--+-porta---------+-------------------------+
| '-sitename:port-' |
+-stop--name--+-porta---------+--------------------------+
| '-sitename:port-' |
+-timeout--name--+-porta---------+-----------------------+
| '-sitename:port-' |
'-version--name--+-porta---------+--seconds--------------'
'-sitename:port-'
- connecttimeout
- Impostare il tempo che un advisor attende prima di riferire l'interruzione di una
connessione a un server. Per ulteriori informazioni, vedere
Timeout di connessione e timeout di ricezione dell'advisor per
i server.
- name
- Il nome dell'advisor. Tra i valori possibili vi sono http, https, ftp, sip, ssl, smtp, imap, pop3, ldap, ldaps,
nntp, telnet, connect, ping, WLM
e WTE. I nomi degli advisor personalizzati sono nel formato xxxx,
dove per ADV_xxxx si intende il nome della
classe che implementa l'advisor personalizzato.
- port
- Il numero della porta monitorata dall'advisor.
- seconds
- Un numero intero positivo che rappresenta il tempo, in secondi,
che l'advisor attende prima di riferire l'interruzione di una connessione a un server.
Il valore predefinito è pari a 3 volte il
valore specificato per l'intervallo dell'advisor.
- interval
- Impostare la frequenza con cui l'advisor richiede
informazioni ai server.
- seconds
- Un numero intero positivo che rappresenta il numero di secondi trascorsi
tra le richieste di stato ai server. Il valore predefinito è 7.
- list
- Mostra l'elenco degli advisor che attualmente forniscono
informazioni al gestore.
- loglevel
- Imposta il livello di registrazione per un log dell'advisor.
- level
- Il numero del livello (da 0 a 5). Il valore predefinito è 1.
Maggiore è il numero, maggiori saranno le informazioni scritte sul
log dell'advisor.
I valori possibili sono:
- 0 sta per Nessuno
- 1 per Minimo
- 2 per Base
- 3 per Moderato
- 4 per Avanzato
- 5 per Verbose
.
- logsize
- Impostare la dimensione massima di un log dell'advisor. Se si imposta la
dimensione massima del file di log, il file riparte dall'inizio;
quando il file raggiunge la dimensione specificata, le voci
successive sovrascrivono le voci di log precedenti. La dimensione del
log non può essere inferiore alla dimensione corrente del log. Le
voci di log sono dotate di un indicatore di data e ora in modo da
poter comunicare l'ordine in cui sono state scritte.
Tanto maggiore
sarà il valore impostato per il livello di log, tanto più
attentamente dovrà essere selezionata la dimensione del log, in
quanto lo spazio può esaurirsi velocemente quando si esegue la
registrazione ai livelli più alti.
- size | unlimited
- La dimensione massima in byte del file di log
dell'advisor.
È possibile specificare un numero positivo maggiore di zero
o unlimited. Il file di log potrebbe non
raggiungere esattamente la dimensione massima, prima prima di essere
sovrascritto, in quanto le voci di log variano in termini di
dimensione. Il valore predefinito è 1 MB.
- receivetimeout
- Impostare il tempo che un advisor attende prima di riferire
l'impossibilità di ricezione da un
server. Per ulteriori informazioni, vedere
Timeout di connessione e timeout di ricezione dell'advisor per
i server.
- seconds
- Un numero intero positivo che rappresenta il tempo, in secondi,
che l'advisor attende prima di riferire l'impossibilità di una
ricezione da un server.
Il valore predefinito è pari a 3 volte il
valore specificato per l'intervallo dell'advisor.
- report
- Visualizza un report sullo stato dell'advisor.
- retries
- Il numero di tentativi che un
advisor può eseguire prima di contrassegnare un server come inattivo.
- numretries
- Un numero intero maggiore o uguale a zero. È preferibile che questo valore
non sia maggiore di 3. Se la parola chiave retries non è configurata, per il numero di
tentativi viene assunto il valore zero.
- start
- Avvia l'advisor. Sono disponibili advisor per ciascun
protocollo. Le porte predefinite sono:
Nome advisor |
Protocollo |
Port |
Connect |
n/d |
definito dall'utente |
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 |
N/A |
pop3 |
POP3 |
110 |
sip |
SIP |
5060 |
smtp |
SMTP |
25 |
ssl |
SSL |
443 |
telnet |
Telnet |
23 |
- name
- Il nome dell'advisor.
- sitename:port
- Sui comandi advisor il valore sitename è opzionale mentre il
valore port è obbligatorio. Se il valore sitename non è specificato,
l'advisor inizia l'esecuzione su tutti i sitename configurati e
disponibili.
Se si specifica un sitename,
l'advisor inizia l'esecuzione solo per il sitename specificato. I sitename supplementari
vengono separati dal segno più (+).
- log file
- Nome del file su cui sono registrati i dati di gestione. Ciascun
record nel log è dotato di un indicatore di data e ora.
Il file predefinito è advisorname_port.log, ad esempio, http_80.log. Per modificare la directory su cui
vengono memorizzati i file di log, consultare
Modifica dei percorsi file di log.
È possibile avviare un solo
advisor per ogni sitename.
- status
- Visualizza lo stato corrente e le impostazioni predefinite di
tutti i valori globali in un advisor.
- stop
- Arresta l'advisor.
- timeout
- Imposta il numero di secondi entro il quale il gestore
considera valide le informazioni ricevute dall'advisor. Se il gestore
rileva che le informazioni dell'advisor sono meno aggiornate rispetto
a questo periodo di timeout, non utilizza tali informazioni per
determinare i pesi dei server sulla porta monitorata dall'advisor. Un'eccezione a questo timeout avviene quando l'advisor ha informato
il gestore dell'inattività di uno specifico server. Il gestore
utilizza quelle informazioni sul server anche in seguito al timeout
delle informazioni dell'advisor.
- seconds
- Un numero positivo che rappresenta un numero di secondi o unlimited. Il valore predefinito è unlimited.
- version
- Visualizza la versione corrente dell'advisor.
Esempi
- Per impostare il tempo (30 secondi) che un advisor HTTP
(per la porta 80) attende prima di riferire l'interruzione di una connessione a un server:
sscontrol advisor connecttimeout http 80 30
- Per impostare l'intervallo per l'advisor FTP (per la porta 21) su 6
secondi:
sscontrol advisor interval ftp 21 6
- Per visualizzare l'elenco degli advisor che attualmente
forniscono informazioni al gestore:
sscontrol advisor list
Questo comando produce un
output simile a:
---------------------------------------
| ADVISOR | SITENAME:PORT | TIMEOUT |
---------------------------------------
| http | 80 | unlimited |
| ftp | 21 | unlimited |
---------------------------------------
- Per modificare il livello di log del log dell'advisor
http, del sitename
di mysite, su 0 al fine di ottenere
migliori prestazioni:
sscontrol advisor loglevel http mysite:80 0
- Per modificare la dimensioni di log dell'advisor ftp per
sitename di mysite
su 5000 byte:
sscontrol advisor logsize ftp mysite:21 5000
- Per impostare il tempo (60 secondi) che un advisor HTTP (per la
porta 80) attende prima di riferire l'impossibilità di ricezione da
un server:
sscontrol advisor receivetimeout http 80 60
- Per visualizzare un report sullo stato dell'advisor ftp (per la
porta 21):
sscontrol advisor report ftp 21
Questo comando produce un
output simile a:
Advisor Report:
---------------
Advisor name ............. http
Port number .............. 80
sitename ................. mySite
Server address ........... 9.67.129.230
Load ..................... 8
- Per avviare l'advisor con il file ftpadv.log:
sscontrol advisor start ftp 21 ftpadv.log
- Per visualizzare lo stato corrente dei valori associati
all'advisor http:
sscontrol advisor status http 80
Questo comando produce un output simile al seguente:
Advisor Status:
---------------
Interval (seconds) ............ 7
Timeout (seconds) ............. Unlimited
Connect timeout (seconds).......21
Receive timeout (seconds).......21
Advisor log filename .......... Http_80.log
Log level ..................... 1
Maximum log size (bytes) ...... Unlimited
Number of retries ............. 0
- Per arrestare l'advisor http sulla porta 80:
sscontrol advisor stop http 80
- Per impostare il valore di timeout per le informazioni
dell'advisor su 5
secondi:
sscontrol advisor timeout ftp 21 5
- Per trovare il numero di porta corrente dell'advisor ssl:
sscontrol advisor version ssl 443
sscontrol file -- gestisce i file di configurazione

>>-sscontrol--file--+-delete--filename.ext----------+----------><
+-appendload--filename.ext------+
+-report------------------------+
+-save--filename.ext--+-------+-+
| '-force-' |
'-newload--filename.ext---------'
- delete
- Elimina il file.
- file.ext
- Un file di configurazione.
L'estensione del file
(.ext) è a scelta e facoltativa.
- appendload
- Aggiunge un file di configurazione alla configurazione
corrente e lo carica su Site Selector.
- report
- Crea il report relativo ai file disponibili.
- save
- Salva la configurazione corrente di Site Selector nel file.
Nota:
I file vengono salvati nelle directory e caricati dalle
stesse directory:
- Sistemi operativi AIX, HP-UX, Linux e Solaris: /opt/ibm/edge/lb/servers/configurations/ss
- Sistemi operativi Windows: <root_installazione>ibm\edge\lb\servers\configurations\componente
- force
- Per salvare il file in un file esistente con nome identico,
utilizzare l'opzione force per eliminare il
file esistente prima di salvare quello nuovo. Se non si utilizza
l'opzione force, il file esistente non verrà sovrascritto.
- newload
- Carica un nuovo file di configurazione in Site Selector. Il nuovo file
di configurazione sostituisce la configurazione corrente.
Esempi
- Per eliminare un file:
sscontrol file delete file3
File (file3) was deleted.
- Per caricare un nuovo file di configurazione per sostituire la
configurazione corrente:
sscontrol file newload file1.sv
File (file1.sv) was loaded into the Dispatcher.
- Per aggiungere un file di configurazione alla configurazione corrente e
caricarlo:
sscontrol file appendload file2.sv
File (file2.sv) was appended to the current configuration and loaded.
- Per visualizzare un report dei file (ossia, dei file
precedentemente salvati):
sscontrol file report
FILE REPORT:
file1.save
file2.sv
file3
- Per salvare la configurazione in un file denominato file3:
sscontrol file save file3
The configuration was saved into file (file3).
sscontrol help -- visualizza o stampa la guida per il comando in questione

>>-sscontrol--help--+-advisor----+-----------------------------><
+-file-------+
+-help-------+
+-host-------+
+-logstatus--+
+-gestore----+
+-metriche---+
+-nameserver-+
+-regola-----+
+-server-----+
+-set--------+
+-sitename---+
'-stato------'
Esempi
- Per richiamare la guida sul comando sscontrol:
sscontrol help
Questo comando produce un
output simile a:
HELP COMMAND
ARGUMENTS:
---------------------------------
Usage: help <help option>
Esempio: nome guida
help - stampa il testo completo della guida
advisor - guida per il comando advisor
file - guida per il comando file
host - help on host command
manager - guida per il comando manager
metric - guida per il comando metric
sitename - guida per il comando sitename
nameserver - guida per il comando nameserver
rule - guida per il comando rule
server - guida per il comando server
set - guida per il comando set
status - guida per il comando status
logstatus - help on logstatus command
I parametri nelle tag < > sono variabili.
- A volte la guida visualizza le scelte per le variabili
utilizzando il carattere | per separare le opzioni:
logsize <number of bytes | unlimited>
-Set the maximum number of bytes to be logged in the log file
sscontrol logstatus -- visualizza le impostazioni log del server

>>-sscontrol--logstatus----------------------------------------><
- logstatus
- Visualizza le impostazioni log del server (nome file
di log, livello di registrazione e dimensione log).
sscontrol manager -- controlla il gestore

>>-sscontrol--gestore--+-interval--seconds----------------------+-><
+-loglevel--level------------------------+
+-logsize--+-unlimited-+-----------------+
| '-byte------' |
+-metric set--+-loglevel--level--------+-+
| '-logsize--+-unlimited-+-' |
| '-byte------' |
+-reach set--+-interval--seconds------+--+
| +-loglevel--level--------+ |
| '-logsize--+-unlimited-+-' |
| '-byte------' |
+-report--sitename+sn2+...+snN-----------+
+-restart--------------------------------+
+-sensitivity--weight--------------------+
+-smoothing--indice di arrotondamento----+
+-start--+----------------------+--------+
| '-logfile--metric_port-' |
+-stato----------------------------------+
+-stop-----------------------------------+
'-version--------------------------------'
- interval
- Imposta la frequenza con cui il gestore aggiorna i
pesi del server.
- seconds
- Un numero intero, in secondi, che indica la frequenza
con cui il gestore aggiorna i pesi. Il valore predefinito è 2.
- loglevel
- Imposta il livello di registrazione per il log del
gestore.
- level
- Il numero del livello (da 0 a 5). Maggiore è il numero,
maggiori saranno le informazioni scritte sul log del gestore. Il
valore predefinito è 1. I valori possibili sono:
- 0 sta per Nessuno
- 1 per Minimo
- 2 per Base
- 3 per Moderato
- 4 per Avanzato
- 5 per Verbose
- logsize
- Imposta la dimensione massima del log del gestore. Se si
imposta la dimensione massima del file di log, il file riparte
dall'inizio; quando il file raggiunge la dimensione specificata, le
voci successive vengono scritte partendo dall'inizio del file,
sovrascrivendo quindi le precedenti voci di log. La dimensione del
log non può essere inferiore alla dimensione corrente del log. Le
voci di log sono dotate di un indicatore di data e ora in modo da
poter comunicare l'ordine in cui sono state scritte. Tanto maggiore
sarà il valore impostato per il livello di log, tanto più
attentamente dovrà essere selezionata la dimensione del log, in
quanto lo spazio può esaurirsi velocemente quando si esegue la
registrazione ai livelli più alti.
- bytes
- La dimensione massima in byte del file di log del
gestore.
È possibile specificare un numero positivo maggiore di zero
o unlimited. Il file di log potrebbe non
raggiungere esattamente la dimensione massima, prima prima di essere
sovrascritto, in quanto le voci di log variano in termini di
dimensione. Il valore predefinito è 1 MB.
- metric set
- Imposta loglevel e
logsize per il log di controllo metrica. Loglevel è il livello di registrazione di controllo metrica (0 -
Nessuno, 1 - Minimo, 2 - Base, 3 - Moderato, 4 - Avanzato o 5 -
Verbose). Il loglevel predefinito è 1. Il logsize è il numero massimo di byte
da registrare nel file di log di controllo metrica. È possibile
specificare un numero positivo maggiore di zero o unlimited. Il
valore logsize predefinito è 1.
- reach set
- Imposta interval, loglevel e logsize per l'advisor
reach.
- report
- Visualizza un report delle istantanee delle statistiche.
- sitename
- Il nome del sito da visualizzare nel report. È un nome host
non risolvibile che il client richiederà. Il sitename deve essere un nome dominio completo.
Nota:
i
sitename supplementari vengono separati da un segno più (+).
- restart
- Riavvia tutti i server (non disattivi) con i pesi normalizzati
(1/2 del peso massimo).
- message
- Un messaggio che si desidera venga scritto nel file di log del
gestore.
- sensitivity
- Impostare la sensibilità minima su cui aggiornare i pesi. Questa impostazione definisce il momento in cui il gestore deve
modificare il peso del server in base alle informazioni esterne.
- weight
- Un numero da 0 a 100 utilizzato come percentuale dei pesi. Il
valore predefinito 5 crea una sensibilità minima del 5%.
- smoothing
- Impostare un indice che arrotondi le variazioni del peso
durante il bilanciamento del carico. Un indice di arrotondamento più alto fa in modo che i pesi del server
subiscano delle variazioni meno drastiche, in caso di cambiamento
delle condizioni di rete. Con un indice più basso, i pesi del server
subiscono delle variazioni più drastiche.
- index
- Un numero a virgola mobile positivo. Il valore predefinito è 1,5.
- start
- Avvia il gestore.
- log file
- Nome del file in cui vengono registrati i
dati del gestore. Ciascun
record nel log è dotato di un indicatore di data e ora.
Il file
predefinito viene installato nella directory
logs. Consultare Appendice C. File di configurazione di esempio. Per modificare la directory su cui
vengono memorizzati i file di log, consultare
Modifica dei percorsi file di log.
- metric_port
- La porta utilizzata da Metric Server per creare i report dei
carichi di sistema. Se si specifica una porta metrica, è necessario
indicare il nome di un file di log. La porta metrica predefinita è la
numero 10004.
- status
- Visualizza lo stato corrente e le impostazioni predefinite di
tutti i valori globali in un gestore.
- stop
- Arresta il gestore.
- version
- Visualizza la versione corrente del gestore.
Esempi
- Per impostare l'intervallo di aggiornamento del gestore ogni 5
secondi:
sscontrol manager interval 5
- Per impostare il livello di registrazione su 0 per ottenere
migliori prestazioni:
sscontrol manager loglevel 0
- Per impostare la dimensione del log del gestore su 1.000.000 byte:
sscontrol manager logsize 1000000
- Per richiamare l'istantanea delle statistiche del gestore:
sscontrol manager report
Questo comando produce un
output simile a:
----------------------------------
| SERVER | STATUS |
----------------------------------
| 9.67.129.221| ACTIVE|
| 9.67.129.213| ACTIVE|
| 9.67.134.223| ACTIVE|
----------------------------------
--------------------------
| MANAGER REPORT LEGEND |
--------------------------
| CPU | CPU Load |
| MEM | Memory Load |
| SYS | System Metric |
| NOW | Current Weight |
| NEW | New Weight |
| WT | Weight |
--------------------------
------------------------------------------------------------------------
| mySite | WEIGHT | CPU 49% | MEM 50% | PORT 1% | SYS 0% |
------------------------------------------------------------------------
| |NOW NEW | WT LOAD | WT LOAD | WT LOAD | WT LOAD |
------------------------------------------------------------------------
| 9.37.56.180 | 10 10 |-99 -1|-99 -1|-99 -1| 0 0|
------------------------------------------------------------------------
| TOTALS:| 10 10 | -1| -1| -1| 0|
------------------------------------------------------------------------
-----------------------------------------
| ADVISOR | SITENAME:PORT | TIMEOUT |
-----------------------------------------
| http | 80 | unlimited |
-----------------------------------------
- Per riavviare tutti i server con i pesi normalizzati e scrivere
un messaggio nel file di log del gestore:
sscontrol manager restart Restarting the manager to update code
Questo comando produce un
output simile a:
320-14:04:54 Restarting the manager to update code
- Per impostare la sensibilità alle variazioni del peso su 10:
sscontrol manager sensitivity 10
- Per impostare l'indice di arrotondamento su 2,0:
sscontrol manager smoothing 2.0
- Per avviare il gestore e
specificare il file di log denominato ndmgr.log (i percorsi non possono essere impostati)
sscontrol manager start ndmgr.log
- Per visualizzare lo stato corrente dei valori associati al
gestore:
sscontrol manager status
Questo comando produce un output simile al seguente esempio.
Manager status:
=============
Metric port................................... 10004
Manager log filename.......................... manager.log
Manager log level............................. 1
Maximum manager log size (bytes).............. unlimited
Sensitivity level............................. 5
Smoothing index............................... 1.5
Update interval (seconds)..................... 2
Weights refresh cycle......................... 2
Reach log level............................... 1
Maximum reach log size (bytes)................ unlimited
Reach update interval (seconds)............... 7
- Per arrestare il gestore:
sscontrol manager stop
- Per visualizzare il numero della versione corrente del gestore:
sscontrol manager version
sscontrol metric -- configura le metriche di sistema

>>-sscontrol--metriche--+-add--sitename+sn2+...+snN:metric+metric1+...+metricN--------------+-><
+-remove--sitename+sn2+...+snN:metric+metric1+...+metricN-----------+
+-proporzioni--sitename+sn2+...+snN:proportion1 prop2 prop3...propN-+
'-stato--sitename+sn2+...+snN metric+metric1+...+metricN------------'
- add
- Aggiunge la metrica specificata.
- sitename
- Il sitename configurato. i
sitename supplementari vengono separati da un segno più (+).
- metric
- Il nome della metrica di sistema, che deve essere il nome di un
file eseguibile o script nella directory script di Metric Server.
- remove
- Elimina la metrica specificata.
- proportions
- Determina l'importanza di ciascuna metrica
confrontata con
le altre se su un singolo server vengono utilizzate più metriche.
- status
- Visualizza i valori correnti del server della metrica in
questione.
Esempi
- Per aggiungere una metrica di sistema:
sscontrol metric add site1:metric1
- Per impostare le proporzioni di un sitename con due
metriche di sistema:
sscontrol metric proportions site1 0 100
- Per visualizzare lo stato corrente dei valori associati alla
metrica specificata:
sscontrol metric status site1:metric1
Questo comando produce un output simile al seguente:
Metric Status:
------------
sitename ..................... site1
Metric name ................... metric1
Metric proportion ............. 50
Server ......... 9.37.56.100
Metric data .... -1
sscontrol nameserver -- controlla il server dei nomi

>>-sscontrol--nameserver--+-start--+----------------------+-+--><
| '-bindaddress--address-' |
+-stop----------------------------+
'-status--------------------------'
- start
- Avvia il server dei nomi.
- bindaddress
- Avvia il server dei nomi associato all'indirizzo specifico. Il
server dei nomi risponde solo a una richiesta destinata a questo
indirizzo.
- address
- Un indirizzo (IP o simbolico) configurato sulla macchina Site Selector.
- stop
- Arresta il server dei nomi.
- status
- Visualizza lo stato del server dei nomi.
sscontrol rule -- configura le regole

>>-sscontrol--rule--+-add--sitename+sn2+...+snN:rule+r2+...+rN--tipo--value--| value |--| opts |-+-><
+-dropserver--sitename+sn2+...+snN:rule+r2+...+rN--server+s2+...+snN---------+
+-remove--sitename+sn2+...+snN:rule+r2+...+rN--------------------------------+
+-set--sitename+sn2+...+snN:rule+r2+...+rN--| value |--| opts |--------------+
+-status--sitename+sn2+...+snN:rule+r2+...+rN--------------------------------+
'-useserver--sitename+sn2+...+snN:rule+r2+...+rN--server+s2+...+snN----------'
opts:
|--+---------------------------------+--------------------------|
+-beginrange--low--endrange--high-+
+-priority--value-----------------+
'-metricname--value---------------'
- add
- Aggiunge la regola a un sitename.
- sitename
- Un nome host non risolvibile che il client
richiederà.
Il sitename deve essere un nome dominio completo. I sitename supplementari
vengono separati dal segno più (+).
- regola
- Il nome scelto per la regola. Tale nome può contenere qualsiasi carattere alfanumerico, il carattere di sottolineatura, un trattino o un punto. La lunghezza può variare da 1 a 20 caratteri e gli spazi non
sono ammessi.
Nota:
le regole supplementari vengono separate
da un segno più (+).
- tipo
- Il tipo di regola.
- tipo
- Le scelte per type sono:
- ip
- La regola è basata
sull'indirizzo IP client.
- metricall
- La regola si basa sul valore della metrica
attuale per tutti i server all'interno del gruppo.
- metricavg
- La regola si basa sulla media dei valori di
metrica correnti per tutti i server all'interno del gruppo.
- time
- La regola è basata sull'ora del
giorno.
- true
- Questa regola è sempre true. Considerarla come un'istruzione else nella logica programmatica.
- beginrange
- Il valore minimo nell'intervallo utilizzato per determinare se
la regola assume o meno il valore true.
- low
- Dipende dal tipo di regola. Il tipo di valore e le relative
impostazioni predefinite vengono qui elencate per tipo di regola:
- ip
- L'indirizzo del client espresso come nome simbolico o nel
formato indirizzo IP. Il valore predefinito è 0.0.0.0.
- time
- Numero intero. Il valore predefinito è 0, ossia mezzanotte.
- metricall
- Numero intero. Il valore predefinito è 100.
- metricavg
- Numero intero. Il valore predefinito è 100.
- endrange
- Il valore massimo nell'intervallo utilizzato per determinare se
la regola assume o meno il valore true.
- high
- Dipende dal tipo di regola. Il tipo di valore e le relative
impostazioni predefinite vengono qui elencate per tipo di regola:
- ip
- L'indirizzo del client espresso come nome simbolico o nel
formato indirizzo IP. Il valore predefinito è 255.255.255.254.
- time
- Numero intero. Il valore predefinito è 24, ossia mezzanotte.
Nota:
quando si definiscono i valori beginrange ed endrange degli
intervalli di tempo, notare che ciascun valore deve essere un numero
intero positivo che rappresenta solo l'ora; non è possibile
specificare i minuti. Per questo motivo, per indicare
una singola ora --ad esempio, l'ora compresa tra le 3:00 e le
4:00 -- specificare 3 per beginrange e nuovamente
3 per endrange. Ciò indica tutti i minuti dalle 3:00 alle 3:59. Specificando
3 per beginrange e 4 per endrange,
l'intervallo di tempo stabilito sarà compreso tra le 3:00 e le 4:59.
- metricall
- Numero intero. Il valore predefinito è 2 alla
trentaduesima potenza meno 1.
- metricavg
- Numero intero. Il valore predefinito è 2 alla
trentaduesima potenza meno 1.
- priority
- L'ordine in cui verranno riviste le regole.
- level
- Numero intero. Se non si specifica la priorità della prima regola
aggiunta, Site Selector la imposta, per valore predefinito, su 1.
Quando si aggiunge una seconda regola, sempre per valore predefinito,
la relativa priorità viene calcolata come 10 + la priorità
attualmente più bassa di una regola esistente. Ad esempio, si assuma di avere una regola con priorità pari a 30. Quindi, viene
aggiunta una nuova regola la cui priorità viene impostata su 25
(ossia, una priorità superiore a 30). A questo punto, viene aggiunta una terza regola senza impostarne la priorità. La priorità di questa terza regola viene calcolata come 40 (30 + 10).
- metricname
- Nome della metrica misurata per una regola.
- dropserver
- Rimuovere un server da una serie di regole.
- server
- L'indirizzo IP della macchina server TCP espresso come nome simbolico o in formato
indirizzo IP.
Nota:
I sitename supplementari
vengono separati dal segno più (+).
- remove
- Rimuovere una o più regole, separate le une dalle altre mediante segni più (+).
- set
- Impostare i valori per questa regola.
- status
- Visualizza tutti i valori di una o più regole.
- useserver
- Inserisce il server in un insieme di regole.
Esempi
- Per aggiungere una regola il cui valore sarà sempre true, non
specificare il valore di inizio o di fine:
sscontrol rule add sitename:rulename type true priority 100
- Per creare una regola che vieta l'accesso a un intervallo di indirizzi IP, in questo
caso, gli indirizzi IP che iniziano con "9" :
sscontrol rule add sitename:rulename type ip b 9.0.0.0 e 9.255.255.255
- Per creare una regola che specificherà l'uso di un determinato
server dalle 11:00 a.m. alle 3:00 p.m.:
sscontrol rule add sitename:rulename type time beginrange 11 endrange 14
sscontrol rule useserver sitename:rulename server05
sscontrol server -- configura i server

>>-sscontrol--server--+-add--sitename+sn2+...+snN:server+s2+...+sN--+------------------------+-+-><
| +-metricaddress--address-+ |
| '-weight--value----------' |
+-down--sitename+sn2+...+snN:server+s2+...+sN----------------------------+
+-remove--sitename+sn2+...+snN:server+s2+...+sN--------------------------+
+-set--sitename+sn2+...+snN:server+s2+...+sN--+------------------------+-+
| +-metricaddress--address-+ |
| '-weight--value----------' |
+-status--sitename+sn2+...+snN:server+s2+...+sN--------------------------+
'-attivo--sitename+sn2+...+snN:server+s2+...+sN--------------------------'
- add
- Aggiunge il server.
- sitename
- Un nome host non risolvibile che il client richiede.
Il sitename deve essere un nome dominio completo. I sitename supplementari
vengono separati dal segno più (+).
- server
- L'indirizzo IP della macchina server TCP espresso come nome simbolico o in formato
indirizzo IP.
Nota:
i server supplementari sono separati
mediante un carattere di addizione (+).
- metricaddress
- L'indirizzo di metric server.
- address
- L'indirizzo del server espresso come nome simbolico o
nel
formato indirizzo IP.
- weight
- Un numero compreso nell'intervallo
0-100 (che non deve superare
il valore weightbound massimodel sitename) che
rappresenta il peso per questo
server. L'impostazione
del peso su zero impedisce di inviare al server eventuali nuove
richieste. Il valore predefinito è metà del valore weightbound massimo del nome sito specificato. Se il gestore è in esecuzione, questa
impostazione verrà velocemente sovrascritta.
- value
- Il valore del peso del server.
- down
- Contrassegna il server come disattivo. Questo comando
impedisce a qualsiasi richiesta di essere risolta su quel server.
- remove
- Rimuove il server.
- set
- Imposta i valori per il server.
- status
- Mostra lo stato dei server.
- up
- Contrassegna il server come attivo. Site Selector risolverà
le nuove richieste su quel server.
Esempi
- Per aggiungere il server all'indirizzo 27.65.89.42 su un
sitename di site1:
sscontrol server add site1:27.65.89.42
- Per contrassegnare il server all'indirizzo 27.65.89.42 come
disattivo:
sscontrol server down site1:27.65.89.42
- Per rimuovere il server dall'indirizzo
27.65.89.42 di tutti i sitename:
sscontrol server remove :27.65.89.42
- Per contrassegnare il server all'indirizzo 27.65.89.42 come
attivo:
sscontrol server up site1:27.65.89.42
sscontrol set -- configura il log del server

>>-sscontrol--set--+-loglevel--level--------+------------------><
'-logsize--+-unlimited-+-'
'-size------'
- loglevel
- Il livello su cui ssserver registra le proprie attività.
- level
- Il valore predefinito di
loglevel
è 0. I valori possibili sono:
- 0 sta per Nessuno
- 1 per Minimo
- 2 per Base
- 3 per Moderato
- 4 per Avanzato
- 5 per Verbose
- logsize
- Il numero massimo di byte da registrare nel file di log.
- size
- Il valore predefinito di logsize è 1 MB.
sscontrol sitename -- configura un sitename

>>-sscontrol--sitename--+-add--sitename+sn2+...+snN--+--------------------------------------------+-+-><
| +-cachelife--value---------------------------+ |
| +-networkproximity--yes | no-----------------+ |
| +-proportions--cpu--memoria--porta--metriche-+ |
| +-proximitypercentage--value-----------------+ |
| +-stickytime--time---------------------------+ |
| +-ttl--time----------------------------------+ |
| +-waitforallresponses--yes | no--------------+ |
| '-weightbound--weight------------------------' |
+-remove--sitename+sn2+...+snN----------------------------------------------+
+-set--sitename+sn2+...+snN--+--------------------------------------------+-+
| +-cachelife--value---------------------------+ |
| +-networkproximity--yes | no-----------------+ |
| +-proportions--cpu--memoria--porta--metriche-+ |
| +-proximitypercentage--value-----------------+ |
| +-stickytime--time---------------------------+ |
| +-ttl--time----------------------------------+ |
| +-waitforallresponses--yes | no--------------+ |
| '-weightbound--weight------------------------' |
'-status--sitename+sn2+...+snN----------------------------------------------'
- add
- Aggiunge un nuovo sitename.
- sitename
- Un nome host non risolvibile, richiesto dal client.
I sitename supplementari
vengono separati dal segno più (+).
- cachelife
- La quantità di tempo durante la
quale una risposta di prossimità sarà valida e verrà salvata nella
cache. Il valore predefinito è 1800. Consultare Uso della funzione di prossimità della rete per ulteriori informazioni.
- value
- Un numero positivo che rappresenta il numero di
secondi per cui una risposta di prossimità è valida e viene salvata
nella cache.
- networkproximity
- Determina la prossimità della rete di ciascun server al
client richiedente. Utilizzare la risposta di prossimità nella decisione di
bilanciamento del carico.
Impostare la prossimità su on o off. Consultare Uso della funzione di prossimità della rete per ulteriori informazioni.
- value
- Le scelte sono sì o no. L'impostazione predefinita è no, e
indica che la prossimità della rete è disabilitata.
- proportions
- Imposta la proporzione di importanza per
cpu, memoria,
porta (informazioni fornite dagli advisor) e metriche di sistema
per Metric Server, utilizzate dal gestore per impostare i pesi dei
server. Ognuno di questi valori viene espresso come una percentuale
del totale e il totale è sempre 100.
- cpu
- La percentuale di CPU in uso su ciascuna macchina server con
bilanciamento del carico (input dell'agente Metric Server).
- memory
- La percentuale di memoria in uso (input dell'agente di Metric Server
agent) su ciascun server con bilanciamento del carico
- port
- l'input degli advisor in ascolto sulla porta.
- system
- L'input di Metric Server.
- proximitypercentage
- Imposta l'importanza della risposta di
prossimità rispetto allo stato del server (peso
del gestore). Consultare Uso della funzione di prossimità della rete per ulteriori informazioni.
- value
- Il valore predefinito è 50.
- stickytime
- L'intervallo durante il quale un client riceve lo
stesso ID server restituito in precedenza, per la prima richiesta. Il
valore predefinito di stickytime
è 0, e indica che il nome sito (sitename) non è aderente.
- time
- Un numero positivo, diverso da zero, che rappresenta
il numero di secondi durante i quali il client riceve lo stesso ID
server restituito in precedenza per la prima richiesta.
- ttl
- Imposta la durata (TTL, time to live). Indica il tempo durante il quale un altro server dei nomi
memorizzerà nella cache la risposta risolta. Il valore predefinito è
5.
- value
- Un numero positivo che rappresenta il numero di
secondi per cui il server dei nomi memorizzerà nella cache la
risposta risolta.
- waitforallresponses
- Determina se attendere tutte
le risposte di prossimità dai server prima di
rispondere alla richiesta del client. Consultare Uso della funzione di prossimità della rete per ulteriori informazioni.
- value
- Le scelte sono sì o no. Il valore predefinito è sì.
- weightbound
- Un numero che rappresenta il peso massimo che si può
impostare per i server su questo sitename. Il valore weightbound,
impostato per il sitename, può essere ignorato per i singoli server
mediante il peso server. Il valore predefinito di weightbound di sitename è 20.
- weight
- Il valore di weightbound.
- set
- Imposta le proprietà di sitename.
- remove
- Rimuove il sitename.
- status
- Mostra lo stato corrente di un sitename specifico.
Esempi
- Per aggiungere un sitename:
sscontrol sitename add 130.40.52.153
- Per attivare la prossimità della rete:
sscontrol sitename set mySite networkproximity yes
- Per impostare la durata della cache su 1900000 secondi:
sscontrol sitename set mySite cachelife 1900000
- Per impostare la percentuale di prossimità di 45:
sscontrol sitename set mySite proximitypercentage 45
- Per impostare un sitename ed evitare che aspetti tutte le
risposte prima di rispondere:
sscontrol sitename set mySite waitforallresponses no
- Per impostare il valore TTL (time to live) su 7 secondi:
sscontrol sitename set mySite ttl 7
- Per impostare le proporzioni di importanza rispettivamente per
CpuLoad, MemLoad, Port e System
Metric:
sscontrol sitename set mySite proportions 50 48 1 1
- Per rimuovere un sitename:
sscontrol sitename remove 130.40.52.153
- Per visualizzare lo stato del sitename
mySite:
sscontrol sitename status mySite
Questo comando produce un
output simile a:
SiteName Status:
---------------
SiteName ........................... mySite
WeightBound ........................ 20
TTL ................................ 5
StickyTime ......................... 0
Number of Servers .................. 1
Proportion given to CpuLoad ........ 49
Proportion given to MemLoad ........ 50
Proportion given to Port ........... 1
Proportion given to System metric .. 0
Advisor running on port ............ 80
Using Proximity .................... N
sscontrol status -- mostra se il gestore e gli advisor sono
in esecuzione

>>-sscontrol--stato--------------------------------------------><
Esempi