Cluster Server 7.4.2 Agent for DB2 Installation and Configuration Guide - Linux

Last Published:
Product(s): InfoScale & Storage Foundation (7.4.2)
Platform: Linux
  1. Introducing the Cluster Server Agent for DB2
    1.  
      About the Cluster Server Agent for DB2
    2.  
      How Cluster Server Agent for DB2 makes DB2 highly available
    3.  
      How the DB2 agent supports intelligent resource monitoring
    4.  
      Supported software for VCS agent for DB2
    5. About agent functions for VCS Agent for DB2
      1.  
        About the online agent function for VCS agent for DB2
      2.  
        About the offline agent function for VCS agent for DB2
      3.  
        About the monitor agent function for VCS agent for DB2
      4.  
        About the clean agent function for VCS agent for DB2
      5.  
        About the info agent function for VCS agent for DB2
      6.  
        About the action agent function for VCS agent for DB2
      7. About IMF Integration functions for VCS Agent for DB2
        1.  
          About the imf_init function for VCS agent for DB2
        2.  
          About the imf_register function for VCS agent for DB2
        3.  
          About the imf_getnotification function for VCS agent for DB2
      8.  
        About running the info agent function to get database information for VCS agent for DB2
    6.  
      Typical DB2 configuration in a Cluster Server
    7.  
      Road map for setting up DB2 UDB in a VCS environment
  2. Installing and configuring DB2
    1. VCS requirements for installing DB2
      1.  
        Preparing to install DB2 UDB non-MPP versions
      2.  
        Preparing to install DB2 UDB MPP versions
      3.  
        Creating the file systems for non-MPP instances for DB2
      4.  
        Creating the shared file systems for MPP instances for DB2
      5. Defining user and group accounts for DB2
        1.  
          Creating user group accounts for DB2
        2.  
          Adding user accounts for DB2 on Linux
    2.  
      Installing DB2 in a VCS environment
    3. Setting up the DB2 configuration
      1.  
        Checking /etc/services for DB2
      2.  
        Enabling password less communication for DB2 users among all cluster nodes
      3.  
        Modifying the $DB2InstHome/sqllib/db2nodes.cfg file for DB2
      4.  
        Confirming the DB2 installation
  3. Installing and removing the Cluster Server Agent for DB2
    1.  
      Before you install or upgrade the VCS Agent for DB2
    2.  
      Installing the VCS agent for DB2 software
    3.  
      Upgrading the VCS Agent for DB2
    4.  
      Disabling the VCS Agent for DB2
    5.  
      Removing the VCS Agent for DB2
  4. Configuring VCS service groups for DB2
    1.  
      About configuring service groups for DB2
    2. About DB2 configurations in VCS
      1.  
        Non-MPP configuration service groups for DB2
      2. MPP configuration service groups for DB2
        1.  
          Parallel CVM service group for MPP configuration for DB2
        2.  
          Failover service group for MPP configuration for DB2
    3. Before configuring the service group for DB2
      1.  
        Importing the Db2udbTypes.cf file
    4. Configuring the VCS Agent for DB2 from Cluster Manager (Java Console)
      1.  
        Adding service group for DB2 MPP using the Cluster Manager (Java Console)
      2.  
        Adding a service group for DB2 non-MPP with the Cluster Manager (Java Console)
    5. Configuring the VCS Agent for DB2 by editing the main.cf file
      1.  
        Configuring the agent to use the DB2 MPP configuration
      2.  
        Configuring the agent to use the DB2 non-MPP configurations
      3.  
        Verifying the configuration for VCS agent for DB2
    6. Setting up in-depth monitoring of a DB2 instance
      1.  
        Enabling in-depth monitoring of a DB2 instance
      2.  
        Enabling in-depth monitoring from the command line for DB2
      3. Enabling and disabling intelligent resource monitoring for Db2udb resource
        1.  
          Administering the AMF kernel driver
      4.  
        Handling DB2 error codes during in-depth monitoring
      5.  
        Disabling in-depth monitoring for DB2
  5. Administering VCS service groups for DB2
    1.  
      About administering service groups for DB2
    2.  
      Bringing the DB2 service group online
    3.  
      Taking the DB2 service group offline
    4.  
      Switching the DB2 service group
    5.  
      Disabling the agent for DB2
  6. Appendix A. Troubleshooting Cluster Server Agent for DB2
    1.  
      Creating a db2profile for environment variables for DB2
    2.  
      Setting the RestartLimit attribute for VCS agent for DB2
    3.  
      Partition/Node switch-over scenarios for DB2 in MPP mode
  7. Appendix B. Resource type information for Cluster Server Agent for DB2
    1. About the resource type definitions for DB2
      1.  
        DB2 UDB type definition file: Db2udbTypes.cf on Linux
  8. Appendix C. Resource type attributes for DB2
    1.  
      About the Db2udb resource types and attribute definitions
  9. Appendix D. Sample configurations
    1. Sample configuration files for VCS agent for DB2 on Linux
      1.  
        Non-MPP main.cf configuration for VCS agent for DB2 on Linux
      2.  
        MPP main.cf configuration for VCS agent for DB2 on Linux

MPP main.cf configuration for VCS agent for DB2 on Linux

The following configuration file reflects DB2 UDB in an ESE multi-partition instance MPP environment. Four database partitions are shown. One partition is configured on each cluster node. Each database service group depends on the same CVM service group, which manages the shared storage in the cluster.

include "types.cf"
include "CFSTypes.cf"
include "CVMTypes.cf"
include "Db2udbTypes.cf"

cluster db2_mpp (
    CounterInterval = 5
    )

system vcstc1 (
    )

system vcstc2 (
    )

system vcstc3 (
    )

system vcstc4 (
    )

group cvm (
    SystemList = { vcstc1 = 0, vcstc2 = 1, vcstc3 = 2, vcstc4 = 3 }
    AutoFailOver = 0
    Parallel = 1
    AutoStartList = { vcstc1, vcstc2, vcstc3, vcstc4 }
    )

    CFSMount db2cfsmnt (
        MountPoint = "/db2_mnt/db2inst1"
        BlockDevice = "/dev/vx/dsk/cdb2dg1/cdb2dg1home"
        )

    CFSfsckd vxfsckd (
        )

    CVMCluster cvm_clus (
        CVMClustName = db2_mpp
        CVMNodeId = { vcstc1 = 0, vcstc2 = 1, vcstc3 = 2, vcstc4 = 3 
        }
        CVMTransport = gab
        CVMTimeout = 200
        )

    CVMVolDg db2dg (
        CVMDiskGroup = cdb2dg1
        CVMVolume = { cdb2dg1home }
        CVMActivation = sw
        )

    CVMVxconfigd cvm_vxconfigd (
        Critical = 0
        CVMVxconfigdArgs = { syslog }
        )

    cvm_clus requires cvm_vxconfigd
    db2cfsmnt requires db2dg

    db2cfsmnt requires vxfsckd
    db2dg requires cvm_clus
    vxfsckd requires cvm_clus
    
    // resource dependency tree
    //
    //          group cvm
    //          {
    //          CFSMount db2cfsmnt
    //                {
    //                CVMVolDg db2dg
    //                      {
    //                      CVMCluster cvm_clus
    //                            {
    //                            CVMVxconfigd cvm_vxconfigd
    //                            }
    //                      }
    //                CFSfsckd vxfsckd
    //                      {
    //                      CVMCluster cvm_clus
    //                            {
    //                            CVMVxconfigd cvm_vxconfigd
    //                            }
    //                      }
    //                }
    //          }

group db2mpp_grp0 (
    SystemList = { vcstc1 = 0, vcstc2 = 1, vcstc3 = 2, vcstc4 = 3 }
    AutoStartList = { vcstc1 }
    AutoStart = 1
    )

    Db2udb db2udb0 (
        DB2InstOwner = db2inst1
        DB2InstHome = "/db2_mnt/db2inst1"
        IndepthMonitor = 1
        DatabaseName = SAMPLE
        NodeNumber = 0
        )

    IP Db2_IP0 (
        Device = eth0
        Address = "10.118.2.144"
        NetMask = "255.255.248.0"
        )

    NIC Db2_NIC0 (
        Device = eth0
        )

    requires group cvm online local firm
    Db2_IP0 requires Db2_NIC0
    db2udb0 requires Db2_IP0

    // resource dependency tree
    //
    //          group db2mpp_grp0
    //          {
    //          Db2udb db2udb0
    //                {
    //                IP Db2_IP0
    //                      {
    //                      NIC Db2_NIC0
    //                      }
    //                }
    //          }

group db2mpp_grp1 (
    SystemList = { vcstc1 = 0, vcstc2 = 1, vcstc3 = 2, vcstc4 = 3 }
    AutoStartList = { vcstc2 }
    AutoStart = 1
    )
    Db2udb db2udb1 (
         DB2InstOwner = db2inst1
         DB2InstHome = "/db2_mnt/db2inst1"
         IndepthMonitor = 1
         DatabaseName = TEST1
         NodeNumber = 1
         )

    IP Db2_IP1 (
         Device = eth0
         Address = "10.118.2.145"
         NetMask = "255.255.248.0"
         )

    NIC Db2_NIC1 (
         Device = eth0
         )

    requires group cvm online local firm
    Db2_IP1 requires Db2_NIC1
    db2udb1 requires Db2_IP1

    // resource dependency tree
    //
    //          group db2mpp_grp1
    //          {
    //          Db2udb db2udb1
    //                {
    //                IP Db2_IP1
    //                      {
    //                      NIC Db2_NIC1
    //                      }
    //                }
    //          }

group db2mpp_grp2 (
     SystemList = { vcstc1 = 0, vcstc2 = 1, vcstc3 = 2, vcstc4 = 3 }
     AutoStartList = { vcstc3 }
     AutoStart = 1
     )

     Db2udb db2udb2 (
         DB2InstOwner = db2inst1
         DB2InstHome = "/db2_mnt/db2inst1"
         IndepthMonitor = 1
         DatabaseName = TEST2
         NodeNumber = 2
         )

     IP Db2_IP2 (
         Device = eth0
         Address = "10.118.2.146"
         NetMask = "255.255.248.0"
         )

     NIC Db2_NIC2 (
         Device = eth0
         )

     requires group cvm online local firm
     Db2_IP2 requires Db2_NIC2
     db2udb2 requires Db2_IP2

     // resource dependency tree
     //
     //          group db2mpp_grp2
     //          {
     //          Db2udb db2udb2
     //                {
     //                IP Db2_IP2
     //                      {
     //                      NIC Db2_NIC2
     //                      }
     //                }
     //          }

group db2mpp_grp3 (
    SystemList = { vcstc1 = 0, vcstc2 = 1, vcstc3 = 2, vcstc4 = 3 }
    AutoStartList = { vcstc4 }
    AutoStart = 1
    )

    Db2udb db2udb3 (

        DB2InstOwner = db2inst1
        DB2InstHome = "/db2_mnt/db2inst1"
        NodeNumber = 3
        )
    IP Db2_IP3 (
        Device = eth0
        Address = "10.118.2.147"
        NetMask = "255.255.248.0"
        )

    NIC Db2_NIC3 (
        Device = eth0
        )

    requires group cvm online local firm
    Db2_IP3 requires Db2_NIC3
    db2udb3 requires Db2_IP3
   
    // resource dependency tree
    //
    //          group db2mpp_grp3
    //          {
    //          Db2udb db2udb3
    //                {
    //                IP Db2_IP3
    //                      {
    //                      NIC Db2_NIC3
    //                      }
    //                }
    //          }