Red Hat Training

A Red Hat training course is available for Red Hat Enterprise Linux

4.3. Valores predeterminados de archivo de configuración

El archivo de configuración /etc/multipath.conf incluye una sección de defaults (predeterminados) que establece el parámetro user_friendly_names a yes, así: 
defaults {
        user_friendly_names yes
}
Así se anula el valor predeterminado del parámetro user_friendly_names.
El archivo de configuración incluye una plantilla de valores predeterminados de configuración. Esta sección está comentada, así: 
#defaults {
#       udev_dir                /dev
#       polling_interval        5
#       path_selector           "round-robin 0"
#       path_grouping_policy    failover
#       getuid_callout          "/lib/dev/scsi_id --whitelisted --device=/dev/%n"
#	prio			const
#	path_checker		directio
#	rr_min_io		1000
#	rr_weight		uniform
#	failback		manual
#	no_path_retry		fail
#	user_friendly_names	no
#}
Para sobrescribir el valor predeterminado de cualquiera de los parámetros de configuración, copie la línea pertinente de esta plantilla en la sección defaults y quítele el comentario (#). Por ejemplo, pare sobrescribir el parámetro path_grouping_policy para que sea multibus en lugar del valor predeterminado failover, copie la línea apropiada de la plantilla a la sección inicial defaults del archivo de configuración, y remueva el comentario, así: 
defaults {
        user_friendly_names     yes
        path_grouping_policy    multibus
}
Describe los atributos establecidos en la sección defaults del archivo de configuración multipath.conf. Estos valores son utilizados por DM-Multipath a menos que sean anulados por los atributos especificados en las secciones devices y multipaths del archivo multipath.conf.

Nota

A partir del lanzamiento de Red Hat Enterprise Linux 6.0, los parámetros mode, uid, y gid han sido descontinuados. Los permisos para dispositivos device-mapper (incluidos los mapas multirrutas) se establecen mediante las reglas udev. Existe un archivo de plantilla en /usr/share/doc/device-mapper-version llamado 12-dm-permissions.rules, el cual debe colocar en el directorio /etc/udev/rules.d para que se pueda efectuar.

Tabla 4.1. Valores predeterminados de configuración Multipath

Atributo Descripción
polling_interval Especifica el intervalo en segundos entre dos revisiones de rutas. Para rutas que funcionan correctamente, el intervalo entre revisiones gradualmente aumentará a (4 * polling_interval). El valor predeterminado es 5.
udev_dir El directorio donde se crean los nodos de dispositivos udev. El valor predeterminado es /dev.
multipath_dir El directorio donde se almacenan los objetos compartidos dinámicos. El valor predeterminado depende del sistema, comúnmente /lib/multipath.
find_multipaths
Define el modo para establecer los dispositivos multirrutas. Si este parámetro se establece a yes, entonces no intentará crear un dispositivo para cada ruta que no esté en lista negra. En su lugar, Multipath creará un dispositivo solo si alguna de estas tres condiciones se cumple:
- Hay al menos dos rutas que no están en la lista negra con el mismo WWID.
- El usuario fuerza en forma manual la creación del dispositivo al especificar un dispositivo con el comando multipath.
- Una ruta tiene el mismo WWID como dispositivo multirrutas creado anteriormente. Cuando un dispositivo multirrutas sea creado con find_multipaths, multipath recuerda el WWID del dispositivo para que automáticamente cree nuevamente el dispositivo tan pronto como vea la ruta con ese WWID. De esta manera, puede hacer que multipath elija automáticamente las rutas correctas para convertir en dispositivos multirrutas, sin tener que editar la lista negra de multirrutas. Para obtener instrucciones sobre el procedimiento a seguir si ha creado anteriormente dispositivos multirrutas cuando el parámetro find_multipaths no esta establecido, la consulte la Sección 4.2, “Lista negra de archivo de configuración”.
El valor predeterminado es no.
verbosity La verbosidad predeterminada. Los valores superiores aumentan el nivel de verbosidad. Los niveles válidos están entre O y 6. El valor predeterminado es 2.
path_selector
Especifica el algoritmo por defecto a utilizar al determinar la ruta a usar para la siguiente operación de E/S. Posibles valores incluyen:
round-robin 0: Bucle a través de cada ruta en el grupo de rutas, enviando la misma cantidad de E/S a cada una.
queue-length 0: Envía el siguiente grupo de E/S a la ruta con el número inferior de solicitudes de E/S.
service-time 0: Envía el siguiente grupo de E/S a la ruta con el menor tiempo de servicio estimado, el cual se determina al dividir el tamaño total de la E/S pendiente para cada ruta por el rendimiento relativo.
El valor predeterminado es round-robin 0.
path_grouping_policy
Especifica la directiva de agrupación de ruta predeterminada para aplicar multirrutas no específicas. Los posibles valores incluyen:
failover: 1 ruta por grupo de prioridad.
multibus: todas las rutas en grupo de prioridad 1.
group_by_serial: grupo de prioridad 1 por número de serie detectado.
group_by_prio: grupo de prioridad 1 por valor de prioridad de ruta. Las prioridades están determinadas por programas de llamadas especificadas como globales, por-controlador, o por opciones de multirrutas.
group_by_node_name: grupo de prioridad 1 por nombre de nodo de destino. Los nombres de nodo de destino se obtienen en /sys/class/fc_transport/target*/node_name.
El valor predeterminado es failover.
getuid_callout
Especifica el programa predeterminado y los argumentos de llamada para obtener un identificador de rutas único. Se requiere una ruta absoluta.
El valor por defecto es /lib/udev/scsi_id --whitelisted --device=/dev/%n.
prio
Especifica la función predeterminada de llamada para obtener un valor de prioridad de ruta. Por ejemplo, los bits ALUA en SPC-3 proporcionan un valor prio explotable. Los posibles valores incluyen:
const: Establece una prioridad de 1 para todas las rutas.
emc: Genera la prioridad de ruta para matrices EMC.
alua: Genera la prioridad de ruta basada en las configuraciones de SCSI-3 ALUA.
tpg_pref: Genera la prioridad de ruta basada en las configuraciones de SCSI-3 ALUA, mediante el bit de puerto preferido.
ontap: Genera la prioridad de ruta para matrices NetApp.
rdac: Genera la prioridad de ruta para el controlador LSI/Engenio RDAC.
hp_sw: Genera la prioridad de ruta para el controlador Compaq/HP en modo activo/alerta.
hds: Genera la prioridad de ruta para matrices de almacenaje Hitachi HDS Modular.
El valor predeterminado es const.
features Las funciones adicionales de los dispositivos multirrutas. La única funcionalidad existente es queue_if_no_path, la cual es lo mismo que establecer no_path_retry a queue. Para obtener información sobre problemas que se puedan presentar al utilizar esta funcionalidad, consulte la Sección 5.6, “Problemas con la función queue_if_no_path”.
path_checker
Especifica el método predeterminado utilizado para determinar el estado de las rutas. Los posibles valores incluyen:
readsector0: Lee el primer sector del dispositivo.
tur: Expide un TEST UNIT READY para el dispositivo.
emc_clariion: Busca la OxCO de la página EVPD específica de EMC Clariion para determinar la ruta.
hp_sw: Revisa el estado de ruta para matrices de almacenaje HP con firmware Activo/Alerta.
rdac: Revisa la estadística de la ruta para el controlador de almacenaje LSI/Engenio RDAC.
directio: Lee el primer sector con E/S directas.
El valor predeterminado es directio.
failback
Administra la recuperación de grupo de rutas.
El valor immediate especifica recuperación inmediata para el grupo de rutas de más alta prioridad contiene rutas activas.
El valor manual especifica que no debe haber recuperación inmediata, sino que puede suceder únicamente con la intervención del operador.
El valor followover especifica que se debe efectuar recuperación automática cuando la primera ruta de un grupo de rutas se activa. Así, se impide que un nodo falle cuando se haya solicitado la conmutación de otro nodo.
Un valor numérico mayor que cero especifica la recuperación, expresada en segundos.
El valor predeterminado es manual.
rr_min_io Especifica el número de peticiones de E/S para dirigirse a esta ruta antes de cambiar a la siguiente ruta en el grupo actual. Este parámetro solamente es para sistemas que ejecutan kérneles anteriores a 2.6.31. Los sistemas más recientes deben utilizar rr_min_io_rq. El parámetro predeterminado es 1000.
rr_min_io_rq Especifica el número de peticiones de E/S para dirigirse a esta ruta antes de cambiar a la siguiente ruta en el grupo actual. Este parámetro debe utilizarse en sistemas que ejecutan kérneles actuales. En sistemas que ejecutan kérneles anteriores a 2.6.31, utilice rr_min_io_rq. El valor predeterminado es 1.
rr_weight Si se establece a priorities, entonces, en lugar de enviar las peticiones rr_min_io a una ruta antes de llamar a path_selector para escoger la siguiente, el número de peticiones a enviar es determinado por rr_min_io multiplicado por la prioridad de la ruta, tal como lo determina la función prio. Si se establece a uniform, todos los valores serán iguales. El valor predeterminado es uniform.
no_path_retry
Un valor numérico para este atributo especifica el número de veces que el sistema debe intentar utilizar una ruta fallida antes de inhabilitar la cola.
Un valor de fail indica falla inmediata, sin cola.
Un valor de queue indica que la cola no debe parar sino hasta que la ruta sea corregida.
El valor por defecto es 0.
user_friendly_names Si se establece a yes, especifica que el sistema debe utilizar el archivo /etc/multipath/bindings para asignar un alias persistente y único al multirrutas, en la forma de mpathn. Si se establece a no, especifica que el sistema debe usar el WWID como el alias para multirrutas. En cualquier caso, lo que se especifica aquí será anulado por cualquier alias específico de dispositivo especificado en la sección multipaths del archivo de configuración. El valor por defecto es no.
queue_without_daemon Si se establece a no, el daemon multipathd inhabilitará la cola para todos los dispositivos cuando se haya apagado. El valor por defecto es no.
flush_on_last_del Si se establece a yes, el daemon multipathd inhabilitará la cola cuando la última ruta a un dispositivo haya sido borrada. El valor por defecto es no.
max_fds Establece el número máximo de descriptores de archivos abiertos que multirrutas y el daemon multipathd pueden abrir. Es equivalente al comando ulimit -n. A partir del lanzamiento de Red Hat Enterprise Linux 6.3, el valor predeterminado es max, el cual lo establece al límite del sistema desde /proc/sys/fs/nr_open. Para lanzamientos anteriores, si este valor no se establece al máximo número de descriptores de archivos abiertos se tomará desde el proceso de llamada; suele ser 1024. Para estar seguro, se debe establecer al número máximo de rutas más 32, si ese número es mayor que 1024.
checker_timeout Tiempo de expiración para usar los verificadores de rutas que establecen comandos con un tiempo de espera explícito. El valor predeterminado se toma de sys/block/sdx/device/timeout.
fast_io_fail_tmo El número de segundos que la capa SCSI esperará después de que se haya detectado un problema en un puerto remoto FC antes que falle E/S a dispositivos en ese puerto remoto. Este valor debe ser inferior al valor de dev_loss_tmo. Al establecerlo a off se desactivará el tiempo de espera. El SO determina el valor predeterminado.
dev_loss_tmo El número de segundos que la capa SCSI esperará después de que un problema haya sido detectado en un puerto FC remoto antes de retirarlo del sistema. Si establece este parámetro a infinito se establecerá a 2147483647 segundos, o 68 años. El SO determina el valor predeterminado.
hwtable_regex_match
(Lanzamiento de Red Hat Enterprise Linux 6.3 y posterior) controla cómo multirrutas se integra a las configuraciones de dispositivo desde la sección devices del archivo de configuración con las configuraciones de dispositivos incorporados.
Cada configuración en la sección de devices del archivo multipath.conf creará su configuración de dispositivo o modificará alguna de las configuraciones de dispositivos incorporadas. Antes de Red Hat Enterprise Linux 6.3, si el vendedor, el producto y las cadenas de revisión en una configuración de dispositivos de usuario coincidían exactamente con las cadenas en una configuración de dispositivo incorporada, la configuración incorporada era modificada por las opciones en la configuración de usuario. De lo contrario, la configuración de usuario sería tratada como una nueva configuración.
Si hwtable_regex_match se establece a yes, una expresión regular coincidente será utilizada en su lugar. El vendedor, el producto y las cadenas de revisión son todas expresiones regulares. Los valores de configuración de dispositivos de usuario para estas opciones coinciden con las de los valores de configuración de dispositivos incorporados. Esta concordancia funciona de la misma forma que el producto de vendedor del dispositivo real y las cadenas de revisión se comparan con las cadenas de configuración de dispositivos para ver qué configuración debe utilizarse para el dispositivo. Si la configuración del dispositivo de usuario coincide, entonces la configuración incorporada es modificada por las opciones en la configuración de usuario. De lo contrario, la configuración de dispositivos de usuario es considerada como una nueva configuración.
retain_attached_hw_handler (Red Hat Enterprise Linux Release 6.4 y posterior) Si este parámetro se establece a yes y la capa SCSI ya tiene conectado un manejador de hardware al dispositivo de rutas, multirrutas no forzará al dispositivo para que utilice el hardware_handler especificado por el archivo mutipath.conf. Si la capa SCSI no tiene conectado un manejador de hardware, mutirrutas continuará usando su manejador de hardware como siempre. El valor predeterminado es no.
detect_prio (Red Hat Enterprise Linux Release 6.4 y posterior) Si se establece a yes, multirrutas revisará primero si el dispositivo soporta ALUA, y si lo hace, asignará automáticamente el dispositivo que otorga prioridades alua. Si el dispositivo no soporta ALUA, determinará el dispositivo que otorga prioridades como lo hace siempre. El valor predeterminado es no.