InfoScale™ 9.0 Cluster Server Agent for DB2 Installation and Configuration Guide - Linux

Last Published:
Product(s): InfoScale & Storage Foundation (9.0)
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

Modifying the $DB2InstHome/sqllib/db2nodes.cfg file for DB2

DB2 uses the $DB2InstHome/sqllib/db2nodes.cfg file during failover from one node to another.

To modify the $DB2InstHome/sqllib/db2nodes.cfg file for non-MPP versions

  1. Open the $DB2InstHome/sqllib/db2nodes.cfg file.
  2. Add an entry for database partition.
  3. For IPv4, assign the virtual IP address as the hostname, for example for this step and the previous step:
    0 virtualhostname 0
    1 virtualhostname 1

    Note that the virtualhostname corresponds to the virtual IP address in the /etc/hosts file. Make sure that the virtual IP address is up and works.

  4. For IPv6, DB2 has a limitation that the hostname entries in db2nodes.cfg need to correspond to the hostname of the node. For example, if the hostname is sysA-v6, db2nodes.cfg should contain sysA-v6.

    With VCS, use virtual hostnames. When the service group fails over to another node, the virtual IP address is brought up on the target node. As a workaround for the limitation where the hostname entries in db2nodes.cfg need to correspond to the hostname of the node, you can use something similar to the following configuration.

    On each node, create a /local/$DB2InstHome/db2nodes.cfg file with same permission as that of $DB2InstHome and create a symbolic link to this file from $DB2InstHome/sqllib/db2nodes.cfg.

    # mkdir -p /local/$DB2InstHome/
    # ln -s /local/$DB2InstHome/db2nodes.cfg \
    $DB2InstHome/sqllib/db2nodes.cfg

    The path /local/$DB2InstHome/db2nodes.cfg is local to each system. Enter the IPv6 hostname in the/local/$DB2InstHome/db2nodes.cfg on each node.

    For example, on nodes sysA-v6 and sysB-v6, enter the following in their respective db2nodes.cfg files.

    • On sysA-v6:

      0 sysA-v6 0
    • On sysB-v6:

      0 sysB-v6 0

To modify the $DB2InstHome/sqllib/db2nodes.cfg file for MPP versions

  1. For MPP versions, modify the file $DB2InstHome/sqllib/db2nodes.cfg with the hostname that you want each database partition to start on. DB2 automatically changes and updates the db2nodes.cfg file to enable the database partitions to fail over from one node to another. DB2 adds a fourth column for the "netname". Netname is an IP address of the high speed interconnect for the communication of Fast Communication Manager (FCM). Netname is required only if you are using a high speed interconnect for database partition communications. If the netname is not specified, it is by default the hostname. The virtual IP is not used in the db2nodes.cfg file for MPP configurations when we configure more than one database partition.

    For example when the high speed interconnect (FCM switch) is not used:

    0 sysA 0
    1 sysB 0
    2 sysC 0
    3 sysD 0

    For example when the high speed interconnect (FCM switch) is used for inter-partition communication:

    0 sysA 0 switchA
    1 sysB 0 switchB
    2 sysC 0 switchC
    3 sysD 0 switchD

    Make sure that the relative port number in the third column is unique for each partition on a host. For example when the high speed interconnect (FCM switch) is not used:

    0 sysA 0
    1 sysA 1
    2 sysB 0
    3 sysC 0
    4 sysD 0

    For example when the high speed interconnect (FCM switch) is used for inter-partition communication:

    0 sysA 0 switchA
    1 sysA 1 switchA
    2 sysB 0 switchB
    3 sysC 0 switchC
    4 sysD 0 switchD
  2. If a high speed communication switch/netname is configured for inter partition communication, add entry of the switchname/netname in the db2 global registry using db2greg command before bringing the partitions online using db2start or db2gcf commands. Execute db2greg command, after sourcing the db2profile from DB2 Instance's home directory as mentioned below

    # source /db2_mnt/db2inst1/sqllib/db2profile

    # db2greg -addvarrec variable=switchname, value=$switch

    To verify the entry of switchname is the db2 global registry use the below command

    # db2greg -dump