FAQ NIM

Creation: 23 fevrier 2011
Mise à jour:
Version: 1.0
Author: Jean-Louis Bicquelet-Salaün
Location: http://jlbicquelet.free.fr
Copyright: (c) 2010-2011 Jean-Louis BICQUELET-SALAÜN

NIM (Network Instalaltion Manager) Frequently-Asked Questions

Pour plus d'information au sujet de cette faq, contactez Jean-Louis BICQUELET


FAQ Revised: Wednesday 23 February 2011 11:49:00


Table of Contents

1. configuration
2. machine
3. client
4. groupes
5. reseau
6. ressources
7. administration
8. operations
9. smit
10. trucs

1. configuration

1.1. Ou se trouvent les log de NIM ?
Dans le fichier nimsh.log du répertoire /var/adm/ras.


2. machine

2.1. comment obtenir la liste des machines gérées par le serveur NIM?
Pour lister toutes les machines
#lsnim -c machines
master       machines       master
batman       machines       standalone
badboy       machines       standalone
darkstar     machines       standalone

Si vous voulez lister une ou plusieures machines, il faut donner leurs noms.

lsnim  batman batboy
batman       machines       standalone
badboy       machines       standalone

lsnim  batgirl


2.2. comment afficher les ressources accessibles par une machine ?
# lsnim -L hermes
exclude_batman                    exclude_files
exclude_robin                     exclude_files
exclude_batgirl                   exclude_files
vsyst01_badboy_20101011           savevg
vsyst01_badgirl                   savevg
vsyst01_robin_20101011            savevg
exclude_spiderman                 exclude_files
mksysb_batman_20101011            mksysb              Mksysb_batman
mksysb_batman_20100903            mksysb


2.3. comment obtenir l'état d'une machine et son mode de connection?
# lsnim -l batman
batman:
   class          = machines
   type           = standalone
   connect        = nimsh
   platform       = chrp
   netboot_kernel = mp
   if1            = nimres batman 0
   cable_type1    = N/A
   Cstate         = ready for a NIM operation
   prev_state     = not running
   Mstate         = currently running
   cpuid          = 00CB588EEC00
   Cstate_result  = failure
   missing        = bosinst_data


2.4. comment afficher les types de machines
#lsnim -p -c machines
wpar
diskless
dataless
standalone
master
alternate_master
La version avec -P est plus bavarde:
#lsnim -P -c machines
wpar             = file systems and resources hosted on managing system
diskless         = all filesystems & resources remote
dataless         = local paging,dump; remote /,/usr; others remote or local
standalone       = local filesystems & resources
master           = machine which controls the NIM environment
alternate_master = alternate machine which can control the NIM environment


2.5. comment lister les opérations possibles avec une machine ?
# lsnim -o batgirl
batgirl:
   cust             = perform software customization
   diag             = enable a machine to boot a diagnostic image
   maint            = perform software maintenance
   bos_inst         = perform a BOS installation
   reset            = reset an object's NIM state
   fix_query        = perform queries on installed fixes
   check            = check the status of a NIM object
   reboot           = reboot specified machines
   showlog          = display a log in the NIM environment
   maint_boot       = enable a machine to boot in maintenance mode
   showres          = show contents of a resource
   lppchk           = verify installed filesets
   alt_disk_install = perform an alt_disk_install operation on a client
   alt_disk_mig     = perform an alt_disk_mig operation on a client
   restvg           = perform a restvg operation
   linux_inst       = operation to install Linux onto a standalone
   lswpar           = show the characteristics of a workload partition
   syncwpar         = synchronize workload partition software with the managed system
   deploy           = deploy an ovf_vm NIM resource to the target NIM client objects


2.6. comment supprimer une machine d'un serveur NIM?
nim -o remove batgirl
Ou se trouve la configuration locale d'un client NIM ?


3. client

3.1. comment définir un client NIM ?
Le plus simple consiste à utiliser smit avec la commande smit niminit sur le serveur client. On obtient le menu suivant:
  Configure Network Installation Management Client Fileset

Type or select values in entry fields.
Press Enter AFTER making all desired changes.

[TOP]                                                   [Entry Fields]
* Machine Name                                       [batman]
* Primary Network Install Interface                  [en0]                   +
* Host Name of Network Install Master                [darkstar]

  Hardware Platform Type                              chrp
  Kernel to use for Network Boot                     [mp]                    +
  Communication Protocol used by client              [nimsh]                 +
  Ethernet Interface Options
    Network Speed Setting                            []                      +
    Network Duplex Setting                           []                      +
  Comments                                           []

  Alternate Port Numbers for Network Communications
[MORE...3]

batman est le nom du client, darkstar le nom du serveur.

Il faut faire attention à l'interface réseau qui va etre utilisée, surtout si le serveur possède plusieures cartes réseau, au type de noyau utilisé lors du boot par le réseau (ici mp pour multiprocessuer) et au protocole utilisé (Nimsh), car ces paramêtres assurent la communication entre le client et le serveur NIM, ainsi que le boot du client (et donc l'installation la maintenance ...).

3.2. Comment remettre l'état d'un client à zero?

Sur le serveur NIM tapez:

#nim -F -o reset darkstar



4. groupes

4.1. comment lister les groupes de machines ?
#lsnim -c groups
prod                  groups       mac_group
mksysb_prod           groups       res_group
duo                   groups       mac_group
unix_national         groups       mac_group


4.2. comment afficher les membres d'un groupe ?
# lsnim -g duo
duo:
   class   = groups
   type    = mac_group
   member1 = batman  ready for a NIM operation; currently running;
   member2 = batgirl ready for a NIM operation; currently running;

Une autre manière renvoyant moins d'information est:

# lsnim -m duo
batman  machines       standalone
batgirl machines       standalone

Pour afficher une liste détailler tapez:

#lsnim -m -Fl



5. reseau

5.1. comment lister les réseaux utilisés par nim ?
#lsnim -c networks
nimoper          networks       ent
ent-Network1     networks       ent


5.2. comment obtenir les caractéristiques d'un réseau utilisé par NIM ?
# lsnim -l nimsartre
nimoper:
   class      = networks
   type       = ent
   Nstate     = ready for use
   prev_state = ready for use
   net_addr   = 176.242.1.0
   snm        = 255.255.255.0
   routing1   = default 176.242.1.250



6. ressources

6.1. comment connaitre les ressources gérées par un serveur NIM ?
#lsnim -p
machines
resources
networks
groups

Ou pour avoir le détail

#lsnim -P
machines  = class of NIM objects which represent machines
resources = NIM object class which represent install resources
networks  = class of NIM objects which represent networks
groups    = a group of machines or resources


6.2. comment connaitre les opérations possibles avec une ressource ?
# lsnim -p -t spot -o
spot:
   showres    = /usr/lpp/bos.sysmgt/nim/methods/m_showres
   reset      = /usr/lpp/bos.sysmgt/nim/methods/m_ckspot
   cust       = /usr/lpp/bos.sysmgt/nim/methods/m_instspot
   sync_roots = /usr/lpp/bos.sysmgt/nim/methods/m_sync_roots
   maint      = /usr/lpp/bos.sysmgt/nim/methods/m_spotmaint
   lslpp      = /usr/lpp/bos.sysmgt/nim/methods/m_lslpp
   fix_query  = /usr/lpp/bos.sysmgt/nim/methods/m_fixquery
   showlog    = /usr/lpp/bos.sysmgt/nim/methods/m_showlog
   check      = /usr/lpp/bos.sysmgt/nim/methods/m_ckspot
   lppchk     = /usr/lpp/bos.sysmgt/nim/methods/m_lppchk



6.3. comment lister un type de ressource donnée ?

Pour lister un spot:

lsnim -t spot
spot_helios_2110           resources       spot
spot_lassie_20101011       resources       spot
spot_heracles_20101011     resources       spot
spotAIX52TL10SP08          resources       spot

Pour lister un mksysb:

# lsnim -t  mksysb
mksysb_batman_20101011       resources       mksysb
mksysb_ironman_20101011      resources       mksysb

Pour lister un lpp_source:

# lsnim -t  lpp_source
AIX52_TL10_SP08     resources       lpp_source
AIX61TL01SP1        resources       lpp_source
AIX53TL07SP1        resources       lpp_source


6.4. comment afficher les caractéristiques d'une ressource ?
# lsnim -l mksysb_batman_20101028
mksysb_batman_20101028:
   class         = resources
   type          = mksysb
   comments      = Mksysb_batman
   arch          = power
   Rstate        = ready for use
   prev_state    = unavailable for use
   location      = /NIM/mksysb_batman/mksysb_batman_20101028
   version       = 5
   release       = 2
   mod           = 0
   oslevel_r     = 5200-10
   alloc_count   = 0
   server        = master
   creation_date = Thu Oct 28 16:25:31 2010
   source_image  = batman


6.5. comment definir une ressources?

Tapez smitty nim_res puis choisissez Define a Resource et compléter le menu:

                               Define a Resource

Type or select values in entry fields.
Press Enter AFTER making all desired changes.

[TOP]                                                   [Entry Fields]
* Resource Name                                      [spotAIX52TL10SP08]
* Resource Type                                       spot
* Server of Resource                                 [master]                +
* Source of Install Images                           [AIX52_TL10_SP08]       +
* Location of Resource                               [/NIM/spot]              /
  NFS Client Security Method                         []                      +
  NFS Version Access                                 []                      +
  Expand file systems if space needed?                yes                    +
  Comments                                           []

  installp Flags
  PREVIEW only? (install operation will NOT occur)    no                     +
  COMMIT software updates?                            no                     +
[MORE...4]

F1=Help             F2=Refresh          F3=Cancel           F4=List
F5=Reset            F6=Command          F7=Edit             F8=Image
F9=Shell            F10=Exit            Enter=Do


6.6. comment vérifier une ressource?

Les lignes qui suivent vérifient la cohérence d'un spot.

# nim -o -check spotAIX52TL10SP08

ou

# nim -o -check -F spotAIX52TL10SP08


6.7. comement examiner le contenu d'une ressource?
# nim -o showres AIX52_TL10_SP08
  Fileset Name                Level                     I/U Q Content
  ====================================================================
  Java14.license              1.4.2.0                    I  N usr
#   Java SDK 32-bit License

  Java14.sdk                  1.4.2.150                  I  N usr,root
#   Java SDK 32-bit
...
  xlC.cpp                     5.0.2.0                    I  N usr
#   C for AIX Preprocessor

  xlC.msg.en_US.cpp           5.0.2.0                    I  N usr
#   C for AIX Preprocessor Messages--U.S. English

  xlC.rte                     6.0.0.0                    I  N usr
#   C Set ++ Runtime



6.8. comment supprimer une ressource?
# nim -o remove spotAIX52TL10SP08



7. administration

7.1. comment lister les ressources NIM ?
# lsnim -m
master                           machines        master
boot                             resources       boot
nim_script                       resources       nim_script
nimbatman                        networks        ent
batman                           machines        standalone
mksysb_batgirl_20110211          resources       mksysb
exclude_batman                   resources       exclude_files
mksysb_darkstar_20110211         resources       mksysb
exclude_darkstar                 resources       exclude_files
badboy                           machines        standalone
mksysb_badboy_20101224           resources       mksysb
darkstar                         machines        standalone
AIX52_TL10_SP08                  resources       lpp_source
vsystsy01_batman_20101011        resources       savevg
mksysb_darkstar_20101126         resources       mksysb
vgdata_darkstar_20101011         resources       savevg


7.2. comment supprimer toutes les ressources liées à un serveur ?
for i in `lsnim | grep _darkstar_ | awk '{print $1}'`
do
 nim -o remove $i
done



8. operations

8.1. comment cloner un rootv d'un client via NIM ?

On va faire un alt_disk_install via NIM :

#nim -o alt_disk_install -a source=rootvg -a disk=hdisk1 badboy



9. smit

9.1. quels sont les raccourcis dans smit amenant aux menus du serveur NIM?

nim_macgestion des machines
nim_lsmacgestion des machines
nim_resgestion des ressources NIM
nim_lsresliste des ressources
nim_rmressuppresion d'un ressource


9.2. quels sont les raccourcis dans smit amenant aux menus NIM pour un client?

niminitconfiguration nim d'un client


9.3. quels sont les operations qu'il vaut mieux faire par smit ?

  • Sur le client, l'initialisation avec smit niminit



10. trucs

10.1. que faire en cas de problème d'export ?

Pensez à nettoyer le fichier /etc/exports à l'aiode d'un éditeur, puis à taper la commande

#exportfs -a