Cluster Server 8.0 Agent for Sybase Installation and Configuration Guide - Linux

Last Published:
Product(s): InfoScale & Storage Foundation (8.0)
Platform: Linux
  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.  
        Language settings for the Sybase agent
    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
      2.  
        Using SystemD attributes for Sybase and SybaseBk
    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 Linux systems
    4. Sample main.cf files for Sybase ASE CE configurations
      1.  
        Sample main.cf for a basic Sybase ASE CE cluster configuration under VCS control with shared mount point on CFS for Sybase binary installation
      2.  
        Sample main.cf for a basic Sybase ASE CE cluster configuration with local mount point on VxFS for Sybase binary installation
      3.  
        Sample main.cf for a primary CVM VVR site
      4.  
        Sample main.cf for a secondary CVM VVR site

Attribute definitions for the SybaseBk agent

Review the description of the SybaseBk agent attributes. The agent attributes are classified as required and internal.

Table: Required attributes lists the required attributes for SybaseBk resource.

Table: Required attributes

Required Attributes

Definition

Server

The $DSQUERY Backup name. Only one server should be configured in a Sybase service group. The advantage of configuring Sybase resources in a separate service group is, each Sybase data server can failover independently. When multiple Sybase resources are configured in a single service group, even if one of the "n" data servers fail, the entire service group will be failed over.

Type and dimension: string-scalar

Owner

Sybase user as the defined owner of executables and database files in any of the sources (such as NIS+, /etc/hosts, and so on) specified in the /etc/nsswitch.conf file for passwd entry. The Sybase executables and database files are accessed in the context of this user.

Type and dimension: string-scalar

Home

The $SYBASE path to Sybase binaries and configuration files.

Type and dimension: string-scalar

Version

Version of Sybase Backup Server.

Type and dimension: string-scalar

Backupserver

The $BACKUP SYBASE Backup Server name.

Type and dimension: string-scalar

SA

Sybase database administrator. This attribute is required to connect to the ASE for shutdown.

Type and dimension: string-scalar

SApswd

Encrypted password of Sybase database administrator. This password is required to connect to the ASE for shutdown.

Type and dimension: string-scalar

Note:

You need not specify a value for this attribute if the SA user does not require a password.

Table:  Optional attribute lists the optional attribute for SybaseBk agent.

Table: Optional attribute

Optional attribute

Definition

Run_ServerFile

Specifies the location of the RUN_SERVER file for the Sybase instance. The default location of this file is used if no value is specified for this attribute.

Type and dimension: String-scalar

Default value: No default value

interfaces _File

Specifies the location of interfaces file for the Sybase instance. If this attribute is configured, [-I interfaces file] option is used when connecting to the isql session. If this attribute is not configured, the agent does not use the -I option.

Type and dimension: string-scalar

Default value: No defalult value

For example: /sybase/my_interfaces_file

Note:

It is assumed that you have modified the RUN_ServerFile with the non-default interface file location if the interfaces_File attribute is configured.

IMF

This resource-type level attribute determines whether the Sybase agent must perform intelligent resource monitoring. You can also override the value of this attribute at resource-level.

This attribute includes the following keys:

  • Mode: Define this attribute to enable or disable intelligent resource monitoring.

    Valid values are as follows:

    • 0 - Does not perform intelligent resource monitoring

    • 1 - Performs intelligent resource monitoring for offline resources and performs poll-based monitoring for online resources

    • 2 - Performs intelligent resource monitoring for online resources and performs poll-based monitoring for offline resources

    • 3 - Performs intelligent resource monitoring for both online and for offline resources

      Default: 3

  • MonitorFreq: This key value specifies the frequency at which the agent invokes the monitor agent function. The value of this key is an integer.

    Default: 5

    You can set this key to a non-zero value for cases where the agent requires to perform both poll-based and intelligent resource monitoring. If the value is 0, the agent does not perform poll-based process check monitoring.

    After the resource registers with the AMF kernel driver, the agent calls the monitor agent function as follows:

    • After every (MonitorFreq x MonitorInterval) number of seconds for online resources

    • After every (MonitorFreq x OfflineMonitorInterval) number of seconds for offline resources

  • RegisterRetryLimit: If you enable intelligent resource monitoring, the agent invokes the oracle_imf_register agent function to register the resource with theAMFkernel driver. The value of the RegisterRetryLimit key determines the number of times the agent must retry registration for a resource. If the agent cannot register the resource within the limit that is specified, then intelligent monitoring is disabled until the resource state changes or the value of the Mode key changes.

    Default: 3

Type and dimension: Integer-association.

UseSystemD

SystemD is a system and service manager for Linux operating systems. It helps manage applications across Linux distributions that support SystemD feature.

  • When this attribute is set to 0, the online entry point starts the resource in user.slice.

  • When this attribute is set to 1, the online entry point brings the Sybase or the SybaseBk resource online as a service in system.slice.

The application process can be viewed as vcs-resourceName.service, in /etc/systemd/system.

Note:

After a system restart, if an application resource is started under user.slice, there is a possibility that the processes are not stopped gracefully. In this case, you can enable the UseSystemD attribute.

Type and dimension: Boolean-Scalar

SystemDAttrList

Set the key-value pairs for the SystemD environment using this attribute.

Note:

Ensure that UseSystemD is set to 1 before you set the key-value pairs.

To know more about the different limits that you can apply to an application, refer to the appropriate Red Hat documentation.

Type and dimension: String-scalar

Table: Internal attribute lists the internal attribute for SybaseBk agent.

This attribute is for internal use only. Veritas recommends not to modify the value of this attribute.

Table: Internal attribute

Internal attribute

Definition

AgentDirectory

Specifies the location of the binaries, scripts, and other files related to the agent for SybaseBk.

Type and dimension: static-string

More Information

Encrypting passwords for Sybase