Under Construction

Anzeigen von customized NIM-Objekten

Wird beim lsnim Kommando keine der Optionen „-p“ oder „-P“ (predefined) verwendet, dann werden Informationen zu angelegten (customized) NIM-Objekten angezeigt. Auch hier gibt es eine ganze Reihe verschiedener Möglichkeiten, abhängig von den gewünschten Informationen.

Ganz ohne Optionen, werden alle angelegten (customized) NIM-Objekte angezeigt:

aixnim # lsnim
master                        machines        master
boot                           resources       boot
nim_script                     resources       nim_script
net_10_192_168_0               networks        ent
aix01                   machines        standalone
aix02                  machines        standalone
aix720509lpp                   resources       lpp_source

aixnim #

Dabei wird neben dem Namen der NIM-Objekte (erste Spalte), auch die Klasse (zweite Spalte) und der Typ (dritte Spalte) angezeigt. Es können aber auch nur bestimmte NIM-Objekte angezeigt werden, dazu gibt es verschiedene Möglichkeiten.

Die Namen der interessierenden NIM-Objekte können einfach als Argumente angegeben werden, z.B.:

aixnim # lsnim boot nim_script certificate
boot            resources       boot
nim_script      resources       nim_script
certificate     resources       certificate
aixnim #

Alternativ kann aber auch die Klasse (Option „-c“), die Subklasse (Option „-s“) oder der Typ (Option „-t“) angegeben werden:

Beispiel 1: Anzeigen aller NIM-Objekte der Klasse machines.

aixnim # lsnim -c machines
master              machines       master
aix01         machines       standalone
aix02         machines       standalone

aixnim #

Beispiel 2: Anzeigen aller NIM-Objekte der Subklasse bos_res.

aixnim # lsnim -s bos_res
aix01_72_mksysb_mig_73     resources       mksysb
aix03_72_mksysb            resources       mksysb
aix03_72_mksysb_mig_73     resources       mksysb
aix730300spot              resources       spot
aix730202spot              resources       spot
aix730101spot              resources       spot
aix01_72_mksysb            resources       mksysb
aixnim #

Beispiel 3: Anzeigen aller NIM-Objekte vom Typ spot.

aixnim # lsnim -t spot
aix730300spot     resources       spot
aix730202spot     resources       spot
aix730101spot     resources       spot
aixnim #

In allen bisherigen Beispielen wurden nur Name, Klasse und Typ angezeigt. Durch zusätzliche Verwendung der Option „-l“ (long) oder „-O“ (operation), können detaillierte Informationen zu den NIM-Objekten bzw. Operationen die auf den NIM-Objekten möglich sind, angezeigt werden.

Beispiel 1: Anzeigen von detaillierten Informationen zu ausgewählten NIM-Objekten.

aixnim # lsnim -l boot nim_script certificate
boot:
   class       = resources
   type        = boot
   comments    = represents the network boot resource
   Rstate      = ready for use
   location    = /tftpboot
   alloc_count = 0
   server      = master
   reserved    = yes
nim_script:
   class       = resources
   type        = nim_script
   comments    = directory containing customization scripts created by NIM
   Rstate      = ready for use
   location    = /export/nim/scripts
  alloc_count = 0
   server      = master
   reserved    = yes
certificate:
   class       = resources
   type        = certificate
   comments    = specifies the ssl certificate associated with remote services
   Rstate      = ready for use
   location    = /ssl_nimsh/certs/
   alloc_count = 0
   server      = master
   reserved    = yes
aixnim #

Beispiel 2: Anzeigen von detaillierten Informationen aller NIM-Objekte vom Typ spot.

aixnim # lsnim -l -t spot                   
aix730300spot:
   class         = resources
   type          = spot
   plat_defined  = chrp
   arch          = power
   bos_license   = yes
   Rstate        = ready for use
   prev_state    = verification is being performed
   location      = /export/nim/spots/aix730300spot/usr
   version       = 7
   release       = 3
   mod           = 3
   oslevel_r     = 7300-03
   oslevel_s     = 7300-03-00-2446
   alloc_count   = 0
   server        = master
   if_supported  = chrp.64 ent
   Rstate_result = success
   date_updated  = Mon Mar 31 12:02:24 2025
aix730202spot:
   class         = resources
   type          = spot
   plat_defined  = chrp
   arch          = power
   bos_license   = yes
   Rstate        = ready for use
   prev_state    = verification is being performed
  location      = /export/nim/spots/aix730202spot/usr
   version       = 7
   release       = 3
   mod           = 2
   oslevel_r     = 7300-02
   oslevel_s     = 7300-02-02-2420
   alloc_count   = 0
   server        = master
   if_supported  = chrp.64 ent
   Rstate_result = success
   date_updated  = Mon Apr 14 15:08:59 2025
aix730101spot:
   class         = resources
   type          = spot
   plat_defined  = chrp
   arch          = power
   bos_license   = yes
   Rstate        = ready for use
   prev_state    = verification is being performed
   nfs_vers      = 4
   nfs_sec       = sys
   location      = /export/nim/spots/aix730101spot/usr
   version       = 7
   release       = 3
   mod           = 1
   oslevel_r     = 7300-01
   oslevel_s     = 7300-01-01-2246
   alloc_count   = 0
   server        = master
   if_supported  = chrp.64 ent
   Rstate_result = success
aixnim #

Beispiel 3: Anzeigen der Operationen die auf den NIM-Objekten certificate und master möglich sind.

aixnim # lsnim -O certificate master
certificate:
   showres = show contents of a resource
   check   = check the status of a NIM object
master:
   unconfig   = unconfigure the NIM master fileset
   change     = change an object's attributes
   allocate   = allocate a resource for use
   deallocate = deallocate a resource
   cust       = perform software customization
   maint      = perform software maintenance
   reset      = reset an object's NIM state
   lslpp      = list LPP information about an object
   fix_query  = perform queries on installed fixes
   check      = check the status of a NIM object
   showlog    = display a log in the NIM environment
   showres    = show contents of a resource
   lppchk     = verify installed filesets
   restvg     = perform a restvg operation
aixnim #

Bei Verwendung der Option „-l“ (long) werden jeweils alle Attribute der ausgewählten NIM-Objekte angezeigt. Die Ausgabe kann dementsprechend länger sein. Eine Alternative dazu ist nur bestimmte Attribute anzeigen zu lassen. Dazu muss anstelle von „-l“ die Option „-a“ (attribute) verwendet werden. Dabei kann das interessierende Attribut als Options-Argument bei „-a“ angegeben werden. Die Option „-a“ kann mehrfach verwendet werden, womit dann auch mehrere Attribute angezeigt werden können. Allerdings werden die Optionen „-c“ (class), „-s“ (subclass) und „-t“ (type) nicht zusammen mit „-a“ unterstützt. Nachfolgend einige Beispiele:

Beispiel 1: Auflisten aller NIM-Objekte die ein Attribut mit Namen nfs_vers oder reserved haben.

aixnim # lsnim -a reserved -a nfs_vers
master:
   reserved = yes
boot:
   reserved = yes
nim_script:
   reserved = yes
aix730101lpp:
   nfs_vers = 4
certificate:
   reserved = yes
aix730101spot:
   nfs_vers = 4
aixnim #

Beispiel 2: Für die angegebenen NIM-Objekte auflisten, welche davon das Attribut nfs_vers besitzen.

aixnim # lsnim -a nfs_vers aix730101lpp aix730202lpp aix730101spot
aix730101lpp:
   nfs_vers = 4
aix730101spot:
   nfs_vers = 4
aixnim #

Hinweis: Nur zwei der drei angegebenen NIM-Objekte besitzen das Attribut nfs_vers.

Soll auf einem NIM-Objekt eine Operation ausgeführt werden, müssen dafür häufig einige Attribute für die Operation angegeben werden. Bei Operationen und Objekt-Typen, mit denen der Administrator seltener zu tun hat, ist oft nicht ganz klar welche Attribute angegeben werden müssen und auch nicht welche Attribute bei der Operation angegeben werden können. Mit der Option „-q“ (query) lassen sich die Attribute für jede beliebige Operation und jedes beliebige Objekt anzeigen. Dabei kann entweder das konkrete NIM-Objekt angegeben werden, auf dem eine Operation durchgeführt werden soll, oder es kann der Typ des NIM-Objekts mit der Option „-t“ (type) angegeben werden.

Beispiel 1: Anzeigen der Attribute für die Operation maint auf dem NIM-Client (NIM-Objekt) aix01.

aixnim # lsnim -q maint aix01

the following resources are optional:
        installp_bundle

the following attributes are required:
        -a installp_flags=<value>

the following attributes are optional:
        -a filesets=<value>
        -a show_progress=<value>
        -a installp_bundle=<value>
        -a group=<value>
        -a smit_bundle=<value>

aixnim #

Hinweis: Nur das Attribut installp_flags muss bei der Operation maint zwingend angegeben werden.

Beispiel 2: Anzeigen der Attribute für die Operation allocate auf NIM-Objekten vom Typ standalone.

aixnim # lsnim -q allocate -t standalone
aixnim #

Hinweis: Es gibt keine Attribute die für diese Operation angegeben werden können.

Es gibt eine Reihe von weiteren Möglichkeiten speziell für NIM-Gruppen, die in einem eigenen Kapitel beschrieben werden.