Ajuste de las propiedades del controlador de destino de disco

Idioma:

En este apéndice, se explica cómo ajustar las propiedades del controlador de destino de disco Oracle Solaris (controlador sd o ssd) en el archivo .conf mediante el uso de la propiedad global ssd-config-list o sd-config-list.

El apéndice describe los siguientes formatos para ajustar las propiedades del controlador de destino de disco:

Parámetros ajustables para controladores de disco

Los parámetros ajustables para un controlador de disco utilizan las siguientes categorías prefijadas:

BCD: Decimal de código binario, como se muestra en la Table D–1
delay: Tiempo de demora en emisión de reintento
timeout: Tiempo máximo permitido por un proceso
reset: Control de restablecimiento
retries: Número de reintentos antes de fallo
throttle: Control de actividad

Los siguientes nombres ajustables y sus tipos de datos son admitidos por Oracle Solaris 10 y Oracle Solaris 11:

caché no volátil: BOOLEAN
tipo de controlador: UINT32
delay-busy: UINT32
disksort: BOOLEAN
emulation-rmw: UINT32
physical-block-size: UINT32
reset-lun: BOOLEAN
retries-busy: UINT32
retries-timeout: UINT32
retries-notready: UINT32
retries-reset: UINT32
rmw-type: UINT32
timeout-releasereservation: UINT32
throttle-max: UINT32
throttle-min: UINT32

Los parámetros ajustables que solo se admiten en Oracle Solaris 11 son todos de tipos de datos BOOLEAN. Los parámetros son:

cdb-suppress-dpofua
mmc-gesn-polling
power-condition

Notas - El valor BOOLEAN debe ser TRUE o FALSE.

`Name`: formato de par `Value` para ajustar controladores de disco

Los controladores sd y ssd admiten el formato name:value JSON-text, que le permite especificar valores de propiedad ajustable específicos.

Use la siguiente sintaxis para un controlador sd:

sd-config-list = duplet [, duplet]*;

Notas - Asegúrese de finalizar la entrada con un punto y coma o la configuración no será válida y las propiedades conservarán sus valores por defecto.

Use la siguiente sintaxis para un controlador ssd:

ssd-config-list = duplet [, duplet]*;

donde, duplet es "VID PID", "tunable [, tunable]*"

VID: Contenido del campo de identificación de proveedor (VID) de la respuesta de dispositivo para un comando INQUIRY SCSI. El campo VID debe tener ocho caracteres de largo. Si el campo VID tiene menos de ocho caracteres, debe agregar espacios en blanco para que el largo del VID sea de ocho caracteres. Consulte Example D–1.
PID: Contenido del campo de identificación de producto (PID) de la respuesta del dispositivo a un comando INQUIRY SCSI. El PID puede contener un máximo de 16 caracteres ajustados a la izquierda. Si proporciona menos de 16 caracteres, la comparación está limitada al largo del PID que proporcionó.
tunable[, tunable] *: tunable es el name: par value.

Notas - Si escribe incorrectamente un valor ajustable o no finaliza la entrada con un punto y coma, la configuración no será válida y las propiedades del dispositivo conservarán sus valores por defecto.

El valor PID se considera una coincidencia cuando el valor de prefijo devuelto por el comando INQUIRY de SCSI y el PID en sd-config-list o ssd-config-list son iguales. Por ejemplo, se considera una coincidencia si CMS200 es el PID en la entrada sd-config-list o ssd-config-list y si el PID devuelto por el comando INQUIRY SCSI es CMS200-R, CMS200-T o CMS200-UV10.

En una plataforma SPARC, los dispositivos de destino pueden estar vinculados a un controlador sd o ssd según si el dispositivo es un dispositivo FC o si MPxIO está activado en el dispositivo. Puede usar el comando prtconf para controlar la información de configuración del dispositivo. Consulte la página del comando man prtconf(1M).

Ejemplo D-1 Configuración de dos dispositivos de destino en un archivo sd.conf

El siguiente ejemplo muestra cómo configurar dos dispositivos de destino SAMPLE y SUM en un archivo sd.conf.

sd-config-list = "SAMPLE  STTU1234566AB", "delay-busy:6000000000", 
                 "SUM     ABC200_R", "retries-busy:5, throttle-max:300";

En este ejemplo, para el dispositivo SAMPLE, el VID es SAMPLE y el PID es STTU1234566AB. El tiempo de retraso antes de volver a intentar es de 6 segundos.

Para el SUM del dispositivo, el VID es SUM y el PID es ABC200_R. El número de reintentos en un estado ocupado de E/S se define en 5. El valor máximo de acelerador se define en 300.

Ejemplo D-2 Configuración de dos dispositivos de destino en un archivo ssd.conf

El siguiente ejemplo muestra cómo configurar dos dispositivos de destino GATES y SINE en un archivo ssd.conf.

ssd-config-list = "GATES   AB568536611CD46G", "reset-lun:TRUE", 
                  "SINE    XYZ200_R", "retries-notready:6, throttle-min:200";

En este ejemplo, para el GATES del dispositivo, el VID es GATES y el PID es AB568536611CD46G. El valor TRUE para el parámetro ajustable reset-lun indica que el LUN se restableció.

Para el SINE del dispositivo, el VID es SINE y el PID es XYZ200_R. El número de reintentos cuando la E/S no está lista se define en 6. El valor mínimo de acelerador se define en 200.

Formato de enmascaramiento de bits para ajustar los controladores de disco

Puede ajustar parámetros mediante el uso del formato de enmascaramiento de bits, también conocido como formato Version1. El formato de enmascaramiento incluye la propiedad sd-config-list, que contiene entradas para la matriz de bit.

Use la siguiente sintaxis para un controlador sd:

sd-config-list = duplet [, duplet ]*;
sd-ver1-conf-data = 1, mask, value-sequence;

Notas - Asegúrese de finalizar la entrada con un punto y coma o la configuración no será válida y las propiedades conservarán sus valores por defecto.

Use la siguiente sintaxis para un controlador ssd:

ssd-config-list = duplet [, duplet ]*;
sd-ver1-conf-data = 1, mask, value-sequence;

donde duplet es "VID PID", "sd-ver1-conf-data"

VID

Contenido de campo de identificación de proveedor (VID) de la respuesta de dispositivo para un comando INQUIRY SCSI. El campo VID debe tener ocho caracteres de largo. Si el campo de identificador de proveedor tiene menos de ocho caracteres, debe agregar espacios en blanco para que el largo del VID sea de ocho caracteres.

PID

Contenido del campo de identificación de producto (PID) de la respuesta del dispositivo a un comando INQUIRY SCSI. El PID puede contener un máximo de 16 caracteres ajustados a la izquierda. Si proporciona menos de 16 caracteres, la comparación está limitada al largo del PID que proporcionó.

sd-ver1-conf-data

La matriz de propiedad consiste en un número de versión, que es 1, un número de máscara y valores ajustables para definir.

mask: Valor entre 0x01 y 0x7FFFF. El valor de mask a veces puede ser el resultado OR de múltiples indicadores deseados. La Table D–1 muestra el valor de bit de cada parámetro ajustable.
value-sequence: Secuencia de valores de propiedad válidos y número de 0 correspondientes al valor de mask. El límite de largo de value-sequence es de 19 caracteres. Consulte Parámetros ajustables para controladores de disco para conocer el tipo de datos de parámetros ajustables.

Notas - Las duplas con diferentes VID y PID comparten la misma matriz de propiedad sd-ver1-conf-data o definen su propia matriz de propiedad. Puede personalizar el nombre de matriz de propiedad.

El valor PID se considera una coincidencia cuando el comando INQUIRY de SCSI y el PID en sd-config-list o ssd-config-list son iguales. Por ejemplo, si CMS200 es el PID en la entrada sd-config-list o ssd-config-list y si el PID devuelto por el comando INQUIRY SCSI es CMS200-R, CMS200-T o CMS200-UV10 se considera una coincidencia.

La definición de la posición de cada bit depende de la plataforma. Es posible que un valor ajustable se corresponda con un valor de indicador diferente en una plataforma diferente. Oracle Solaris 11 y Oracle Solaris 10 admiten el mismo conjunto de19 parámetros ajustables en el formato de enmascaramiento de bits.

La siguiente tabla muestra los parámetros ajustables y sus valores de indicador en plataformas diferentes.

Tabla D-1 Parámetros ajustables admitidos y sus valores de indicador en las diferentes plataformas

Bit	Valor de indicador	Controlador sd en SPARC	Controlador ssd en SPARC	Controlador sd en x86 o x64
1	0x00001	`throttle-max`	`throttle-max`	`throttle-max`
2	0x00002	`controller-type`	`retries-notready`	`controller-type`
3	0x00004	`retries-notready`	`retries-busy`	`fab-devid`
4	0x00008	`fab-devid`	`fab-devid`	`disable_caching`
5	0x00010	`disable_caching`	`disable_caching`	`BCD-play`
6	0x00020	`retries-busy`	`controller-type`	`BCD-read-subchannel`
7	0x00040	`BCD-play`	`BCD-play`	`BCD-read-TOC-TRK`
8	0x00080	`BCD-read-subchannel`	`BCD-read-subchannel`	`BCD-read-TOC-ADDR`
9	0x00100	`BCD-read-TOC-TRK`	`BCD-read-TOC-TRK`	`no-READ-HDR`
10	0x00200	`BCD-read-TOC-ADDR`	`BCD-read-TOC-ADDR`	`CD-read-XD4`
11	0x00400	`no-READ-HDR`	`no-READ-HDR`	`retries-notready`
12	0x00800	`CD-read-XD4`	`CD-read-XD4`	`retries-busy`
13	0x01000	`retries-reset`	`retries-reset`	`retries-reset`
14	0x02000	`timeout-releasereservation`	`timeout-releasereservation`	`timeout-releasereservation`
15	0x04000	`tur-check`	`tur-check`	`tur-check`
16	0x08000	`throttle-min`	`throttle-min`	`throttle-min`
17	0x10000	`disksort`	`disksort`	`disksort`
18	0x20000	`reset-lun`	`reset-lun`	`reset-lun`
19	0x40000	`cache-nonvolatile`	`cache-nonvolatile`	`cache-nonvolatile`

Ejemplo D-3 Configuración de parámetros ajustables para un controlador sd en una plataforma x86

Este ejemplo muestra cómo ajustar los parámetros en un archivo sd.conf en una plataforma x86.

sd-config-list = "SUM     ABC200_R","sd-ver1-x86-example";
sd-ver1-x86-example = 1,0x801,300,0,0,0,0,0,0,0,0,0,0,5,0,0,0,0,0,0,0;

En este ejemplo, para el SUM del dispositivo, el VID es SUM y el PID es ABC200_R.

El valor de máscara 0x801 es el valor OR de bit de los indicadores 0x00800 y 0x00001. Estos valores son parámetros ajustables retries-busy y throttle-max en una plataforma x86.

Ejemplo D-4 Configuración de parámetros ajustables para un controlador ssd en una plataforma SPARC

Este ejemplo muestra cómo ajustar los parámetros en un archivo ssd.conf en una plataforma SPARC.

ssd-config-list = "SUM     XYZ200_R","sd-ver1-ssd-example";
sd-ver1-ssd-example = 1,0x5,300,0,5,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0;

En este ejemplo, para el SUM del dispositivo, el VID es SUM y el PID es XYZ200_R.

El valor de máscara 0x5 es el valor OR de bit de los indicadores 0x00004 y 0x00001. Estos valores son parámetros ajustables retries-busy y throttle-max en una plataforma SPARC.

Si un archivo .conf contiene múltiples entradas sd-config-list o ssd-config-list en el mismo dispositivo de destino, solo la primera entrada tiene efecto. Todas las entradas subsiguientes con el mismo VID y PID se ignoran. Este comportamiento es el mismo para el formato de enmascaramiento de bit y el formato de par name:value.

Si una propiedad sd-config-list contiene más de un par con el mismo VID y PID, las especificaciones subsiguientes en el orden de entrada tienen más relevancia y reemplazan los valores que aparecían en duplas anteriores. Este comportamiento es el mismo para el formato de enmascaramiento de bit y el formato de par name:value.

En el formato de enmascaramiento, si el largo del parámetro value-sequence es de más de 19 caracteres, los valores después del carácter 19 se ignoran. Si el largo de value-sequence es menor de 19 caracteres, el resultado de la configuración depende del valor mask precedente. Si la posición de valor correspondiente del bit indicado en el valor mask está vacía, se genera en un valor aleatorio que se asigna para una propiedad en el controlador de destino.

El controlador de destino no proporciona una comprobación de sintaxis para el archivo .conf, de modo que no aparecen mensajes de advertencia para errores, como faltas de ortografía de nombres ajustables o entradas incorrectas para value-sequence.