wrsmconf - manage WCI RSM controller configurations


     /usr/platform/sun4u/sbin/wrsmconf create -c controller_id -f

     wrsmconf initial -f config_file [ -c controller_id]

     wrsmconf remove [ -c controller_id]

     wrsmconf topology [ -c controller_id]

     wrsmconf dump -c controller_id -f config_file


     wrsmconf provides a means to create, install, retrieve,  and
     remove  configurations  for  WCI  remote shared memory (RSM)


     The following options are supported:

     create -c controller_id -f config_file
           Create a set of per-node configurations for the speci-
           fied   controller   and   store   them   to  the  file
           config_file. The created file contains a per-node con-
           figuration  for  each  node specified in the input for
           the specified controller. The file has a  checksum  on
           it  and  cannot be modified directly. This file can be
           used in a  wrsmconf  initial  call  on  each  node  to
           install   the  node's  configuration  into  the  local

           A list of nodes and WCI  devices  connected  to  those
           nodes  is read from standard input. For each connected
           pair of links, specify the nodename (uname -n), safari
           port  id, and link number on both sides of the connec-
           tion. The format of the information looks like this:


           This interface is intended for  installing  configura-
           tions  for  testing (such as for SunVTS). Only direct-
           connect, non-striped configurations for 1 to  3  nodes
           can  be  specified.  FM  node  ids  and  RSM  hardware
           addresses are assigned to the specified nodes contigu-
           ously and in order starting from 0.

     initial -f config_file [-c controller_id]
           Install the configuration for the local node stored in
           the  file  config_file  into the driver as the initial
           configuration for the specified controller. This  com-
           mand fails under the following circumstances:

              o  If controller_id is specified and the configura-
                 tion  in  the file is not for the specified con-

              o  If the file does not contain a valid  configura-
                 tion  for  the  local node or if the checksum in
                 the file shows it has been modified.

              o  If a configuration has  already  been  installed
                 for   the   controller.  If  this  happens,  use
                 wrsmconf remove to remove  the  existing  confi-

     remove [ -c controller_id ]
           Disable communication through the installed configura-
           tion  for  all controllers or the specified controller
           and remove the configuration(s) from the driver.

     topology -c controller_id
           For each installed controller (or  for  the  specified
           controller),  print  to  stdout  the set of nodes this
           controller  is  configured  to  reach,  including  the
           nodename,  FM  node  id,  and RSM hardware address for
           each node. The following is example output:

           FM Node ID   Node Name  Controller Instance    Controller HW Addr
           0            hpc00              0                    101
           0            hpc00              1                    333
           1            hpc01              0                    102
           1            hpc01              1                    54
           1            hpc01              2                    34
           2            hpc03              0                    103
           2            hpc03              1                    103
           2            hpc03              2                    103

     dump -c controller-id -f config_file
           Fetch the installed configuration  for  the  specified
           controller  from the driver and store it into the file
           config_file along with a checksum to protect the data.
           This  configuration  can  later  be installed with the
           command wrsmconf initial.


     This command returns 0 on successful completion, and a  non-
     zero value if an error occured.


     See attributes(5) for descriptions of the  following  attri-

    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    | Availability                | SUNWwrsm                    |


     kstat(1M), wrsmstat(1M), attributes(5)

Man(1) output converted with man2html