Document revision date: 30 March 2001

## OpenVMS Cluster Systems

Previous | Contents | Index

### 8.3.1 Example

Example 8-4 illustrates the use of CLUSTER_CONFIG.COM on JUPITR to remove satellite EUROPA from the cluster.

Example 8-4 Sample Interactive CLUSTER_CONFIG.COM Session to Remove a Satellite with Local Page and Swap Files

    $ @CLUSTER_CONFIG.COM
                     Cluster Configuration Procedure

        Use CLUSTER_CONFIG.COM to set up or change an OpenVMS Cluster configuration.
        To ensure that you have the required privileges, invoke this procedure
        from the system manager's account.

        Enter ? for help at any prompt.

                1. ADD a node to the cluster.
                2. REMOVE a node from the cluster.
                3. CHANGE a cluster node's characteristics.
                4. CREATE a second system disk for JUPITR.
                5. MAKE a directory structure for a new root on a system disk.
                6. DELETE a root from a system disk.

        Enter choice [1]: 2
        The REMOVE function disables a node as a cluster member.

            o It deletes the node's root directory tree.

            o It removes the node's network information
              from the network database.

        If the node being removed is a voting member, you must adjust
        EXPECTED_VOTES in each remaining cluster member's MODPARAMS.DAT.
        You must then reconfigure the cluster, using the procedure described
        in the OpenVMS Cluster Systems manual.

    What is the node's DECnet node name? EUROPA
    Verifying network database...
    Verifying that SYS10 is EUROPA's root...

        WARNING - EUROPA's page and swap files will not be deleted.
                  They do not reside on $1$DJA11:.

    Deleting directory tree SYS10...
    %DELETE-I-FILDEL, $1$DJA11:<SYS10>SYSCBI.DIR;1 deleted (1 block)
    %DELETE-I-FILDEL, $1$DJA11:<SYS10>SYSERR.DIR;1 deleted (1 block)
       .
       .
       .
    System root SYS10 deleted.
    Updating network database...
    The configuration procedure has completed successfully.

### 8.3.2 Removing a Quorum Disk

To disable a quorum disk on a node or nodes, use the cluster configuration command procedure as described in Table 8-7.

Table 8-7 Preparing to Remove a Quorum Disk Watcher
IF... | THEN...
--- | ---
Other cluster nodes will still be enabled as quorum disk watchers. | Perform the following steps: Log in to the computer that is to be disabled as the quorum disk watcher and run CLUSTER_CONFIG_LAN.COM or CLUSTER_CONFIG.COM. Execute the CHANGE function and select menu item 7 to disable a quorum disk (see Section 8.4). Reboot the node (see Section 8.6.7).
All quorum disk watchers will be disabled. | Perform the following steps: Perform the preceding steps 1 and 2 for all computers with the quorum disk enabled. Reconfigure the cluster according to the instructions in Section 8.6.

## 8.4 Changing Computer Characteristics

As your processing needs change, you may want to add satellites to an existing OpenVMS Cluster, or you may want to change an OpenVMS Cluster that is based on one interconnect (such as the CI or DSSI interconnect, or HSC subsystem) to include several interconnects.

Table 8-8 describes the operations you can accomplish when you select the CHANGE option from the main menu of the cluster configuration command procedure.

Note: All operations except changing a satellite's LAN (Ethernet or FDDI) hardware address must be executed on the computer whose characteristics you want to change.

Table 8-8 CHANGE Options of the Cluster Configuration Procedure
Option | Operation Performed
--- | ---
Enable the local computer as a disk server | Loads the MSCP server by setting, in MODPARAMS.DAT, the value of the MSCP_LOAD parameter to 1 and the MSCP_SERVE_ALL parameter to 1 or 2.
Disable the local computer as a disk server | Sets MSCP_LOAD to 0.
Enable the local computer as a boot server | If you are setting up an OpenVMS Cluster that includes satellites, you must perform this operation once before you attempt to add satellites to the cluster. You thereby enable MOP service for the LAN adapter circuit that the computer uses to service operating system load requests from satellites. When you enable the computer as a boot server, it automatically becomes a disk server (if it is not one already) because it must serve its system disk to satellites.
Disable the local computer as a boot server | Disables DECnet MOP service for the computer's adapter circuit.
Enable the LAN for cluster communications on the local computer | Loads the port driver PEDRIVER by setting the value of the NISCS_LOAD_PEA0 parameter to 1 in MODPARAMS.DAT. Creates the cluster security database file, SYS$SYSTEM:[SYSEXE]CLUSTER_AUTHORIZE.DAT, on the local computer's system disk. Caution: The VAXCLUSTER system parameter must be set to 2 if the NISCS_LOAD_PEA0 parameter is set to 1. This ensures coordinated access to shared resources in the cluster and prevents accidental data corruption.
Disable the LAN for cluster communications on the local computer | Sets NISCS_LOAD_PEA0 to 0.
Enable a quorum disk on the local computer | In MODPARAMS.DAT, sets the DISK_QUORUM system parameter to a device name; sets the value of QDSKVOTES to 1 (default value).
Disable a quorum disk on the local computer | In MODPARAMS.DAT, sets a blank value for the DISK_QUORUM system parameter; sets the value of QDSKVOTES to 1.
Change a satellite's LAN hardware address | Changes a satellite's hardware address if its LAN device needs replacement. Both the permanent and volatile network databases and NETNODE_UPDATE.COM are updated on the local computer. Rule: You must perform this operation on each computer enabled as a boot server for the satellite.
Enable the local computer as a tape server | Loads the TMSCP server by setting, in MODPARAMS.DAT, the value of the TMSCP_LOAD parameter to 1 and the TMSCP_SERVE_ALL parameter to 1 or 2.
Disable the local computer as a tape server | Sets TMSCP_LOAD to zero.
Change the local computer's node allocation class value | Sets a value for the computer's ALLOCLASS parameter in MODPARAMS.DAT.
Change the local computer's tape allocation class value | Sets a value from 1 to 255 for the computer's TAPE_ALLOCLASS parameter in MODPARAMS.DAT. The default value is zero. You must specify a nonzero tape allocation class parameter if this node is locally connected to a dual-ported tape, or if it will be serving any multiple-host tapes (for example, TF nn or HSC connected tapes) to other cluster members. Satellites usually have TAPE_ALLOCLASS set to zero.
Change the local computer's port allocation class value | Sets a value for the computer's ALLOCLASS parameter in MODPARAMS.DAT for all devices attached to it.
Enable MEMORY CHANNEL | Sets MC_SERVICES_P2 to 1 to load the PMDRIVER (PMA0) cluster driver. This system parameter enables MEMORY CHANNEL on the local computer for node-to-node cluster communications.
Disable MEMORY CHANNEL | Sets MC_SERVICES_P2 to 0 so that the PMDRIVER (PMA0) cluster driver is not loaded. The setting of 0 disables MEMORY CHANNEL on the local computer as the node-to-node cluster communications interconnect.

### 8.4.1 Preparation

You usually need to perform a number of steps before using the cluster configuration command procedure to change the configuration of your existing cluster.

Table 8-9 suggests several typical configuration changes and describes the procedures required to make them.

Table 8-9 Tasks Involved in Changing OpenVMS Cluster Configurations
Task | Procedure
--- | ---
Add satellite nodes | Perform these operations on the computer that will be enabled as a cluster boot server: Execute the CHANGE function to enable the first installed computer as a boot server (see Example 8-7). Execute the ADD function to add the satellite (as described in Section 8.2). Reconfigure the cluster according to the postconfiguration instructions in Section 8.6.
Change an existing CI or DSSI cluster to include satellite nodes | To enable cluster communications over the LAN (Ethernet or FDDI) on all computers, and to enable one or more computers as boot servers, proceed as follows: Log in as system manager on each computer, invoke either CLUSTER_CONFIG_LAN.COM or CLUSTER_CONFIG.COM, and execute the CHANGE function to enable LAN communications. Rule: You must perform this operation on all computers. Note: You must establish a cluster group number and password on all system disks in the OpenVMS Cluster before you can successfully add a satellite node using the CHANGE function of the cluster configuration procedure. Execute the CHANGE function to enable one or more computers as boot servers. Reconfigure the cluster according to the postconfiguration instructions in Section 8.6.
Change an existing LAN-based cluster to include CI and DSSI interconnects | Before performing the operations described here, be sure that the computers and HSC subsystems or RF disks you intend to include in your new configuration are correctly installed and checked for proper operation. The method you use to include CI and DSSI interconnects with an existing LAN-based cluster configuration depends on whether your current boot server is capable of being configured as a CI or DSSI computer. Note: The following procedures assume that the system disk containing satellite roots will reside on an HSC disk (for CI configurations) or an RF disk (for DSSI configurations). If the boot server can be configured as a CI or DSSI computer, proceed as follows: Log in as system manager on the boot server and perform an image backup operation to back up the current system disk to a disk on an HSC subsystem or RF storage device. (For more information about backup operations, refer to the OpenVMS System Management Utilities Reference Manual.) Modify the computer's default bootstrap command procedure to boot the computer from the HSC or RF disk, according to the instructions in the appropriate system-specific installation and operations guide. Shut down the cluster. Shut down the satellites first, and then shut down the boot server. Boot the boot server from the newly created system disk on the HSC or RF storage subsystem. Reboot the satellites. If your current boot server cannot be configured as a CI or a DSSI computer, proceed as follows: Shut down the old local area cluster. Shut down the satellites first, and then shut down the boot server. Install the OpenVMS operating system on the new CI computer's HSC system disk or on the new DSSI computer's RF disk, as appropriate. When the installation procedure asks whether you want to enable the LAN for cluster communications, answer YES. When the installation completes, log in as system manager, and configure and start the DECnet for OpenVMS network as described in Chapter 4. Execute the CHANGE function of either CLUSTER_CONFIG_LAN.COM or CLUSTER_CONFIG.COM to enable the computer as a boot server. Log in as system manager on the newly added computer and execute the ADD function of either CLUSTER_CONFIG_LAN.COM or CLUSTER_CONFIG.COM to add the former LAN cluster members (including the former boot server) as satellites. Reconfigure the cluster according to the postconfiguration instructions in Section 8.6.
Convert a standalone computer to an OpenVMS Cluster computer | Execute either CLUSTER_CONFIG_LAN.COM or CLUSTER_CONFIG.COM on a standalone computer to perform either of the following operations: Add the standalone computer with its own system disk to an existing cluster. Set up the standalone computer to form a new cluster if the computer was not set up as a cluster computer during installation of the operating system. Reconfigure the cluster according to the postconfiguration instructions in Section 8.6. See Example 8-11, which illustrates the use of CLUSTER_CONFIG.COM on standalone computer PLUTO to convert PLUTO to a cluster boot server. If your cluster uses DECdtm services, you must create a transaction log for the computer when you have configured it into your cluster. For step-by-step instructions on how to do this, see the chapter on DECdtm services in the OpenVMS System Manager's Manual.
Enable or disable disk-serving or tape-serving functions | After invoking either CLUSTER_CONFIG_LAN.COM or CLUSTER_CONFIG.COM to enable or disable the disk or tape serving functions, run AUTOGEN with the REBOOT option to reboot the local computer (see Section 8.6.1).

Note: When the cluster configuration command procedure sets or changes values in MODPARAMS.DAT, the new values are always appended at the end of the file so that they override earlier values. You may want to edit the file occasionally and delete lines that specify earlier values.

### 8.4.2 Examples

Examples 8_5 through 8-11 show the use of CLUSTER_CONFIG.COM to perform the following operations:

- Enable a computer as a disk server (Example 8-5).
- Change a computer's ALLOCLASS value (Example 8-6).
- Enable a computer as a boot server (Example 8-7).
- Specify a new hardware address for a satellite node that boots from a common system disk (Example 8-8).
- Enable a computer as a tape server (Example 8-9).
- Change a computer's TAPE_ALLOCLASS value (Example 8-10).
- Convert a standalone computer to a cluster boot server (Example 8-11).

Example 8-5 Sample Interactive CLUSTER_CONFIG.COM Session to Enable the Local Computer as a Disk Server

    $ @CLUSTER_CONFIG.COM
                     Cluster Configuration Procedure

        Use CLUSTER_CONFIG.COM to set up or change an OpenVMS Cluster configuration.
        To ensure that you have the required privileges, invoke this procedure
        from the system manager's account.

        Enter ? for help at any prompt.

                1. ADD a node to the cluster.
                2. REMOVE a node from the cluster.
                3. CHANGE a cluster node's characteristics.
                4. CREATE a second system disk for URANUS.
                5. MAKE a directory structure for a new root on a system disk.
                6. DELETE a root from a system disk.

        Enter choice [1]: 3
        CHANGE Menu

           1. Enable URANUS as a disk server.
           2. Disable URANUS as a disk server.
           3. Enable URANUS as a boot server.
           4. Disable URANUS as a boot server.
           5. Enable the LAN for cluster communications on URANUS.
           6. Disable the LAN for cluster communications on URANUS.
           7. Enable a quorum disk on URANUS.
           8. Disable a quorum disk on URANUS.
           9. Change URANUS's satellite's Ethernet or FDDI hardware address.
          10. Enable URANUS as a tape server.
          11. Disable URANUS as a tape server.
          12. Change URANUS's ALLOCLASS value.
          13. Change URANUS's TAPE_ALLOCLASS value.
          14. Change URANUS's shared SCSI port allocation class value.
          15. Enable Memory Channel for cluster communications on Uranus.
          16. Disable Memory Channel for cluster communications on Uranus.

        Enter choice [1]: [Return]
    Will URANUS serve HSC disks [Y]? [Return]
    Enter a value for URANUS's ALLOCLASS parameter: 2
    The configuration procedure has completed successfully.

        URANUS has been enabled as a disk server. MSCP_LOAD has been
        set to 1 in MODPARAMS.DAT. Please run AUTOGEN to reboot URANUS:

               $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT

        If you have changed URANUS's ALLOCLASS value, you must reconfigure the
        cluster, using the procedure described in the OpenVMS Cluster Systems manual.

Example 8-6 Sample Interactive CLUSTER_CONFIG.COM Session to Change the Local Computer's ALLOCLASS Value

    $ @CLUSTER_CONFIG.COM
                     Cluster Configuration Procedure

        Use CLUSTER_CONFIG.COM to set up or change an OpenVMS Cluster configuration.
        To ensure that you have the required privileges, invoke this procedure
        from the system manager's account.

        Enter ? for help at any prompt.

                1. ADD a node to the cluster.
                2. REMOVE a node from the cluster.
                3. CHANGE a cluster node's characteristics.
                4. CREATE a second system disk for URANUS.
                5. MAKE a directory structure for a new root on a system disk.
                6. DELETE a root from a system disk.

        Enter choice [1]: 3
        CHANGE Menu

           1. Enable URANUS as a disk server.
           2. Disable URANUS as a disk server.
           3. Enable URANUS as a boot server.
           4. Disable URANUS as a boot server.
           5. Enable the LAN for cluster communications on URANUS.
           6. Disable the LAN for cluster communications on URANUS.
           7. Enable a quorum disk on URANUS.
           8. Disable a quorum disk on URANUS.
           9. Change URANUS's satellite's Ethernet or FDDI hardware address.
          10. Enable URANUS as a tape server.
          11. Disable URANUS as a tape server.
          12. Change URANUS's ALLOCLASS value.
          13. Change URANUS's TAPE_ALLOCLASS value.
          14. Change URANUS's shared SCSI port allocation class value.
          15. Enable Memory Channel for cluster communications on Uranus.
          16. Disable Memory Channel for cluster communications on Uranus.

        Enter choice [1]: 12
    Enter a value for URANUS's ALLOCLASS parameter [2]: 1
    The configuration procedure has completed successfully

        If you have changed URANUS's ALLOCLASS value, you must reconfigure the
        cluster, using the procedure described in the OpenVMS Cluster Systems manual.

Example 8-7 Sample Interactive CLUSTER_CONFIG.COM Session to Enable the Local Computer as a Boot Server

    $ @CLUSTER_CONFIG.COM
                     Cluster Configuration Procedure

        Use CLUSTER_CONFIG.COM to set up or change an OpenVMS Cluster configuration.
        To ensure that you have the required privileges, invoke this procedure
        from the system manager's account.

        Enter ? for help at any prompt.

                1. ADD a node to the cluster.
                2. REMOVE a node from the cluster.
                3. CHANGE a cluster node's characteristics.
                4. CREATE a second system disk for URANUS.
                5. MAKE a directory structure for a new root on a system disk.
                6. DELETE a root from a system disk.

        Enter choice [1]: 3
        CHANGE Menu

           1. Enable URANUS as a disk server.
           2. Disable URANUS as a disk server.
           3. Enable URANUS as a boot server.
           4. Disable URANUS as a boot server.
           5. Enable the LAN for cluster communications on URANUS.
           6. Disable the LAN for cluster communications on URANUS.
           7. Enable a quorum disk on URANUS.
           8. Disable a quorum disk on URANUS.
           9. Change URANUS's satellite's Ethernet or FDDI hardware address.
          10. Enable URANUS as a tape server.
          11. Disable URANUS as a tape server.
          12. Change URANUS's ALLOCLASS value.
          13. Change URANUS's TAPE_ALLOCLASS value.
          14. Change URANUS's shared SCSI port allocation class value.
          15. Enable Memory Channel for cluster communications on Uranus.
          16. Disable Memory Channel for cluster communications on Uranus.

        Enter choice [1]: 3
    Verifying circuits in network database...
    Updating permanent network database...

        In order to enable or disable DECnet MOP service in the volatile
        network database, DECnet traffic must be interrupted temporarily.

        Do you want to proceed [Y]? [Return]
    Enter a value for URANUS's ALLOCLASS parameter [1]: [Return]
    The configuration procedure has completed successfully.

        URANUS has been enabled as a boot server. Disk serving and
        Ethernet capabilities are enabled automatically. If URANUS was
        not previously set up as a disk server, please run AUTOGEN to
        reboot URANUS:

               $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT

        If you have changed URANUS's ALLOCLASS value, you must reconfigure the
        cluster, using the procedure described in the OpenVMS Cluster Systems
    manual.

Example 8-8 Sample Interactive CLUSTER_CONFIG.COM Session to Change a Satellite's Hardware Address

    $ @CLUSTER_CONFIG.COM
                     Cluster Configuration Procedure

        Use CLUSTER_CONFIG.COM to set up or change an OpenVMS Cluster configuration.
        To ensure that you have the required privileges, invoke this procedure
        from the system manager's account.

        Enter ? for help at any prompt.

                1. ADD a node to the cluster.
                2. REMOVE a node from the cluster.
                3. CHANGE a cluster node's characteristics.
                4. CREATE a second system disk for URANUS.
                5. MAKE a directory structure for a new root on a system disk.
                6. DELETE a root from a system disk.

        Enter choice [1]: 3
        CHANGE Menu

           1. Enable URANUS as a disk server.
           2. Disable URANUS as a disk server.
           3. Enable URANUS as a boot server.
           4. Disable URANUS as a boot server.
           5. Enable the LAN for cluster communications on URANUS.
           6. Disable the LAN for cluster communications on URANUS.
           7. Enable a quorum disk on URANUS.
           8. Disable a quorum disk on URANUS.
           9. Change URANUS's satellite's Ethernet or FDDI hardware address.
          10. Enable URANUS as a tape server.
          11. Disable URANUS as a tape server.
          12. Change URANUS's ALLOCLASS value.
          13. Change URANUS's TAPE_ALLOCLASS value.
          14. Change URANUS's shared SCSI port allocation class value.
          15. Enable Memory Channel for cluster communications on Uranus.
          16. Disable Memory Channel for cluster communications on Uranus.

        Enter choice [1]: 9
    What is the node's DECnet node name? ARIEL
    What is the new hardware address [XX-XX-XX-XX-XX-XX]? 08-00-3B-05-37-78
    Updating network database...
    The configuration procedure has completed successfully.

Example 8-9 Sample Interactive CLUSTER_CONFIG.COM Session to Enable the Local Computer as a Tape Server

    $ @CLUSTER_CONFIG.COM
                     Cluster Configuration Procedure

        Use CLUSTER_CONFIG.COM to set up or change an OpenVMS Cluster configuration.
        To ensure that you have the required privileges, invoke this procedure
        from the system manager's account.

        Enter ? for help at any prompt.

                1. ADD a node to the cluster.
                2. REMOVE a node from the cluster.
                3. CHANGE a cluster node's characteristics.
                4. CREATE a second system disk for URANUS.
                5. MAKE a directory structure for a new root on a system disk.
                6. DELETE a root from a system disk.

        Enter choice [1]: 3
        CHANGE Menu

           1. Enable URANUS as a disk server.
           2. Disable URANUS as a disk server.
           3. Enable URANUS as a boot server.
           4. Disable URANUS as a boot server.
           5. Enable the LAN for cluster communications on URANUS.
           6. Disable the LAN for cluster communications on URANUS.
           7. Enable a quorum disk on URANUS.
           8. Disable a quorum disk on URANUS.
           9. Change URANUS's satellite's Ethernet or FDDI hardware address.
          10. Enable URANUS as a tape server.
          11. Disable URANUS as a tape server.
          12. Change URANUS's ALLOCLASS value.
          13. Change URANUS's TAPE_ALLOCLASS value.
          14. Change URANUS's shared SCSI port allocation class value.
          15. Enable Memory Channel for cluster communications on Uranus.
          16. Disable Memory Channel for cluster communications on Uranus.

        Enter choice [1]: 10

    Enter a value for URANUS's TAPE_ALLOCLASS parameter [1]: [Return]
        URANUS has been enabled as a tape server. TMSCP_LOAD has been
        set to 1 in MODPARAMS.DAT. Please run AUTOGEN to reboot URANUS:

               $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT

        If you have changed URANUS's TAPE_ALLOCLASS value, you must reconfigure
        the cluster, using the procedure described in the OpenVMS Cluster Systems
        manual.

Example 8-10 Sample Interactive CLUSTER_CONFIG.COM Session to Change the Local Computer's TAPE_ALLOCLASS Value

    $ @CLUSTER_CONFIG.COM
                     Cluster Configuration Procedure

        Use CLUSTER_CONFIG.COM to set up or change an OpenVMS Cluster configuration.
        To ensure that you have the required privileges, invoke this procedure
        from the system manager's account.

        Enter ? for help at any prompt.

                1. ADD a node to the cluster.
                2. REMOVE a node from the cluster.
                3. CHANGE a cluster node's characteristics.
                4. CREATE a second system disk for URANUS.
                5. MAKE a directory structure for a new root on a system disk.
                6. DELETE a root from a system disk.

        Enter choice [1]: 3
        CHANGE Menu

           1. Enable URANUS as a disk server.
           2. Disable URANUS as a disk server.
           3. Enable URANUS as a boot server.
           4. Disable URANUS as a boot server.
           5. Enable the LAN for cluster communications on URANUS.
           6. Disable the LAN for cluster communications on URANUS.
           7. Enable a quorum disk on URANUS.
           8. Disable a quorum disk on URANUS.
           9. Change URANUS's satellite's Ethernet or FDDI hardware address.
          10. Enable URANUS as a tape server.
          11. Disable URANUS as a tape server.
          12. Change URANUS's ALLOCLASS value.
          13. Change URANUS's TAPE_ALLOCLASS value.
          14. Change URANUS's shared SCSI port allocation class value.
          15. Enable Memory Channel for cluster communications on Uranus.
          16. Disable Memory Channel for cluster communications on Uranus.

        Enter choice [1]: 13

    Enter a value for URANUS's TAPE_ALLOCLASS parameter [1]: 2

        If you have changed URANUS's TAPE_ALLOCLASS value, you must reconfigure
        the cluster, using the procedure described in the OpenVMS Cluster Systems
        manual.)

Previous | Next | Contents | Index

| privacy and legal statement |
4477PRO_015.HTML