Sun Cluster 2.2 System Administration Guide

6.2.1 How to Set Up PNM

These are the high-level steps to set up PNM:

These are the detailed steps to set up PNM.

  1. Set up the node hardware so that you have multiple network adapters on a single node using the same subnet.

    Refer to your Sun Cluster node hardware documentation to set up your network adapters.

  2. If the Sun Cluster node software packages have not been installed already, install them by using the scinstall(1M) command.

    The scinstall(1M) command runs interactively to install the package set you select. The PNM package, SUNWpnm, is part of the node package set. See the Sun Cluster 2.2 Software Installation Guide for the detailed cluster installation procedure.

  3. Register the default network interface on each node, if you did not do so already.

    You must register one default network interface per node in the interface database associated with each node, and verify that the interface is plumbed and functioning correctly.

    1. Create an interface database on each node and register the primary public network interfaces.

      Create a file in the /etc directory on each node to use as the interface database. Name the file hostname.interface, where hostname is the name of the primary physical host. Then add one line containing the interface name for that node. For example, on node phys-hahost1 with a default interface qfe-1, create a file /etc/phys-hahost1.qfe1 containing the following line.

      phys-hahost1-qfe1
    2. In the /etc/hosts file on each node, associate the primary public network interface name with an IP address.

      In this example, the primary physical host name is phys-hahost1:

      129.146.75.200 phys-hahost1-qfe1

      If your system uses a naming mechanism other than /etc/hosts, refer to the appropriate section in the TCP/IP and Data Communications Administration Guide to perform the equivalent function.

  4. Establish PNM backup groups by using the pnmset(1M) command.

    Run the pnmset(1M) interactive script to set up backup groups.


    Caution - Caution -

    If you have configured logical hosts and data services already, you must stop the HA data services before changing the backup group membership with pnmset(1M). If you do not stop the data services before running the pnmset(1M) command, serious problems and data service failures can result.


    1. Run the pnmset(1M) command.

      phys-hahost1# /opt/SUNWpnm/bin/pnmset
      
    2. Enter the total number of backup groups you want to configure.

      Normally this number corresponds with the number of public subnets.

      In the following dialog, you will be prompted to configure public 
      network management.
      
       do you want to continue ... [y/n]: y
      
       How many NAFO backup groups on the host [1]: 2
      
    3. Assign backup group numbers.

      At the prompt, supply an integer between 0 and the maximum of 255. The pnmset(1M) command appends this number to the string nafo to form the backup group name.

      Enter backup group number [0]: 0
      
    4. Assign adapters to backup groups.

      Please enter all network adapters under nafo0:
       qe0 qe1
      ...

      Continue by assigning backup group numbers and adapters for all other backup groups in the configuration.

    5. Allow the pnmset(1M) command to test your adapter configuration.

      The pnmset(1M) command tests the correctness of your adapter configuration. In this example, the backup group contains one active adapter and two redundant adapters.

      The following test will evaluate the correctness of the customer 
      NAFO configuration...
       name duplication test passed
      
      
       Check nafo0... < 20 seconds
       qe0 is active
       remote address = 192.168.142.1
       nafo0 test passed
      
      
       Check nafo1... < 20 seconds
       qe3 is active
       remote address = 192.168.143.1
       test qe4 wait...
       test qe2 wait...
       nafo1 test passed
       phys-hahost1#

      Once the configuration is verified, the PNM daemon pnmd(1M) automatically notes the configuration changes and starts monitoring the interfaces.


      Note -

      Only one adapter within a backup group should be plumbed and have an entry in the /etc/hostname.adapter file. Do not assign IP addresses to the backup adapters; they should not be plumbed.



      Note -

      PNM uses broadcast ping(1M) to monitor networks, which in turn uses broadcast ICMP (Internet Control Message Protocol) packets to communicate with other remote hosts. Some routers do not forward broadcast ICMP packets; consequently, PNM's fault detection behavior is affected. See the Sun Cluster 2.2 Release Notes for a workaround to this problem.


  5. Start the cluster by using the scadmin(1M) command.

    Run the following command on one node:

    # scadmin startcluster physical-hostname sc-cluster
    

    Then add all other nodes to the cluster by running the following command from all other nodes:

    # scadmin startnode
    
  6. Verify the PNM configuration by using the pnmstat(1M) command.

    phys-hahost1# /opt/SUNWpnm/bin/pnmstat -l
    bkggrp  r_adp   status  fo_time live_adp
     nafo0   hme0    OK      NEVER   hme0
     phys-hahost1# 

    You have now completed the initial setup of PNM.