Configuration des éditeurs

Pour l'installation et la mise à jour de logiciels, vous devez être en mesure de contacter un référentiel de packages.

Affichage des informations sur les éditeurs

Utilisez la commande pkg publisher pour afficher des informations sur les éditeurs de package configurés pour cette image. Les éditeurs sont répertoriés dans l'ordre dans lequel ils sont recherchés pour trouver les packages lorsque l'éditeur n'est pas spécifié dans le package FMRI.

/usr/bin/pkg publisher [-HPn] [publisher ...]

Par défaut, l'éditeur solaris est configuré sur un système Oracle Solaris 11 récemment installé. Utilisez la commande pkg publisher pour connaître l'origine de votre éditeur.

$ pkg publisher
PUBLISHER                   TYPE    STATUS  URI
solaris                     origin  online  http://pkg.oracle.com/solaris11/release/
isv.com        (non-sticky) origin  online  file:/export/isv-repo/
example.com    (disabled)   origin  online  http://pkg.example.com/

Spécifiez les éditeurs par nom pour afficher la configuration détaillée de ces éditeurs.

$ pkg publisher solaris
       Publisher: solaris
           Alias:
      Origin URI: http://pkg.oracle.com/solaris11/release/
         SSL Key: None
        SSL Cert: None
     Client UUID: 00000000-3db4-fcc2-0111-000000000000
 Catalog Updated: Thu Sep 22 21:06:03 2011
         Enabled: Yes
Signature Policy: verify

Utilisez l'option -P pour afficher uniquement le premier éditeur dans l'ordre de recherche des éditeurs. Utilisez l'option -n pour afficher uniquement les éditeurs activés. L'option -H omet les en-têtes dans la sortie.

Ajout, modification ou suppression des éditeurs de packages

Utilisez la commande pkg set-publisher pour effectuer les opérations suivantes :

• Configuration d'un nouvel éditeur.

• Définition des origines et des miroirs d'un éditeur.

• Activation ou désactivation d'un éditeur. Un éditeur récemment ajouté est activé par défaut. Un éditeur désactivé n'est pas utilisé lorsque la liste du package est renseignée, ou lors des opérations d'installation, de désinstallation ou de mise à jour de package. Il est toujours possible de définir et d'afficher les propriétés d'un éditeur désactivé. Si seul un éditeur est activé, celui-ci ne peut pas être désactivé.

• Définition de la persistance d'un éditeur. Un éditeur récemment ajouté est persistant par défaut. Si un éditeur n'est pas persistant, un package installé à partir de cet éditeur peut être mis à jour à partir d'un autre éditeur.

• Définition de l'ordre de recherche des éditeurs. Un éditeur récemment ajouté est affiché par défaut en dernier dans l'ordre de recherche. L'ordre de recherche des éditeurs sert à trouver des packages à installer. L'ordre de recherche des éditeurs est utilisé pour trouver des packages à mettre à jour si l'éditeur à partir duquel le package a été installé initialement est non persistant.

• Spécification des certificats et clés SSL pour un éditeur.

• Définition et rétablissement de la propriété d'un éditeur, et ajout et suppression de la valeur de propriété d'un éditeur. Reportez-vous à la section Configuration des propriétés de signature de package.

/usr/bin/pkg set-publisher [-Ped] [-k ssl_key] [-c ssl_cert]
    [-g origin_to_add | --add-origin origin_to_add ...]
    [-G origin_to_remove | --remove-origin origin_to_remove ...]
    [-m mirror_to_add | --add-mirror mirror_to_add ...]
    [-M mirror_to_remove | --remove-mirror mirror_to_remove ...]
    [-p repo_uri] [--enable] [--disable] [--no-refresh]
    [--reset-uuid] [--non-sticky] [--sticky]
    [--search-after publisher] [--search-before publisher] [--search-first]
    [--approve-ca-cert path_to_CA]
    [--revoke-ca-cert hash_of_CA_to_remove]
    [--unset-ca-cert hash_of_CA_to_remove]
    [--set-property name_of_property=value]
    [--add-property-value name_of_property=value_to_add]
    [--remove-property-value name_of_property=value_to_remove]
    [--unset-property name_of_property_to_delete]
    [publisher]

La commande suivante ajoute un nouvel éditeur nommé data.com avec un URI d'origine spécifié avec l'option -g et définit cet éditeur afin qu'il soit le premier dans l'ordre de recherche. Utilisez l'option -P ou l'option --search-first pour définir l'éditeur spécifié en premier dans l'ordre de recherche.

# pkg set-publisher -P -g http://pkg.data.com/release/ data.com

La commande suivante vous permet d'activer l'éditeur example.com et le met devant l'éditeur isv.com dans l'ordre de recherche.

# pkg set-publisher --enable --search-before isv.com example.com

Utilisez l'option -p afin d'obtenir les informations de configuration d'éditeur auprès de l'URI du référentiel spécifié. Si un éditeur est spécifié, seul l'éditeur correspondant est ajouté ou mis à jour. Si aucun éditeur n'est spécifié, tous les éditeurs sont ajoutés ou mis à jour de façon adéquate. L'option -p ne peut pas être associée aux options -g, --add-origin, - G, --remove-origin, -m, --add-mirror , -M, --remove-mirror, --disable, - -enable, --no-refresh ou --reset-uuid.

Pour modifier l'URI d'origine d'un éditeur, ajoutez le nouvel URI et supprimer l'ancien. Utilisez l'option -g pour ajouter un nouvel URI d'origine. Utilisez l'option -G pour supprimer l'ancien URI d'origine.

# pkg set-publisher -G '*' -g http://pkg.example.com/support/ example.com

Utilisez l'option -m pour ajouter un URI comme miroir pour l'éditeur spécifié. Reportez-vous à Sources et miroirs du référentiel pour obtenir une explication sur la différence entre une source et un miroir. Utilisez l'option -M pour supprimer un URI servant de miroir à l'éditeur spécifié.

# pkg set-publisher -m http://pkg.data.com/release2/ data.com
# pkg publisher
PUBLISHER                   TYPE    STATUS   URI
data.com                    origin  online   http://pkg.data.com/release/
data.com                    mirror  online   http://pkg.data.com/release2/

Utilisez l'option -k pour spécifier la clé SSL client. Utilisez l'option -c pour spécifier le certificat SSL client. Utilisez l'option --approve-ca-cert pour ajouter le certificat spécifié comme certificat d'AC fiable. Les hachages des certificats de CA approuvés par l'utilisateur sont répertoriés dans la sortie de la commande pkg publisher pour cet éditeur. Reportez-vous à la section Affichage des informations sur les éditeurs.

# pkg set-publisher -k /root/creds/example.key -c /root/creds/example.cert \
--approve-ca-cert /tmp/example_file.pem example.com

Utilisez l'option --revoked-ca-cert pour traiter le certificat spécifié comme révoqué. Les hachages des certificats de CA révoqués par l'utilisateur sont répertoriés dans la sortie de la commande pkg publisher pour cet éditeur.

Utilisez l'option --unset-ca-cert pour supprimer le certificat spécifié de la liste des certificats approuvés et de la liste des certificats révoqués.

Lorsque vous spécifiez l'option -no-refresh, les référentiels pour les éditeurs de l'image ne sont pas contactés en vue de la récupération de la liste des packages disponibles la plus récente et autres métadonnées.

Utilisez l'option --reset-uuid pour choisir un nouvel identifiant unique qui identifie cette image auprès de son éditeur.

Utilisez la commande pkg unset-publisher pour supprimer un éditeur.

# pkg unset-publisher isv.com