Contrôle de l'installation des composants optionnels

Les logiciels peuvent avoir des composants optionnels et des composants incompatibles. Les environnements linguistiques et la documentation sont des exemples de composants optionnels. Les binaires SPARC ou x86 et les binaires de débogage et de non-débogage sont des exemples de composants incompatibles. Dans IPS, les composants optionnels sont appelés des facettes et les composants incompatibles sont appelés des variantes.

Les facettes et les variantes sont des propriétés spéciales de l'image et ne peuvent pas être définies sur des packages individuels. Pour afficher les valeurs actuelles des facettes et des variantes définies sur l'image, utilisez les commandes pkg facet et pkg variant. Pour modifier les valeurs des facettes et des variantes définies sur l'image, utilisez les commandes pkg change-facet et pkg change-variant. Reportez-vous à la page de manuel pkg(1) et aux exemples ci-dessous.

Les facettes et les variantes sont spécifiées sous forme de repères sur les actions de package. Chaque repère de facette et de variante possède un nom et une valeur. Une seule action peut avoir plusieurs repères de facette et de variante. Un fichier d'en-tête spécifique à une architecture utilisé par des développeurs ou un composant uniquement destiné à une zone globale SPARC sont des exemples de composants à repères de facettes et de variantes multiples.

variant.arch=sparc est un exemple de repère de variante. facet.devel=true est un exemple de repère de facette. Il est souvent fait référence aux facettes et variantes sans les faire précéder de facet. et variant..

Les facettes sont booléennes : elles peuvent uniquement être définies sur true (activé) ou false (désactivé). Par défaut, toutes les facettes sont considérées comme définies sur true dans une image. Un repère de facette sur une action doit uniquement avoir la valeur true ; les autres valeurs ont des comportements indéterminés. Une facette définie sur l'image peut être une facette complète telle que doc.man ou un modèle tel que locale.*. L'intérêt de cette caractéristique est qu'elle vous permet de désactiver une partie de l'espace de noms d'une facette et de n'activer que des facettes individuelles en son sein. Par exemple, vous pouvez désactiver tous les environnements linguistiques, puis n'activer qu'un ou deux environnements linguistiques particuliers, comme illustré dans l'exemple suivant :

# pkg change-facet locale.*=false
[output about packages being updated]
# pkg change-facet locale.en_US=true
[output about packages being updated]

La plupart des variantes peuvent avoir un nombre de valeurs quelconque. Par exemple, la variante arch peut être définie sur i386, sparc, ppc, arm ou n'importe quelle architecture prise en charge par la distribution. (Seuls i386 et sparc sont utilisés dans Oracle Solaris.) Les variantes debug constituent une exception. Les variantes debug peuvent uniquement être définies sur true ou false ; les autres valeurs ont un comportement indéterminé. S'il existe une version non-débogage et une version débogage d'un même fichier, la variante debug applicable doit être explicitement définie sur ces deux fichiers, comme illustré dans l'exemple suivant :

file group=sys mode=0644 overlay=allow owner=root \
  path=etc/motd pkg.csize=115 pkg.size=103 preserve=true \
  variant.debug.osnet=true

file group=sys mode=0644 overlay=allow owner=root \
  path=etc/motd pkg.csize=68 pkg.size=48 preserve=true \
  variant.debug.osnet=false 

Pour qu'un package utilisant une variante donnée puisse être installé, il faut que cette variante soit définie sur l'image. Les variantes arch et zone sont définies par le programme qui crée l'image et installe son contenu initial. Par défaut, les variantes debug.* sont définies sur false dans l'image.

Les facettes et les variantes définies sur l'image déterminent si une action particulière est installée ou non.

• Les actions sans repère de facette ou de variante sont toujours installées.

• Les actions avec repères de facettes sont installées, sauf si toutes les facettes ou tous les modèles de facettes correspondant aux repères sont définis sur false dans l'image. Si une seule facette est définie sur true ou n'est pas explicitement définie (true est la valeur par défaut), l'action est installée.

• Les actions avec repères de variantes sont uniquement installées si les valeurs des repères de variantes sont les mêmes que celles définies dans l'image.

• Les actions comportant à la fois des repères de facettes et des repères de variantes sont installées si les facettes et les variantes autorisent l'installation des actions concernées.

Vous pouvez créer vos propres repères de facettes et de variantes. Les repères suivants sont couramment utilisés dans Oracle Solaris.

La liste suivante présente quelques exemples de repères de facettes utilisés dans Oracle Solaris :

facet.devel             facet.doc
facet.doc.html          facet.doc.info
facet.doc.man           facet.doc.pdf
facet.locale.de         facet.locale.en_GB
facet.locale.en_US      facet.locale.fr
facet.locale.ja_JP      facet.locale.zh_CN

Vous pouvez afficher les valeurs des variantes et des facettes qui sont définies sur l'image actuelle et vous pouvez modifier les variantes et facettes dans l'image actuelle. La modification de variantes et de facettes peut entraîner la mise à jour d'un grand nombre de packages et peuvent nécessiter un nouvel environnement d'initialisation. Utilisez -nv pour passer en revue les modifications qui seront effectuées avant de les réaliser.

Affichage d'une variante

Utilisez la commande pkg variant pour afficher les valeurs des variantes définies.

/usr/bin/pkg variant [-H] [variant_spec ...] 

$ pkg variant
VARIANT                  VALUE
variant.opensolaris.zone global
variant.arch             i386
$ pkg variant -H variant.arch
variant.arch i386

Modification d'une variante

Utilisez la commande pkg change-variant pour modifier la valeur d'une variante.

/usr/bin/pkg change-variant [-nvq] [-g path_or_uri ...]
    [--accept] [--licenses] [--no-be-activate]
    [--no-backup-be | --require-backup-be] [--backup-be-name name]
    [--deny-new-be | --require-new-be] [--be-name name]
    variant_spec=instance ...

La commande suivante produit une sortie de données de grand volume, car de nombreux packages seraient concernés. Notez qu'un nouvel environnement d'initialisation ne serait pas créé par défaut, mais qu'un nouvel environnement d'initialisation de secours serait créé. Reportez-vous à la section Propriétés d'image de la stratégie d'environnement d'initialisation pour obtenir des informations sur la création des environnements d'initialisation.

Utilisez l'option -n pour voir ce qui serait modifié si vous aviez effectué l'opération sans -n, mais sans effectuer de modification réelle.

# pkg change-variant -nv --accept variant.debug.*=true
            Packages to update:       831
     Variants/Facets to change:         4
     Estimated space available: 112.19 GB
Estimated space to be consumed: 220.76 MB
       Create boot environment:        No
Create backup boot environment:       Yes
          Rebuild boot archive:        No
Changed variants/facets:
  variant variant.debug.*: true
    facet facet.locale.en_US: None
    facet facet.locale.en: None
    facet facet.locale.*: None
Changed packages:
solaris
  ...

Affichage d'une facette

Utilisez la commande pkg facet pour afficher les valeurs des facettes qui sont définies.

/usr/bin/pkg facet [-H] [facet_spec ...]

$ pkg facet
FACETS             VALUE
facet.locale.en_US True
facet.locale.en    True
facet.locale.*     False
$ pkg facet -H facet.locale.*
facet.locale.* False

Modification d'une facette

Utilisez la commande pkg change-facet pour modifier la valeur d'une facette.

/usr/bin/pkg change-facet [-nvq] [-g path_or_uri ...]
    [--accept] [--licenses] [--no-be-activate]
    [--no-backup-be | --require-backup-be] [--backup-be-name name]
    [--deny-new-be | --require-new-be] [--be-name name] 
    facet_spec=[True|False|None] ...

Utilisez l'option -n pour voir ce qui serait modifié si vous aviez effectué l'opération sans -n, mais sans effectuer de modification réelle.

Si la valeur de la facette est None, sa spécification est supprimée de l'image active.

La commande suivante produit une sortie de données de grand volume, car de nombreux packages seraient concernés. Notez que la quantité d'espace supplémentaire qui serait utilisé est exprimée en Go et non en Mo. Cette opération peut nécessiter une grande quantité de temps et entraîner une grande quantité de trafic réseau entre cette image et le référentiel de packages. Notez qu'un nouvel environnement d'initialisation ne serait pas créé par défaut, mais qu'un nouvel environnement d'initialisation de secours serait créé. Reportez-vous à la section Propriétés d'image de la stratégie d'environnement d'initialisation pour obtenir des informations sur la création des environnements d'initialisation.

# pkg change-facet -nv facet.locale.*=true
            Packages to update:       831
     Variants/Facets to change:         1
     Estimated space available: 112.19 GB
Estimated space to be consumed:   2.96 GB
       Create boot environment:        No
Create backup boot environment:       Yes
          Rebuild boot archive:        No
Changed variants/facets:
    facet facet.locale.*: True
Changed packages:
solaris
  ...