Storage Foundation for Sybase ASE CE 7.4.1 Configuration and Upgrade Guide - Linux

Last Published:
Product(s): InfoScale & Storage Foundation (7.4.1)
Platform: Linux
  1. Section I. Configuring SF Sybase ASE CE
    1. Preparing to configure SF Sybase CE
      1.  
        About this document
      2.  
        Supported Sybase ASE CE releases
      3.  
        Supported SF Sybase CE configurations
      4.  
        Coordinator disk requirements for I/O fencing
      5.  
        Supported replication technologies for global clusters
      6. About planning to configure I/O fencing
        1.  
          Typical SF Sybase CE cluster configuration with disk-based I/O fencing
      7.  
        Planning for cluster management
    2. Configuring SF Sybase CE
      1.  
        About configuring SF Sybase CE
      2. Configuring the SF Sybase CE components using the script-based installer
        1. Configuring the SF Sybase CE cluster
          1.  
            Configuring the cluster name
          2.  
            Configuring private heartbeat links
          3.  
            Configuring the virtual IP of the cluster
          4. Configuring SF Sybase CE in secure mode
            1.  
              Setting up trust relationships for your SF Sybase CE cluster
          5. Configuring a secure cluster node by node
            1.  
              Configuring the first node
            2.  
              Configuring the remaining nodes
            3.  
              Completing the secure cluster configuration
          6.  
            Adding VCS users
          7.  
            Configuring SMTP email notification
          8.  
            Configuring SNMP trap notification
          9.  
            Configuring global clusters
    3. Configuring SF Sybase CE clusters for data integrity
      1. Setting up disk-based I/O fencing using installer
        1.  
          Initializing disks as VxVM disks
        2.  
          Identifying disks to use as coordinator disks
        3.  
          Refreshing keys or registrations on the existing coordination points for disk-based fencing using the installer
        4. Checking shared disks for I/O fencing
          1.  
            Verifying Array Support Library (ASL)
          2.  
            Verifying that the nodes have access to the same disk
          3.  
            Testing the disks using vxfentsthdw utility
        5.  
          Configuring disk-based I/O fencing using installer
    4. Performing an automated SF Sybase CE configuration
      1.  
        Configuring SF Sybase CE using response files
      2.  
        Response file variables to configure SF Sybase CE
      3.  
        Sample response files for configuring SF Sybase CE
    5. Performing an automated I/O fencing configuration using response files
      1.  
        Configuring I/O fencing using response files
      2.  
        Response file variables to configure disk-based I/O fencing
      3.  
        Sample response file for configuring disk-based I/O fencing
    6. Configuring a cluster under VCS control using a response file
      1.  
        Configuring a Sybase cluster under VCS control with a response file
      2.  
        Response file variables to configure SF Sybase CE in VCS
  2. Section II. Post-installation and configuration tasks
    1. Verifying the installation
      1.  
        Upgrading the disk group version
      2.  
        Performing a postcheck on a node
      3.  
        Verifying SF Sybase CE installation using VCS configuration file
      4. Verifying LLT, GAB, and cluster operation
        1.  
          Verifying LLT
        2.  
          Verifying GAB
        3.  
          Verifying the cluster
        4.  
          Verifying the cluster nodes
    2. Performing additional post-installation and configuration tasks
      1. About enabling LDAP authentication for clusters that run in secure mode
        1.  
          Enabling LDAP authentication for clusters that run in secure mode
      2.  
        Configuring Volume Replicator
      3.  
        Running SORT Data Collector to collect configuration information
  3. Section III. Upgrade of SF Sybase CE
    1. Planning to upgrade SF Sybase CE
      1.  
        About the upgrade
      2.  
        Supported upgrade paths
      3.  
        Using Install Bundles to simultaneously install or upgrade full releases (base, maintenance, rolling patch), and individual patches
    2. Performing a full upgrade of SF Sybase CE using the product installer
      1.  
        About full upgrades
      2.  
        Preparing to perform a full upgrade to SF Sybase CE 7.4.1
      3. Upgrading to SF Sybase CE 7.4.1
        1.  
          Upgrading SF Sybase CE using the Veritas installation program
    3. Performing an automated full upgrade of SF Sybase CE using response files
      1.  
        Upgrading SF Sybase CE using a response file
      2.  
        Response file variables to upgrade SF Sybase CE
      3.  
        Sample response file for upgrading SF Sybase CE
    4. Performing a phased upgrade of SF Sybase CE
      1.  
        About phased upgrade
      2. Performing a phased upgrade of SF Sybase CE from version 6.2.1 and later release
        1.  
          Step 1: Performing pre-upgrade tasks on the first half of the cluster
        2.  
          Step 2: Upgrading the first half of the cluster
        3.  
          Step 3: Performing pre-upgrade tasks on the second half of the cluster
        4.  
          Step 4: Performing post-upgrade tasks on the first half of the cluster
        5.  
          Step 5: Upgrading the second half of the cluster
        6.  
          Step 6: Performing post-upgrade tasks on the second half of the cluster
    5. Performing a rolling upgrade of SF Sybase CE
      1.  
        About rolling upgrade
      2.  
        Supported rolling upgrade paths
      3.  
        Preparing to perform a rolling upgrade to SF Sybase CE 7.4.1
    6. Performing post-upgrade tasks
      1.  
        Re-joining the backup boot disk group into the current disk group
      2.  
        Reverting to the backup boot disk group after an unsuccessful upgrade
      3.  
        Setting or changing the product license level
      4.  
        Upgrading disk layout versions
      5.  
        Upgrading CVM protocol version and VxVM disk group version
  4. Section IV. Installation and upgrade of Sybase ASE CE
    1. Installing, configuring, and upgrading Sybase ASE CE
      1.  
        Before installing Sybase ASE CE
      2.  
        Preparing for local mount point on VxFS for Sybase ASE CE binary installation
      3.  
        Preparing for shared mount point on CFS for Sybase ASE CE binary installation
      4.  
        Installing Sybase ASE CE software
      5.  
        Preparing to create a Sybase ASE CE cluster
      6.  
        Creating the Sybase ASE CE cluster
      7. Preparing to configure the Sybase instances under VCS control
        1.  
          Language settings for the Sybase agent
        2.  
          Configuring Sybase for detail monitoring
        3.  
          Encrypting passwords for Sybase
        4. 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.  
        Configuring a Sybase ASE CE cluster under VCS control using the SF Sybase CE installer
      9.  
        Upgrading Sybase ASE CE
  5. Section V. Adding and removing nodes
    1. Adding a node to SF Sybase CE clusters
      1.  
        About adding a node to a cluster
      2.  
        Before adding a node to a cluster
      3. Adding the node to a cluster manually
        1.  
          Starting Veritas Volume Manager (VxVM) on the new node
        2.  
          Configuring cluster processes on the new node
        3. Setting up the node to run in secure mode
          1.  
            Configuring the authentication broker on node sys5
        4.  
          Starting fencing on the new node
        5.  
          Configuring Cluster Volume Manager (CVM) and Cluster File System (CFS) on the new node
        6.  
          After adding the new node
        7.  
          Configuring the ClusterService group for the new node
      4.  
        Adding a node to a cluster using the Veritas InfoScale installer
      5. Adding the new instance to the Sybase ASE CE cluster
        1.  
          Creating Sybase user and groups
        2.  
          Preparing the mount point for Sybase resources on the new node
        3.  
          Adding a new Sybase ASE CE instance to the Sybase ASE CE cluster
        4.  
          Bringing the new Sybase ASE CE instance under VCS control
    2. Removing a node from SF Sybase CE clusters
      1.  
        About removing a node from a cluster
      2.  
        Removing a node from a cluster
      3.  
        Modifying the VCS configuration files on existing nodes
      4.  
        Modifying the Cluster Volume Manager (CVM) configuration on the existing nodes to remove references to the deleted node
      5.  
        Removing security credentials from the leaving node
  6. Section VI. Configuration of disaster recovery environments
    1. Configuring disaster recovery environments
      1.  
        Disaster recovery options for SF Sybase CE
      2.  
        About setting up a global cluster environment for SF Sybase CE
      3.  
        About configuring a parallel global cluster using Volume Replicator (VVR) for replication
  7. Section VII. Installation reference
    1. Appendix A. Installation scripts
      1.  
        Installation script options
      2.  
        About using the postcheck option
    2. Appendix B. Sample installation and configuration values
      1.  
        SF Sybase CE installation and configuration information
      2.  
        SF Sybase CE worksheet
    3. Appendix C. Tunable files for installation
      1.  
        About setting tunable parameters using the installer or a response file
      2.  
        Setting tunables for an installation, configuration, or upgrade
      3.  
        Setting tunables with no other installer-related operations
      4.  
        Setting tunables with an un-integrated response file
      5.  
        Preparing the tunables file
      6.  
        Setting parameters for the tunables file
      7.  
        Tunables value parameter definitions
    4. Appendix D. Configuration files
      1.  
        About sample main.cf files
      2. 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
    5. Appendix E. Configuring the secure shell or the remote shell for communications
      1. About configuring secure shell or remote shell communication modes before installing products
        1.  
          Manually configuring passwordless ssh
        2.  
          Setting up ssh and rsh connection using the installer -comsetup command
        3.  
          Setting up ssh and rsh connection using the pwdutil.pl utility
        4.  
          Restarting the ssh session
        5.  
          Enabling rsh for Linux
    6. Appendix F. High availability agent information
      1. About agents
        1.  
          VCS agents included within SF Sybase CE
        2.  
          VCS agent for Sybase included within SF Sybase CE
      2. CVMCluster agent
        1.  
          Entry points for CVMCluster agent
        2.  
          Attribute definition for CVMCluster agent
        3.  
          CVMCluster agent type definition
        4.  
          CVMCluster agent sample configuration
      3. CVMVxconfigd agent
        1.  
          Entry points for CVMVxconfigd agent
        2.  
          Attribute definition for CVMVxconfigd agent
        3.  
          CVMVxconfigd agent type definition
        4.  
          CVMVxconfigd agent sample configuration
      4. CVMVolDg agent
        1.  
          Entry points for CVMVolDg agent
        2.  
          Attribute definition for CVMVolDg agent
        3.  
          CVMVolDg agent type definition
        4.  
          CVMVolDg agent sample configuration
      5. CFSMount agent
        1.  
          Entry points for CFSMount agent
        2.  
          Attribute definition for CFSMount agent
        3.  
          CFSMount agent type definition
        4.  
          CFSMount agent sample configuration
      6. Process agent
        1.  
          Agent functions
        2.  
          State definitions
        3.  
          Attributes
        4.  
          Resource type definition
        5.  
          Sample configurations
      7.  
        Monitoring options for the Sybase agent
      8. Sybase resource type
        1.  
          Type definition for the Sybase agent
        2.  
          Attribute definitions for the Sybase agent

Response file variables to configure SF Sybase CE

Table: Response file variables specific to configuring SF Sybase CE lists the response file variables that you can define to configure SF Sybase CE.

Table: Response file variables specific to configuring SF Sybase CE

Variable

List or Scalar

Description

CFG{config_cfs}

Scalar

Performs the Cluster File System configuration for SF Sybase CE.

(Required)

Set the value to 1 to configure Cluster File System for SF Sybase CE.

CFG{opt}{configure}

Scalar

Performs the configuration if the RPMs are already installed.

(Required)

Set the value to 1 to configure SF Sybase CE.

CFG{accepteula}

Scalar

Specifies whether you agree with EULA.pdf on the media.

(Required)

CFG{activecomponent}

List

Defines the component to be configured.

The value is SFSYBASECE741 for SFSYBASECE.

(Required)

CFG{keys}{keyless}

CFG{keys}{license}

List

CFG{keys}{keyless} gives a list of keyless keys to be registered on the system.

CFG{keys}{license} gives a list of user defined keys to be registered on the system.

(Optional)

CFG{systems}

List

List of systems on which the product is to be configured.

(Required)

CFG{prod}

Scalar

Defines the product for operations.

The value is ENTERPRISE741 for Veritas InfoScale Enterprise.

(Required)

CFG{opt}{keyfile}

Scalar

Defines the location of an ssh keyfile that is used to communicate with all remote systems.

(Optional)

CFG{opt}{rsh}

Scalar

Defines that rsh must be used instead of ssh as the communication method between systems.

(Optional)

CFG{opt}{logpath}

Scalar

Mentions the location where the log files are to be copied. The default location is /opt/VRTS/install/logs.

Note:

The installer copies the response files and summary files also to the specified logpath location.

(Optional)

CFG{uploadlogs}

Scalar

Defines a Boolean value 0 or 1.

The value 1 indicates that the installation logs are uploaded to the Veritas website.

The value 0 indicates that the installation logs are not uploaded to the Veritas website.

(Optional)

Note that some optional variables make it necessary to define other optional variables. For example, all the variables that are related to the cluster service group (csgnic, csgvip, and csgnetmask) must be defined if any are defined. The same is true for the SMTP notification (smtpserver, smtprecp, and smtprsev), the SNMP trap notification (snmpport, snmpcons, and snmpcsev), and the Global Cluster Option (gconic, gcovip, and gconetmask).

Table: Response file variables specific to configuring a basic SF Sybase CE cluster lists the response file variables that specify the required information to configure a basic SF Sybase CE cluster.

Table: Response file variables specific to configuring a basic SF Sybase CE cluster

Variable

List or Scalar

Description

CFG{donotreconfigurevcs}

Scalar

Defines if you need to re-configure VCS.

(Optional)

CFG{donotreconfigurefencing}

Scalar

Defines if you need to re-configure fencing.

(Optional)

CFG{vcs_clusterid}

Scalar

An integer between 0 and 65535 that uniquely identifies the cluster.

(Required)

CFG{vcs_clustername}

Scalar

Defines the name of the cluster.

(Required)

CFG{vcs_allowcomms}

Scalar

Indicates whether or not to start LLT and GAB when you set up a single-node cluster. The value can be 0 (do not start) or 1 (start).

(Required)

Table: Response file variables specific to configuring private LLT over Ethernet lists the response file variables that specify the required information to configure LLT over Ethernet.

Table: Response file variables specific to configuring private LLT over Ethernet

Variable

List or Scalar

Description

CFG{vcs_lltlink#}

{"system"}

Scalar

Defines the NIC to be used for a private heartbeat link on each system. At least two LLT links are required per system (lltlink1 and lltlink2). You can configure up to four LLT links.


You must enclose the system name within double quotes.

(Required)

CFG{vcs_lltlinklowpri#}

{"system"}

Scalar

Defines a low priority heartbeat link. Typically, lltlinklowpri is used on a public network link to provide an additional layer of communication.

If you use different media speed for the private NICs, you can configure the NICs with lesser speed as low-priority links to enhance LLT performance. For example, lltlinklowpri1, lltlinklowpri2, and so on.

You must enclose the system name within double quotes.

(Optional)

Table: Response file variables specific to configuring LLT over UDP lists the response file variables that specify the required information to configure LLT over UDP.

Table: Response file variables specific to configuring LLT over UDP

Variable

List or Scalar

Description

CFG{lltoverudp}=1

Scalar

Indicates whether to configure heartbeat link using LLT over UDP.

(Required)

CFG{vcs_udplink<n>_address}

{<sys1>}

Scalar

Stores the IP address (IPv4 or IPv6) that the heartbeat link uses on node1.

You can have four heartbeat links and <n> for this response file variable can take values 1 to 4 for the respective heartbeat links.

(Required)

CFG

{vcs_udplinklowpri<n>_address}

{<sys1>}

Scalar

Stores the IP address (IPv4 or IPv6) that the low priority heartbeat link uses on node1.

You can have four low priority heartbeat links and <n> for this response file variable can take values 1 to 4 for the respective low priority heartbeat links.

(Required)

CFG{vcs_udplink<n>_port}

{<sys1>}

Scalar

Stores the UDP port (16-bit integer value) that the heartbeat link uses on node1.

You can have four heartbeat links and <n> for this response file variable can take values 1 to 4 for the respective heartbeat links.

(Required)

CFG{vcs_udplinklowpri<n>_port}

{<sys1>}

Scalar

Stores the UDP port (16-bit integer value) that the low priority heartbeat link uses on node1.

You can have four low priority heartbeat links and <n> for this response file variable can take values 1 to 4 for the respective low priority heartbeat links.

(Required)

CFG{vcs_udplink<n>_netmask}

{<sys1>}

Scalar

Stores the netmask (prefix for IPv6) that the heartbeat link uses on node1.

You can have four heartbeat links and <n> for this response file variable can take values 1 to 4 for the respective heartbeat links.

(Required)

CFG{vcs_udplinklowpri<n>_netmask}

{<sys1>}

Scalar

Stores the netmask (prefix for IPv6) that the low priority heartbeat link uses on node1.

You can have four low priority heartbeat links and <n> for this response file variable can take values 1 to 4 for the respective low priority heartbeat links.

(Required)

Table: Response file variables specific to configuring virtual IP for SF Sybase CE cluster lists the response file variables that specify the required information to configure virtual IP for SF Sybase CE cluster.

Table: Response file variables specific to configuring virtual IP for SF Sybase CE cluster

Variable

List or Scalar

Description

CFG{vcs_csgnic}

{system}

Scalar

Defines the NIC device to use on a system. You can enter 'all' as a system value if the same NIC is used on all systems.

(Optional)

CFG{vcs_csgvip}

Scalar

Defines the virtual IP address for the cluster.

(Optional)

CFG{vcs_csgnetmask}

Scalar

Defines the Netmask of the virtual IP address for the cluster.

(Optional)

Table: Response file variables specific to configuring SF Sybase CE cluster in secure mode lists the response file variables that specify the required information to configure the SF Sybase CE cluster in secure mode.

Table: Response file variables specific to configuring SF Sybase CE cluster in secure mode

Variable

List or Scalar

Description

CFG{vcs_eat_security}

Scalar

Specifies if the cluster is in secure enabled mode or not.

CFG{opt}{securityonenode}

Scalar

Specifies that the securityonenode option is being used.

CFG{securityonenode_menu}

Scalar

Specifies the menu option to choose to configure the secure cluster one at a time.

  • 1 - Configure the first node

  • 2 - Configure the other node

CFG{secusrgrps}

List

Defines the user groups which get read access to the cluster.

List or scalar: list

Optional or required: optional

CFG{rootsecusrgrps}

Scalar

Defines the read access to the cluster only for root and other users or user groups which are granted explicit privileges in VCS objects.

(Optional)

CFG{security_conf_dir}

Scalar

Specifies the directory where the configuration files are placed.

CFG{opt}{security}

Scalar

Specifies that the security option is being used.

CFG{defaultaccess}

Scalar

Defines if the user chooses to grant read access to everyone.

Optional or required: optional

CFG{vcs_eat_security_fips}

Scalar


Specifies that the enabled security is FIPS compliant.

Table: Response file variables specific to configuring VCS users lists the response file variables that specify the required information to configure VCS users.

Table: Response file variables specific to configuring VCS users

Variable

List or Scalar

Description

CFG{vcs_userenpw}

List


List of encoded passwords for VCS users

The value in the list can be "Administrators Operators Guests"

Note:

The order of the values for the vcs_userenpw list must match the order of the values in the vcs_username list.

(Optional)

CFG{vcs_username}

List

List of names of VCS users

(Optional)

CFG{vcs_userpriv}

List

List of privileges for VCS users

Note:

The order of the values for the vcs_userpriv list must match the order of the values in the vcs_username list.

(Optional)

Table: Response file variables specific to configuring VCS notifications using SMTP lists the response file variables that specify the required information to configure VCS notifications using SMTP.

Table: Response file variables specific to configuring VCS notifications using SMTP

Variable

List or Scalar

Description

CFG{vcs_smtpserver}

Scalar

Defines the domain-based hostname (example: smtp.example.com) of the SMTP server to be used for web notification.

(Optional)

CFG{vcs_smtprecp}

List

List of full email addresses (example: user@example.com) of SMTP recipients.

(Optional)

CFG{vcs_smtprsev}

List

Defines the minimum severity level of messages (Information, Warning, Error, SevereError) that listed SMTP recipients are to receive. Note that the ordering of severity levels must match that of the addresses of SMTP recipients.

(Optional)

Table: Response file variables specific to configuring VCS notifications using SNMP lists the response file variables that specify the required information to configure VCS notifications using SNMP.

Table: Response file variables specific to configuring VCS notifications using SNMP

Variable

List or Scalar

Description

CFG{vcs_snmpport}

Scalar

Defines the SNMP trap daemon port (default=162).

(Optional)

CFG{vcs_snmpcons}

List

List of SNMP console system names

(Optional)

CFG{vcs_snmpcsev}

List

Defines the minimum severity level of messages (Information, Warning, Error, SevereError) that listed SNMP consoles are to receive. Note that the ordering of severity levels must match that of the SNMP console system names.

(Optional)

Table: Response file variables specific to configuring SF Sybase CE global clusters lists the response file variables that specify the required information to configure SF Sybase CE global clusters.

Table: Response file variables specific to configuring SF Sybase CE global clusters

Variable

List or Scalar

Description

CFG{vcs_gconic}

{system}

Scalar

Defines the NIC for the Virtual IP that the Global Cluster Option uses. You can enter 'all' as a system value if the same NIC is used on all systems.

(Optional)

CFG{vcs_gcovip}

Scalar

Defines the virtual IP address to that the Global Cluster Option uses.

(Optional)

CFG{vcs_gconetmask}

Scalar

Defines the Netmask of the virtual IP address that the Global Cluster Option uses.

(Optional)