xcat-core/xCAT-client/pods/man1/lsflexnode.1.pod
daniceexi f6071c9f1e Code drop of HX5 support
git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@6147 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
2010-05-17 11:52:18 +00:00

185 lines
4.8 KiB
Plaintext

=head1 B<NAME>
B<lsflexnode> - Display the information of flexible node
=head1 B<SYNOPSIS>
B<lsflexnode> [-h | --help]
B<lsflexnode> [-v | --version]
B<lsflexnode> I<noderange>
=head1 B<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<Parition>: 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 B<OPTIONS>
=over 4
=item B<-h | --help>
Display the usage message.
=item B<-v | --version>
Display the version information.
=back
=head1 B<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.
=head1 B<EXAMPLES>
=over 3
=item 1
Display all the B<Complex>, B<Partition> and B<Blade slot node> which managed by a AMM.
B<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.
B<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 B<FILES>
/opt/xcat/bin/lsflexnode
=head1 SEE ALSO
L<mkflexnode>, L<rmflexnode>