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
Définition de la persistance d'un éditeur
Définition de l'ordre de recherche des éditeurs
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
Spécification des certificats et clés SSL pour un éditeur
Définir un éditeur proxy
Activation ou désactivation d'un éditeur
Supprimer un éditeur
La commande pkg set-publisher possède deux formes. Reportez-vous à la page de manuel pkg(1).
Dans une forme, le nom de l'éditeur est obligatoire opérande.
Dans l'autre forme, un référentiel URI est fourni comme l'argument de l'option -p, et les informations de l'éditeur sont obtenues à partir de ce référentiel spécifié. Le nom de l'éditeur est un opérande facultatif vous permettant de configurer uniquement l'éditeur nommé si plusieurs éditeurs publient des packages sur ce référentiel.
Les exemples ci-après présentent les deux méthodes pour l'ajout d'un éditeur.
Exemple 5-1 Indiquez un nouvel éditeurLa commande suivante ajoute un nouvel éditeur nommé devtool avec un URI d'origine spécifié avec l'option -g et définit cet éditeur comme étant 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.example1.com/release/ devtoolExemple 5-2 Configuration d'importation Publisher
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.
$ pkg publisher PUBLISHER TYPE STATUS P LOCATION solaris origin online F http://pkg.oracle.com/solaris/release/ $ pkg set-publisher -p /export/IPSpkgrepos/myrepo $ pkg publisher PUBLISHER TYPE STATUS P LOCATION solaris origin online F http://pkg.oracle.com/solaris/release/ site origin online F file:///export/IPSpkgrepos/myrepo/
Les commandes suivantes montrent l'ajout d'une origine à l'éditeur solaris. Si plusieurs origines sont configurées pour un éditeur donné dans une image, le client IPS tente de choisir la meilleure origine à partir de laquelle récupérer les données des packages.
$ pkg publisher PUBLISHER TYPE STATUS P LOCATION solaris origin online F http://pkg.oracle.com/solaris/release/ $ pkg set-publisher -g /export/IPSpkgrepos/Solaris solaris $ pkg publisher PUBLISHER TYPE STATUS P LOCATION solaris origin online F http://pkg.oracle.com/solaris/release/ solaris origin online F file:///export/IPSpkgrepos/Solaris/
Utilisez l'option -G pour supprimer un URI servant de miroir à l'éditeur spécifié.
Pour modifier l'URI d'origine d'un éditeur, ajoutez le nouvel URI et supprimez l'ancien.
$ pkg set-publisher -G '*' -g file:///export/IPSpkgrepos/isvrepo/ isvpub
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. Vous ne pouvez pas accéder au contenu d'un référentiel miroir, sauf si la même version du même package existe également dans un référentiel d'origine pour ce même éditeur.
$ pkg set-publisher -m http://pkg.example3.com/ devtool $ pkg publisher PUBLISHER TYPE STATUS P LOCATION devtool origin online F http://pkg.example1.com/ devtool mirror online F http://pkg.example3.com/
Utilisez l'option -M pour supprimer un URI servant de miroir à l'éditeur spécifié.
Pour modifier l'URI d'origine d'un éditeur, ajoutez le nouvel URI et supprimez l'ancien.
Un éditeur récemment ajouté est persistant par défaut. Si un éditeur est non permanent, un package installé à partir de cet éditeur peut être mis à jour à partir d'un autre éditeur. Utilisez les options --sticky et --non-sticky pour définir la persistance de l'éditeur.
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 permanent. Utilisez les options --search-before, --search-after et --search-first pour modifier la recherche des éditeurs. L'option-P est un synonyme pour l'option --search-first.
Le premier éditeur qui fournit un package correspondant est utilisé en tant que source de l'installation. Si cet éditeur ne fournit pas une version du package qui peut être installée sur cette image, l'opération d'installation échoue. Pour installer à partir d'un éditeur qui se trouve plus bas dans l'ordre de recherche, fournissez des informations supplémentaires dans le package FMRI, comme par exemple le nom de l'éditeur ou la chaîne de version du package.
Les options suivantes vous permettent de définition et rétablissement et les propriétés de l'éditeur et enlever des valeurs d'pour ajouter les propriétés de l'éditeur, procédez comme suit :
--set-property property=value
--add-property-value property=value
--remove-property-value property=value
--unset-property property
Les propriétés publisher-search-order et signature-required-names peuvent avoir plusieurs valeurs.
Reportez-vous aux exemples pkg set-publisher de la section Configuration des propriétés de signature de package.
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 d'AC 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 isvpubExemple 5-4 Une clé et un certificat révoquer d'un éditeur
Utilisez l'option --revoke-ca-cert pour traiter le certificat spécifié comme révoqué. 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.
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.
Utilisez l'option --proxy pour spécifier un URI de proxy persistant à partir duquel récupérer du contenu pour l'origine ou le miroir indiqué. Le proxy a la valeur suivante protocol://host[:port], où protocol est http ou https et :port est optionnel. Voir Spécification d'un proxy pour plus d'informations sur les différentes méthodes permettant de définir un proxy.
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 install, uninstall ou update. 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é.
La commande suivante vous permet d'activer l'éditeur isvpub et le place devant l'éditeur devtool dans l'ordre de recherche.
$ pkg set-publisher --enable --search-before devtool isvpub
Utilisez l'option --disable pour la désactivation d'un éditeur. Il peut être utile de désactiver un éditeur si l'origine de l'éditeur est temporariement inaccessible, par exemple. Si aucun éditeur est n'est accessible, les opérations d'installation et de mise à jour des packages échouent.
Utilisez la commande pkg unset-publisher pour supprimer un éditeur.
$ pkg unset-publisher devtool