xcat-core/xCAT-client/pods/man1/lshwconn.1.pod

114 lines
2.1 KiB
Plaintext

=head1 NAME
B<lshwconn> - Use this command to display the connection status for CEC, Frame and Firebird nodes.
=head1 SYNOPSIS
B<lshwconn> [B<-h>| B<--help>]
B<lshwconn> [B<-v>| B<--version>]
=head2 PPC (with HMC) specific:
B<lshwconn> [B<-V>| B<--verbose>] I<noderange>
=head2 PPC (without HMC, using FSPAPI) specific:
B<lshwconn> I<noderange> B<-T> I<tooltype>
=head1 DESCRIPTION
This command is used to display the connection status for CEC, Frame and Firebird nodes.
=head1 OPTIONS
=over 5
=item B<-h|--help>
Display usage message.
=item B<-V|--verbose>
Verbose output.
=item B<-T>
The tooltype is used to communicate to the CEC/Frame/Firebird. The value could be lpar or fnm. The tooltype value lpar is for xCAT and fnm is for CNM.
=back
=head1 RETURN VALUE
0 The command completed successfully.
1 An error has occurred.
=head1 EXAMPLES
=over 3
=item 1.
To display connection status for all CEC nodes in node group CEC:
lshwconn cec
Output is similar to:
cec1: ipaddr=192.168.200.245,alt_ipaddr=unavailable,state=Connected
cec2: Connection not found
=item 2.
To display connection status for Frame node frame1:
lshwconn frame1
Output is similar to:
frame1: side=a,ipaddr=192.168.200.247,alt_ipaddr=unavailable,state=Connected
frame1: side=b,ipaddr=192.168.200.248,alt_ipaddr=unavailable,state=Connected
=item 3.
To display connection status for all CEC nodes in node group CEC to hardware server, and using lpar tooltype:
lshwconn cec -T lpar
Output is similar to:
cec1: sp=primary,ipadd=40.3.7.1,alt_ipadd=unavailable,state=LINE UP
cec2: Connection not found
=item 4.
To display connection status for Fireblades to hardware server:
lshwconn blade
Output is similar to:
blade01: sp=primary,ipadd=70.0.0.21,alt_ipadd=unavailable,state=LINE UP
blade02: sp=primary,ipadd=70.0.0.22,alt_ipadd=unavailable,state=LINE UP
=back
=head1 FILES
$XCATROOT/bin/lshwconn
(The XCATROOT environment variable is set when xCAT is installed. The
default value is "/opt/xcat".)
=head1 NOTES
This command is part of the xCAT software product.
=head1 SEE ALSO
L<rmhwconn(1)|rmhwconn.1>, L<mkhwconn(1)|mkhwconn.1>