mirror of
				https://github.com/xcat2/xcat-core.git
				synced 2025-10-30 19:02:27 +00:00 
			
		
		
		
	git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@5194 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
		
			
				
	
	
		
			228 lines
		
	
	
		
			6.9 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			228 lines
		
	
	
		
			6.9 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
| =head1 NAME
 | |
| 
 | |
| B<lsslp> - Discovers selected networked services information within the same subnet.
 | |
| 
 | |
| =head1 SYNOPSIS
 | |
| 
 | |
| I<lsslp [-h| --help]>
 | |
| 
 | |
| I<lsslp [-v| --version]>
 | |
| 
 | |
| 
 | |
| I<lsslp [-V| --verbose] [-i ip[,ip..]][-w][-r|-x|-z][-n][-s BPA|MM|IVM|RSA|FSP|HMC][-t tries][-m][-e command][-c [timeout[timeout,..]]][--vpdtable][-M vpd|switchport][--updatehosts][-makedhcp][--resetnet]>
 | |
| 
 | |
| 
 | |
| =head1 DESCRIPTION
 | |
| 
 | |
| The lsslp command discovers selected service types using the -s flag. All service types are returned if the -s flag is not specified. If a specific IP address is not specified using the -i flag, the request is sent out all available network adapters. The optional -r, -x, -z and --vpdtable flags format the output.
 | |
| 
 | |
| NOTE: SLP broadcast requests will propagate only within the subnet of the network adapter broadcast IPs specified by the -i flag.
 | |
| 
 | |
| =head1 OPTIONS
 | |
| 
 | |
| 
 | |
| B<-c>          Convergence timeout.
 | |
|             A value-list of 32 bit integers used as timeouts, in milliseconds, to
 | |
|             implement the convergence algorithm. Each value specifies the time
 | |
|             to wait before sending the next request, or until nothing new
 | |
|             has been learned from two successive requests. A maximum of 5 comma-
 | |
|             seperated values are allowed. Note that specifying -c with no arguments
 | |
|             will use the timeout values last specified. Not including -c will use
 | |
|             the hardcoded defaults of 500,750,1000,1500,2000 milliseconds.
 | |
| 
 | |
| B<-i>          IP(s) the command will send out (defaults to all available adapters).
 | |
| 
 | |
| B<-e>          Path and command name of IBM SLP slp_query (defaults to OpenSLP - slptool).
 | |
|             An IBM proprietary implementation of SLP can be also be used.
 | |
|             Contact IBM for details. 
 | |
| 
 | |
| B<-h>          Display usage message.
 | |
| 
 | |
| B<-m>          Multicast mode (defaults to broadcast).
 | |
| 
 | |
| B<--makedhcp>  Issue xCAT command makedhcp internally.
 | |
| 
 | |
| B<-M>          Matching mode, match the pre-defined node names from vpd table or switch table.
 | |
|             Default is using factory name if no -M specified.
 | |
| 
 | |
| B<-n>          Only display and write the newly discovered hardwares.
 | |
| 
 | |
| B<-r>          Display Raw SLP response.
 | |
| 
 | |
| B<--resetnet>  Login to hardwares and reset the network interfaces. This option is only valid
 | |
|             for the nodes with different attributes: ip and otherinterfaces in hosts table.
 | |
| 
 | |
| B<-s>          Service type interested in discovering.
 | |
| 
 | |
| B<-t>          Number or service-request attempts.
 | |
| 
 | |
| B<--updatehosts>  Display current IP address or write the ip address into xCAT DB. Please be 
 | |
|             aware that otherinterfaces column in hosts table saved the current ip address, 
 | |
|             ip column stores the new ip address that user defined. With this option, lsslp
 | |
|             will write the current ip to ip column also, which means the ip user wants is 
 | |
|             the same as current ip address running on hardwares. This is to avoid useless 
 | |
|             network resetting that if ip and otherinterfaces are the same, lsslp will skip
 | |
|             the network resetting for that node.
 | |
| 
 | |
| B<--vpdtable>  Output the SLP response in vpdtable formatting. Easy for writting data to vpd table.
 | |
| 
 | |
| B<-v>          Command Version.
 | |
| 
 | |
| B<-V>          Verbose output.
 | |
| 
 | |
| B<-w>          Writes output to xCAT database.
 | |
| 
 | |
| B<-x>          XML format.
 | |
| 
 | |
| B<-z>          Stanza formated output.
 | |
| 
 | |
| 
 | |
| =head1 RETURN VALUE
 | |
| 
 | |
| 0 The command completed successfully.
 | |
| 
 | |
| 1 An error has occurred.
 | |
| 
 | |
| =head1 EXAMPLES
 | |
| 
 | |
| 1. To list all discovered HMC service types in tabular format with convergence timeouts of 5000,5000,2000,1000,1000 milliseconds, enter:
 | |
| 
 | |
|  lsslp -s HMC -c 5000,5000,2000,1000,1000
 | |
| 
 | |
| Output is similar to:
 | |
| 
 | |
|  device type-model serial-number ip-addresses                    hostname
 | |
|  HMC    7310CR2    103F55A        1.1.1.115 2.2.2.164 3.3.3.102  hmc01
 | |
|  HMC    7310CR2    105369A        3.3.3.103 2.2.2.103 1.1.1.163  hmc02
 | |
|  HMC    7310CR3    KPHHK24        3.3.3.154 2.2.2.110 1.1.1.154  hmc03
 | |
| 
 | |
| 
 | |
| 2. list all discovered FSP service types in raw response format on subnet 30.0.0.255, enter:
 | |
| 
 | |
|  lsslp -i 3.0.0.255 -s FSP -r
 | |
| 
 | |
| Output is similar to:
 | |
| 
 | |
|  (type=cec-service-processor),(serial-number=10A3AEB),(machinetype-model=9117-570),(fru-serial-number=YL11C5338102),(hostname=),(frame-number=0),(cage-number=0),(ip-address=3.0.0.94,1.1.1.147),(web-url=https://3.0.0.94:473 ), (slot=1),(bpc-machinetype-model=0),(bpc-serial-number=0),(Image=fips240/b0630a_0623.240)
 | |
|  (type=cec-service-processor),(serial-number=10A3E2B),(machinetype-model=9117-570),(fru-serial- number=YL11C5338250),(hostname=),(frame-number=0),(cage-number=0),(ip-address=3.0.0.95,1.1.1.147), (web-url=https://3.0.0.95:473 ),(slot=1),(bpc-machinetype-model=0),(bpc-serial-number=0),(Image=fips240/b0630a_0623.240)
 | |
| 
 | |
| 
 | |
| 
 | |
| 3. To list all discovered MM service types in XML format and write the output to the xCAT database, enter:
 | |
| 
 | |
|  lsslp -s MM -x -w
 | |
| 
 | |
| Output is similar to:
 | |
| 
 | |
|   <Node>
 | |
|     <groups>mm,all</groups>
 | |
|     <id>00:14:5E:E0:CB:1E</id>
 | |
|     <mgt>blade</mgt>
 | |
|     <mtm>029310C</mtm>
 | |
|     <node>Server-029310C-SN100485A-A</node>
 | |
|     <nodetype>mm</nodetype>
 | |
|     <otherinterfaces>9.114.47.229</otherinterfaces>
 | |
|     <serial>100485A</serial>
 | |
|   </Node>
 | |
| 
 | |
| 
 | |
| 4. To list all discovered service types in stanza format and write the output to the xCAT database, enter:
 | |
| 
 | |
|  lsslp -z -w
 | |
| 
 | |
| Output is similar to:
 | |
| 
 | |
|  mm01:
 | |
|     objtype=node
 | |
|     nodetype=fsp
 | |
|     mtm=8233-E8B
 | |
|     serial=1000ECP
 | |
|     side=A
 | |
|     otherinterfaces=50.0.0.5
 | |
|     groups=fsp,all
 | |
|     mgt=fsp
 | |
|     id=0
 | |
|     mac=00:14:5E:F0:5C:FD
 | |
|     ip=50.0.0.5
 | |
| 
 | |
|  bpa01:
 | |
|     objtype=node
 | |
|     nodetype=bpa
 | |
|     mtm=9A01-100
 | |
|     serial=0P1N746
 | |
|     side=A
 | |
|     otherinterfaces=50.0.0.1
 | |
|     groups=bpa,all
 | |
|     mgt=bpa
 | |
|     id=0
 | |
|     mac=00:1A:64:54:8C:A5
 | |
|     ip=50.0.0.1
 | |
| 
 | |
| 
 | |
| 5. To list all discovered service types in stanza format and display the IP address, enter:
 | |
| 
 | |
|  lsslp -w --updatehosts
 | |
| 
 | |
| Output is similar to:
 | |
| 
 | |
|  mm01:
 | |
|     objtype=node
 | |
|     nodetype=fsp
 | |
|     mtm=8233-E8B
 | |
|     serial=1000ECP
 | |
|     side=A
 | |
|     otherinterfaces=50.0.0.5
 | |
|     groups=fsp,all
 | |
|     mgt=fsp
 | |
|     id=0
 | |
|     mac=00:14:5E:F0:5C:FD
 | |
|     ip=50.0.0.5
 | |
| 
 | |
|  bpa01:
 | |
|     objtype=node
 | |
|     nodetype=bpa
 | |
|     mtm=9A01-100
 | |
|     serial=0P1N746
 | |
|     side=A
 | |
|     otherinterfaces=50.0.0.1
 | |
|     groups=bpa,all
 | |
|     mgt=bpa
 | |
|     id=0
 | |
|     mac=00:1A:64:54:8C:A5
 | |
|     ip=50.0.0.1
 | |
| 
 | |
| 
 | |
| 6. To list all the FSPs and reset their network interfaces to get new IP from dhcp server, enter:
 | |
| 
 | |
|  lsslp -s FSP --resetnet
 | |
| 
 | |
| Output is similar to:
 | |
| 
 | |
|  Start to reset network..
 | |
| 
 | |
|  Reset network failed nodes:
 | |
| 
 | |
|  Reset network succeed nodes:
 | |
|  Server-8233-E8B-SN1000ECP-A,Server-9119-FHA-SN0275995-B,Server-9119-FHA-SN0275995-A,
 | |
| 
 | |
|  Reset network finished.
 | |
| 
 | |
|  device  type-model  serial-number  side  ip-addresses             hostname
 | |
|  FSP     8233-E8B    1000ECP        A     192.168.200.19 50.0.0.5  Server-8233-E8B-SN1000ECP-A(50.0.0.5)
 | |
|  FSP     9119-FHA    0275995        A     192.168.200.6 50.0.0.3   Server-9119-FHA-SN0275995-A(50.0.0.3)
 | |
|  FSP     9119-FHA    0275995        B     192.168.200.2 50.0.0.4   Server-9119-FHA-SN0275995-B(50.0.0.4)
 | |
| 
 | |
| 
 | |
| =head1 FILES
 | |
| 
 | |
| /opt/xcat/bin/lsslp
 | |
| 
 | |
| 
 | |
| =head1 SEE ALSO
 | |
| 
 | |
| L<rscan(1)|rscan.1>
 | |
| 
 | |
| 
 | |
| 
 | |
| 
 |