mirror of
				https://github.com/xcat2/xcat-core.git
				synced 2025-10-26 00:45:38 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			185 lines
		
	
	
		
			4.8 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			185 lines
		
	
	
		
			4.8 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
| =head1 NAME
 | |
| 
 | |
| B<lsflexnode> - Display the information of flexible node
 | |
| 
 | |
| 
 | |
| =head1 SYNOPSIS
 | |
| 
 | |
| B<lsflexnode> [B<-h> | B<--help>]
 | |
| 
 | |
| B<lsflexnode> [B<-v> | B<--version>]
 | |
| 
 | |
| B<lsflexnode> I<noderange> 
 | |
| 
 | |
| 
 | |
| =head1 DESCRIPTION
 | |
| 
 | |
| IBM BladeCenter HX5 offers flexibility ideal that the blades can be combined together for scalability. 
 | |
| 
 | |
| There are several concepts to support the HX5 multiple blades combination:
 | |
| 
 | |
| =over 2
 | |
| 
 | |
| B<Complex>: Multiple blades which combined by a scalability card is a complex. 
 | |
| 
 | |
| B<Partition>: A logic concept which containing part of the B<Blade slot node> in a complex. Each partition can map to a system to install Operating System. Each partition could have 1HX5, 1HX5+1MD or 2HX5+2MD. (MD is the Memory Drawer)
 | |
| 
 | |
| B<Blade slot node>: The physical blade which installed in the slot of a chassis. It can be a HX5 or MD.
 | |
| 
 | |
| =back
 | |
| 
 | |
| A B<Complex> will be created automatically when a multiple blades combination is installed. In this B<Complex>, every blade belongs to it is working as a B<Blade slot node>. 
 | |
| 
 | |
| A B<Partition> can be created base on the B<Complex>, each B<Partition> can have one or multiple B<Blade slot node>.
 | |
| 
 | |
| The I<noderange> in the B<SYNOPSIS> can be a AMM node or a blade node.
 | |
| 
 | |
| 
 | |
| =head1 OPTIONS
 | |
| 
 | |
| =over 17
 | |
| 
 | |
| =item B<-h | --help>
 | |
| 
 | |
| Display the usage message.
 | |
| 
 | |
| =item B<-v | --version>
 | |
| 
 | |
| Display the version information.
 | |
| 
 | |
| =back
 | |
| 
 | |
| 
 | |
| 
 | |
| =head1 ATTRIBUTES
 | |
| 
 | |
| The meaning of attributes which displayed by the B<lsflexnode>. The word 'node' in this section means B<Blade slot node>.
 | |
| 
 | |
| =over 4
 | |
| 
 | |
| =item B<Complex>  
 | |
| 
 | |
| The unique numeric identifier for a complex installed in the chassis.
 | |
| 
 | |
| =item B<Partition number>
 | |
| 
 | |
| The number of partitions currently defined for this complex.
 | |
| 
 | |
| =item B<Complex node number>
 | |
| 
 | |
| The number of nodes existing in this complex, regardless of their assignment to any given partition.
 | |
| 
 | |
| =item B<Partition>
 | |
| 
 | |
| The unique numeric identifier for a partition defined within a complex installed in the chassis.
 | |
| 
 | |
| =item B<Partition Mode>
 | |
| 
 | |
| The currently configured mode of this partition. It can be 'partition' or 'standalone'.
 | |
| 
 | |
| =item B<Partition node number>
 | |
| 
 | |
| The number of nodes currently defined for this partition.
 | |
| 
 | |
| =item B<Partition status>
 | |
| 
 | |
| The current power status of this partition when the partition has a valid partition configuration. It can be 'poweredoff', 'poweredon', 'resetting' or 'invalid'.
 | |
| 
 | |
| =item B<Node>
 | |
| 
 | |
| The unique numeric identifier for this node, unique within the partition. If this node does not belong to a partition, the slot number will be displayed.
 | |
| 
 | |
| =item B<Node state>
 | |
| 
 | |
| The physical power state of this node. It can be 'poweredoff', 'poweredon' or 'resetting'.
 | |
| 
 | |
| =item B<Node slot>
 | |
| 
 | |
| The base slot number where the node exists in the chassis.
 | |
| 
 | |
| =item B<Node resource>
 | |
| 
 | |
| A string providing a summary overview of the resources provided by this node. It includes the CPU number, CPU frequency and Memory size.
 | |
| 
 | |
| =item B<Node type>
 | |
| 
 | |
| The general categorization of the node. It can be 'processor', 'memory' or 'io'.
 | |
| 
 | |
| =item B<Node role>
 | |
| 
 | |
| Indicates if the node is assigned to a partition, and if so, provides an indication of whether the node is the primary node of the partition or not.
 | |
| 
 | |
| =item B<Flexnode state>
 | |
| 
 | |
| The state of a flexible node. It is the state of the partition which this node belongs to. If this node does NOT belong to a partition, the value should be 'invalid'.
 | |
| 
 | |
| It can be 'poweredoff', 'poweredon', 'resetting' or 'invalid'.
 | |
| 
 | |
| =item B<Complex id>
 | |
| 
 | |
| The identifier of the complex this node belongs to.
 | |
| 
 | |
| =item B<Partition id>
 | |
| 
 | |
| The identifier of the partition this node belongs to.
 | |
| 
 | |
| =back
 | |
| 
 | |
| =head1 EXAMPLES
 | |
| 
 | |
| =over 3
 | |
| 
 | |
| =item 1
 | |
| Display all the B<Complex>, B<Partition> and B<Blade slot node> which managed by a AMM.
 | |
| 
 | |
|  lsflexnode amm1
 | |
| 
 | |
| The output:
 | |
| 
 | |
|     amm1: Complex - 24068
 | |
|     amm1: ..Partition number - 1
 | |
|     amm1: ..Complex node number - 2
 | |
|     amm1: ..Partition = 1
 | |
|     amm1: ....Partition Mode - partition
 | |
|     amm1: ....Partition node number - 1
 | |
|     amm1: ....Partition status - poweredoff
 | |
|     amm1: ....Node - 0 (logic id)
 | |
|     amm1: ......Node state - poweredoff
 | |
|     amm1: ......Node slot - 14
 | |
|     amm1: ......Node type - processor
 | |
|     amm1: ......Node resource - 2 (1866 MHz) / 8 (2 GB)
 | |
|     amm1: ......Node role - secondary
 | |
|     amm1: ..Partition = unassigned
 | |
|     amm1: ....Node - 13 (logic id)
 | |
|     amm1: ......Node state - poweredoff
 | |
|     amm1: ......Node slot - 13
 | |
|     amm1: ......Node type - processor
 | |
|     amm1: ......Node resource - 2 (1866 MHz) / 8 (2 GB)
 | |
|     amm1: ......Node role - unassigned
 | |
| 
 | |
| =item 2
 | |
| Display a flexible node.
 | |
| 
 | |
|  lsflexnode blade1
 | |
| 
 | |
| The output:
 | |
| 
 | |
|     blade1: Flexnode state - poweredoff
 | |
|     blade1: Complex id - 24068
 | |
|     blade1: Partition id - 1
 | |
|     blade1: Slot14: Node state - poweredoff
 | |
|     blade1: Slot14: Node slot - 14
 | |
|     blade1: Slot14: Node type - processor
 | |
|     blade1: Slot14: Node resource - 2 (1866 MHz) / 8 (2 GB)
 | |
|     blade1: Slot14: Node role - secondary
 | |
| 
 | |
| =back
 | |
| 
 | |
| =head1 FILES
 | |
| 
 | |
| /opt/xcat/bin/lsflexnode
 | |
| 
 | |
| =head1 SEE ALSO
 | |
| 
 | |
| L<mkflexnode(1)|mkflexnode.1>, L<rmflexnode(1)|rmflexnode.1>
 |