CCISS(4)

NOM
cciss - pilote de périphérique de bloc HP Smart Array

SYNOPSIS
modprobe cciss [ cciss_allow_hpsa=1 ]

DESCRIPTION
cciss est un pilote de périphérique de bloc pour les contrôleurs RAID HP Smart Array anciens.

  Options
cciss_allow_hpsa=1 : cette option empêche le pilote cciss d'essayer de faire fonctionner un contrôleur qui pourrait être géré par le pilote hpsa(4). En d'autre termes, cela signifie que le pilote cciss est alors restreint avec cette option aux contrôleurs suivants :
    Smart Array 5300
    Smart Array 5i
    Smart Array 532
    Smart Array 5312
    Smart Array 641
    Smart Array 642
    Smart Array 6400
    Smart Array 6400 EM
    Smart Array 6i
    Smart Array P600
    Smart Array P400i
    Smart Array E200i
    Smart Array E200
    Smart Array E200i
    Smart Array E200i
    Smart Array E200i
    Smart Array E500

  Matériel pris en charge
Le pilote cciss prend en charge les cartes Smart Array suivantes :
    Smart Array 5300
    Smart Array 5i
    Smart Array 532
    Smart Array 5312
    Smart Array 641
    Smart Array 642
    Smart Array 6400
    Smart Array 6400 U320 Expansion Module
    Smart Array 6i
    Smart Array P600
    Smart Array P800
    Smart Array E400
    Smart Array P400i
    Smart Array E200
    Smart Array E200i
    Smart Array E500
    Smart Array P700m
    Smart Array P212
    Smart Array P410
    Smart Array P410i
    Smart Array P411
    Smart Array P812
    Smart Array P712m
    Smart Array P711m

  Détails de configuration
Pour configurer les contrôleurs HP Smart Array, utilisez l'utilitaire de configuration (hpacuxe(8) ou bien hpacucli(8)) ou l'utilitaire de configuration hors-ligne sur ROM, lancé au démarrage depuis l'option « ROM » du Smart Array.

FICHIERS

  Nœuds de périphériques
La convention de nommage des périphériques est la suivante :
Numéros majeurs :
    104     cciss0
    105     cciss1
    106     cciss2
    105     cciss3
    108     cciss4
    109     cciss5
    110     cciss6
    111     cciss7
Numéros mineurs :
    b7 b6 b5 b4 b3 b2 b1 b0
    |----+----| |----+----|
         |           |
         |           +-------- identifiant partition (0=périph. entier, 1-15 partition)
         |
         +-------------------- numéro du volume logique
La convention de nommage de périphérique est :
    /dev/cciss/c0d0         contrôleur 0, disque 0, périphérique entier
    /dev/cciss/c0d0p1       contrôleur 0, disque 0, partition 1
    /dev/cciss/c0d0p2       contrôleur 0, disque 0, partition 2
    /dev/cciss/c0d0p3       contrôleur 0, disque 0, partition 3
    /dev/cciss/c1d1         contrôleur 1, disque 1, périphérique entier
    /dev/cciss/c1d1p1       contrôleur 1, disque 1, partition 1
    /dev/cciss/c1d1p2       contrôleur 1, disque 1, partition 2
    /dev/cciss/c1d1p3       contrôleur 1, disque 1, partition 3

  Fichiers dans /proc
Les fichiers /proc/driver/cciss/cciss[0-9]+ contiennent des informations au sujet de la configuration de chaque contrôleur. Par exemple :
    $ cd /proc/driver/cciss
    $ ls -l
    total 0
    -rw-r--r-- 1 root root 0 2010-09-10 10:38 cciss0
    -rw-r--r-- 1 root root 0 2010-09-10 10:38 cciss1
    -rw-r--r-- 1 root root 0 2010-09-10 10:38 cciss2
    $ cat cciss2
    cciss2: HP Smart Array P800 Controller
    Board ID: 0x3223103c
    Firmware Version: 7.14
    IRQ: 16
    Logical drives: 1
    Current Q depth: 0
    Current # commands on controller: 0
    Max Q depth since init: 1
    Max # commands on controller since init: 2
    Max SG entries since init: 32
    Sequential access devices: 0
    cciss/c2d0:   36.38GB       RAID 0

  Fichiers dans /sys

/sys/bus/pci/devices/<dev>/ccissX/cXdY/model
    Affiche le modèle indiqué sur la page 0 de SCSI INQUIRY pour le lecteur logique Y du contrôleur X.

/sys/bus/pci/devices/<dev>/ccissX/cXdY/rev
    Affiche la révision indiquée sur la page 0 de SCSI INQUIRY pour le lecteur logique Y du contrôleur X.

/sys/bus/pci/devices/<dev>/ccissX/cXdY/unique_id
    Affiche le numéro de série indiqué sur la page 83 de SCSI INQUIRY pour le lecteur logique Y du contrôleur X.

/sys/bus/pci/devices/<dev>/ccissX/cXdY/vendor
    Affiche le fournisseur indiqué sur la page 0 de SCSI INQUIRY pour le lecteur logique Y du contrôleur X.

/sys/bus/pci/devices/<dev>/ccissX/cXdY/block:cciss!cXdY
    Lien symbolique vers /sys/block/cciss!cXdY.

/sys/bus/pci/devices/<dev>/ccissX/rescan
    Après écriture dans ce fichier, le pilote rescanne le contrôleur à la recherche de lecteurs logiques dont l'état a changé (nouveaux, retirés ou modifiés).

/sys/bus/pci/devices/<dev>/ccissX/resettable
    Si le fichier contient la valeur 1, cela signifie que le paramètre du noyau « reset_devices=1 » (utilisé par kdump) est pris en compte par le contrôleur. S'il contient la valeur 0, cela signifie que le paramètre du noyau « reset_devices=1 » n'est pas pris en compte. Certains modèles de Smart Array ne sont pas capables de prendre en compte ce paramètre.

/sys/bus/pci/devices/<dev>/ccissX/cXdY/lunid
    Affiche l'identifiant d'unité logique (« LUN ID ») sur 8 octets pour représenter le lecteur logique Y du contrôleur X.

/sys/bus/pci/devices/<dev>/ccissX/cXdY/raid_level
    Affiche le niveau RAID du lecteur logique Y du contrôleur X.

/sys/bus/pci/devices/<dev>/ccissX/cXdY/usage_count
    Affiche le comptage d'utilisation (nombre d'ouvertures) du lecteur logique Y du contrôleur X.

  Lecteur de bandes SCSI et prise en charge du changeur de support.
Les périphériques SCSI à accès séquentiel et les périphériques de changement de support sont pris en charge, et les nœuds de périphériques idoines sont automatiquement créés (p. ex. /dev/st0, /dev/st1, etc. ; consultez st(4) pour plus de détails). Vous devez activer « SCSI tape drive support for Smart Array 5xxx » et « SCSI support » dans votre configuration du noyau pour pouvoir utiliser des lecteurs de bandes SCSI avec votre contrôleur Smart Array 5xxx. De plus, notez que le pilote n'engagera pas le cœur SCSI à l'initialisation. Le pilote ne doit pas être réglé pour engager dynamiquement le cœur SCSI au moyen de l'entrée /proc/driver/cciss/cciss*, qui est créée par la partie « bloc » du pilote pendant l'exécution. En effet, à l'initialisation du pilote, le cœur SCSI peut ne pas être encore initialisé (car il s'agit d'un pilote de périphérique bloc) et essayer d'engager le cœur SCSI dans cet état pourrait causer un plantage. La meilleure façon de le faire est d'utiliser un script d'initialisation (typiquement dans /etc/init.d, mais peut dépendre de la distribution). Par exemple :
    for x in /proc/driver/cciss/cciss[0-9]*
    do
        echo "Engager le cœur SCSI" > $x
    done
Une fois le cœur SCSI engagé par le pilote, il ne peut être désengagé (sauf en retirant le pilote, s'il est lié sous forme d'un module). Notez aussi que si aucun périphérique à accès séquentiel ou changeur de support n'est détecté, le cœur SCSI ne sera pas engagé par l'action du script ci-dessus.

  Prise en charge du branchement à chaud de lecteurs de bandes SCSI
Le branchement à chaud des lecteurs de bandes SCSI est pris en charge, avec quelques mises en garde. Le pilote cciss doit être informé des changements apportés au bus SCSI. Cela peut être réalisé en utilisant de système de fichiers /proc. Par exemple :
    echo "rescan" > /proc/scsi/cciss0/1 Cela fait faire au pilote les actions suivantes :

    1.  interroger l'adaptateur au sujet des changements intervenus sur les bus SCSI physiques et/ou sur le Fibre Channel en boucle, et

    2.  prendre note de tout périphérique à accès séquentiel ou changeur de support ajouté ou retiré

Le pilote affichera des messages indiquant quels périphériques ont été ajoutés ou retirées, ainsi que les contrôleur, bus, cible et numéro d'unité logique utilisés pour accéder à chacun de ces périphériques. Le pilote prévient ensuite la couche intermédiaire SCSI de ces changements. Notez que la convention de nommage des entrées du système de fichiers /proc contient un numéro en plus du nom du pilote (p. ex. « cciss0 » au lieu du simple « cciss » attendu). Remarque : seulement les périphériques à accès séquentiel et les changeurs de support sont présentés par le pilote cciss comme des périphériques SCSI à la couche intermédiaire SCSI. Précisément, les disques physiques SCSI ne sont pas présentés à la couche intermédiaire SCSI. Les seuls périphériques de disque présentés au noyau sont les lecteurs logiques que le contrôleur construit à partir de régions sur les lecteurs physiques. Les lecteurs logiques sont présentés à la couche « bloc » (et non à la couche intermédiaire SCSI). Il est important que le pilote empêche le noyau d'accéder directement aux lecteurs physiques, puisque ces lecteurs sont utilisés par le contrôleur pour construire les lecteurs logiques.

  Gestion des erreurs SCSI pour les lecteurs de bandes et les changeurs de support
La couche intermédiaire SCSI de Linux fournit un protocole de gestion d'erreurs, qui est initialisé dès qu'une commande SCSI échoue après un certain laps de temps (qui peut dépendre de la commande). Le pilote cciss participe à ce protocole dans une certaine mesure. Le protocole normal comprend quatre étapes :

*   D'abord, le périphérique est prié d'interrompre la commande.

*   Si cela ne fonctionne pas, le périphérique est réinitialisé.

*   Si cela ne fonctionne pas, le bus SCSI est réinitialisé.

*   Si cela ne fonctionne pas, le bus hôte est réinitialisé.

Le pilote cciss est un pilote pour périphérique bloc, ainsi qu'un pilote SCSI et seuls les lecteurs de bandes et les changeurs de support sont présentés à la couche intermédiaire SCSI. De plus, contrairement à d'autres pilotes SCSI plus simples, les opérations d'entrée et sortie sur le disque continuent du côté bloc pendant le processus de réparation d'erreur. C'est pourquoi le pilote cciss implémente seulement les deux premières actions : interrompre la commande, et réinitialiser le périphérique. Notez aussi que la plupart des lecteurs de bandes ne vont pas coopérer lors de l'interruption de commandes, et parfois même ne vont pas obéir à la commande de réinitialisation, même s'ils le feront dans la majorité des cas. Si la commande ne peut être interrompue et le périphérique ne peut être réinitialisé, le périphérique sera placé hors-ligne. Dans le cas où la gestion des erreurs est déclenchée et un lecteur de bandes est réinitialisé correctement ou la commande qui traîne est interrompue correctement, le lecteur de bandes peut quand même ne pas permettre les opérations d'entrée-sortie de continuer tant qu'une commande qui positionnera la bande à une position connue ne sera pas exécutée. Typiquement, vous devez rembobiner la bande (en exécutant mt -f /dev/st0 rewind par exemple), avant que les opérations d'entrée-sorties puissent reprendre sur un lecteur de bandes réinitialisé.

VOIR AUSSI
cciss_vol_status(8), hpsa(4), hpacucli(8), hpacuxe(8), http://cciss.sf.net, et les fichiers source du noyau Linux Documentation/blockdev/cciss.txt et Documentation/ABI/testing/sysfs-bus-pci-devices-cciss

COLOPHON
Cette page fait partie de la publication 3.40 du projet man-pages Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION
Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <URL:http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet perkamon <URL:http://perkamon.alioth.debian.org/>.

Veuillez signaler toute erreur de traduction en écrivant à <perkamon-fr@traduc.org>.

Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « LC_ALL=C man <section> <page_de_man> ».