InfoScale™ 9.0 Cluster Server Agent for Sybase Installation and Configuration Guide - AIX

Last Published:
Product(s): InfoScale & Storage Foundation (9.0)
Platform: AIX
  1. Introducing the Cluster Server agent for Sybase
    1.  
      About the Cluster Server agent for Sybase
    2.  
      Supported software for the VCS agent for Sybase
    3.  
      How the agent makes Sybase highly available
    4.  
      How the Sybase and SybaseBk agents support intelligent resource monitoring
    5. About the Sybase agent functions
      1.  
        Sybase agent functions
      2.  
        SybaseBk agent functions
      3.  
        Using the IPC Cleanup feature for the Sybase agent
    6.  
      Monitoring options for the Sybase agent
    7.  
      Action function for the VCS agent for Sybase
    8.  
      Typical Sybase configuration in a VCS cluster
  2. Installing and configuring Sybase
    1. VCS requirements for installing Sybase
      1.  
        Sybase installation directory
      2.  
        SYBASE directory on shared disks
      3.  
        System Group and User for Sybase home directory
      4.  
        Database dbspaces
      5.  
        Transparent TCP/IP failover
      6.  
        Changes required in Sybase RUN_Server file for AMF offline monitoring
      7.  
        Language settings for the Sybase agent
      8.  
        AMF kernel driver limitation for process offline event notification
    2.  
      Installing Sybase in a VCS environment
    3.  
      Configuring Sybase for detail monitoring
  3. Installing, upgrading, and removing the agent for Sybase
    1.  
      Before you install or upgrade the agent for Sybase
    2.  
      Installing the agent for Sybase
    3.  
      Disabling the agent for Sybase
    4.  
      Removing the agent for Sybase
    5.  
      Upgrading the agent for Sybase
  4. Configuring VCS service groups for Sybase
    1.  
      About configuring service groups for Sybase
    2. Before configuring the service group for Sybase
      1.  
        Importing the SybaseTypes.cf file
    3.  
      Configuring the service groups for Sybase
    4.  
      Configuring the service group for Sybase from Cluster Manager (Java console)
    5.  
      Configuring the service group for Sybase using the command line
    6.  
      Encrypting passwords for Sybase
    7. About setting up detail monitoring for the agent for Sybase
      1.  
        Enabling detail monitoring for the agent for Sybase
      2.  
        Disabling detail monitoring for the agent for Sybase
    8.  
      Enabling and disabling intelligent resource monitoring (IMF) for agents
    9.  
      Administering the AMF kernel driver
  5. Administering VCS service groups for Sybase
    1.  
      About administering service groups for Sybase
    2.  
      Bringing the Sybase service group online
    3.  
      Taking the Sybase service group offline
    4.  
      Switching the Sybase service group
    5.  
      Modifying the Sybase service group configuration
    6.  
      Viewing the agent log for Sybase
  6. Appendix A. Resource type definitions for Sybase
    1.  
      About the resource type and attribute definitions for Sybase
    2. Sybase resource type
      1.  
        Type definition for the Sybase agent
      2.  
        Attribute definitions for the Sybase agent
    3. SybaseBk resource type
      1.  
        Type definition for the SybaseBk agent
      2.  
        Attribute definitions for the SybaseBk agent
  7. Appendix B. Sample configurations for Sybase
    1.  
      About the sample configuration for the Sybase agent
    2.  
      Resource dependency graph for the Sybase agent
    3.  
      Sample configuration for a Sybase service group on AIX systems

SybaseBk agent functions

The agent for SybaseBk starts a Sybase Backup server, monitors the server process, and shuts down the server.

The SybaseBk agent is IMF-aware.

Table: Sybase agent for Backup server functions lists the Sybase agent for Backup server functions.

Table: Sybase agent for Backup server functions

Agent operation

Description

Online

Starts the Sybase Backup server by using the following command.

startserver -f $SYBASE/$SYBASE_ASE/
install/RUN_$BackupServer

Where $SYBASE/$SYBASE_ASE/install/RUN_$BackupServer is the default location of the Run server file. If you specify the value of the Run_ServerFile attribute, then the value that you specify is used instead of the default location.

Monitor

Scans the process table for the backupserver process.

Offline

Stops the Sybase Backup server by using the isql command in the following manner.

If interfaces file location is specified using the interfaces_File attribute, agent uses the specified file while connecting to isql session.

The agent first executes the command shutdown SYB_BACKUP with wait. If this command fails, the offline script executes shutdown SYB_BACKUP with nowait.

Clean

Forcefully stops the Sybase Backup server by using the isql command in the following manner.

The agent first executes the command shutdown SYB_BACKUP with wait. If this command fails, the clean script executes shutdown SYB_BACKUP with nowait.

If the process does not respond to the shutdown command, the agent scans the process table for the processes that are associated with the configured Sybase Backup server and kills them.

imf_init

Initializes the agent to interface with the AMF kernel driver, which is the IMF notification module for SybaseBk agent. This function runs when the agent starts up.

imf_ register

Registers or unregisters resource entities with the AMF kernel module. This function runs for each resource after the resource goes into steady state (online or offline).

imf_getnotification

Gets notification about resource state changes. This function runs after the agent initializes with the AMF kernel module. This function continuously waits for notification and takes action on the resource upon notification.