There are several CONFIGURATION subcommands. Select the one you
want from the choices below.
1 – SET
1.1 – CLUSTER_AUTHORIZATION
Modifies security data in a local area cluster.
Requires SYSPRV privilege.
Format
CONFIGURATION SET CLUSTER_AUTHORIZATION
1.1.1 – Qualifiers
1.1.1.1 /GROUP_NUMBER
/GROUP_NUMBER=[n]
Specifies the cluster group number that is recorded in
SYS$SYSTEM:CLUSTER_AUTHORIZE.DAT. A group number uniquely
identifies each local area cluster on a single Ethernet. This
number must be in the range from 1 to 4095 or 61440 to 65535.
1.1.1.2 /PASSWORD
/PASSWORD=password
Specifies a password for cluster access. A password consists of
1 to 31 characters, including alphanumeric characters, dollar
signs, and underscores. A password provides a second level of
validation to ensure the integrity of individual clusters on the
same Ethernet that accidentally use identical group numbers. A
password also prevents an intruder who discovers the group number
from joining the cluster.
1.1.2 – Description
The CONFIGURATION SET CLUSTER_AUTHORIZATION command modifies the
group number and password of a local area cluster, as recorded
in SYS$SYSTEM:CLUSTER_AUTHORIZE.DAT. If your configuration has
multiple system disks, SYSMAN automatically updates each copy
of CLUSTER_AUTHORIZE.DAT, provided the environment is defined as
a cluster (SET ENVIRONMENT/CLUSTER). For more information about
CLUSTER_AUTHORIZE.DAT, see VSI OpenVMS Cluster Systems.
CAUTION
If you change either the group number or the password, you
must reboot the entire cluster.
The file CLUSTER_AUTHORIZE.DAT is initialized during execution
of CLUSTER_CONFIG.COM and maintained through SYSMAN. Under
normal conditions, altering records in the CLUSTER_AUTHORIZE.DAT
file interactively is not necessary. To protect the integrity
of the cluster membership use the CONFIGURATION SET CLUSTER_
AUTHORIZATION command.
1.1.3 – Example
SYSMAN> SET ENVIRONMENT/CLUSTER/NODE=NODE21
SYSMAN> SET PROFILE /PRIVILEGES=SYSPRV
SYSMAN> CONFIGURATION SET CLUSTER_AUTHORIZATION/PASSWORD=GILLIAN
%SYSMAN-I-CAFOLDGROUP, existing group will not be changed
%SYSMAN-I-GRPNOCHG, Group number not changed
SYSMAN-I-CAFREBOOT, cluster authorization file updated.
The entire cluster should be rebooted.
The CONFIGURATION SET CLUSTER_AUTHORIZATION command in this
example sequence modifies the cluster password. Note that
the environment is defined to be a cluster, and the SYSPRV
privilege is established before entering the CONFIGURATION SET
CLUSTER_AUTHORIZATION command.
1.2 – TIME
Modifies the current system time.
Requires OPER, LOG_IO, and SYSPRV privileges, and, in a cluster
environment, SYSLCK privilege.
Format
CONFIGURATION SET TIME [time]
1.2.1 – Description
The CONFIGURATION SET TIME command enables you to reset the
system time. Specify a time value using the following format:
[dd-mmm-yyyy[:]] [hh:mm:ss.cc]
You can also enter a delta time value. For more information about
time formats, see the OpenVMS User's Manual.
In an environment of individual nodes, SYSMAN sets the time to
the specified value on each node. Without a time specification,
SYSMAN sets the time according to the time-of-year clock on each
node.
In an OpenVMS Cluster environment, SYSMAN sets the time to the
specified value on each node. If you do not specify a value,
SYSMAN uses the time-of-year clock. In a local cluster, SYSMAN
reads the clock on the node from which you are executing SYSMAN
and assigns this value to all nodes in the cluster. In a remote
OpenVMS Cluster, SYSMAN reads the clock on the target node in
the cluster and assigns that value to all nodes. Note that the
time-of-year clock is optional for some processors; for more
information, see your processor handbook.
SYSMAN uses special processing in an OpenVMS Cluster environment
to ensure that all processors in the cluster are set to the same
time. Because of communication and processing delays, it is not
possible to synchronize clocks exactly. However, the variation
is typically less than a few hundredths of a second. If SYSMAN
cannot set the time to within one half second of the specified
time, you receive a warning message that names the node that
failed to respond quickly enough.
As a result of slight inaccuracies in each processor clock,
times on various members of a cluster tend to drift apart.
The following procedure synchronizes system times in a cluster
environment:
$ SYNCH_CLOCKS:
$ RUN SYS$SYSTEM:SYSMAN
SET ENVIRONMENT/CLUSTER
CONFIGURATION SET TIME
EXIT
$ WAIT 6:00:00
$ GOTO SYNCH_CLOCKS
The procedure sets the time on all cluster nodes to the value
obtained from the local time-of-year clock, waits 6 hours, then
resets the time for the cluster.
1.2.2 – Example
SYSMAN> SET ENVIRONMENT/NODE=(NODE21,NODE22,NODE23)
SYSMAN> SET PROFILE /PRIVILEGE=LOG_IO
SYSMAN> CONFIGURATION SET TIME 12:38:00
The CONFIGURATION SET TIME command in this example sequence
modifies the system time on NODE21, NODE22, and NODE23.
2 – SHOW
2.1 – CLUSTER_AUTHORIZATION
Displays the group number and multicast address of a local area
cluster.
Requires SYSPRV privilege.
Format
CONFIGURATION SHOW CLUSTER_AUTHORIZATION
2.1.1 – Qualifier
2.1.1.1 /OUTPUT
/OUTPUT[=filespec]
Redirects output from SYS$OUTPUT to the specified file. If no
file specification is provided, SYSMAN writes the output to
SYSMAN.LIS in the current directory.
2.1.2 – Description
The CONFIGURATION SHOW CLUSTER_AUTHORIZATION command displays
the group number and multicast address, and Ethernet address
used to send a message to all nodes in the cluster. The group
number and multicast address are recorded in SYS$SYSTEM:CLUSTER_
AUTHORIZE.DAT during the CLUSTER_CONFIG dialog.
In a cluster or multinode environment, SYSMAN displays the group
number of the first node and then displays the names of any
nodes in the cluster whose group numbers, passwords, or both,
are different.
2.1.3 – Example
SYSMAN> SET ENVIRONMENT/CLUSTER/NODE=NODE21
.
.
.
SYSMAN> SET PROFILE /PRIVILEGE=SYSPRV
SYSMAN> CONFIGURATION SHOW CLUSTER_AUTHORIZATION
Node NODE23: Cluster group number 65240
Multicast address: AB-00-04-01-F2-FF
The CONFIGURATION SHOW CLUSTER_AUTHORIZATION command in this
example displays the group number and multicast address of
NODE21. Because the group number and password on other nodes in
the cluster are identical, no further information is displayed.
2.2 – TIME
Displays the current date and system time to the nearest
hundredth of a second.
Format
CONFIGURATION SHOW TIME
2.2.1 – Qualifier
2.2.1.1 /OUTPUT
/OUTPUT[=filespec]
Redirects output from SYS$OUTPUT to the specified file. If no
file specification is provided, SYSMAN writes the output to
SYSMAN.LIS in the current directory.
2.2.2 – Example
SYSMAN> SET ENVIRONMENT/CLUSTER/NODE=NODE21
.
.
.
SYSMAN> CONFIGURATION SHOW TIME
System time on node NODE21: 19-JUN-2002 13:32:19.45
System time on node NODE22: 19-JUN-2002 13:32:27.79
System time on node NODE23: 19-JUN-2002 13:32:58.66
The CONFIGURATION SHOW TIME command in this example displays
the system times for all nodes in the cluster.