=head1 NAME

B<rscan> - Collects node information from one or more hardware control points.

=head1 SYNOPSIS

I<rscan [-h|--help]>

I<rscan [-v|--version]>

I<rscan [-V|--verbose] noderange [-u][-w][-x|-z]>


=head1 DESCRIPTION

The rscan command lists hardware information for each node managed by the hardware control points specified in noderange.

For the management module of blade, if the blade server is an IBM Flex System Compute Node (compute node for short), the fsp belongs to the blade server also will be scanned.

Note: The first line of the output always contains information about the hardware control point. When using the rscan command to generate output for HMC or IVM hardware control points, it provides the FSPs and BPAs as part of the output. The only exception is the rscan -u flag which provides updates made hardware control point in the xCAT database. 

=head1 OPTIONS



B<-h>          Display usage message.

B<-v>          Command Version.

B<-V>          Verbose output.

B<-u>          Updates and then prints out node definitions in the xCAT database for CEC/BPA. It updates the existing nodes that contain the same mtms and serial number for nodes managed by the specified hardware control point. This primarily works with CEC/FSP and frame/BPA nodes when the node name is not the same as the managed system name on hardware control point (HMC), This flag will update the BPA/FSP node name definitions to be listed as the managed system name in the xCAT database.  

The Compute Node object of xCAT will be updated if the mpa and slot id are matched to the object which has been defined in the xCAT database.

Note: only the matched object will be updated.

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 nodes managed by HMC hmc01 in tabular format, enter:

I<rscan hmc01>


Output is similar to:

  type    name                       id   type-model  serial-number  address

  hmc     hmc01                           7310-C05    10F426A        hmc01
  fsp     Server-9117-MMA-SN10F6F3D       9117-MMA    10F6F3D        3.3.3.197
  lpar    lpar3                       4   9117-MMA    10F6F3D
  lpar    lpar2                       3   9117-MMA    10F6F3D
  lpar    lpar1                       2   9117-MMA    10F6F3D
  lpar    p6vios                      1   9117-MMA    10F6F3D


2. To list all nodes managed by IVM ivm02 in XML format and write the output to the xCAT database, enter:

I<rscan ivm02 -x -w>

Output is similar to:

 <Node>
   <cons></cons>
   <profile></profile>
   <parent></parent>
   <serial>10B7D1G</serial>
   <model>9133-55A</model>
   <node>Server-9133-55A-10B7D1G</node>
   <mgt>ivm</mgt>
   <nodetype>fsp</nodetype>
   <hcp>ivm02</hcp>
   <groups>fsp,all</groups>
   <id>10</id>
 </Node>

 <Node>
   <cons>ivm</cons>
   <profile>lpar01</profile>
   <parent>Server-9133-55A-10B7D1G</parent>
   <serial></serial>
   <model></model>
   <node>lpar01</node>
   <mgt>ivm</mgt>
   <nodetype>lpar,osi</nodetype>
   <hcp>ivm02</hcp>
   <groups>lpar,all</groups>
   <id>1</id>
 <Node>

 </Node>
   <cons>ivm</cons>
   <profile>lpar02</profile>
   <parent>Server-9133-55A-10B7D1G</parent>
   <serial></serial>
   <model></model>
   <node>lpar02</node>
   <mgt>ivm</mgt>
   <nodetype>lpar,osi</nodetype>
   <hcp>ivm02</hcp>
   <groups>lpar,all</groups>
   <id>2</id>
 </Node>


3. To list all nodes managed by HMC hmc02 in stanza format and write the output to the xCAT database, enter:

I<rscan hmc02 -z -w>

Output is similar to:

  Server-9458-100992001Y_B:
    objtype=node
    nodetype=bpa
    id=2
    model=9458-100
    serial=992001Y
    hcp=hmc02
    profile=
    parent=
    groups=bpa,all
    mgt=hmc
    cons=

  Server-9119-590-SN02C5F9E:
    objtype=node
    type=fsp
    id=10
    model=9119-590
    serial=02C5F9E
    hcp=hmc02
    profile=
    parent=Server-9458-100992001Y_B
    groups=fsp,all
    mgt=hmc
    cons=

  lpar01:
    objtype=node
    nodetype=lpar,osi
    id=1
    model=
    serial=
    hcp=hmc02
    profile=lpar01
    parent=Server-9119-590-SN02C5F9E
    groups=lpar,all
    mgt=hmc
    cons=hmc

  lpar02:
    objtype=node
    nodetype=lpar,osi
    id=2
    model=
    serial=
    hcp=hmc02
    profile=lpar02
    parent=Server-9119-590-SN02C5F9E
    groups=lpar,all
    mgt=hmc
    cons=hmc

4. To update definitions of nodes, which is managed by hmc03, enter:

I<rscan hmc03 -u>

Output is similar to:

  #Updated following nodes:
  type    name                           id      type-model  serial-number  address
  fsp     Server-9125-F2A-SN0262672-B    3       9125-F2A    0262672        192.168.200.243

5. To collects the node information from one or more hardware control points on zVM AND populate the database with details collected by rscan:

I<rscan gpok2 -W>

Output is similar to:

  gpok2:
    objtype=node
    arch=s390x
    os=sles10sp3
    hcp=gpok3.endicott.ibm.com
    userid=LINUX2
    nodetype=vm
    parent=POKDEV61
    groups=all
    mgt=zvm

6. To scan the Compute Node:

I<rscan cmm01>

Output is similar to:

  type    name                  id      type-model  serial-number  mpa        address
  cmm     AMM680520153          0       789392X     100048A        cmm01      cmm01
  blade   SN#YL10JH184067       1       789542X     10F752A        cmm01      12.0.0.9
  blade   SN#YL10JH184079       3       789542X     10F697A        cmm01      12.0.0.11

7. To update the Compute Node:

I<rscan cmm01 -u>

Output is similar to:

  cmm    [AMM680520153]         Matched To =>[cmm01]
  blade  [SN#YL10JH184067]      Matched To =>[cmm01node01]
  blade  [SN#YL10JH184079]      Matched To =>[cmm01node03]

=head1 FILES

/opt/xcat/bin/rscan


=head1 SEE ALSO

L<lsslp(1)|lsslp.1>