Modifies security data in a local area cluster.

    Requires SYSPRV privilege.

    Format

      CONFIGURATION SET CLUSTER_AUTHORIZATION

1  –  Qualifiers

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.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.

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.

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.