Referencia de mandatos para Selector de sitio
En este capítulo se describe cómo utilizar los siguientes mandatos sscontrol de Selector de sitio:
Puede escribir una versión minimizada de los parámetros del mandato sscontrol.
Sólo es necesario especificar las letras exclusivas de los parámetros. Por ejemplo, para obtener ayuda sobre el mandato
para guardar archivos, puede escribir sscontrol he f en lugar de sscontrol help file.
Nota:
Los valores de los parámetros de mandatos deben especificarse en
caracteres del idioma inglés. Las únicas excepciones son los nombres de sistema principal (que se utilizan en los mandatos del clúster y servidor) y los nombres de archivo (que se utilizan en los mandatos de archivo).
sscontrol advisor — controlar el asesor

>>-sscontrol--advisor--+-connecttimeout--name--+-port----------------+--segundos--------------------+-><
| '-nombre_sitio:puerto-' |
+-interval--name--+-port----------------+--segundos--------------------------+
| '-nombre_sitio:puerto-' |
+-list-----------------------------------------------------------------------+
+-loglevel--name--+-port----------------+--nivel-----------------------------+
| '-nombre_sitio:puerto-' |
+-logsize--name--+-port----------------+--+-size | unlimited-+---------------+
| '-nombre_sitio:puerto-' '-bytes------------' |
+-receivetimeout--name--+-port----------------+--segundos--------------------+
| '-nombre_sitio:puerto-' |
+-informe--name--+-port----------------+-------------------------------------+
| '-nombre_sitio:puerto-' |
+-retries--name--+-port----------------+--número_reintentos------------------+
| '-nombre_sitio:puerto-' |
+-start--name--+-port----------------+--+----------------------------------+-+
| '-nombre_sitio:puerto-' '-archivo_anotaciones_cronológicas-' |
+-estado--name--+-port----------------+--------------------------------------+
| '-nombre_sitio:puerto-' |
+-stop--name--+-port----------------+----------------------------------------+
| '-nombre_sitio:puerto-' |
+-timeout--name--+-port----------------+-------------------------------------+
| '-nombre_sitio:puerto-' |
'-versión--name--+-port----------------+--segundos---------------------------'
'-nombre_sitio:puerto-'
- connecttimeout
- Establece cuánto tiempo espera un asesor antes de notificar que se ha producido un error en una
conexión a un servidor. Para
obtener más información, consulte Tiempo de espera de conexión y recepción del asesor para los servidores.
- nombre
- Nombre del asesor. Los valores posibles incluyen http, https, ftp, sip, ssl, smtp, imap, pop3, ldap, ldaps, nntp, telnet, connect, ping, WLM y WTE. Los nombres de asesores personalizados están en formato xxxx, donde ADV_xxxx es el nombre de la clase que implementa el asesor personalizado.
- puerto
- Número del puerto que el asesor está supervisando.
- segundos
- Entero positivo que representa el tiempo en segundos durante el que el asesor espera antes de notificar que se ha producido una anomalía en una conexión a un servidor. El valor por omisión es 3 veces el valor especificado para el intervalo del asesor.
- interval
- Establece con qué frecuencia el asesor consulta si hay información en los servidores.
- segundos
- Entero positivo que representa el número de segundos entre las peticiones a los servidores sobre su estado. El valor predeterminado es 7.
- list
- Muestra una lista de los asesores que actualmente proporcionan información al gestor.
- loglevel
- Establece el nivel de registro cronológico para las anotaciones cronológicas del asesor.
- nivel
- El número del nivel (0 a 5). El valor predeterminado es 1. Cuanto más alto sea el número, más información se anotará
en las anotaciones cronológicas del asesor. Los valores posibles son:
- 0 es Ninguno
- 1 es Mínimo
- 2 es Básico
- 3 es Moderado
- 4 es Avanzado
- 5 es Detallado
.
- logsize
- Establece el tamaño máximo de las anotaciones cronológicas del asesor. Cuando se establece un tamaño máximo para
el archivo de anotaciones cronológicas, el texto del archivo vuelve al principio; es decir, cuando el archivo alcanza el tamaño
especificado, las entradas subsiguientes se grabarán encima de las entradas de anotaciones cronológicas anteriores.
El tamaño de las anotaciones cronológicas no puede establecerse más pequeño que el tamaño actual de las anotaciones
cronológicas. Las entradas de las anotaciones cronológicas incluyen la indicación de la hora para poder saber el orden
en el que se anotaron. Cuando más alto se establezca el nivel de anotaciones cronológicas, más cuidado deberá tener al elegir el
tamaño de las anotaciones cronológicas porque, cuando el registro cronológico está establecido en los niveles más altos, puede quedarse
sin espacio rápidamente.
- tamaño | unlimited
- El tamaño máximo en bytes para el archivo de anotaciones cronológicas del asesor. Puede especificar un número positivo mayor que cero o la palabra unlimited.
Es posible que el archivo de anotaciones cronológicas no alcance el tamaño máximo exacto antes de empezar a sobrescribir porque el
tamaño de las entradas del archivo varían. El valor predeterminado es 1 MB.
- receivetimeout
- Establece cuánto tiempo espera un asesor antes de notificar que se ha producido un error en una
recepción en un servidor. Para
obtener más información, consulte Tiempo de espera de conexión y recepción del asesor para los servidores.
- segundos
- Entero positivo que representa el tiempo en segundos durante el que el asesor espera antes de notificar que se ha producido una anomalía en una recepción en un servidor. El valor por omisión es 3 veces el valor especificado para el intervalo del asesor.
- report
- Muestra un informe sobre el estado del asesor.
- retries
- El número de reintentos que un asesor puede realizar antes de marcar un servidor como inactivo.
- núm_reintentos
- Número entero mayor que o igual a cero. Este valor no debe ser mayor que 3.
Si la palabra clave retries no está configurada, el número de reintentos tendrá el valor por omisión de cero.
- start
- Inicia el asesor. Estos son asesores de cada protocolo. Los puertos por omisión son:
Nombre del asesor |
Protocolo |
Puerto |
Connect |
n/d |
definido por el usuario |
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/D |
pop3 |
POP3 |
110 |
sip |
SIP |
5060 |
smtp |
SMTP |
25 |
ssl |
SSL |
443 |
telnet |
Telnet |
23 |
- nombre
- Nombre del asesor.
- nombre_sitio:puerto
- El valor de nombre de sitio es opcional en los mandatos del asesor; sin embargo, el valor de puerto sí es necesario. Si no se especifica el valor de nombre de sitio, el asesor empieza a ejecutarse en todos los nombres de sitio disponibles configurados. Si especifica un nombre de sitio, el asesor sólo empieza a ejecutarse en el nombre del sistema que especifique. Los nombres de sitios adicionales se separan mediante un signo más (+).
- archivo_anotaciones_cronológicas
- Nombre de archivo en el que se anotan los datos de gestión. Cada registro de las anotaciones cronológicas incluye la indicación de la hora.
El archivo por omisión es puerto_nombre_asesor.log,
por ejemplo, http_80.log. Para cambiar el directorio en el que se guardan los archivos de
anotaciones cronológicas, consulte el apartado Cambio de las vías de acceso del archivo de anotaciones cronológicas.
Sólo puede iniciar un asesor para cada nombre de sitio.
- status
- Muestra el estado actual y los valores por omisión de todos los valores globales de un asesor.
- stop
- Detiene el asesor.
- timeout
- Establece el número de segundos durante los que el gestor considerará válida la información del asesor.
Si el gestor cree que la información del asesor es anterior a este intervalo de tiempo de espera, el gestor no la utiliza para determinar los pesos para los servidores en el puerto que el asesor está supervisando.
Una excepción a este tiempo de espera es cuando el asesor ha notificado al gestor que un servidor específico está inactivo. El gestor utiliza dicha información sobre el servidor, incluso después de que el información del asesor
exceda el tiempo de espera.
- segundos
- Número positivo que representa el número de segundos o la palabra unlimited. El valor predeterminado es unlimited.
- version
- Muestra la versión actual del asesor.
Ejemplos
- Establecer el tiempo (30 segundos) que un asesor HTTP (para el puerto 80) espera antes de notificar que
se ha producido una anomalía en una conexión a un servidor:
sscontrol advisor connecttimeout http 80 30
- Establecer el intervalo para el asesor FTP (para el puerto 21) en 6 segundos:
sscontrol advisor interval ftp 21 6
- Visualizar la lista de asesores que actualmente proporcionan información al gestor:
sscontrol advisor list
Este mandato genera una salida parecida a la siguiente:
---------------------------------------
| ASESOR | NOM_SITIO:PUERTO|TIEMPO ESP.|
---------------------------------------
| http | 80 | unlimited |
| ftp | 21 | unlimited |
---------------------------------------
- Cambiar el nivel de anotaciones cronológicas de las anotaciones cronológicas del asesor http para el nombre de sitio misitio en 0 para un mejor rendimiento:
sscontrol advisor loglevel http misitio:80 0
- Cambiar el tamaño de las anotaciones cronológicas del asesor ftp para el nombre del sitio misitio en 5000 bytes:
sscontrol advisor logsize ftp mysite:21 5000
- Establecer el tiempo (60 segundos) que un asesor HTTP (para el puerto 80) espera
antes de informar que falla una recepción de un servidor:
sscontrol advisor receivetimeout http 80 60
- Visualizar un informe sobre el estado del asesor ftp (para el puerto 21):
sscontrol advisor report ftp 21
Este mandato genera una salida parecida a la siguiente:
Informe del asesor:
---------------
Nombre del asesor ........ http
Número de puerto ......... 80
Nombre sitio ............. miSitio
Dirección del servidor ... 9.67.129.230
Carga .................... 8
- Iniciar el asesor con el archivo ftpadv.log:
sscontrol advisor start ftp 21 ftpadv.log
- Mostrar el estado actual de los valores asociados al asesor http:
sscontrol advisor status http 80
Este mandato genera
una salida parecida a la siguiente:
Estado del asesor:
---------------
Intervalo (segundos) .......... 7
Tiempo de espera (segundos) ... Unlimited
Tiempo espera conexión (seg) .. 21
Tiempo espera recepción (seg).. 21
Nombre anotaciones asesor ..... Http_80.log
Nivel anotación cronológica ... 1
Tam. máx. arch. anot. (bytes) . Unlimited
Número de reintentos .......... 0
- Detener el asesor http en el puerto 80:
sscontrol advisor stop http 80
- Establecer el valor de tiempo de espera para la información del asesor en 5 segundos:
sscontrol advisor timeout ftp 21 5
- Averiguar el número de versión actual del asesor SSL:
sscontrol advisor version ssl 443
sscontrol file — gestionar archivos de configuración

>>-sscontrol--archivo--+-suprimir--nombre_archivo.ext--------+-><
+-appendload--nombre_archivo.ext------+
+-informe-----------------------------+
+-save--nombre_archivo.ext--+-------+-+
| '-force-' |
'-newload--nombre_archivo.ext---------'
- delete
- Suprime el archivo.
- archivo.ext
- Un archivo de configuración.
La extensión de archivo (.ext) puede ser cualquiera y es opcional.
- appendload
- Adjunta un archivo de configuración a la configuración actual y la carga en Selector de sitio.
- report
- Informa sobre el archivo o los archivos disponibles.
- save
- Guarda la configuración actual de Selector de sitio en el archivo.
Nota:
Los archivos se guardan y se cargan de los siguientes directorios:
- Sistemas operativos AIX, HP-UX, Linux y Solaris: /opt/ibm/edge/lb/servers/configurations/ss
- Sistemas operativos Windows: <raíz_instalación>ibm\edge\lb\servers\configurations\component
- force
- Para guardar el archivo en un archivo existente con el mismo nombre, utilice force para suprimir el archivo existente antes de guardar el nuevo archivo. Si no utiliza la opción force, no se sobrescribirá el archivo existente.
- newload
- Cargar un nuevo archivo de configuración en Selector de sitio. El nuevo archivo de configuración sustituirá a la configuración actual.
Ejemplos
- Suprimir un archivo:
sscontrol file delete file3
Se ha suprimido el archivo (file3).
- Cargar un nuevo archivo de configuración para que sustituya a la configuración actual:
sscontrol file newload file1.sv
El archivo (file1.sv) se ha cargado en Dispatcher.
- Adjuntar un archivo de configuración a un configuración actual y cargar:
sscontrol file appendload file2.sv
El archivo (file2.sv) se ha añadido a la configuración actual y se ha cargado.
- Ver un informe de los archivos (es decir, estos archivos que ha guardado anteriormente):
sscontrol file report
INFORME SOBRE EL ARCHIVO:
file1.save
file2.sv
file3
- Guardar la configuración en un archivo denominado file3:
sscontrol file save file3
La configuración se ha guardado en el archivo (file3).
sscontrol help — mostrar o imprimir ayuda para este mandato

>>-sscontrol--help--+-advisor-------+--------------------------><
+-archivo-------+
+-help----------+
+-host----------+
+-logstatus-----+
+-manager-------+
+-metric--------+
+-nameserver----+
+-regla---------+
+-server--------+
+-estableciendo-+
+-sitename------+
'-estado--------'
Ejemplos
- Obtener ayuda sobre el mandato sscontrol:
sscontrol help
Este mandato genera una salida parecida a la siguiente:
ARGUMENTOS DEL MANDATO DE AYUDA:
---------------------------------
Uso: help <opción de ayuda>
Ejemplo: help nombre
help - imprime el texto completo de la ayuda
advisor - ayuda para el mandato advisor
file - ayuda para el mandato file
host - ayuda para el mandato host
manager - ayuda para el mandato manager
metric - ayuda para el mandato metric
sitename - ayuda para el mandato sitename
nameserver - ayuda para el mandato nameserver
rule - ayuda para el mandato rule
server - ayuda para el mandato server
set - ayuda para el mandato set
status - ayuda para el mandato status
logstatus - ayuda para el mandato logstatus
Los parámetros dentro de < > son variables.
- Algunas veces la ayuda muestra opciones para las variables utilizando | para separar las opciones:
logsize <número de bytes | unlimited>
-Establece el número máximo de bytes anotados en el archivo de anotaciones cronológicas
sscontrol logstatus — mostrar valores de anotaciones cronológicas de servidor

>>-sscontrol--logstatus----------------------------------------><
- logstatus
- Muestra los valores de las anotaciones cronológicas del servidor (nombre de archivo de anotaciones
cronológicas, nivel de registro cronológico y tamaño de las anotaciones cronológicas).
sscontrol manager — controlar el gestor

>>-sscontrol--manager--+-interval--segundos-----------------------------+-><
+-loglevel--nivel--------------------------------+
+-logsize--+-unlimited-+-------------------------+
| '-bytes-----' |
+-metric set--+-loglevel--nivel--------+---------+
| '-logsize--+-unlimited-+-' |
| '-bytes-----' |
+-reach set--+-interval--segundos-----+----------+
| +-loglevel--nivel--------+ |
| '-logsize--+-unlimited-+-' |
| '-bytes-----' |
+-informe--nombre_sitio+ns2+...+nsN--------------+
+-restart--mensaje-------------------------------+
+-sensitivity--peso------------------------------+
+-smoothing--índice de suavizado-----------------+
+-start--+-------------------------------------+-+
| '-archivo_anotaciones--puerto_métrica-' |
+-estado-----------------------------------------+
+-stop-------------------------------------------+
'-versión----------------------------------------'
- interval
- Establece la frecuencia con la que el gestor actualiza los pesos de los servidores.
- segundos
- Número positivo en segundos que representa la frecuencia con la que el gestor actualiza pesos.
El valor predeterminado es 2.
- loglevel
- Establece el nivel de registro cronológico para las anotaciones cronológicas del gestor.
- nivel
- El número del nivel (0 a 5). Cuanto más alto sea el número, más información se anotará en las anotaciones cronológicas del gestor. El valor predeterminado es 1.
Los valores posibles son:
- 0 es Ninguno
- 1 es Mínimo
- 2 es Básico
- 3 es Moderado
- 4 es Avanzado
- 5 es Detallado
- logsize
- Establece el tamaño máximo de las anotaciones cronológicas del gestor. Cuando se establece un tamaño máximo para el archivo de anotaciones cronológicas, el texto del archivo vuelve al principio; es decir,
cuando el archivo alcanza el tamaño especificado, las entradas subsiguientes se anotarán al principio del archivo y se
grabarán encima de las entradas de anotaciones cronológicas anteriores.
El tamaño de las anotaciones cronológicas no puede establecerse más pequeño que el tamaño actual de las anotaciones
cronológicas. Las entradas de las anotaciones cronológicas incluyen la indicación de la hora para poder saber el orden
en el que se anotaron. Cuando más alto se establezca el nivel de anotaciones cronológicas, más cuidado deberá tener al elegir el
tamaño de las anotaciones cronológicas porque, cuando el registro cronológico está establecido en los niveles más altos, puede quedarse
sin espacio rápidamente.
- bytes
- El tamaño máximo en bytes para el archivo de anotaciones cronológicas de gestor. Puede especificar un número positivo mayor que cero o la palabra unlimited.
Es posible que el archivo de anotaciones cronológicas no alcance el tamaño máximo exacto antes de empezar a sobrescribir porque el
tamaño de las entradas del archivo varían. El valor predeterminado es 1 MB.
- metric set
- Establece loglevel y logsize para las anotaciones cronológicas del supervisor de métrica. loglevel es el nivel de registro cronológico del supervisor de métrica (0 - Ninguno,1 - Mínimo,2 - Básico,3 - Moderado, 4 - Avanzado o 5 - Detallado).
El valor predeterminado de loglevel es 1. El logsize es el número máximo de bytes que deben anotarse en el archivo de
anotaciones cronológicas del supervisor de métrica. Puede especificar un número positivo mayor que cero o unlimited.
El valor por omisión de logsize es 1.
- reach set
- Establece el intervalo, el nivel de anotaciones cronológicas y el tamaño de las anotaciones cronológicas para el asesor de alcance.
- report
- Muestra un informe de instantánea de estadísticas.
- nombre_sitio
- El nombre de sitio que desea que se muestre en el informe. Esto es un nombre de sistema principal que no es posible resolver que el cliente solicitará. El nombre de sitio debe ser un nombre de dominio completamente cualificado.
Nota:
Los nombres de sitios adicionales se separan mediante un signo más (+).
- restart
- Reinicia todos los servidores (que no están inactivos) para pesos normalizados (1/2 del peso máximo).
- mensaje
- Mensaje que desea escribir en el archivo de anotaciones cronológicas del gestor.
- sensitivity
- Establece la sensibilidad mínima en la que se actualizan los pesos. Este valor define cuando el gestor debe cambiar su ponderación para el servidor basándose en información externa.
- peso
- Número comprendido entre 0 y 100 utilizado como porcentaje de peso. El valor predeterminado 5 crea una sensibilidad mínima del 5%.
- smoothing
- Establece un índice que suavice las variaciones en el peso al realizar el equilibrio de carga. Un índice de suavizado más alto hará que los pesos de servidores cambien menos radicalmente cuando cambian las condiciones de la red. Un índice más bajo hará que los pesos de servidores cambien de forma más radical.
- índice
- Número de coma flotante positivo. El valor predeterminado es 1,5.
- start
- Inicia el gestor.
- archivo_anotaciones_cronológicas
- Nombre de archivo en el que se anotan los datos del gestor. Cada registro de las anotaciones cronológicas incluye la indicación de la hora.
El archivo por omisión se instala en el directorio
logs. Consulte Apéndice C. Archivos de configuración de ejemplo. Para cambiar el directorio en el que se guardan los archivos de anotaciones cronológicas, consulte el apartado Cambio de las vías de acceso del archivo de anotaciones cronológicas.
- puerto_métrica
- Puerto que Metric Server utiliza para notificar cargas del sistema. Si especifica un puerto de métrica, debe
especificar un nombre de archivo de anotaciones cronológicas. El puerto de métrica predeterminado es 10004.
- status
- Muestra el estado actual y los valores por omisión de todos los valores globales del gestor.
- stop
- Detiene el gestor.
- version
- Visualiza la versión actual del gestor.
Ejemplos
- Establecer el intervalo de actualización del gestor en cada 5 segundos:
sscontrol manager interval 5
- Establecer el nivel de registro en 0 para mejorar el rendimiento:
sscontrol manager loglevel 0
- Establecer el tamaño de las anotaciones cronológicas de gestor en 1.000.000 bytes:
sscontrol manager logsize 1000000
- Obtener una instantánea de estadísticas del gestor:
sscontrol manager report
Este mandato genera una salida parecida a la siguiente:
----------------------------------
| SERVIDOR | ESTADO |
----------------------------------
| 9.67.129.221| ACTIVO|
| 9.67.129.213| ACTIVO|
| 9.67.134.223| ACTIVO|
----------------------------------
--------------------------
| LEYENDA INFORMES GESTOR|
--------------------------
| CPU | Carga CPU |
| MEM | Carga memoria |
| SYS | Métrica sistema |
| NOW | Peso actual |
| NEW | Nuevo peso |
| WT | Peso |
--------------------------
------------------------------------------------------------------------
| miSitio | PESO | CPU 49% | MEM 50% | PUERTO 1%| SYS 0% |
------------------------------------------------------------------------
| |NOW NEW | WT CARGA | WT CARGA | WT CARGA | WT CARGA |
------------------------------------------------------------------------
| 9.37.56.180 | 10 10 |-99 -1|-99 -1|-99 -1| 0 0|
------------------------------------------------------------------------
| TOTALES:| 10 10 | -1| -1| -1| 0|
------------------------------------------------------------------------
-----------------------------------------
| ASESOR | NOM_SITIO:PUERTO|TIEMPO ESP.|
-----------------------------------------
| http | 80 | unlimited |
-----------------------------------------
- Reiniciar todos los servidores en pesos normalizados y escribir un mensaje
en el archivo de anotaciones cronológicas de gestor:
sscontrol manager restart Reiniciando el gestor para actualizar código
Este mandato genera una salida parecida a la siguiente:
320-14:04:54 Reiniciando el gestor para actualizar código
- Establecer la sensibilidad a los cambios de peso en 10:
sscontrol manager sensitivity 10
- Establecer el índice de suavizado en 2.0:
sscontrol manager smoothing 2.0
- Iniciar el gestor
y especificar el archivo de anotaciones cronológicas denominado ndmgr.log
(no se pueden establecer vías de acceso)
sscontrol manager start ndmgr.log
- Visualizar el estado actual de los valores asociados con el gestor:
sscontrol manager status
Este mandato genera una salida parecida al siguiente ejemplo:
Estado del gestor:
=============
Puerto de métrica ............................ 10004
Archivo anotaciones del gestor ............... manager.log
Nivel anotaciones del gestor ................. 1
Tamaño máximo anotaciones de gestor (bytes) .. unlimited
Nivel de sensibilidad ........................ 5
Índice de suavizado .......................... 1,5
Intervalo de actualización (segundos) ........ 2
Ciclo de renovación de pesos ................. 2
Nivel de anotaciones asesor de alcance ....... 1
Tamaño máximo anot. asesor alcance (bytes) ... unlimited
Intervalo intentos acceso a destino (seg.) ... 7
- Detener el gestor:
sscontrol manager stop
- Visualizar el número de versión actual del gestor:
sscontrol manager version
sscontrol metric — configurar métrica del sistema

>>-sscontrol--metric--+-add--nombre_sitio+sn2+...+nsN:métrica+métrica1+...+métricaN------------+-><
+-remove--nombre_sitio+sn2+...+nsN:métrica+métrica1+...+métricaN---------+
+-proporciones--nombre_sitio+ns2+...+nsN:proporción1 prop2 prop3...propN-+
'-estado--nombre_sitio+ns2+...+nsN métrica+métrica1+...+métricaN---------'
- add
- Añadir la métrica específica.
- nombre_sitio
- El nombre de sitio configurado. Los nombres de sitios adicionales se separan mediante un signo más (+).
- métrica
- El nombre del sistema métrico. Debe ser el nombre de un archivo script o ejecutable en el directorio de scripts de Metric Server.
- remove
- Elimina la métrica especificada.
- proporciones
- Proportions determina la importancia de cada métrica en comparación con las demás cuando se combinan en una sola carga del sistema para un servidor.
- status
- Muestra los valores de servidor actuales para esta métrica.
Ejemplos
- Para añadir una métrica de sistema:
sscontrol metric add sitio1:métrica1
- Para establecer proporciones para el nombre de sito con dos métricas de sistema:
sscontrol metric proportions site1 0 100
- Mostrar el estado actual de valores asociados a la métrica especificada:
sscontrol metric status sitio1:métrica1
Este mandato genera
una salida parecida a la siguiente:
Estado de métrica:
------------
nombre_sitio .................. sitio1
Nombre de métrica ............. métrica1
Proporción de métrica ......... 50
Servidor ....... 9.37.56.100
Datos métrica .. -1
sscontrol nameserver — controlar el servidor de nombres

>>-sscontrol--nameserver--+-start--+----------------------+-+--><
| '-bindaddress--address-' |
+-stop----------------------------+
'-status--------------------------'
- start
- Inicia el servidor de nombres.
- bindaddress
- Inicia el enlace del servidor de nombres con la dirección especificada. El servidor de nombres responde sólo a una petición destinada para esta dirección.
- dirección
- Dirección (IP o simbólica) configurada en la máquina Selector de sitio.
- stop
- Detiene el servidor de nombres.
- status
- Muestra el estado del servidor de nombres.
sscontrol rule — configurar normas

>>-sscontrol--rule--+-add--nombre_sitio+ns2+...+nsN:norma+n2+...+nN--type--valor--| valor |--| opc |-+-><
+-dropserver--nombre_sitio+ns2+...+nsN:norma+n2+...+nN--servidor+s2+...+nsN------+
+-remove--nombre_sitio+ns2+...+nsN:norma+n2+...+nN-------------------------------+
+-set--nombre_sitio+ns2+...+nsN:norma+n2+...+nN--| valor |--| opc |--------------+
+-status--nombre_sitio+ns2+...+nsN:norma+n2+...+nN-------------------------------+
'-useserver--nombre_sitio+ns2+...+nsN:norma+n2+...+nN--servidor+s2+...+nsN-------'
opc:
|--+---------------------------------+--------------------------|
+-beginrange--low--endrange--high-+
+-priority--valor-----------------+
'-metricname--valor---------------'
- add
- Añade esta norma a un nombre de sitio.
- nombre_sitio
- Nombre de host que no es posible resolver que el cliente solicitará. El nombre de sitio debe ser un nombre de dominio completamente cualificado. Los nombres de sitios adicionales se separan mediante un signo más (+).
- norma
- Nombre que se selecciona para la regla. Este nombre puede contener cualquier carácter alfanumérico, subrayado,
guión o punto. Puede tener de 1 a 20 caracteres y no puede contener blancos.
Nota:
Las normas adicionales se separan mediante un signo más (+).
- type
- Tipo de norma.
- tipo
- Las opciones de tipo son:
- ip
- La norma se basa en la dirección IP de cliente.
- metricall
- La norma se basa en el valor de métrica actual para todos los servidores en el conjunto de servidores.
- metricavg
- La norma se basa en el promedio de los valores de métrica actual para todos los servidores en el conjunto de servidores.
- time
- La norma se basa en la hora del día.
- true
- Esta norma es siempre cierta. Piense en ella como si fuera una sentencia else en lógica de programación.
- beginrange
- El valor más pequeño del rango utilizado para determinar si una norma es cierta.
- bajo
- Depende del tipo de regla. El tipo de valor y su valor por omisión se listan según el tipo de norma:
- ip
- La dirección del cliente, en forma de nombre simbólico o en un formato de dirección IP. El valor por omisión es 0.0.0.0.
- hora
- Número entero. El valor por omisión es 0, que representa medianoche.
- metricall
- Número entero. El valor por omisión es 100.
- metricavg
- Número entero. El valor por omisión es 100.
- endrange
- El valor más alto del rango utilizado para determinar si la norma es cierta.
- alto
- Depende del tipo de regla. El tipo de valor y su valor por omisión se listan según el tipo de norma:
- ip
- La dirección del cliente, en forma de nombre simbólico o en un formato de dirección IP. El valor por omisión es 255.255.255.254.
- hora
- Número entero. El valor por omisión es 24, que representa medianoche.
Nota:
Al definir beginrange y endrange de los intervalos de tiempo, tenga en cuenta que cada valor debe ser un entero que represente sólo la porción de la hora del tiempo; no se especifican las fracciones de una hora.
Por esta razón, para especificar una sola hora, por ejemplo la hora entre las 3:00 y las 4:00, debería especificar 3 en beginrange y también 3 en endrange. Esto indicará todos los minutos, empezando en 3:00 y terminando en 3:59. Si especifica 3 en beginrange y 4 en endrange, abarcará un periodo de dos horas, de las 3:00 hasta las 4:59.
- metricall
- Número entero. El valor por omisión es 2 elevado a la 32 menos 1.
- metricavg
- Número entero. El valor por omisión es 2 elevado a la 32 menos 1.
- priority
- El orden en el que se revisan las normas.
- nivel
- Número entero. Si no especifica la prioridad de la primera norma que añade, por omisión
Selector de sitio la establece en 1. Cuando posteriormente se añade otra norma, por omisión su prioridad se calcula sumando 10 a la prioridad más baja actual de cualquier norma existente. Por ejemplo, suponga que tiene una norma existente con una prioridad 30. Añada una nueva norma con la prioridad 25 (que es una prioridad más alta que 30). A continuación, añada una tercera norma sin establecer la prioridad. La prioridad de la tercera norma se calculará como 40 (30 + 10).
- metricname
- Nombre de la métrica medida para una norma.
- dropserver
- Eliminar un servidor de un conjunto de reglas.
- servidor
- Dirección IP de la máquina servidor TCP como nombre simbólico o en formato de dirección IP.
Nota:
Los nombres de sitios adicionales se separan mediante un signo más (+).
- remove
- Elimina una o más normas, separadas entre sí por signos más.
- set
- Establece los valores para esta regla.
- status
- Muestra todos los valores de una o más normas.
- useserver
- Inserta el servidor en un conjunto de normas.
Ejemplos
- Para añadir una norma que será siempre cierta, no especifique el inicio del rango ni el fin del rango:
sscontrol rule add nombresitio:nombreregla type true priority 100
- Crear una norma que prohíba el acceso a un rango de direcciones IP, en este caso las que empiecen por “9”:
sscontrol rule add nombresitio:nombreregla type ip b 9.0.0.0 e 9.255.255.255
- Crear una norma que especificará el uso de un servidor específico desde las 11:00 hasta las 15:00.
sscontrol rule add nombresitio:nombrenorma type time beginrange 11 endrange 14
sscontrol rule useserver sitename:rulename server05
sscontrol server — configurar servidores

>>-sscontrol--server--+-add--nombre_sitio+sn2+...+nsN:servidor+s2+...+sN--+------------------------+-+-><
| +-metricaddress--address-+ |
| '-weight--valor----------' |
+-down--nombre_sitio+sn2+...+nsN:servidor+s2+...+sN----------------------------+
+-remove--nombre_sitio+sn2+...+nsN:servidor+s2+...+sN--------------------------+
+-set--nombre_sitio+sn2+...+nsN:servidor+s2+...+sN--+------------------------+-+
| +-metricaddress--address-+ |
| '-weight--valor----------' |
+-status--nombre_sitio+sn2+...+nsN:servidor+s2+...+sN--------------------------+
'-up--nombre_sitio+sn2+...+nsN:servidor+s2+...+sN------------------------------'
- add
- Añade este servidor.
- nombre_sitio
- Nombre de host que no es posible resolver que el cliente solicitará. El nombre de sitio debe ser un nombre de dominio completamente cualificado. Los nombres de sitios adicionales se separan mediante un signo más (+).
- servidor
- Dirección IP de la máquina servidor TCP como nombre simbólico o en formato de dirección IP.
Nota:
Los servidores adicionales se separan mediante un signo más (+).
- metricaddress
- Dirección de Metric Server.
- dirección
- La dirección del servidor, en forma de nombre simbólico o en un formato de dirección IP.
- weight
- Número comprendido entre 1 y 100 (no exceda el máximo valor de ponderación del puerto del nombre del sitio especificado) que representa el peso de este servidor. Si se establece el peso en cero, se impedirá que se envíen nuevas peticiones al servidor. El valor por omisión es la mitad del máximo valor de ponderación del nombre de sitio especificado. Si el gestor se está ejecutando, este valor se sobrescribirá.
- valor
- El valor de peso del servidor.
- down
- Marca este servidor como inactivo. Este mandato impide que se resuelva cualquier otra petición para dicho servidor.
- remove
- Elimina este servidor.
- set
- Establece los valores para este servidor.
- status
- Muestra el estado de los servidores.
- up
- Marca este servidor como activo. Selector de sitio ahora resolverá nuevas peticiones para dicho servidor.
Ejemplos
- Añadir el servidor con la dirección 27.65.89.42 al nombre de sitio sitio1:
sscontrol server add sitio1:27.65.89.42
- Marcar el servidor en 27.65.89.42 como activo:
sscontrol server down sitio1:27.65.89.42
- Eliminar el servidor en 27.65.89.42 para todos los nombres de sitios:
sscontrol server remove :27.65.89.42
- Marcar el servidor en 27.65.89.42 como activo:
sscontrol server up sitio1:27.65.89.42
sscontrol set — configurar anotaciones cronológicas de servidor

>>-sscontrol--estableciendo--+-loglevel--nivel--------+--------><
'-logsize--+-unlimited-+-'
'-size------'
- loglevel
- El nivel en el que el ssserver anota sus actividades.
- nivel
- El valor por omisión de loglevel es 0. Los valores posibles son:
- 0 es Ninguno
- 1 es Mínimo
- 2 es Básico
- 3 es Moderado
- 4 es Avanzado
- 5 es Detallado
- logsize
- El número máximo de bytes que se deben anotar en el archivo de anotaciones cronológicas.
- tamaño
- El valor predeterminado de logsize es 1 MB.
sscontrol sitename — configurar un nombre de sitio

>>-sscontrol--sitename--+-add--nombre_sitio+ns2+...+nsN--+-----------------------------------------+-+-><
| +-cachelife--valor------------------------+ |
| +-networkproximity--yes | no--------------+ |
| +-proportions--cpu--memoria--port--metric-+ |
| +-proximitypercentage--valor--------------+ |
| +-stickytime--time------------------------+ |
| +-ttl--time-------------------------------+ |
| +-waitforallresponses--yes | no-----------+ |
| '-weightbound--peso-----------------------' |
+-remove--nombre_sitio+ns2+...+nsN-------------------------------------------+
+-set--nombre_sitio+ns2+...+nsN--+-----------------------------------------+-+
| +-cachelife--valor------------------------+ |
| +-networkproximity--yes | no--------------+ |
| +-proportions--cpu--memoria--port--metric-+ |
| +-proximitypercentage--valor--------------+ |
| +-stickytime--time------------------------+ |
| +-ttl--time-------------------------------+ |
| +-waitforallresponses--yes | no-----------+ |
| '-weightbound--peso-----------------------' |
'-status--nombre_sitio+ns2+...+nsN-------------------------------------------'
- add
- Añade un nuevo nombre de sitio.
- nombre_sitio
- Nombre de sistema principal que no se puede resolver, solicitado por el cliente. Los nombres de sitios adicionales se separan mediante un signo más (+).
- cachelife
- Cantidad de tiempo que una respuesta de proximidad será válida y se guardará en la antememoria.
El valor predeterminado es 1800. Consulte el apartado Utilización de la característica proximidad de red para obtener más información.
- valor
- Número positivo que representa el número de segundos que una respuesta de proximidad será válida y se guardará en la antememoria.
- networkproximity
- Determina la proximidad de red de cada servidor al cliente que realiza la petición.
Utilice esta respuesta de proximidad en la decisión de equilibrio de carga. Activa o desactiva la proximidad.
Consulte el apartado Utilización de la característica proximidad de red para obtener más información.
- valor
- Las opciones son sí o no. El valor predeterminado es no, que significa que la proximidad de red está desactivada.
- proporciones
- Establece la proporción de la importancia para la CPU, la memoria, el puerto (información de todos los asesores) y la métrica del sistema del Metric Server que utiliza el gestor para establecer pesos de servidor.
Cada uno de estos valores se expresan como porcentaje del total y el total siempre es 100.
- cpu
- El porcentaje de la CPU en uso para cada máquina servidor con equilibrio de carga (entrada del agente de Metric Server).
- memoria
- El porcentaje de la memoria en uso (entrada del agente de Metric Server) en cada servidor con equilibrio de carga
- puerto
- La entrada de los asesores que escuchan en el puerto.
- sistema
- La entrada desde Metric Server.
- proximitypercentage
- Establece la importancia de la respuesta de proximidad frente al estado del servidor (peso del gestor). Consulte el apartado Utilización de la característica proximidad de red para obtener más información.
- valor
- El valor predeterminado es 50.
- stickytime
- El intervalo durante el que un cliente recibirá el mismo ID de servidor devuelto anteriormente para la primera petición. El valor por omisión de stickytime es 0, lo que significa que el nombre de sitio no es permanente en memoria.
- tiempo
- Número positivo distinto de cero que representa el número de segundos durante los que el cliente recibe el mismo ID de servidor devuelto anteriormente para la primera petición.
- ttl
- Establece la duración. Esto indica cuánto tiempo otro servidor de nombres guardará en la antememoria la respuesta resuelta. El valor predeterminado es 5.
- valor
- Número positivo que representa el número de segundos que el servidor de nombres guardará en la antememoria la respuesta resuelta.
- waitforallresponses
- Establece si se debe esperar a recibir todas las respuestas de proximidad de los servidores antes de responder a la petición de cliente. Consulte el apartado Utilización de la característica proximidad de red para obtener más información.
- valor
- Las opciones son sí o no. El valor predeterminado es no.
- weightbound
- Número que representa el peso máximo que puede establecerse para los servidores en este nombre de sitio.
El valor de weightbound establecido para el nombre de sitio puede alterarse temporalmente para servidores individuales mediante server weight. El valor por omisión de sitename weightbound es 20.
- peso
- El valor de weightbound.
- set
- Establece las propiedades del nombre del sitio.
- remove
- Elimina este nombre de sitio.
- status
- Muestra el estado actual de un nombre de sitio específico.
Ejemplos
- Añadir un nombre de sitio:
sscontrol sitename add 130.40.52.153
- Activar la proximidad de red:
sscontrol sitename set mySite networkproximity yes
- Establecer la duración de antememoria en 1900000 segundos:
sscontrol sitename set mySite cachelife 1900000
- Establecer el porcentaje de proximidad 45:
sscontrol sitename set mySite proximitypercentage 45
- Establecer un nombre de sitio de forma que no espere todas las respuestas antes de responder:
sscontrol sitename set miSitio waitforallresponses no
- Establecer la duración en 7 segundos:
sscontrol sitename set mySite ttl 7
- Establecer la proporciones de la importancia para CpuLoad, MemLoad, Port y System
Metric, respectivamente:
sscontrol sitename set mySite proportions 50 48 1 1
- Eliminar un nombre de sitio:
sscontrol sitename remove 130.40.52.153
- Mostrar el estado para el nombre de sitio miSitio:
sscontrol sitename status mySite
Este mandato genera una salida parecida a la siguiente:
Estado del nombre del sitio:
---------------
Nombre de sitio .................... miSitio
Ponderación ........................ 20
TTL ................................ 5
Tiempo permanencia en memoria ...... 0
Número de servidores ............... 1
Proporción asignada a CpuLoad ...... 49
Proporción asignada a MemLoad ...... 50
Proporción asignada a Port ......... 1
Proporción asignada a métrica sist . 0
Asesor ejecutándose en puerto ...... 80
Utilización de proximidad .......... N
sscontrol status — mostrar si el gestor y los asesores se están ejecutando

>>-sscontrol--estado-------------------------------------------><
Ejemplos