Création de profils

La commande netcfg, qui est décrite dans la page de manuel netcfg(1M), est l'une des deux commandes d'administration de l'interface de ligne de commande NWAM.

La commande netcfg peut être utilisée pour afficher les données de configuration de profil, et pour afficher, créer et modifier les objets WLAN connus, par toute personne disposant de privilèges Console User. Ces privilèges sont automatiquement attribués à tout utilisateur qui est connecté au système à partir de /dev/console. Les utilisateurs qui possèdent le profil Network Autoconf Admin peuvent également créer et modifier tous les types de profils NWAM et d'objets de configuration. Pour plus d'informations, reportez-vous à la section Présentation de la sécurité NWAM .

Vous pouvez utiliser la commande netcfg pour sélectionner, créer, modifier et détruire les profils définis par l'utilisateur. La commande peut être utilisée en mode interactif ou de ligne de commande. La commande netcfg prend également en charge l'exportation des informations de configuration de profil dans les fichiers de commandes.

Vous pouvez créer, modifier et supprimer les profils et les objets de configuration suivants :

• Profils de configuration réseau (NCP, Network Configuration Profiles)

• Profils d'emplacement

• Modificateurs réseau externes (ENM, External Network Modifiers)

• Réseaux locaux sans fil connu (WLAN, Wireless Local Area Networks)

• Unités de configuration réseau (NCU, Network Configuration Units)

Création de profils en mode de ligne de commande

La syntaxe de commande de base à utiliser pour créer un profil à partir de la ligne de commande est la suivante :

netcfg create [ -t template ] object-type [ class ] object-name

create

Crée un profil en mémoire (ou un objet de configuration) avec le type et le nom spécifiés.

-t template

Spécifie que le nouveau profil doit être identique au template (modèle), où template est le nom d'un profil existant du même type. Si l'option -t n'est pas utilisée, le nouveau profil est créé avec les valeurs par défaut.

object-type

Spécifie le type de profil à créer.

Vous pouvez spécifier l'une des valeurs suivantes pour l'option object-type :

• ncp

• umn

• loc

• enm

• wlan

Tous les profils qui sont spécifiés par l'option object-type, à l'exception d'un ncu, doivent être créés au niveau global avant de pouvoir utiliser la commande netcfg select pour sélectionner l'objet concerné.

class

Spécifie la classe de profil qui est spécifiée par object-type. Ce paramètre est utilisé uniquement pour le type d'objet ncu , et a deux valeurs possibles, phys ou ip.

object-name

Spécifie le nom du profil défini par l'utilisateur. Pour une unité monétaire nationale, object-name est le nom du lien ou de l'interface correspondante. Pour tous les autres types de profil, object-name est un nom défini par l'utilisateur.

Par exemple, pour créer un NCP nommé User, vous devez saisir la commande suivante :

$ netcfg create ncp User

où ncp est le type d'objet (type-objet) et User est le nom de l'objet (object-name).

Si vous le souhaitez, vous pouvez utiliser une copie du NCP automatique en tant que modèle, puis apporter des modifications à ce profil, comme indiqué ci-après :

$ netcfg create -t Automatic ncp

Pour créer un profil d'emplacement nommé office, vous devez saisir la commande suivante :

$ netcfg create loc office

Création interactive de profils

Vous pouvez utiliser la commande netcfg en mode interactif pour effectuer les tâches suivantes :

• créer un profil ;

• sélectionner et modifier un profil ;

• vérifier que toutes les informations requises sur un profil sont définies et valides ;

• valider les modifications pour un nouveau profil ;

• annuler la configuration de profil en cours sans valider les modifications dans le stockage persistant ;

• annuler les modifications que vous avez apportées à un profil.

Création d'un NCP

La création d'un profil en mode interactif entraîne l'affichage d'une invite de commande qui correspond à l'une des portées suivantes :

• Dans la portée du NCP, si un NCP est créé

• Dans la portée du profil, si un profil d'emplacement, un ENM, ou un objet WLAN est créé

La création d'un NCP ou d'une NCU déplace le focus dans la portée de cet objet, ce qui vous permet de parcourir les propriétés par défaut du profil indiqué.

Pour créer un NCP de façon interactive, vous devez commencer en lançant une session interactive netcfg. Ensuite, vous utilisez la sous-commande create pour créer le nouveau NCP User, comme suit :

$ netcfg
netcfg> create ncp User
netcfg:ncp:User>

Création de NCU pour un NCP

Le NCP est essentiellement un conteneur qui se compose d'un ensemble de NCU. Tous les NCP contiennent des NCU de lien et d'interface. Les NCU de lien spécifient à la fois la configuration de lien et la stratégie de sélection de lien. Les NCU d'interface spécifient la stratégie de configuration d'interface. Si la connectivité IP est nécessaire, deux NCU, de lien et d'interface, sont requises. Des NCU doivent être ajoutées ou supprimées explicitement en utilisant la commande netcfg ou à l'aide du GUID.

Vous pouvez créer des NCU à l'aide de la commande netcfg en mode interactif ou en mode de ligne de commande. Etant donné que la création d'une NCU implique plusieurs opérations, il est plus facile et plus efficace de créer les NCU en mode interactif, plutôt que d'essayer de construire une commande d'une seule ligne qui crée la NCU et toutes ses propriétés. Vous pouvez créer les NCU lors de la création initiale d'un NCP, ou ultérieurement. Le processus de création ou de modification d'une NCU implique la définition des propriétés générales de NCU, ainsi que la définition des propriétés s'appliquant spécifiquement à chaque type de NCU.

Les propriétés qui vous sont présentées au cours de la procédure de création de NCU pour un NCP sont les plus logiques par rapport aux choix que vous avez effectués au cours de la création du NCP en question.

Lorsque vous créez une NCU en mode interactif, netcfg passe en revue chaque propriété pertinente, en affichant à la fois la valeur par défaut, s'il en existe une, et les valeurs possibles. Si vous appuyez sur la touche Entrée sans spécifier de valeur, la valeur par défaut est appliquée (ou la propriété est laissée vide s'il n'y a aucune valeur par défaut). Vous pouvez également spécifier une autre valeur. Les propriétés qui s'affichent lors du processus de création des NCU pour un NCP sont pertinentes par rapport aux choix que vous avez déjà effectués. Par exemple, si vous choisissez l'option dhcp pour la propriété ipv4-addrsrc d'une NCU d'interface, vous n'êtes pas invité à spécifier une valeur pour la propriété ipv4-addr.

Le tableau suivant décrit toutes les propriétés de NCU que vous pouvez spécifier lors de la création ou la modification d'une NCU. Certaines propriétés s'appliquent aux deux types de NCU. D'autres propriétés s'appliquent à une NCU de lien ou une NCU d'interface. Pour obtenir une description complète de l'ensemble des propriétés de NCU, y compris des règles et conditions qui peuvent s'appliquer lorsque vous spécifiez ces propriétés, reportez-vous à la page de manuel netcfg(1M).

Tableau 4-1 Propriétés de création ou modification d'une NCU

Création d'un NCP en mode interactif

La procédure suivante décrit la création d'un NCP en mode interactif.

1. Lancez une session netcfg en mode interactif.

   $ netcfg
   netcfg>

2. Créez le NCP.

   netcfg> create ncp User
   netcfg:ncp:User>

   où ncp est le type de profil et User est le nom du profil.

   La création automatique du NCP vous conduit à la portée du NCP. Si vous créiez un emplacement, un ENM, ou un objet WLAN, l'invite de commande vous conduirait à la portée du profil.

3. Créez les NCU de lien et d'interface pour le NCP.
   1. Pour créer la NCU de lien, tapez la commande suivante :

      netcfg:ncp:User> create ncu phys net0
      Created ncu `net0', Walking properties ...

      où ncu est le type d'objet, phys est la classe et net0 (à titre d'exemple uniquement) est le nom de l'objet.

      La création d'une NCU vous place dans la portée de l'objet et vous permet de parcourir les propriétés par défaut de l'objet.

   2. Pour créer une NCU d'interface, tapez la commande suivante :

      netcfg:ncp:User> create ncu ip net0
      Created ncu `net0'. walking properties ...

      où ncu est le type d'objet, ip est la classe et net0 (à titre d'exemple uniquement) est le nom de l'objet.

      La création d'une NCU vous place dans la portée de l'objet et vous permet de parcourir les propriétés par défaut de l'objet.

      Au cours de la création d'une NCU, l'option class est utilisée pour faire la différence entre deux types de NCU. Cette option est particulièrement utile dans les situations où différents types de NCU partagent le même nom. Si l'option class n'est pas précisée, il est beaucoup plus difficile de distinguer les NCU qui partagent le même nom.

4. Ajoutez les propriétés appropriées pour la NCU que vous avez créée.

   ---

   Remarque - Répétez les étapes 3 et 4 jusqu'à ce que toutes les NCU requises pour le NCP aient été créées.

   ---

5. Au cours de la création de la NCU, ou lorsque vous définissez les valeurs de propriétés d'une NCU spécifique, utilisez la sous-commande verify pour vous assurer que les modifications que vous avez apportées sont correctes.

   netcfg:ncp:User:ncu:net0> verify
   All properties verified

6. Validez les propriétés que vous avez définies pour la NCU.

   netcfg:ncp:User:ncu:net0> commit
   committed changes.

   Vous pouvez également utiliser la sous-commande fin pour effectuer une validation implicite, ce qui a pour effet de déplacer la session interactive d'un niveau jusqu'à la portée supérieure. Dans cet exemple, si vous avez terminé la création du NCP et l'ajout des NCU à celui-ci, vous pouvez quitter la session interactive directement à partir de la portée du NCP.

   ---

   Remarque -

   • En mode interactif, les modifications ne sont pas enregistrées dans le stockage persistant tant que vous ne les avez pas validées. Lorsque vous utilisez la sous-commande commit, l'ensemble du profil est validé. Pour assurer la cohérence du stockage persistant, l'opération de validation comprend également une étape de vérification. Si la vérification échoue, la validation échoue également. Si une validation implicite échoue, vous avez la possibilité de mettre fin à la session interactive, ou de la fermer, sans valider les modifications effectuées. Vous pouvez également rester dans la portée actuelle et continuer à apporter des modifications au profil.

   • Pour annuler les modifications que vous avez apportées, utilisez la sous-commande cancel ou revert.

     La sous-commande cancel termine la configuration de profil actuelle sans valider les modifications actuelles dans le stockage persistant, puis déplace la session interactive d'un niveau jusqu'à la portée suivante. La sous-commande revert annule les modifications que vous avez apportées et lit à nouveau la configuration précédente. Lorsque vous utilisez la sous-commande revert, la session interactive reste dans la même portée.

   ---

7. Utilisez la sous-commande list pour afficher la configuration NCP.
8. Lorsque vous avez fini de configurer le NCP, quittez la session interactive.

   netcfg:ncp:User> exit

   Chaque fois que vous utilisez la sous-commande exit pour mettre fin à une session netcfg interactive, le profil actuel est vérifié et validé. Si l'opération de vérification ou de validation échoue, un message d'erreur approprié est affiché, et vous avez la possibilité de quitter sans valider les modifications actuelles. Vous pouvez également rester dans la portée actuelle et continuer à apporter des modifications au profil.

   ---

   Remarque - Pour quitter la portée sans quitter la session netcfg interactive, saisissez la commande fin :

   netcfg:ncp:User> end
   netcfg>

   ---

Exemple 4-1 Création d'un NCP en mode interactif

Dans l'exemple suivant, un NCP et deux NCU (de lien et d'interface) sont créés.

$ netcfg
netcfg> create ncp User
netcfg:ncp:User> create ncu phys net0
Created ncu `net0', Walking properties ...
activation-mode (manual) [manual|prioritized]>
link-mac-addr>
link-autopush>
link-mtu>
netcfg:ncp:User:ncu:net0> end
Committed changes
netcfg:ncp:User> create ncu ip net0
Created ncu `net0'. Walking properties ...
ip-version (ipv4,ipv6) [ipv4|ipv6]> ipv4
ipv4-addrsrc (dhcp) [dhcp|static]>
ipv4-default-route>
netcfg:ncp:User:ncu:net0> verify
All properties verified
netcfg:ncp:User:ncu:net0> end
Committed changes
netcfg:ncp:User> list
NCUs:
        phys    net0
        ip      net0
netcfg:ncp:User> list ncu phys net0
ncu:net0
        type                    link
        class                   phys
        parent                  "User"
        activation-mode         manual
        enabled                 true
netcfg:ncp:User> list ncu ip net0
ncu:net0
        type                    interface
        class                   ip
        parent                  "User"
        enabled                 true
        ip-version              ipv4
        ipv4-addrsrc            dhcp
        ipv6-addrsrc            dhcp,autoconf
netcfg:ncp:User> exit
$

Dans cet exemple, la valeur ipv4 n'étant pas choisie, aucune invite n'est affichée pour la propriété ipv6-addrsrc, car cette propriété n'est pas utilisée. De la même façon, pour la NCU phys, la valeur par défaut (activation manuelle) de la propriété priority-group est acceptée, de sorte qu'aucune autre propriété associée de manière conditionnelle n'est appliquée.

Exemple 4-2 Création d'une NCU pour un NCP existant

Pour créer une NCU pour un NCP existant ou pour modifier les propriétés de n'importe quel profil, utilisez la commande netcfg avec la sous-commande select.

Dans l'exemple suivant, une NCU IP est créée pour un NCP existant. Le processus de modification d'un profil existant en mode interactif est semblable à la création d'un profil. La différence entre l'exemple suivant et Exemple 4-1 est que, dans cet exemple, la sous-commande select est utilisée à la place de la sous-commande create car le NCP existe déjà.

$ netcfg
netcfg> select ncp User
netcfg:ncp:User> list
NCUs:
        phys   net0
netcfg:ncp:User> create ncu ip net0
Created ncu `net0'. Walking properties ...
ip-version (ipv4,ipv6) [ipv4|ipv6]> ipv4
ipv4-addrsrc (dhcp) [dhcp|static]>
ipv4-default-route>
netcfg:ncp:User:ncu:net0> end
Committed changes
netcfg:ncp:User> list
NCUs:
        phys    net0
        ip      net0
netcfg:ncp:User> list ncu phys net0
ncu:net0
        type                    link
        class                   phys
        parent                  "User"
        activation-mode         manual
        enabled                 true
netcfg:ncp:User> list ncu ip net0
NCU:net0
        type                    interface
        class                   ip
        parent                  "User"
        enabled                 true
        ip-version              ipv4
        ipv4-addrsrc            dhcp
        ipv6-addrsrc            dhcp,autoconf
netcfg:ncp:User> exit
$

Création d'un profil d'emplacement

Un profil d'emplacement contient les propriétés qui définissent les paramètres de configuration réseau qui ne sont pas directement liés à la connectivité de lien et IP de base. Les paramètres de service de nommage et de filtre IP qui sont appliqués conjointement, lorsque nécessaire, en sont des exemples. A un moment donné, un profil d'emplacement et un NCP doivent être actifs sur le système. Il existe des emplacements définis par le système et d'autres définis par l'utilisateur. Les emplacements système sont la valeur par défaut que NWAM choisit sous certaines conditions, par exemple, si vous n'avez pas indiqué d'emplacement, ou si aucun emplacement n'a été activé manuellement, et qu'aucune des conditions des emplacements activés de manière conditionnelle n'a été satisfaite. Les emplacements définis par le système possèdent un mode activation system. Les emplacements définis par l'utilisateur sont ceux qui sont configurés pour être activés manuellement ou de manière conditionnelle, en fonction des conditions de réseau, par exemple, une adresse IP qui est obtenue par une connexion réseau.

Pour plus d'informations sur l'activation manuelle d'un profil d'emplacement, reportez-vous à la section Activation et désactivation des profils .

Vous pouvez créer des emplacements à l'aide de la commande netcfg en mode interactif ou en mode de ligne de commande. Lorsque vous créez un profil d'emplacement, vous devez définir ses propriétés en indiquant des valeurs qui définissent les paramètres de configuration spécifiques de cet emplacement. Les propriétés d'emplacement sont classées par groupe, où le groupe correspond à une classe spécifique de préférences de configuration.

Les propriétés d'emplacement sont également stockées par NWAM dans un référentiel. Lorsqu'un profil d'emplacement spécifique est activé, NWAM configure automatiquement le réseau, en fonction des propriétés qui sont définies pour l'emplacement. La création ou la modification des emplacements consiste à définir les différentes propriétés qui définissent la façon dont le profil est configuré, ce qui détermine ensuite la façon dont NWAM configure automatiquement votre réseau. Les propriétés qui vous sont présentées pendant le processus de configuration sont celles qui sont les plus pertinentes, en fonction des choix que vous avez effectués précédemment.

Le tableau ci-dessous présente l'ensemble des propriétés d'emplacement qui peuvent être spécifiées. Notez que les propriétés d'emplacement sont classées par groupe. Pour obtenir une description complète de toutes les propriétés d'emplacement, y compris les règles, les conditions et les dépendances qui peuvent s'appliquer lorsque vous spécifiez l'une de ces propriétés, reportez-vous à la page de manuel netcfg(1M).

Tableau 4-2 Propriétés d'emplacement et leurs descriptions

Création d'un profil d'emplacement en mode interactif

La procédure suivante décrit la création d'un profil d'emplacement.

1. Lancez une session netcfg en mode interactif.

   $ netcfg
   netcfg>

2. Créez ou sélectionnez l'emplacement.

   netcfg> create loc office
   netcfg:loc:office>

   Dans cet exemple, l'emplacement office est créé.

   La création de l'emplacement vous déplace automatiquement dans la portée du profil pour cet emplacement.

3. Définissez les propriétés appropriées pour l'emplacement.
4. Affichez la configuration de profil.

   Par exemple, la sortie suivante affiche les propriétés de l'emplacement office :

   netcfg:loc:office> list
   LOC:office
       activation-mode              conditional-any
       conditions                   "ncu ip:wpi0 is active"
       enabled                      false
       nameservices                 dns
       nameservices-config-file     "/etc/nsswitch.dns"
       dns-nameservice-configsrc    dhcp
       ipfilter-config-file         "/export/home/test/wifi.ipf.conf"

5. Vérifiez que la configuration du profil est correcte.

   Dans l'exemple suivant, la configuration de l'emplacement office est vérifiée :

   netcfg:loc:office> verify
   All properties verified

6. Lorsque vous avez terminé la vérification, validez le profil d'emplacement dans le stockage permanent.

   netcfg:loc:office> commit
   Committed changes

   Vous pouvez également utiliser la sous-commande end pour mettre fin à la session, qui permet également d'enregistrer la configuration du profil.

   netcfg:loc:office> end
   Committed changes

   ---

   Remarque -

   • En mode interactif, les modifications ne sont pas enregistrées dans le stockage persistant tant que vous ne les avez pas validées. Lorsque vous utilisez la sous-commande commit, l'ensemble du profil est validé. Pour assurer la cohérence du stockage persistant, l'opération de validation comprend également une étape de vérification. Si la vérification échoue, la validation échoue également. Si une validation implicite échoue, vous avez la possibilité de mettre fin à la session interactive, ou de la fermer, sans valider les modifications effectuées. Vous pouvez également rester dans la portée actuelle et continuer à apporter des modifications au profil.

   • Pour annuler les modifications que vous avez apportées, utilisez la sous-commande cancel.

     La sous-commande cancel termine la configuration de profil actuelle sans valider les modifications actuelles dans le stockage persistant, puis déplace la session interactive d'un niveau jusqu'à la portée suivante.

   ---

7. Quittez la session interactive.

   netcfg> exit
   Nothing to commit
   $

Exemple 4-3 Création interactive d'un profil d'emplacement

Dans l'exemple suivant, un emplacement nommé office est créé.

$ netcfg
netcfg> create loc office
Created loc 'office'.  Walking properties ...
activation-mode (manual) [manual|conditional-any|conditional-all]> conditional-any
conditions> ncu ip:wpi0 is active
nameservices (dns) [dns|files|nis|ldap]> 
nameservices-config-file ("/etc/nsswitch.dns")> 
dns-nameservice-configsrc (dhcp) [manual|dhcp]> 
nfsv4-domain> 
ipfilter-config-file> /export/home/test/wifi.ipf.conf
ipfilter-v6-config-file> 
ipnat-config-file> 
ippool-config-file> 
ike-config-file> 
ipsecpolicy-config-file> 
netcfg:loc:office> list
LOC:office
    activation-mode              conditional-any
    conditions                   "ncu ip:wpi0 is active"
    enabled                      false
    nameservices                 dns
    nameservices-config-file     "/etc/nsswitch.dns"
    dns-nameservice-configsrc    dhcp
    ipfilter-config-file         "/export/home/test/wifi.ipf.conf"
netcfg:loc:office> verify
All properties verified
netcfg:loc:office> commit
Committed changes
netcfg> list
NCPs:
    User
    Automatic
Locations:
    Automatic
    NoNet
    test-loc
WLANs:
    sunwifi
    ibahn
    gogoinflight
    admiralsclub
    hhonors
    sjcfreewifi
netcfg> exit
Nothing to commit
$

Dans cet exemple, les propriétés suivantes ont été spécifiées pour l'emplacement office :

• La propriété activation-mode a été définie sur conditional-any, entraînant une invite de commande qui permet aux conditions d'activation d'être spécifiées.

• La condition d'activation a été spécifiée comme : ncu ip:wpi0 is active.

  ---

  Remarque - La propriété conditions est requise car la propriété conditional-any a été spécifiée à l'étape précédente. Si, par exemple, la propriété manual avait été spécifiée, la propriété conditions ne serait pas requise.

  ---

• Les valeurs par défaut suivantes ont été acceptées en appuyant sur Entrée :

  • nameservices

  • nameservices-config-file

  • dns-nameservice-configsrc

  • nfsv4-domain

• Pour la propriété ipfilter-config-file, le fichier /export/home/test/wifi.ipf.conf a été spécifié.

• Les valeurs par défaut suivantes ont été acceptées en appuyant sur Entrée :

  • ipfilter-v6-config-file

  • ipnat-config-file

  • ippool-config-file

  • ike-config-file

  • ipsecpolicy-config-file

• La sous-commande list a été utilisée pour afficher les propriétés du profil d'emplacement.

• La sous-commande verify a été utilisée pour effectuer une vérification de la configuration.

• La sous-commande commit a été utilisée pour valider les modifications apportées à l'espace de stockage persistant.

• La sous-commande list a été utilisée à nouveau pour s'assurer que le nouvel emplacement a été créé correctement et qu'il contient les informations correctes.

• La sous-commande exit a été utilisée pour quitter la session interactive netcfg.

Pour obtenir des instructions sur les valeurs qui peuvent être spécifiées pour ces propriétés, reportez-vous à la page de manuel netcfg(1M).

Création d'un profil ENM

Les ENM se rapportent à la configuration d'applications qui sont externes à NWAM, par exemple, une application de réseau privé virtuel (VPN). Ces applications peuvent créer et modifier la configuration réseau. Les ENM peuvent également être définis en tant que services ou applications qui modifient directement la configuration réseau lorsqu'ils sont activés ou désactivés. Vous pouvez configurer NWAM pour activer et désactiver des ENM dans les conditions que vous précisez. Contrairement à un profil d'emplacement ou à un NCP où un seul des types de profil peut être actif sur un système à un moment donné, plusieurs ENM sont susceptibles d'être actifs simultanément sur un système. Les ENM qui sont actifs sur un système à un moment donné ne sont pas nécessairement dépendants du profil d'emplacement ou du NCP qui est également activé sur le système en même temps.

Pour créer un ENM, tapez la commande suivante :

$ netcfg
netcfg> create enm my_enm
Created enm 'my_enm'.  Walking properties ...

où enm est le profil ENM et my_enm est le nom de l'objet.

Le processus de création des ENM vous permet d'accéder à la portée du profil pour l'ENM récemment créé, et lance automatiquement une visite des propriétés dans celui-ci. A partir de là, vous pouvez définir les propriétés de l'ENM stipulant quand et comment l'ENM est activé, ainsi que d'autres conditions, y compris la méthode de démarrage et d'arrêt de l'ENM.

Pour de plus amples instructions sur la spécification des propriétés d'ENM, reportez-vous à la page de manuel netcfg(1M).

Le tableau suivant décrit toutes les propriétés que vous pouvez spécifier lors de la création ou la modification d'un ENM.

Exemple 4-4 Création interactive d'un profil ENM

Dans l'exemple suivant, un ENM nommé test-enm est créé en mode interactif.

$ netcfg
netcfg> create enm test-enm
Created enm 'testenm'.  Walking properties ...
activation-mode (manual) [manual|conditional-any|conditional-all]> 
fmri> svc:/application/test-app:default
start> 
stop> 
netcfg:enm:test-enm> list
ENM:test-enm
    activation-mode     manual
    enabled             false
    fmri                "svc:/application/test-enm:default"
netcfg:enm:test-enm> verify
All properties verified
netcfg:enm:test-enm> end
Committed changes
netcfg> list
NCPs:
    User
    Automatic
Locations:
    Automatic
    NoNet
    test-loc
ENMs:
    test-enm
WLANs:
    sunwifi
    ibahn
    gogoinflight
    admiralsclub
    hhonors
    sjcfreewifi
netcfg> end
$

Dans cet exemple, un ENM nommé test-enm a été créé avec les valeurs de propriété suivantes :

• La valeur par défaut (manual) pour la propriété activation-mode a été acceptée en appuyant sur la touche Entrée.

• La propriété SMF FMRI svc:/application/test-enm:default a été spécifiée en tant que méthode à utiliser pour l'activation et désactivation de l'application.

  Notez que dans la mesure où un FMRI a été spécifié, les propriétés de méthode start et stop ont été ignorées.

• La sous-commande list a été utilisée pour afficher les propriétés de l'ENM.

• La sous-commande verify a été utilisée pour s'assurer que la configuration du profil est correcte.

• La sous-commande end a été utilisée pour enregistrer implicitement la configuration.

• La sous-commande end a été utilisée à nouveau pour mettre fin à la session interactive.

Création de WLAN

NWAM gère une liste à l'échelle du système répertoriant les WLAN connus. Les WLAN sont des objets de configuration qui contiennent l'historique et les informations de configuration pour les réseaux sans fil auxquels vous-vous connectez à partir de votre système. Cette liste sert ensuite à déterminer l'ordre dans lequel NWAM tente de se connecter aux réseaux sans fil disponibles. Si un réseau sans fil qui existe dans la liste des WLAN connus est disponible, NWAM se connecte automatiquement à ce réseau. Si deux ou plusieurs réseaux connus sont disponibles, NWAM se connecte au réseau sans fil qui a la priorité la plus élevée (numéro le plus bas). Tout nouveau réseau sans fil auquel NWAN se connecte est ajouté en tête de la liste des WLAN connus et devient le nouveau réseau sans fil à la priorité la plus élevée.

Pour créer un objet WLAN, tapez la commande suivante :

$ netcfg
netcfg> create wlan mywifi
Created wlan 'mywifi'.  Walking properties ...

où wlan est l'objet WLAN et mywifi est le nom de l'objet.

Le processus de création d'un objet WLAN vous permet d'accéder à la portée du profil pour le WLAN récemment créé, et lance automatiquement une visite des propriétés dans celui-ci. Vous pouvez alors définir les propriétés pour le WLAN qui définit sa configuration.

Le tableau suivant décrit toutes les propriétés que vous pouvez spécifier lors de la création ou la modification de WLAN.

Exemple 4-5 Création d'un WLAN

Dans l'exemple suivant, un objet WLAN nommé mywifi est créé.

Cet exemple suppose qu'un objet sécurisé nommé mywifi-key, qui contient la clé spécifiée par la propriété keyname pour le WLAN mywifi, est créé avant l'ajout du WLAN.

Le numéro de priorité peut changer à mesure que d'autres WLAN sont ajoutés ou supprimés. Notez que deux WLAN ne peuvent pas avoir le même numéro de priorité assigné. Les nombres inférieurs indiquent une priorité plus élevée, en termes de préférence des WLAN. Dans cet exemple, le numéro de priorité 100 est affecté au WLAN pour s'assurer qu'il a un niveau de priorité inférieur à celui de toute autre WLAN connu.

Lorsque la sous-commande list est utilisée à la fin de la procédure, le nouveau WLAN est ajouté à la fin de la liste, indiquant qu'il a le niveau de priorité le plus bas de tous les WLAN connus. Si le WLAN avait le numéro de priorité de zéro (0), qui est la valeur par défaut, il serait affiché en haut de la liste, indiquant la priorité la plus élevée. Par conséquent, l'ordre de priorité de tous les autres réseaux WLAN aurait été déplacés vers le bas et aurait été affiché dans la liste après le WLAN venant d'être ajouté.

$ netcfg
netcfg> create wlan mywifi
Created wlan 'mywifi'.  Walking properties ...
priority (0)> 100
bssids> 
keyname> mywifi-key
keyslot> 
security-mode [none|wep|wpa]> wpa
netcfg:wlan:mywifi> list
WLAN:mywifi
    priority            100
    keyname             "mywifi-key"
    security-mode       wpa
netcfg:wlan:mywifi> verify
All properties verified
netcfg:wlan:mywifi> end
Committed changes
netcfg> list
NCPs:
    User
    Automatic
Locations:
    Automatic
    NoNet
    test-loc
ENMs:
    test-enm
WLANs:
    sunwifi
    ibahn
    gogoinflight
    admiralsclub
    hhonors
    sjcfreewifi
    mywifi
netcfg> exit
Nothing to commit
$