wrsmconf(1M) System Administration Commands wrsmconf(1M)NAMEwrsmconf - manage WCI RSM controller configurations
SYNOPSIS
/usr/platform/sun4u/sbin/wrsmconf create -c controller_id -f con‐
fig_file
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
DESCRIPTIONwrsmconf provides a means to create, install, retrieve, and remove con‐
figurations for WCI remote shared memory (RSM) controllers.
OPTIONS
The following options are supported:
create -c controller_id -f config_file
Create a set of per-node configurations for the specified con‐
troller and store them to the file config_file. The created file
contains a per-node configuration 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 wrsm‐
conf initial call on each node to install the node's configuration
into the local driver.
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 connection. The format of the information looks like this:
<nodename>.<wrsm-portid>.<linkno>=<nodename>.<wrsm-portid>.<linkno>
<nodename>.<wrsm-portid>.<linkno>=<nodename>.<wrsm-portid>.<linkno>
This interface is intended for installing configurations for test‐
ing (such as for SunVTS). Only direct-connect, non-striped configu‐
rations for 1 to 3 nodes can be specified. FM node ids and RSM
hardware addresses are assigned to the specified nodes contiguously
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 command fails under the following cir‐
cumstances:
· If controller_id is specified and the configuration in the
file is not for the specified controller.
· If the file does not contain a valid configuration for the
local node or if the checksum in the file shows it has been
modified.
· If a configuration has already been installed for the con‐
troller. If this happens, use wrsmconf remove to remove the
existing configuration.
remove [ -c controller_id ]
Disable communication through the installed configuration for all
controllers or the specified controller and remove the configura‐
tion(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.
EXIT STATUS
This command returns 0 on successful completion, and a non-zero value
if an error occured.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWwrsm │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOkstat(1M), wrsmstat(1M), attributes(5)SunOS 5.10 25 Jun 2003 wrsmconf(1M)