Réglage des propriétés du pilote de disque cible

Langue :

Cette annexe explique comment régler les propriétés du pilote de disque cible Oracle Solaris (pilote sd ou ssd) dans le fichier .conf à l'aide de la propriété globale sd-config-list ou ssd-config-list.

Cette annexe décrit les formats suivants pour le réglage des propriétés du pilote de disque cible :

Paramètres réglables des pilotes de disques

Les paramètres réglables pour définir un pilote de disque utilisent les catégories de préfixes suivantes :

BCD : décimale à codage binaire comme indiqué dans le Table D–1
delay : délai d'émission d'une nouvelle tentative
timeout : temps maximal autorisé par un processus
reset : commande de réinitialisation
retries : nombre de tentatives en cas d'échec
throttle : commande d'activité

Les noms réglables suivants et leurs types de données sont pris en charge par Oracle Solaris 10 et Oracle Solaris 11 :

cache-nonvolatile: BOOLEAN
controller-type: 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

Les paramètres réglables qui ne sont pris en charge que dans Oracle Solaris 11 sont tous des types de données BOOLEAN. Les paramètres sont les suivants :

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

Remarque - La valeur BOOLEAN doit être TRUE ou FALSE.

Format de paire `Name`:`Value` pour le réglage des pilotes de disques

Les pilotes sd et ssd prennent en charge le format de texte JSON name:value, qui permet de définir les valeurs de propriétés réglables spécifiques.

Utilisez la syntaxe suivante pour un pilote sd :

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

Remarque - Veillez à mettre fin à l'entrée par un point-virgule, sinon la configuration ne sera pas valide et les propriétés conserveront leurs valeurs par défaut.

Utilisez la syntaxe suivante pour un pilote ssd :

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

où duplet est "VID PID", "tunable [, tunable]*"

VID: Contenu du champ d'identification du fournisseur (VID) de la réponse du périphérique à une commande SCSI INQUIRY. Le champ VID doit comporter huit caractères. Si le champ VID comporte moins de huit caractères, vous devez ajouter des caractères non imprimables pour que le VID soit composé de huit caractères. Voir Example D–1.
PID: Contenu du champ d'identification du produit (PID) de la réponse du périphérique à une commande SCSI INQUIRY. Le champ PID peut contenir 16 caractères justifiés à gauche au maximum. Si vous saisissez moins de 16 caractères, la comparaison se limite alors à la longueur du PID que vous avez indiqué.
tunable[, tunable] *: tunable correspond à la paire name:value.

Remarque - Si vous orthographiez mal un paramètre réglable ou si vous ne mettez pas fin à l'entrée par un point-virgule, la configuration n'est pas valide et les propriétés de périphérique conservent leurs valeurs par défaut.

La valeur PID est considérée comme une correspondance lorsque la valeur de préfixe renvoyée par la commande SCSI INQUIRY et le PID indiqué dans sd-config-list ou ssd-config-list sont identiques. Par exemple, si CMS200 est le PID dans l'entrée sd-config-list ou ssd-config-list et si le PID renvoyé par la commande SCSI INQUIRY est CMS200-R, CMS200-T ou CMS200-UV10 seront tous considérés comme concordants.

Sur une plate-forme SPARC, les périphériques cible peuvent être liés au pilote sd ou ssd, selon que le périphérique est un périphérique FC et selon que MPxIO est activé sur le périphérique. Vous pouvez utiliser la commande prtconf pour vérifier les informations de configuration du périphérique. Voir la page de manuel prtconf(1M).

Exemple D-1 Configuration de deux périphériques cible dans un fichier sd.conf

L'exemple suivant illustre la configuration de deux périphériques cible SAMPLE et SUM dans un fichier sd.conf.

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

Dans cet exemple, pour le périphérique SAMPLE, le VID est SAMPLE et le PID est STTU1234566AB. Le délai avant une nouvelle tentative est réglé sur 6 secondes.

Pour le périphérique SUM, le VID est SUM et le PID est ABC200_R. Le nombre de tentatives en cas d'état occupé d'E/S est réglé sur 5. La valeur de ralentissement maximum est réglée sur 300.

Exemple D-2 Configuration de deux périphériques cible dans un fichier ssd.conf

L'exemple suivant illustre la configuration de deux périphériques cible GATES et SINEdans un fichier ssd.conf.

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

Dans cet exemple, pour le périphérique GATES, le VID est GATES et le PID est AB568536611CD46G. La valeur TRUE pour le paramètre réglable reset-lun indique que le LUN est réinitialisé.

Pour le périphérique SINE, le VID est SINE et le PID est XYZ200_R. Le nombre de tentatives si l'E/S n'est pas prête est réglé sur 6. La valeur de ralentissement minimum est réglée sur 200.

Format de masquage de bits pour régler les pilotes de disques

Vous pouvez régler les paramètres à l'aide du format de masquage de bits, également appelé "format Version1". Le format de masquage de bits inclut la propriété sd-config-list, qui contient des entrées pour le tableau de propriétés.

Utilisez la syntaxe suivante pour un pilote sd :

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

Remarque - Veillez à mettre fin à l'entrée par un point-virgule, sinon la configuration ne sera pas valide et les propriétés conserveront leurs valeurs par défaut.

Utilisez la syntaxe suivante pour un pilote ssd :

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

où duplet est "VID PID", "sd-ver1-conf-data"

VID

Contenu du champ d'identification du fournisseur (VID) de la réponse du périphérique à une commande SCSI INQUIRY. Le champ VID doit comporter huit caractères. Si le champ d'identification du fournisseur comporte moins de huit caractères, vous devez ajouter des caractères non imprimables pour que le VID soit composé de huit caractères.

PID

Contenu du champ d'identification du produit (PID) de la réponse du périphérique à une commande SCSI INQUIRY. Le champ PID peut contenir 16 caractères justifiés à gauche au maximum. Si vous saisissez moins de 16 caractères, la comparaison se limite alors à la longueur du PID que vous avez indiqué.

sd-ver1-conf-data

Tableau de propriétés consistant en un numéro de version, égal à 1, un numéro de masque et des valeurs réglables à définir.

mask: Valeur comprise entre 0x01 et 0x7FFFF. La valeur de mask peut être parfois le résultat OR de plusieurs indicateurs souhaités. Le Table D–1 indique la valeur de bit de chaque paramètre réglable.
value-sequence: Série de valeurs de propriété valides et nombre de 0 correspondant à la valeur de mask. La longueur limite de value-sequence est de 19 caractères. Voir Paramètres réglables des pilotes de disques pour le type de données des paramètres réglables.

Remarque - Les duplets associés à différents VID et PID partagent le même tableau de propriétés sd-ver1-conf-data ou définissent leur propre tableau de propriétés. Vous pouvez personnaliser le nom du tableau de propriétés.

La définition de la position de chaque bit dépend de la plate-forme. Un paramètre réglable peut correspondre à une valeur d'indicateur différente sur chaque plate-forme différente. Oracle Solaris 11 et Oracle Solaris 10 prennent tous deux en charge le même ensemble de 19 paramètres réglables dans le format de masquage de bits.

Le tableau suivant répertorie les paramètres réglables et leurs valeurs d'indicateur sur différentes plates-formes.

Table D-1 Paramètres réglables pris en charge et valeurs d'indicateur correspondantes sur différentes plates-formes

Bit	Valeur d'indicateur	Pilote sd sur SPARC	Pilote ssd sur SPARC	Pilote sd sur x86 ou 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`

Exemple D-3 Configuration des paramètres réglables pour un pilote sd sur une plate-forme x86

Cet exemple montre comment régler les paramètres dans un fichier sd.conf sur une plate-forme 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;

Dans cet exemple, pour le périphérique SUM, le VID est SUM et le PID est ABC200_R.

La valeur du masque 0x801 est la valeur OR au niveau du bit des indicateurs 0x00800 et 0x00001. Ces valeurs correspondent aux paramètres réglables retries-busy et throttle-maxsur une plate-forme x86.

Exemple D-4 Configuration des paramètres réglables pour un pilote ssd sur une plate-forme SPARC

L'exemple suivant montre comment régler les paramètres contenus dans un fichier ssd.conf sur une plate-forme 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;

Dans cet exemple, pour le périphérique SUM, le VID est SUM et le PID est XYZ200_R.

La valeur de masque 0x5 correspond à la valeur OR au niveau du bit des indicateurs 0x00004 et 0x00001. Ces valeurs correspondent aux paramètres réglables retries-busy et throttle-max sur une plate-forme SPARC.

Si un fichier.conf contient plusieurs entrées sd-config-list ou ssd-config-listréglant le même périphérique cible, seule la première entrée prendra effet. Toutes les entrées suivantes utilisant les mêmes VID et PID seront ignorées. Ce comportement est identique pour le format de masquage de bits et le format de paire name:value.

Si une propriété sd-config-list contient plusieurs duplets associés aux mêmes VID et PID, les spécifications successives dans l'ordre des entrées sont prioritaires et remplacent les valeurs qui apparaissaient dans les duplets antérieurs. Ce comportement est identique pour le format de masquage de bits et le format de paire name:value.

ans le format de masquage de bits, si la longueur du paramètre value-sequence est supérieure à 19 caractères, les valeurs qui viennent après le 19ème caractère sont ignorées. Si la longueur de value-sequence est inférieure à 19 caractères, le résultat de la configuration dépend de la valeur mask précédente de ce paramètre. Si la position de la valeur correspondante du bit signalé dans la valeur mask est vide, cela entraîne l'affectation d'une valeur aléatoire pour cette propriété dans le pilote cible.

Dans la mesure où le pilote cible ne fournit pas de vérification de la syntaxe du fichier .conf, aucun message d'avertissement n'apparaît en cas d'erreur, par exemple si des noms réglables sont mal orthographiés ou si des entrées pour value-sequence sont incorrectes.