This is an old revision of the document!
Table of Contents
NIM operations
- Preview install on client for specific package:
[root@aix06] /root> nimclient -o cust -a lpp_source=LPP-AIX72TL1SP2 -a filesets=bos.rte.install -a installp_flags=-pacNYgX
- Update all packages from NIM client:
[root@aix06] /root> nimclient -o cust -a lpp_source=LPP-AIX72TL1SP2 -a fixes=update_all -a installp_flags=-acNYgX
- Boot a nim client on a ethernet interface using vlan tagging:
[root@aix06] /root> bootlist -m normal -o hdisk0 pathid=1 ent0 speed=auto duplex=auto bserver=10.10.10.1 client=10.10.10.25 gateway=10.10.10.254 vlan_tag=5
- Remove a resource:
# nim -Fo remove spot_aix6100-06-05
- Deallocate resources from a NIM client:
# nim -o reset -a force=yes laboh nim -Fo deallocate -a subclass=all laboh
For info: low level command to unallocated resource:
# lsnim -Fl nimclient1 alloc_count = 1 # /usr/lpp/bos.sysmgt/nim/methods/m_chattr -a alloc_count=0 nimclient1 # lsnim -Fl nimclient1 alloc_count = 0
- Create a NIM client:
# nim -o define -t standalone -a if1="net_41 testsrv 0" -a cable_type1='N/A' -a platform=chrp -a netboot_kernel=64 -a connect=nimsh testsrv
- Register a NIM client from client (if allowed):
# niminit -aname=<ClientName> -amaster=<MasterHostName> -a pif_name=<enX> -a connect=nimsh
- Create a mksysb from a NIM client:
# nim -o define -t mksysb -F -a server=master -a location=/export/mksysb/<nim_client>.mksysb -a source=<nim_client> -a mk_image=yes -a mksysb_flags='-e -i' <nim_client>_mksysb
- Define a LPPSOURCE:
# nim -o define -t lpp_source -a server=master -a source=lpp5300 -a location=/nim/lppsource/lpp5304 lpp5304
- Cleanup an lppsource:
To remove duplicate packages from a directory ppc and put unused files into /software/ppc (lppmgr command):
# /usr/lib/instl/lppmgr -d ppc -ubx -m /software/lpp -V
- Define a SPOT from an LPPSOURCE:
# nim -o define -t spot -a source=lpp_source1 -a server=master -a location=/export/spot spot1
- Update a SPOT with new OS version:
# nim -o cust -a fixes=update_all -a lpp_source=aix7100-05-08-2114 spot_7100-05-06-2028
- Define a SCRIPT:, for example to start before NIM upgrade
# nim -o define -t script -a server=master -a location=/export/nim/custom_scr_mig72/pre_scr_mig72.sh pre_scr_mig72
- Showlogs related to a resource:
# nim -o showlog -a full_log=yes -a log_type=nimerr spot_aix6100-06-05
- Read the full NIM log:
# alog -f /var/adm/ras/nimlog -o
- List operation for a specific object:
[root@nimsrv]/root# lsnim -POt spot spot: change = change an object's attributes showres = show contents of a resource reset = reset an object's NIM state define = define an object remove = remove an object cust = perform software customization sync_roots = synchronize roots for all clients using specified SPOT maint = perform software maintenance lslpp = list LPP information about an object fix_query = perform queries on installed fixes showlog = display a log in the NIM environment check = check the status of a NIM object lppchk = verify installed filesets
Lppchk on a spot (with checksum)
[root@nimsrv]/root# nim -o lppchk -a lppchk_flags="-c" spot_7100-04-03
- List attributes that can be changed for a resource:
[root@nimsrv]/root# lsnim -q change spot_aix6100-06-05 the following attributes are optional: -a comments=<value> -a new_name=<value> -a verbose=<value> -a nfs_vers=<value> -a nfs_sec=<value> -a client_alloc=<value> -a dest_dir=<value> -a dumpsize=<value> -a snapcollect=<value> -a notify=<value> -a max_dumps=<value>
- Instfix command to check APARs, or individual fileset into a spot
# nim -o fix_query spot_7100-01 | grep SP All filesets for 71-00-011037_SP were found. All filesets for 71-00-021041_SP were found. All filesets for 71-00-031115_SP were found. All filesets for 71-01-011141_SP were found. All filesets for 71-00-041140_SP were found. All filesets for 71-01-021150_SP were found. All filesets for 71-01-031207_SP were found. All filesets for 71-00-051207_SP were found. All filesets for 71-01-041216_SP were found. All filesets for 71-00-061216_SP were found. All filesets for 71-01-051228_SP were found. # nim -o fix_query -a fix_query_flags="-c" spot_7100-01 | grep bos.net IV22689:bos.net.tcp.client:7.1.1.16:7.1.1.16:=:NETSTAT -R IN WPAR RETURNS "PERMISSION DENIED" 71-01-051228_SP:bos.net.nfs.client:7.1.1.16:7.1.1.16:=:AIX 7100-01-05 Service Pack 71-01-051228_SP:bos.net.tcp.client:7.1.1.16:7.1.1.16:=:AIX 7100-01-05 Service Pack ... # nim -o lslpp -a lslpp_flags=Lc -a filesets=bos.alt_disk_install.rte spot_aix6100-06
- Perform change on NIM server if hostname, ip or adapter has changed:
[root@nimsrv]/export/software/TSM/client# nim_master_recover -i en0 -S error retrieving nim name, defaulting to host name. Updating master definition Updated master attribute platform to chrp Updated master attribute netboot_kernel to 64 Updated master attribute if1 to network1 nimsrv FA1EC34A1404 Updated master attribute cable_type1 to N/A Updated network1 routing1 to default 10.10.1.1 Finished updating master definition Resetting machines Reset master Reset client1 Reset Finished resetting machines Resetting NIM resources Finished resetting NIM resources Checking NIM resources Keeping spot_aix61tl7 Removing client5_mksysb 0518-307 odmdelete: 1 objects deleted. from nim_attr (serves attr) 0518-307 odmdelete: 0 objects deleted. from nim_attr (group memberships) 0518-307 odmdelete: 10 objects deleted. from nim_attr (resource attributes) 0518-307 odmdelete: 1 objects deleted. from nim_object (resource object) Finished removing client5_mksysb Keeping lpp_aix61tl7 Finished checking NIM resources nim_master_recover Complete
- NIM client commands:
Install and update software from a client
# nimclient -o cust -a installp_flags=gXY -a filesets=xlsmp.rte -a lpp_source=lpp_aix7100-02-03_base # nimclient -o cust -a installp_flags=Y -a fixes=update_all -a lpp_source=lpp_aix7100-02-03_base
- List all resources available for a client:
# nimclient -l -L devds2_nc mksysb_nim_20121001 mksysb lpp_aix7100-01-00_base lpp_source spot_aix5300-08 spot lpp_aix5300-08-00_base lpp_source lpp_aix6100-06-00_base lpp_source lpp_aix7100-02-03_base lpp_source
Changing the CPUID of NIM Master and NIM Clients after LPM
On the NIM Client:
This document explains how to change your NIM Master or NIM Clients CPUID after you have moved it to new HW to match the system's new CPUID.
To check what CPUID the Master has for the NIM Client we can run the following command on the NIM Master:
root@sentinel(/)# lsnim -l instlab163 | grep -i cpuid cpuid = 00FF48B55C00 <---- wrong/old CPUID
To check the current CPUID of the NIM Client:
root@instlab163(/)# uname -a AIX instlab163 2 7 00F84BE54C00
To change the CPUID on the NIM Master’s client definition to match with the actual CPUID of the nim client:
root@sentinel(/)#nim -o change -a cpuid=00F84BE54C00 instlab163 root@sentinel(/)# lsnim -l instlab163 | grep -i cpuid cpuid = 00F84BE54C00 <---- correct CPUID
We can verify connectivity:
root@sentinel(/)# nim -o lslpp instlab163 | grep bos.mp bos.mp64 7.2.4.0 COMMITTED Base Operating System 64-bit
On the NIM Master:
To check the current system CPUID:
root@sentinel(/)# uname -a AIX sentinel 2 7 00FB43B94C00
To check the NIM Master definition:
root@sentinel(/)# lsnim -l master | grep -i cpuid cpuid = 00FB43C85B00 ß old/wrong CPUID
To change the CPUID:
# /usr/lpp/bos.sysmgt/nim/methods/m_chattr -a cpuid="new CPUID" master
Example:
root@sentinel(/)# /usr/lpp/bos.sysmgt/nim/methods/m_chattr -a cpuid="00FB43B94C00" master
To verify:
root@sentinel(/)# lsnim -l master | grep -i cpuid cpuid = 00FB43B94C00
