821-2908

Embed Size (px)

Citation preview

  • 8/6/2019 821-2908

    1/52

    Oracle Solaris Cluster Data Service orSybase ASE Guide

    Part No: 821290810May 2011, Revision A

  • 8/6/2019 821-2908

    2/52

    Copyright 2000, 2011, Oracleand/or itsafliates. Allrights reserved.

    LicenseRestrictionsWarranty/ConsequentialDamagesDisclaimer

    This sotware and related documentation are provided undera license agreement containingrestrictions on use and disclosure and are protected by intellectualproperty laws. Exceptas expresslypermitted in your license agreementor allowed by law, youmay notuse, copy, reproduce, translate, broadcast, modiy, license,transmit,distribute,exhibit,perorm,publish or display anypart,in anyorm,or by anymeans. Reverse engineering,disassembly,or decompilation o this sotware,unless required by law or interoperability, is prohibited.

    WarrantyDisclaimer

    Theinormationcontained hereinis subject to changewithout noticeand is notwarranted to be error-ree. I yound anyerrors,please reportthem to us in writing.

    RestrictedRights Notice

    Ithis is sotware or related documentation that is deliveredto theU.S. Government or anyonelicensing it on behalo theU.S. Government, theollowing noticeisapplicable:

    U.S. GOVERNMENT RIGHTS

    Programs, sotware, databases, and related documentation and technicaldata deliveredto U.S. Governmentcustomers are "commercialcomputersotware" or"commercial technicaldata" pursuant to the applicableFederalAcquisition Regulationand agency-specic supplemental regulations. As such, the use, duplication,

    disclosure, modication,and adaptation shall be subject to therestrictions andlicense terms setorthin theapplicable Government contract,and, to theextentapplicable by thetermso theGovernment contract,the additional rightsset orth in FAR 52.227-19, Commercial Computer Sotware License (December 2007).OracleAmerica,Inc.,500 OracleParkway, Redwood City, CA 94065.

    HazardousApplicationsNotice

    This sotware or hardware is developedor general usein a variety o inormation management applications. Itis notdeveloped or intended oruse in anyinherentlydangerousapplications, includingapplications that maycreate a risk o personal injury. I youuse this sotware or hardware in dangerousapplications, then youshallbe responsible to take allappropriate ail-sae, backup, redundancy, andothermeasuresto ensure itssae use. OracleCorporationand itsafliatesdisclaimanyliabilityor anydamagescausedby useo this sotware or hardware in dangerousapplications.

    TrademarkNotice

    Oracleand Java areregistered trademarks o Oracleand/or itsafliates. Other names maybe trademarks o their respective owners.

    Inteland Intel Xeon aretrademarks or registered trademarks o Intel Corporation.All SPARCtrademarks areused under license andare trademarks or registeredtrademarks o SPARCInternational,Inc. AMD, Opteron, theAMD logo, andthe AMDOpteron logo aretrademarksor registered trademarks o Advanced MicroDevices. UNIX is a registered trademarko TheOpen Group in theUnited Statesand other countries.

    ThirdPartyContent,Products,and ServicesDisclaimer

    This sotware or hardware anddocumentation mayprovide accessto or inormation on content, products,and services rom third parties. OracleCorporationanditsafliates arenot responsible orand expresslydisclaimall warranties o anykind with respect to third-party content, products,and services.Oracle Corporationandits afliates will notbe responsible orany loss, costs,or damages incurred dueto your accessto or useo third-party content, products,or services.

    Copyright 2000, 2011, Oracleet/ouses aflis. Tous droitsrservs.

    Ce logiciel et la documentation quilaccompagnesont protgs parles lois surla propritintellectuelle. Ilssont concds souslicenceet soumis desrestrictionsdutilisation et de divulgation.Sau disposition de votre contrat de licence ou de la loi, vous ne pouvezpas copier, reproduire, traduire,diuser,modier,breveter,transmettre,distribuer,exposer,excuter, publier ou afcherle logiciel,mme partiellement, sous quelque orme et parquelque procd quece soit. Par ailleurs,il estinterdit de procder toute ingnierie inverse du logiciel,de le dsassemblerou de le dcompiler, except desns dinteroprabilitavecdes logicielstiersou telqueprescrit parla loi.

    Les inormations ournies dans ce document sont susceptibles de modication sans pravis. Parailleurs, Oracle Corporationne garantit pas quellessoient exemptesderreurs et vous invite, le caschant, luien aire part parcrit.

    Sice logiciel,ou la documentation quilaccompagne, estconcd sous licence au Gouvernementdes Etats-Unis, ou toute entitqui dlivre la licence de ce logicielou lutilise pour le comptedu Gouvernementdes Etats-Unis,la noticesuivantesapplique :

    U.S. GOVERNMENT RIGHTS. Programs, sotware, databases, and related documentation and technical datadeliveredto U.S. Government customers are"commercial computer sotware" or "commercialtechnical data" pursuant to the applicable Federal Acquisition Regulationand agency-specic supplemental

    regulations.As such, theuse, duplication,disclosure,modication, andadaptationshallbe subject to therestrictions andlicensetermsset orth in theapplicableGovernment contract,and, to theextent applicable by thetermso theGovernment contract,the additional rightsset orth in FAR 52.227-19,CommercialComputer Sotware License (December 2007).Oracle America, Inc.,500 Oracle Parkway, Redwood City,CA 94065.

    Ce logiciel ou matriel a tdvelopp pour un usage gnral dans le cadre dapplicationsde gestiondes inormations. Ce logiciel ou matriel nestpas conu ni nestdestin tre utilis dans desapplications risque, notammentdans desapplications pouvant causerdes dommages corporels. Si vous utilisez ce logiciel ou matrieldans le cadre dapplicationsdangereuses,il estde votre responsabilit de prendre toutesles mesures de secours, de sauvegarde, de redondance et autresmesuresncessaires son utilisation dans des conditionsoptimalesde scurit. Oracle Corporationet ses aflis dclinent touteresponsabilitquant aux dommages causspar lutilisation de ce logiciel ou matriel pource typedapplications.

    Oracleet Java sont desmarques dposes dOracleCorporationet/oude sesaflis.Tout autre nommentionn peut correspondre desmarques appartenant dautres propritaires quOracle.

    AMD, Opteron, le logo AMDet le logo AMDOpteron sont desmarques ou desmarques dposes dAdvanced Micro Devices. Intel et Intel Xeon sont desmarques ou

    desmarques dposes dIntel Corporation.Toutes lesmarques SPARCsont utilisessous licence et sont desmarques ou desmarques dposes de SPARCInternational, Inc. UNIX estune marquedpose concd souslicense parX/Open Company, Ltd.

    110622@25097

  • 8/6/2019 821-2908

    3/52

    Contents

    Preace .....................................................................................................................................................5

    1 Installing and Confguring Solaris Cluster HA or Sybase ASE ......................................................11

    Solaris Cluster HA or Sybase ASE Overview .................................................................................. 11

    Overview o Installing and Conguring Solaris Cluster HA or Sybase ASE ............................... 12

    Preparing to Install Solaris Cluster HA or Sybase ASE .................................................................. 13

    Installing the Sybase ASE Sotware ................................................................................................... 13

    How to Prepare the Nodes or the Installation o the Sybase ASE Sotware .......................... 14

    How to Install the Sybase ASE Sotware .................................................................................... 15

    How to Veriy the Sybase ASE Installation ............................................................................... 17

    Conguring Sybase ASE Database Access and Creating the Sybase ASE DatabaseEnvironment ........................................................................................................................................ 17

    How to Congure Sybase ASE Database Access With Solaris Volume Manager ................ 17

    How to Congure Sybase ASE Database Access With Veritas Volume Manager ............... 18How to Create the Sybase ASE Database Environment .......................................................... 19

    Installing the Solaris Cluster HA or Sybase ASE Packages ............................................................ 21

    How to Install the Solaris Cluster HA or Sybase ASE Packages ............................................ 21

    Registering and Conguring Solaris Cluster HA or Sybase ASE .................................................. 23

    Setting Solaris Cluster HA or Sybase ASE Extension Properties .......................................... 23

    How to Register and Congure Solaris Cluster HA or Sybase ASE ...................................... 23

    Veriying the Solaris Cluster HA or Sybase ASE Installation and Conguration ...................... 27

    How to Veriy the Solaris Cluster HA or Sybase ASE Installation and Conguration ....... 27

    Location o Solaris Cluster HA or Sybase ASE Log Files ........................................................ 28

    Solaris Cluster HA or Sybase ASE Logging and Security Issues ................................................... 28

    Solaris Cluster HA or Sybase ASE Logging Issues .................................................................. 28

    Solaris Cluster HA or Sybase ASE Security Issues .................................................................. 29

    Tuning the Solaris Cluster HA or Sybase ASE Fault Monitor ....................................................... 29Main Fault-Monitor Process ....................................................................................................... 30

    3

  • 8/6/2019 821-2908

    4/52

    Database-Client Fault Probe ....................................................................................................... 30

    Obtaining Core Files or Troubleshooting ............................................................................... 30

    Customizing the Solaris Cluster HA or Sybase ASE Fault Monitor ............................................. 31Dening Custom Behavior or Errors ....................................................................................... 31

    Propagating a Custom Action File to All Nodes in a Cluster .................................................. 39

    Speciying the Custom Action File That a Server Fault Monitor Should Use ....................... 40

    A Solaris Cluster HA or Sybase ASE Extension Properties .............................................................. 41

    B Preset Actions or DBMS Errors and Sybase ASE Logged Alerts ...................................................45

    Index ......................................................................................................................................................49

    Contents

    OracleSolarisCluster Data Serviceor SybaseASE Guide May2011, RevisionA4

  • 8/6/2019 821-2908

    5/52

    Preace

    Oracle Solaris Cluster Data Service or Sybase ASE Guide explains how to install and congure

    Oracle Solaris Cluster data services.

    Note This Oracle Solaris Cluster release supports systems that use the SPARC and x86 amilieso processor architectures: UltraSPARC, SPARC64, AMD64, and Intel 64. In this document, x86reers to the larger amily o 64-bit x86 compatible products. Inormation in this documentpertains to all platorms unless otherwise specied.

    This document is intended or system administrators with extensive knowledge o Oraclesotware and hardware. Do not use this document as a planning or presales guide. Beorereading this document, you should have already determined your system requirements andpurchased the appropriate equipment and sotware.

    The instructions in this book assume knowledge o the Oracle Solaris Operating System andexpertise with the volume-manager sotware that is used with Oracle Solaris Cluster sotware.

    Using UNIX CommandsThis document contains inormation about commands that are specic to installing andconguring Oracle Solaris Cluster data services. The document does notcontaincomprehensive inormation about basic UNIX commands and procedures, such as shuttingdown the system, booting the system, and conguring devices. Inormation about basic UNIX

    commands and procedures is available rom the ollowing sources: Online documentation or the Oracle Solaris Operating System Oracle Solaris Operating System man pages Other sotware documentation that you received with your system

    5

  • 8/6/2019 821-2908

    6/52

    Typographic Conventions

    The ollowing table describes the typographic conventions that are used in this book.

    TABLEP1 TypographicConventions

    Typeace Meaning Example

    AaBbCc123 The names o commands, les, and directories,

    and onscreen computer output

    Edityour .login le.

    Use ls -a to list all les.

    machine_name% you have mail.

    AaBbCc123 What you type, contrasted with onscreen

    computer output

    machine_name% su

    Password:

    aabbcc123 Placeholder:replacewith a realname orvalue The command toremove a le is rmflename.

    AaBbCc123 Book titles, new terms, and terms to beemphasized

    Read Chapter 6 in the User's Guide.

    A cache isa copy thatis storedlocally.

    Do notsave the le.

    Note: Some emphasized items

    appear bold online.

    Shell Prompts in Command ExamplesThe ollowing table shows the deault UNIX system prompt and superuser prompt or shells

    that are included in the Oracle Solaris OS. Note that the deault system prompt that is displayed

    in command examples varies, depending on the Oracle Solaris release.

    TABLEP2 Shell Prompts

    Shell Prompt

    Bashshell, Korn shell, and Bourne shell $

    Bashshell, Korn shell, and Bourne shell or superuser #

    C shell machine_name%

    C shell or superuser machine_name#

    Preace

    OracleSolarisCluster Data Serviceor SybaseASE Guide May2011, RevisionA6

  • 8/6/2019 821-2908

    7/52

    Related Documentation

    Inormation about related Oracle Solaris Cluster topics is available in the documentation that islisted in the ollowing table. All Oracle Solaris Cluster documentation is available at

    http://www.oracle.com/technetwork/indexes/documentation/index.html .

    Topic Documentation

    Data service

    administration

    Oracle Solaris Cluster Data Services Planning and Administration Guide

    Individual data service guides

    Concepts Oracle Solaris Cluster Concepts Guide

    Sotware installation Oracle Solaris Cluster Sotware Installation Guide

    System administration Oracle Solaris Cluster System Administration Guide

    Hardware administration Oracle Solaris Cluster 3.3 Hardware Administration Manual

    Individual hardware administration guides

    Data service development Oracle Solaris Cluster Data Services Developers Guide

    Error messages Oracle Solaris Cluster Error Messages Guide

    Command and unction

    reerence

    Oracle Solaris Cluster Reerence Manual

    For a complete list o Oracle Solaris Cluster documentation, see the release notes or your

    release o Oracle Solaris Cluster at http://www.oracle.com/technetwork/indexes/documentation/index.html.

    Related Third-Party Web Site Reerences

    Third-party URLs that are reerenced in this document provide additional related inormation.

    Note Oracle is not responsible or the availability o third-party web sites mentioned in this

    document. Oracle does not endorse and is not responsible or liable or any content, advertising,

    products, or other materials that are available on or through such sites or resources. Oracle will

    not be responsible or liable or any actual or alleged damage or loss caused or alleged to be

    caused by or in connection with use o or reliance on any such content, goods, or services that

    are available on or through such sites or resources.

    Preace

    7

    http://www.oracle.com/technetwork/indexes/documentation/index.htmlhttp://www.oracle.com/technetwork/indexes/documentation/index.htmlhttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2682http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2845http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2847http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/E22715http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2848http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2849http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2679http://www.oracle.com/technetwork/indexes/documentation/index.htmlhttp://www.oracle.com/technetwork/indexes/documentation/index.htmlhttp://www.oracle.com/technetwork/indexes/documentation/index.htmlhttp://www.oracle.com/technetwork/indexes/documentation/index.htmlhttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2679http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2849http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2848http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/E22715http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2847http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2845http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2682http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850http://www.oracle.com/technetwork/indexes/documentation/index.html
  • 8/6/2019 821-2908

    8/52

    Documentation and SupportSee the ollowing web sites or additional resources:

    Documentation (http://www.oracle.com/technetwork/indexes/documentation/index.html)

    Support (http://www.oracle.com/us/support/systems/index.html)

    Oracle Sotware ResourcesOracle Technology Network (http://www.oracle.com/technetwork/index.html) oers arange o resources related to Oracle sotware:

    Discuss technical problems and solutions on the Discussion Forums(http://forums.oracle.com).

    Get hands-on step-by-step tutorials with Oracle By Example (http://www.oracle.com/technetwork/tutorials/index.html).

    Getting HelpI you have problems installing or using Oracle Solaris Cluster, contact your service providerand provide the ollowing inormation:

    Your name and email address (i available)

    Your company name, address, and phone number

    The model number and serial number o your systems

    The release number o the Oracle Solaris Operating System (or example, Oracle Solaris 10) The release number o Oracle Solaris Cluster (or example, Oracle Solaris Cluster 3.3)

    Use the ollowing commands to gather inormation about each node on your system or yourservice provider.

    Command Function

    prtconf -v Displays the size o the system memory and reports

    inormation about peripheral devices

    psrinfo -v Displays inormation about processors

    showrev p Reports which patches are installed

    prtdiag -v Displays system diagnostic inormation

    /usr/cluster/bin/clnode show-rev Displays Oracle Solaris Cluster release and package

    version inormation

    Preace

    OracleSolarisCluster Data Serviceor SybaseASE Guide May2011, RevisionA8

    http://www.oracle.com/technetwork/indexes/documentation/index.htmlhttp://www.oracle.com/technetwork/indexes/documentation/index.htmlhttp://www.oracle.com/technetwork/indexes/documentation/index.htmlhttp://www.oracle.com/technetwork/indexes/documentation/index.htmlhttp://www.oracle.com/us/support/systems/index.htmlhttp://www.oracle.com/us/support/systems/index.htmlhttp://www.oracle.com/us/support/systems/index.htmlhttp://www.oracle.com/technetwork/index.htmlhttp://www.oracle.com/technetwork/index.htmlhttp://www.oracle.com/technetwork/index.htmlhttp://forums.oracle.com/http://forums.oracle.com/http://forums.oracle.com/http://forums.oracle.com/http://www.oracle.com/technetwork/tutorials/index.htmlhttp://www.oracle.com/technetwork/tutorials/index.htmlhttp://www.oracle.com/technetwork/tutorials/index.htmlhttp://www.oracle.com/technetwork/tutorials/index.htmlhttp://www.oracle.com/technetwork/tutorials/index.htmlhttp://www.oracle.com/technetwork/tutorials/index.htmlhttp://forums.oracle.com/http://forums.oracle.com/http://www.oracle.com/technetwork/index.htmlhttp://www.oracle.com/us/support/systems/index.htmlhttp://www.oracle.com/technetwork/indexes/documentation/index.htmlhttp://www.oracle.com/technetwork/indexes/documentation/index.html
  • 8/6/2019 821-2908

    9/52

    Also have available the contents o the /var/adm/messages le.

    Preace

    9

  • 8/6/2019 821-2908

    10/52

    10

  • 8/6/2019 821-2908

    11/52

    Installing and Confguring Solaris Cluster HA orSybase ASE

    This chapter explains how to congure and administer Solaris Cluster HA or Sybase ASE on

    your Oracle Solaris Cluster nodes.

    This chapter contains the ollowing sections.

    Solaris Cluster HA or Sybase ASE Overview on page 11 Overview o Installing and Conguring Solaris Cluster HA or Sybase ASE on page 12 Preparing to Install Solaris Cluster HA or Sybase ASE on page 13 Installing the Sybase ASE Sotware on page 13 Conguring Sybase ASE Database Access and Creating the Sybase ASE Database

    Environment on page 17 Installing the Solaris Cluster HA or Sybase ASE Packages on page 21 Registering and Conguring Solaris Cluster HA or Sybase ASE on page 23 Veriying the Solaris Cluster HA or Sybase ASE Installation and Conguration on page 27 Solaris Cluster HA or Sybase ASE Logging and Security Issues on page 28 Tuning the Solaris Cluster HA or Sybase ASE Fault Monitor on page 29 Customizing the Solaris Cluster HA or Sybase ASE Fault Monitor on page 31

    Solaris Cluster HA or Sybase ASE OverviewSolaris Cluster HA or Sybase ASE provides ault monitoring and automatic ailover or the

    Sybase ASE application.

    Note Throughout this document a non-global zone might be reerred to as a zone. A global

    zone will always be reerred to as a global zone.

    You must congure Solaris Cluster HA or Sybase ASE as a ailover data service.

    1C H A P T E R 1

    11

  • 8/6/2019 821-2908

    12/52

    For general inormation about data services, resource groups, resources, and other relatedtopics, see:

    Oracle Solaris Cluster Concepts Guide Chapter 1, Planning or Oracle Solaris Cluster Data Services, in Oracle Solaris Cluster Data

    Services Planning and Administration Guide

    Overview o Installing and Confguring Solaris Cluster HA orSybase ASE

    The ollowing table summarizes the tasks or installing and conguring Solaris Cluster HA orSybase ASE and provides cross-reerences to detailed instructions or perorming these tasks.Perorm the tasks in the order that they are listed in the table.

    TABLE 11 Tasks or Installing and Conguring Solaris Cluster HA or Sybase ASE

    Task Instructions

    Prepare to install Solaris Cluster HA or

    Sybase ASE

    Preparing to Install Solaris Cluster HA or Sybase ASE on

    page 13

    Install the Sybase ASE sotware Installing the Sybase ASE Sotware on page 13

    Congure Sybase ASE database access and

    create the Sybase ASE database

    environment

    Conguring Sybase ASE Database Access and Creating the

    Sybase ASE Database Environment on page 17

    Install the Solaris Cluster HA or Sybase

    ASE package

    Installing the Solaris Cluster HA or Sybase ASE Packages on

    page 21

    Register Solaris Cluster HA or Sybase ASE

    resource types and congure resource

    groups and resources

    Registering and Conguring Solaris Cluster HA or Sybase ASE

    onpage 23

    Veriy the Solaris Cluster HA or Sybase

    ASE installation

    Veriying the Solaris Cluster HA or Sybase ASE Installation and

    Conguration on page 27

    Tune the Solaris Cluster HA or Sybase

    ASE ault monitor

    Tuning the Solaris Cluster HA or Sybase ASE Fault Monitor

    onpage 29

    Overview o Installing and ConfguringSolarisCluster HA or Sybase ASE

    OracleSolarisCluster Data Serviceor SybaseASE Guide May2011, RevisionA12

    http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2682http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850#babeechdhttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850#babeechdhttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850#babeechdhttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850#babeechdhttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850#babeechdhttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2682
  • 8/6/2019 821-2908

    13/52

    Preparing to Install Solaris Cluster HA or Sybase ASETo prepare your nodes or the Solaris Cluster HA or Sybase ASE installation, select aninstallation location or the ollowing les.

    SybaseASEapplicationfles.These les include Sybase ASE binaries and libraries. You caninstall these les on either the local le system or the cluster le system.

    For inormation about the advantages and disadvantages o placing the Sybase ASE binarieson the local le system instead o the cluster le system, see Conguration Guidelines orOracle Solaris Cluster Data Services in Oracle Solaris Cluster Data Services Planning and

    Administration Guide.

    SybaseASE confgurationfles.These les include the interfaces le, config le, andenvironment le. You can install these les on the local le system (with links), the highlyavailable local le system, or on the cluster le system.

    Databasedata fles.These les include Sybase device les. You must install these les on thehighly available local le system or the cluster le system as either raw devices or regularles.

    Note Solaris Cluster HA or Sybase ASE can be installed and congured in the global zoneor non-global zone or x86/x64 and SPARC architectures.

    Installing the Sybase ASE Sotware

    Use the procedures in this section to complete the ollowing tasks. Preparing the nodes or the installation o the Sybase ASE Sotware Installing the Sybase ASE sotware Veriying the Sybase ASE installation

    Note Beore you congure Solaris Cluster HA or Sybase ASE, use the procedures that theOracle Solaris Cluster Sotware Installation Guide describes to congure the Oracle Solaris

    Cluster sotware on each node.

    Note The Solaris Cluster HA or Sybase ASE can be congured to run in a whole root or asparse root non-global zone or x86/x64 and SPARC architectures.

    How to Prepare the Nodes or the Installation o the Sybase ASE Sotware on page 14 How to Install the Sybase ASE Sotware on page 15 How to Veriy the Sybase ASE Installation on page 17

    Installingthe Sybase ASE Sotware

    Chapter 1 Installing and Confguring Solaris Cluster HA or Sybase ASE 13

    http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850#chdhbefjhttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850#chdhbefjhttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850#chdhbefjhttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850#chdhbefjhttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2845http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2845http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850#chdhbefjhttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850#chdhbefjhttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850#chdhbefj
  • 8/6/2019 821-2908

    14/52

    How to Prepare the Nodes or the Installation o theSybase ASE Sotware

    Caution Perorm all o the steps inthis procedure on all o the nodes or zones. I you do not

    perorm all o the steps on all o the nodes or zones, the Sybase ASE installation will be

    incomplete, and Solaris Cluster HA or Sybase ASE will ail during startup.

    Note Consult the Sybase ASE documentation beore you perorm this procedure.

    Become superuser on all o the nodes.

    Confgure the /etc/nsswitch.conf fle as ollows so thatSolaris Cluster HA or Sybase ASE

    starts and stops correctly i a switchover or ailover occurs.

    On each node or zone that can master the logical host that runs Solaris Cluster HA or Sybase

    ASE, include the ollowing entries in the /etc/nsswitch.conf le.passwd: files [NOTFOUND=return] nis [TRYAGAIN=0]

    publickey: files [NOTFOUND=return] nis [TRYAGAIN=0]

    project: files [NOTFOUND=return] nis [TRYAGAIN=0]

    group: files [NOTFOUND=return] nis [TRYAGAIN=0]

    Solaris Cluster HA or Sybase ASE uses the su usercommand to start and stop the databasenode.

    The network inormation name service might become unavailable when a cluster node's publicnetwork ails. Adding the preceding entries ensures that the su(1M) command does not reer to

    the NIS/NIS+ name services i the network inormation name service is unavailable.

    Confgure the cluster fle systemor Solaris Cluster HA or Sybase ASE.

    I raw devices contain the databases, congure the global devices or raw-device access. For

    inormation about how to congure global devices, see Oracle Solaris Cluster SotwareInstallation Guide.

    Note Conguring raw devices on non-global zones is not supported on Oracle Solaris Cluster.

    I you use the Solaris Volume Manager sotware, congure the Sybase ASE sotware to use

    UNIX le system (UFS) logging on mirrored metadevices or raw-mirrored metadevices. For

    inormation about how to congure raw-mirrored metadevices, see the Solaris Volume

    Manager documentation.

    Prepare the SYBASE_HOME directory on a local or multihost disk.

    1

    2

    3

    4

    Installingthe Sybase ASE Sotware

    OracleSolarisCluster Data Serviceor SybaseASE Guide May2011, RevisionA14

    http://www.oracle.com/pls/topic/lookup?ctx=E18752&id=REFMAN1Msu-1mhttp://www.oracle.com/pls/topic/lookup?ctx=E18752&id=REFMAN1Msu-1mhttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2845http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2845http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2845http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2845http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2845http://www.oracle.com/pls/topic/lookup?ctx=E18752&id=REFMAN1Msu-1m
  • 8/6/2019 821-2908

    15/52

    Note I you install the Sybase ASE binaries on a local disk, use a separate disk i possible.

    Installing the Sybase ASE binaries on a separate disk prevents the binaries rom being

    overwritten during reinstallation o the operating system.

    On each node or zone, create an entry or the database administrator (DBA) group in the

    /etc/group fle, and add potential users to the group.

    Veriy that the root and sybase users are members o the dba group, and add entries asnecessary or other DBA users. Ensure that group IDs are the same on all o the nodes or zones

    that run Solaris Cluster HA or Sybase ASE, as the ollowing example illustrates.

    dba:*:520:root,sybase

    You can create group entries in a network name service. I you create entries this way, also addyour entries to the local /etc/group le to eliminate dependency on the network name service.

    On each node or zone, create an entry or the Sybase systemadministrator.

    The ollowing command updates the /etc/passwd and /etc/shadow les with an entry or the

    Sybase system administrator.

    # useradd -u 120 -g dba -d /Sybase-home sybase

    Ensure that the sybase user entry is the same on all o the nodes or zones that run Solaris ClusterHA or Sybase ASE.

    How to Install the Sybase ASE Sotware

    On a cluster node or zone, become superuser or assume a role that provides

    solaris.cluster.modify and solaris.cluster.admin RBAC authorizations.

    I you plan to install the Sybase ASE sotware on the cluster flesystem, startthe Oracle Solaris

    Cluster sotware and become the owner o the disk device group.

    I you plan to install the Sybase ASE sotware at another location, omit this step.

    For more inormation about installation locations, see Preparing to Install Solaris Cluster HAor Sybase ASE on page 13.

    Create a ailover resource group to holdthe network and application resources.

    # clresourcegroup create [-n node-zone-list] resource-group

    -n node-zone-list Species an optional, comma-separated list o physical node names orzones or IDs that identiy potential masters. The order here determinesthe order in which the Resource Group Manager (RGM) considersprimary nodes or zones during ailover.

    5

    6

    1

    2

    3

    Installingthe Sybase ASE Sotware

    Chapter 1 Installing and Confguring Solaris Cluster HA or Sybase ASE 15

  • 8/6/2019 821-2908

    16/52

    resource-group Species the name o the resource group. This name can be your choicebut must be unique or resource groups within the cluster.

    Note Use the -n option to speciy the order o the node list. I all o the nodes in the cluster arepotential masters, you do not need to use the -n option.

    Veriy that you have added all o the network resources that Solaris Cluster HA or Sybase ASE

    uses to either the /etc/inet/hosts fle or to your name service (NIS, NIS+) database.

    Add a network resource (logical hostname or shared address) to the ailover resource group.

    # clreslogicalhostname create -g resource-group -h host_list logical_host

    logical_host Species a resource name o your choice.

    host_list Species a comma-separated list o host names that are to be made available bythe logical host name resource.

    Run the clresourcegroup(1CL) command to complete the ollowing tasks.

    Enabling the resource and ault monitoring Moving the resource group into a managed state Bringing the resource group online

    # clresourcegroup online -M resource-group

    On the node or zone that masters the resource group thatyou just created,log in as sybase.

    The installation o the Sybase binaries must be perormed on the node or zone where the

    corresponding logical host is running.

    Install the Sybase ASE sotware.

    Regardless o where you install the Sybase ASE sotware, modiy each node's /etc/system lesas you would in standard Sybase ASE installation procedures. For instructions about how toinstall the Sybase ASE sotware, reer to the Sybase installation and conguration guides.

    For every Sybase ASE server, speciythe hostname that is associated with a network resource.

    I you do not speciy a host name that is associated with a network resource, Sybase ASE startsonly on the node or zone where the Sybase ASE sotware was installed.

    Some versions o Sybase ASE, such as 12.5, prompt you or the host name. Other versions oSybase ASE, such as 12.5.1, use the physical host name. I your version o Sybase ASE uses thephysical host name, you must change the physical host name to speciy a network resource.

    I the Sybase ASE installer prompts you or the host name, type the host name in response tothe prompt.

    4

    5

    6

    7

    8

    9

    Installingthe Sybase ASE Sotware

    OracleSolarisCluster Data Serviceor SybaseASE Guide May2011, RevisionA16

    http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2679#clresourcegroup-1clhttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2679#clresourcegroup-1clhttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2679#clresourcegroup-1cl
  • 8/6/2019 821-2908

    17/52

    Otherwise, modiy the interfaces le to change the physical host name to a host name thatis associated with a network resource.

    Ater you install the Sybase ASE sotware, go to How to Veriy the Sybase ASE Installation onpage 17.

    How toVeriy the Sybase ASE Installation

    Veriy that thesybase user and the dba group ownthe $SYBASE_HOME directory and$SYBASE_HOME children directories.

    Ater you veriy the Sybase ASE installation, go to Conguring Sybase ASE Database Accessand Creating the Sybase ASE Database Environment on page 17.

    Confguring Sybase ASE Database Access and Creating theSybase ASE Database EnvironmentConguring Sybase ASE database access and creating the Sybase ASE Database Environmentinvolves the ollowing tasks.

    1. Conguring Sybase ASE database access with the volume manager that you are using:

    I you are using Solaris Volume Manager, see How to Congure Sybase ASE Database

    Access With Solaris Volume Manager on page 17. I you are using Veritas Volume Manager (VxVM), see How to Congure Sybase ASE

    Database Access With Veritas Volume Manager on page 18.

    2. Creating the Sybase ASE database environment. See How to Create the Sybase ASEDatabase Environment on page 19.

    How to Confgure Sybase ASE Database Access WithSolaris Volume Manager

    Confgure the disk devices or the Solaris Volume Manager sotware to use.

    For inormation about how to congure Solaris Volume Manager, see Oracle Solaris ClusterSotware Installation Guide.

    NextSteps

    NextSteps

    1

    Confguring Sybase ASE Database Access and Creating the Sybase ASE DatabaseEnvironment

    Chapter 1 Installing and Confguring Solaris Cluster HA or Sybase ASE 17

    http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2845http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2845http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2845http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2845http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2845
  • 8/6/2019 821-2908

    18/52

    I you use raw devices to contain the databases, runthe ollowing commands to change each

    raw-mirrored metadevice's owner, group, and mode.

    I you do not use raw devices, do not perorm this step.

    a. I you create raw devices, run the ollowing commands or each device oneach node that can

    masterthe Sybase ASE resource group.

    # chown sybase /dev/md/metaset/rdsk/dn# chgrp dba /dev/md/metaset/rdsk/dn# chmod 600 /dev/md/metaset/rdsk/dn

    metaset Species the name o the disk set

    /rdsk/dn Species the name o the raw disk device within the metasetdisk set

    b. Veriy that the changesare eective.

    # ls -lL /dev/md/metaset/rdsk/dn

    Goto How to Create the Sybase ASE Database Environment on page 19.

    How to Confgure Sybase ASE Database Access WithVeritas Volume Manager

    Confgure the disk devices or theVxVM sotware to use.

    For inormation about how to congure Veritas Volume Manager, see Oracle Solaris ClusterSotware Installation Guide.

    I you use raw devices to contain the databases, runthe ollowing commands on the current

    disk-group primaryto change each device's owner, group, and mode.

    I you do not use raw devices, do not perorm this step.

    a. I you create raw devices, run the ollowing command or each raw device.

    # vxedit -g diskgroup set user=sybase group=dba mode=0600 volume

    b. Veriy that the changesare eective.

    # ls -lL /dev/vx/rdsk/diskgroup/volume

    c. Reregister the device group with the clusterto keep theVxVM namespace consistent

    throughout the cluster.

    # cldevicegroup create -t VxVM diskgroup

    Goto How to Create the Sybase ASE Database Environment on page 19.

    2

    NextSteps

    1

    2

    NextSteps

    Confguring Sybase ASEDatabaseAccessand Creatingthe Sybase ASE Database Environment

    OracleSolarisCluster Data Serviceor SybaseASE Guide May2011, RevisionA18

    http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2845http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2845http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2845http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2845http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2845
  • 8/6/2019 821-2908

    19/52

    How to Create the Sybase ASE Database EnvironmentThe Sybase ASE database environment consists o the ollowing servers:

    Data server Backup server Monitor server Text server XP server

    Creating the Sybase ASE database environment involves conguring these servers.

    Ensure that you have completed the ollowing tasks.

    Establish a highly available IP address and name, that is, a network resource that operates atinstallation time.

    Locate device paths or all o the Sybase ASE devicesincluding the master device andsystem devicesin the highly available local le system or cluster le system. Conguredevice paths as one o the ollowing le types.

    Regular les Raw devices Files that the Solaris Volume Manager sotware or the VxVM sotware manages

    Locate the Sybase ASE server logs in either the cluster le system or the local le system.

    Ensure that the password or the Sybase ASE system administrator account is correctlyspecied.

    Solaris Cluster HA or Sybase ASE must be able to start and monitor the monitor server. To

    meet this requirement, ensure that the password or the Sybase ASE system administratoraccount (sa) is specied in the le RUN_monitor-server, where monitor-serveris the name othe Sybase ASE monitor server. This name is dened during the Sybase ASE installation. Formore inormation, see your Sybase ASE documentation.

    I you do not set the required password in the RUN_monitor-serverle, the Solaris ClusterHA or Sybase ASE data service cannot start the monitor service. I no password is set or thesa account, you do not need to modiy the RUN_monitor-serverle.

    Create an interfaces le or the cluster.

    The entire cluster must contain only one copy o the interfaces le. The $SYBASE directorycontains the interfaces le. I you plan to maintain per-node le copies, ensure the lecontents are identical.

    All o the clients that connect to Sybase ASE servers connect with Sybase OpenClientlibraries and utilities. When you congure the Sybase ASE sotware, in the interfaces le,enter inormation about the network resource and various ports. All o the clients use this

    connection inormation to connect to the Sybase ASE servers.

    BeoreYouBegin

    Confguring Sybase ASE Database Access and Creating the Sybase ASE DatabaseEnvironment

    Chapter 1 Installing and Confguring Solaris Cluster HA or Sybase ASE 19

  • 8/6/2019 821-2908

    20/52

    Run the GUI-based utility srvbuild to create the Sybase ASE database.

    This utility is contained in the $SYBASE/ASE_major-version/bin directory, where major-versionis the major version o Sybase ASE that you are using. For example, i you are using Sybase ASE

    version 12.5.1, major-version is 12-5.

    For inormation about the srvbuildutility, see the Sybase ASE document Installing SybaseAdaptive Server Enterprise on Sun Solaris 2.x (SPARC).

    To veriy successul database installation, ensure that all o the servers start correctly.

    Run the ps(1) command to veriy the operation o all o the servers. Sybase ASE server logsindicate any errors that have occurred.

    Set the password or the Sybase ASE system administrator account.

    For details about changing the sa login password, see Sybase Adaptive Server Enterprise SystemAdministration Guide.

    Create a new Sybase ASE account or ault monitoring.

    This account enables the ault monitor to perorm the ollowing tasks.

    Supporting queries to system tables Creating and updating user tables

    Note Do not use the sa account or these purposes.

    The ollowing example shows how to create a new Sybase ASE account or ault monitoring.

    # isql -Usa -Psybase -Sasedb1> use master2> go1> create database sc3xdb2>go1> sp_addlogin dbmon, dbmonp, sc3xdb2> go1> use sc3xdb2> go1> sp_changedbowner dbmon

    2> go1> sp_modifylogin dbmon, defdb, sc3xdb2> go1> exit

    For more inormation, see Tuning the Solaris Cluster HA or Sybase ASE Fault Monitor onpage 29.

    1

    2

    3

    4

    Confguring Sybase ASEDatabaseAccessand Creatingthe Sybase ASE Database Environment

    OracleSolarisCluster Data Serviceor SybaseASE Guide May2011, RevisionA20

    I t lli th S l i Cl t HA S b ASE P k

    http://www.oracle.com/pls/topic/lookup?ctx=E18752&id=REFMAN1ps-1http://www.oracle.com/pls/topic/lookup?ctx=E18752&id=REFMAN1ps-1http://www.oracle.com/pls/topic/lookup?ctx=E18752&id=REFMAN1ps-1
  • 8/6/2019 821-2908

    21/52

    Update the stop fle with the sa password.

    Because the stop le contains the sa password, protect the le with the appropriate permissions,and place the le in a directory that the system administrator chooses. Enable only the sybaseuser to read, write, and execute the stop le.

    For more inormation about the stop le, see Solaris Cluster HA or Sybase ASE SecurityIssues on page 29.

    Ater you create the Sybase ASE database environment, go to Installing the Solaris Cluster HAor Sybase ASE Packages on page 21.

    Installing the Solaris Cluster HA or Sybase ASE PackagesI you did not install the Solaris Cluster HA or Sybase ASE packages during your initial OracleSolaris Cluster installation, perorm this procedure to install the packages. To install thepackages, use the installer program.

    Note You need to install the Solaris Cluster HA or Sybase ASE packages in the global clusterand not in the zone cluster.

    How to Install the Solaris Cluster HA or Sybase ASEPackages

    Perorm this procedure on each cluster node where you want the Solaris Cluster HA or SybaseASE sotware to run.

    You can run the installer program with a command-line interace (CLI) or with a graphicaluser interace (GUI). The content and sequence o instructions in the CLI and the GUI aresimilar.

    Note Even i you plan to congure this data service to run in non-global zones, install thepackages or this data service in the global zone. The packages are propagated to any existingnon-global zones and to any non-global zones that are created ater you install the packages.

    Ensure that you have the Oracle Solaris Cluster installation media.

    I you intend to run the installer program with a GUI, ensure that your DISPLAY environmentvariable is set.

    5

    NextSteps

    BeoreYouBegin

    Installing the Solaris Cluster HA or Sybase ASE Packages

    Chapter 1 Installing and Confguring Solaris Cluster HA or Sybase ASE 21

    Installingthe Solaris Cluster HA or Sybase ASE Packages

  • 8/6/2019 821-2908

    22/52

    On the cluster node where you areinstallingthe data service packages, become superuser.

    Load the Oracle Solaris Cluster installation media into the DVD-ROM drive.

    I the Volume Management daemon vold(1M) is running and congured to manageDVD-ROM devices, the daemon automatically mounts the DVD-ROM on the /cdromdirectory.

    Change to the installation wizarddirectory o the DVD-ROM.

    I you areinstalling the data service packages on the SPARC platorm, typethe ollowing

    command:

    # cd /cdrom/cdrom0/Solaris_sparc

    I you areinstalling the data service packages on the x86 platorm, typethe ollowing

    command:

    # cd /cdrom/cdrom0/Solaris_x86

    Start the installation wizard.

    #./installer

    When you areprompted, accept the license agreement.

    From the list o Oracle Solaris Cluster agents under AvailabilityServices, select the data service

    or Sybase ASE.

    I you require support or languages other than English, select the option to install multilingual

    packages.

    English language support is always installed.

    When prompted whether to confgure the data service now or later, choose Confgure Later.

    Choose Congure Later to perorm the conguration ater the installation.

    Follow the instructions on the screen to install the data service packages on the node.

    The installation wizard displays the status o the installation. When the installation is complete,the wizard displays an installation summary and the installation logs.

    (GUI only) I you do not want to register the product and receive productupdates, deselect the

    Product Registration option.

    The Product Registration option is not available with the CLI. I you are running the installationwizard with the CLI, omit this step.

    Exit the installation wizard.

    1

    2

    3

    4

    5

    6

    7

    8

    9

    10

    11

    Installingthe Solaris Cluster HA or Sybase ASE Packages

    OracleSolarisCluster Data Serviceor SybaseASE Guide May2011, RevisionA22

    Registering and Confguring Solaris Cluster HA or Sybase ASE

    http://www.oracle.com/pls/topic/lookup?ctx=E18752&id=REFMAN1Mvold-1mhttp://www.oracle.com/pls/topic/lookup?ctx=E18752&id=REFMAN1Mvold-1mhttp://www.oracle.com/pls/topic/lookup?ctx=E18752&id=REFMAN1Mvold-1m
  • 8/6/2019 821-2908

    23/52

    Unload the installation media rom the DVD-ROM drive.

    a. To ensure thatthe DVD-ROM is not beingused, change to a directory that doesnotreside on

    the DVD-ROM.

    b. Ejectthe DVD-ROM.

    # eject cdrom

    Registering and Confguring Solaris Cluster HA or Sybase ASERegister and congure Solaris Cluster HA or Sybase ASE as a ailover data service.

    Setting Solaris Cluster HA or Sybase ASE ExtensionProperties

    The section that ollows contains instructions or registering and conguring resources. These

    instructions explain how to set only extension properties that Solaris Cluster HA or Sybase ASErequires you to set. For inormation about all Solaris Cluster HA or Sybase ASE extensionproperties, see Appendix A, Solaris Cluster HA or Sybase ASE Extension Properties. You canupdate some extension properties dynamically. You can update other properties, however, onlywhen you create or disable a resource. The Tunable entry indicates when you can update aproperty.

    To set an extension property o a resource, include the ollowing option in the

    clresource(1CL) command that creates or modies the resource:

    -p property=value

    -pproperty Identies the extension property that you are setting

    value Species the value to which you are setting the extension property

    You can also use the procedures in Chapter 2, Administering Data Service Resources, in

    Oracle Solaris Cluster Data Services Planning and Administration Guide to congure resourcesater the resources are created.

    How to Register and Confgure Solaris Cluster HA orSybase ASE

    This procedure describes how to use the Oracle Solaris Cluster maintenance commands to

    register and congure Solaris Cluster HA or Sybase ASE.

    12

    Registering and Confguring Solaris Cluster HA or Sybase ASE

    Chapter 1 Installing and Confguring Solaris Cluster HA or Sybase ASE 23

    Registering and Confguring Solaris Cluster HA or Sybase ASE

    http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2679#clresource-1clhttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2679#clresource-1clhttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850#c40000082398http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850#c40000082398http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850#c40000082398http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850#c40000082398http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2679#clresource-1cl
  • 8/6/2019 821-2908

    24/52

    This procedure includes creating the SUNW.HAStoragePlus resource type. This resource typesynchronizes actions between HAStorage and Solaris Cluster HA or Sybase ASE and enablesyou to use a highly available local le system. Solaris Cluster HA or Sybase ASE is disk

    intensive, and thereore you should congure the SUNW.HAStoragePlus resource type.

    For more inormation about the SUNW.HAStoragePlus resource type, see the ollowingdocumentation:

    SUNW.HAStoragePlus(5) man page

    Relationship Between Resource Groups and Device Groups in Oracle Solaris Cluster DataServices Planning and Administration Guide

    Note Other options also enable you to register and congure the data service. For details aboutthese options, see Tools or Data Service Resource Administration in Oracle Solaris ClusterData Services Planning and Administration Guide.

    To perorm this procedure, you must have the ollowing inormation.

    The names o the cluster nodes or zones that master the data service. The network resource that clients use to access the data service. You typically congure the

    IP address when you install the cluster. For inormation about planning the Oracle SolarisCluster environment and the installation o the Solaris sotware, see Chapter 1, Planningthe Oracle Solaris Cluster Conguration, in Oracle Solaris Cluster Sotware InstallationGuide.

    The path to the Sybase ASE application installation.

    Note Perorm the ollowing steps on one cluster node or zone.

    On a cluster node or zone, become superuser or assume a role that provides

    solaris.cluster.modify and solaris.cluster.admin RBAC authorizations.

    Run the clresourcetype command to register resource types or Solaris Cluster HA or Sybase

    ASE.

    # clresourcetype register SUNW.sybase

    Register the SUNW.HAStoragePlus resource typewith the cluster.

    # clresourcetype register SUNW.HAStoragePlus

    Create the resource sybase-hastp-rs o type SUNW.HAStoragePlus.

    # clresource create -g sybase-rg -t SUNW.HAStoragePlus \-p GlobalDevicePaths=sybase-device-group1,/dev/global/dsk/dl \

    1

    2

    3

    4

    g g g g y

    OracleSolarisCluster Data Serviceor SybaseASE Guide May2011, RevisionA24

    Registering and Confguring Solaris Cluster HA or Sybase ASE

    http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2679#sunw.hastorageplus-5http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2679#sunw.hastorageplus-5http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850#bcggabjahttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850#bcggabjahttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850#bcggabjahttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850#babejfcchttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850#babejfcchttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850#babejfcchttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2845#z40000f557ahttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2845#z40000f557ahttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2845#z40000f557ahttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2845#z40000f557ahttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2845#z40000f557ahttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2845#z40000f557ahttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2845#z40000f557ahttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2845#z40000f557ahttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850#babejfcchttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850#babejfcchttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850#bcggabjahttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850#bcggabjahttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2679#sunw.hastorageplus-5
  • 8/6/2019 821-2908

    25/52

    -p FilesystemMountPoints=/global/sybase-inst \-p AffinityOn=TRUE sybase-hastp-rs

    The resource is created in the enabled state.

    Note AffinityOn must beset to TRUE and the local le system must reside on global diskgroups to be ailover.

    Run the clresourcegroup command to complete the ollowing tasks and bring the resource

    group sybase-rg online on a cluster node or zone.

    Moving the resource group into a managed state Bringing the resource group online

    This node becomes the primary or device group sybase-set1 and raw device/dev/global/dsk/d1. Device groups that are associated with le systems such as/global/sybase-inst are also made primaries on this node.

    # clresourcegroup online -M sybase-rg

    Create Sybase ASE application resources in the ailover resource group.# clresource create -g resource-group \-t SUNW.sybase \-p Environment_File=environment-fle-path \-p Adaptive_Server_Name=adaptive-server-name \-p Backup_Server_Name=backup-server-name \-p Text_Server_Name=text-server-name \-p Monitor_Server_Name=monitor-server-name \-p Adaptive_Server_Log_File=log-fle-path \-p Stop_File=stop-fle-path \

    -p Connect_string=user/passwd \-p resource_dependencies_offline_restart=storageplus-resource \-p Wait_for_Online=TRUE \-p DB_Wait_List=db1, db2, ... \-p Restart_type=RESOURCE_RESTART|RESOURCE_GROUP_RESTART\-p Custom_action_file=flepath resource

    -g resource-groupSpecies the resource group name into which the RGM places the resources.

    -t SUNW.sybase

    Species the resource type to add.

    -p Environment_File=environment-fleSets the name o the environment le.

    -p Adaptive_Server_Name=adaptive-server-nameSets the name o the adaptive server.

    -p Backup_Server_Name=backup-server-name

    Sets the name o the backup server.

    5

    6

    Chapter 1 Installing and Confguring Solaris Cluster HA or Sybase ASE 25

    Registering and Confguring Solaris Cluster HA or Sybase ASE

  • 8/6/2019 821-2908

    26/52

    -p Text_Server_Name=text-server-nameSets the name o the text server.

    -p Monitor_Server_Name=monitor-server-nameSets the name o the monitor server.

    -p Adaptive_Server_Log_File=log-fle-pathSets the path to the log le or the adaptive server.

    -p Stop_File=stop-fle-pathSets the path to the stop le.

    -p Connect_string=user/passwd

    Species the user name and password that the ault monitor uses to connect to the database.

    -p Wait_for_Online=TRUE

    Species whether the START method has to wait or the database to be brought online beoreexiting.

    -p DB_Wait_List=db1, db2, ...Species the list o databases that need to be online beore the resource can be broughtonline. The valid values are either an empty list ( ), ALL, or a list o databases.

    -p Restart_type=RESOURCE_RESTART|RESOURCE_GROUP_RESTARTDenes the restart behavior o the resource. I the Restart_type extension property is set toRESOURCE_RESTART, the server ault monitor restarts the database server resource. I theRestart_type extension property is set to RESOURCE_GROUP_RESTART, the server aultmonitor restarts the database server resource group. This property was introduced inSUNW.sybase resource type version 5. Prior to and including SUNW.sybase resource typeversion 5, the server ault monitor restarted the database server resource group.

    -p Custom_action_file=flepathSets the path to the custom action le that contains the custom ault monitor actions.

    resourceSpecies the resource name to add.

    The resource is created in the enabled state.

    You do not have to speciy extension properties that have deault values. For more inormation,

    see Setting Solaris Cluster HA or Sybase ASE Extension Properties on page 23.

    Ater you register and congure Solaris Cluster HA or Sybase ASE, go to Veriying the SolarisCluster HA or Sybase ASE Installation and Conguration on page 27.

    NextSteps

    OracleSolarisCluster Data Serviceor SybaseASE Guide May2011, RevisionA26

    Veriyingthe Solaris Cluster HA or Sybase ASE Installation and Confguration

  • 8/6/2019 821-2908

    27/52

    Veriying the Solaris Cluster HA or Sybase ASE Installationand Confguration

    These checks ensure that all o the nodes that run Solaris Cluster HA or Sybase ASE can start

    the Sybase ASE data server. These checks also ensure that other nodes in the conguration can

    access the Sybase ASE data server. Perorm these checks to isolate any problems with starting

    the Sybase ASE sotware rom Solaris Cluster HA or Sybase ASE.

    How toVeriy the Solaris Cluster HA or Sybase ASEInstallation and Confguration

    Log in to the node that masters the Sybase ASE resource group.

    Set the Sybase ASE environment variables.

    The environment variables are the variables that you speciy with the Environment_file

    extension property. For inormation about setting these environment variables, seeAppendix A, Solaris Cluster HA or Sybase ASE Extension Properties.

    Veriy that the Solaris Cluster HA or Sybase ASE resource is online.

    # clresource status

    Inspect the Sybase ASE logs to determine the cause o any errors that have occurred.

    Confrm that you canconnect to the data server and execute the ollowing test command.

    # isql -S adaptive-server -U sa -P password

    isql> sp_help

    isql> go

    isql> quit

    Kill the process or the Sybase ASE data server.

    The Oracle Solaris Cluster sotware restarts the process.

    Switchthe resource group that contains the Sybase ASE resource to another cluster node or

    zone.

    # clresourcegroup switch -n node[:zone] resource-group

    Log in to the node thatnow contains the resource group.

    Repeat Step 3 and Step 5.

    1

    2

    3

    4

    5

    6

    7

    8

    9

    Chapter 1 Installing and Confguring Solaris Cluster HA or Sybase ASE 27

    Solaris Cluster HA or Sybase ASE Logging and Security Issues

  • 8/6/2019 821-2908

    28/52

    Note Sybase ASE client connections cannot survive a Solaris Cluster HA or Sybase ASEswitchover. I a switchover occurs, the existing client connections to Sybase ASE terminate, and

    clients must reestablish their connections. Ater a switchover, the time that is required to replaythe Sybase ASE transaction log determines Solaris Cluster HA or Sybase ASE recovery time.

    Location o Solaris Cluster HA or Sybase ASE Log Files

    Each instance o the Solaris Cluster HA or Sybase ASE data service maintains log les in the/opt/SUNWscsyb/log directory.

    These les contain inormation about actions that the Solaris Cluster HA or Sybase ASE dataservice perorms. Reer to these les to obtain diagnostic inormation or troubleshooting yourconguration or to monitor the behavior o the Solaris Cluster HA or Sybase ASE data service.

    See also Solaris Cluster HA or Sybase ASE Logging Issues on page 28.

    Solaris Cluster HA or Sybase ASE Logging and Security IssuesThe ollowing sections contain inormation about Solaris Cluster HA or Sybase ASE loggingand security issues.

    Solaris Cluster HA or Sybase ASE Logging Issues on page 28 Solaris Cluster HA or Sybase ASE Security Issues on page 29

    Solaris Cluster HA or Sybase ASE Logging Issues

    Solaris Cluster HA or Sybase ASE logs messages to the le message_log in the/opt/SUNWscsyb/log directory. Although this le cannot exceed 512 Kbytes, Solaris ClusterHA or Sybase ASE does not delete old log les. The number o log les, thereore, can grow to alarge number.

    Solaris Cluster HA or Sybase ASE writes all o the error messages in the syslog le. SolarisCluster HA or Sybase ASE also logs ault monitor history to the le restart_history in thelog directory. These les can also grow to a large number.

    As part o your regular le maintenance, check the ollowing log les and remove les that youno longer need.

    syslog

    message_log

    restart_history

    OracleSolarisCluster Data Serviceor SybaseASE Guide May2011, RevisionA28

    Tuning the Solaris Cluster HA or Sybase ASE Fault Monitor

  • 8/6/2019 821-2908

    29/52

    Solaris Cluster HA or Sybase ASE Security IssuesSolaris Cluster HA or Sybase ASE requires that you embed the system administrator's

    password in a stop le. The /opt/SUNWscsyb/bin directory contains the template or the stople, sybase_stop_servers. Solaris Cluster HA or Sybase ASE uses this le to log in to theSybase ASE environment and to stop the Sybase ASE servers. Enable the sybase user to executethe stop le, but protect the le rom general access. Give read, write, and execute privileges toonly the ollowing users.

    sybase user sybase group

    Tuning the Solaris Cluster HA or Sybase ASE Fault MonitorThe Solaris Cluster HA or Sybase ASE ault monitor queries the Sybase ASE server todetermine server health.

    Note The Solaris Cluster HA or Sybase ASE ault monitor monitors only the Adaptive server.

    The ault monitor does not monitor auxiliary servers.

    The Solaris Cluster HA or Sybase ASE ault monitor is contained in the resource thatrepresents Sybase ASE. You create this resource when you register and congure Solaris ClusterHA or Sybase ASE. For more inormation, see Registering and Conguring Solaris ClusterHA or Sybase ASE on page 23.

    System properties and extension properties o this resource control the behavior o the aultmonitor. The deault values o these properties determine the preset behavior o the aultmonitor. The preset behavior should be suitable or most Oracle Solaris Cluster installations.Thereore, you should tune the Solaris Cluster HA or Sybase ASE ault monitor only i youneed to modiy this preset behavior.

    Tuning the Solaris Cluster HA or Sybase ASE ault monitor involves the ollowing tasks:

    Setting the interval between ault monitor probes

    Setting the timeout or ault monitor probes Dening the criteria or persistent aults Speciying the ailover behavior o a resource

    Perorm these tasks when you register and congure Solaris Cluster HA or Sybase ASE. Formore inormation, see the ollowing sections:

    Registering and Conguring Solaris Cluster HA or Sybase ASE on page 23

    Tuning Fault Monitors or Oracle Solaris Cluster Data Services in Oracle Solaris Cluster

    Data Services Planning and Administration Guide

    Chapter 1 Installing and Confguring Solaris Cluster HA or Sybase ASE 29

    Tuning the Solaris Cluster HA or Sybase ASE Fault Monitor

    http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850#babhbifihttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850#babhbifihttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850#babhbifihttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850#babhbifihttp://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2850#babhbifi
  • 8/6/2019 821-2908

    30/52

    The Solaris Cluster HA or Sybase ASE ault monitor consists o the ollowing processes.

    Main ault-monitor process Database-client ault probe

    Main Fault-Monitor Process

    The ault monitor process diagnoses errors and checks statistics. The monitor labels anoperation successul i the ollowing conditions occur.

    The database is online. The activity check returns no errors. The test transaction returns no errors.

    I an operation ails, the main process checks the action table or an action to perorm and thenperorms the predetermined action. I an operation ails, the main process can perorm theollowing actions.

    1. Restarting the resource on the current node

    2. Restarting the resource group on the current node

    3. Failing over the resource group to the next node on the resource group's node list

    These actions execute external programs as separate processes in the background.

    The server ault monitor also scans the Adaptive_Server_Log le and corrects any errors thatthe scan identies.

    Database-Client Fault Probe

    The database-client ault probe perorms activity checks and test transactions. The extensionpropertyConnect_string species an account that perorms all o the database operations. Theextension propertyProbe_timeout sets the time-out value that the probe uses to determine thetime that has elapsed in a successul database probe.

    Obtaining Core Files orTroubleshooting

    To acilitate troubleshooting o unexplained DBMS timeouts, you can enable the ault monitorto create a core le when a probe timeout occurs. The contents o the core le relate to the aultmonitor process. The ault monitor creates the core le in the / directory. To enable the aultmonitor to create a core le, use the coreadm command to enable set-id core dumps. For more

    inormation, see the coreadm(1M) man page.

    OracleSolarisCluster Data Serviceor SybaseASE Guide May2011, RevisionA30

    Customizing the Solaris Cluster HA or Sybase ASE Fault Monitor

    http://www.oracle.com/pls/topic/lookup?ctx=E18752&id=REFMAN1Mcoreadm-1mhttp://www.oracle.com/pls/topic/lookup?ctx=E18752&id=REFMAN1Mcoreadm-1mhttp://www.oracle.com/pls/topic/lookup?ctx=E18752&id=REFMAN1Mcoreadm-1m
  • 8/6/2019 821-2908

    31/52

    Customizing the Solaris Cluster HA or Sybase ASE FaultMonitor

    Customizing the Solaris Cluster HA or Sybase ASE ault monitor enables you to modiy thebehavior o the server ault monitor as ollows:

    Overriding the preset action or an error Speciying an action or an error or which no action is preset

    Caution Beore you customize the Solaris Cluster HA or Sybase ASE ault monitor, consider

    the eects o your customizations, especially i you change an action rom restart or switch overto ignore or stop monitoring. I errors remain uncorrected or long periods, the errors mightcause problems with the database. I you encounter problems with the database atercustomizing the Solaris Cluster HA or Sybase ASE ault monitor, revert to using the presetactions. Reverting to the preset actions enables you to determine i the problem is caused byyour customizations.

    Customizing the Solaris Cluster HA or Sybase ASE ault monitor involves the ollowingactivities:

    Dening Custom Behavior or Errors on page 31 Propagating a Custom Action File to All Nodes in a Cluster on page 39 Speciying the Custom Action File That a Server Fault Monitor Should Use on page 40

    Defning Custom Behavior or ErrorsThe Solaris Cluster HA or Sybase ASE ault monitor detects the ollowing types o errors:

    DBMS errors that occur during a probe o the database by the server ault monitor

    Alerts that Sybase ASE logs in the Sybase ASE log le

    Timeouts that result rom a ailure to receive a response within the time that is set by theProbe_timeout extension property

    To dene custom behavior or these types o errors, create a custom action le.

    Custom Action File Format

    A custom action le is a plain text le. The le contains one or more entries that dene thecustom behavior o the Solaris Cluster HA or Sybase ASE ault monitor. Each entry denes thecustom behavior or a single DBMS error, a single timeout error, or several logged alerts. A

    maximum o 1024 entries is allowed in a custom action le.

    Chapter 1 Installing and Confguring Solaris Cluster HA or Sybase ASE 31

    Customizing the Solaris Cluster HA or Sybase ASE Fault Monitor

  • 8/6/2019 821-2908

    32/52

    Note Each entry in a custom action le overrides the preset action or an error, or species anaction or an error or which no action is preset. Create entries in a custom action le only or

    the preset actions that you are overriding or or errors or which no action is preset. Do notcreate entries or actions that you are not changing.

    An entry in a custom action le consists o a sequence o keyword-value pairs that are separatedby semicolons. Each entry is enclosed in braces.

    The ormat o an entry in a custom action le is as ollows:

    {[ERROR_TYPE=DBMS_ERROR|SCAN_LOG|TIMEOUT_ERROR;]ERROR=error-spec;[ACTION=SWITCH|RESTART|STOP|NONE;][CONNECTION_STATE=co|di|on|*;][NEW_STATE=co|di|on|*;][MESSAGE="message-string"]}

    White space might be used between separated keyword-value pairs and between entries to

    ormat the le.

    The meaning and permitted values o the keywords in a custom action le are as ollows:

    ERROR_TYPE

    Indicates the type o the error that the server ault monitor has detected. The ollowingvalues are permitted or this keyword:

    DBMS_ERROR Species that the error is a DBMS error.

    SCAN_LOG Species that the error is an alert that is logged in the alert log le.

    TIMEOUT_ERROR Species that the error is a timeout.

    The ERROR_TYPE keyword is optional. I you omit this keyword, the error is assumed to be aDBMS error.

    ERROR

    Identies the error. The data type and the meaning oerror-spec are determined by the value

    o the ERROR_TYPE keyword as shown in the ollowing table.

    Error_Type Keyword Data Type Meaning

    DBMS_ERROR Integer The e rror n umber o a DBMS e rror t hat i s generated by

    Sybase ASE

    SCAN_LOG Quoted regular

    expression

    A string in an error message that Sybase ASE has

    logged to the Sybase ASE log le

    OracleSolarisCluster Data Serviceor SybaseASE Guide May2011, RevisionA32

  • 8/6/2019 821-2908

    33/52

    Customizing the Solaris Cluster HA or Sybase ASE Fault Monitor

  • 8/6/2019 821-2908

    34/52

    * Species that the state o the connection must remain unchanged.

    co Species that the server ault monitor must disconnect rom the database andreconnect immediately to the database.

    di Species that the server ault monitor must disconnect rom the database. The serverault monitor reconnects when it next probes the database.

    The NEW_STATE keyword is optional. I you omit this keyword, the state o the databaseconnection remains unchanged ater the error is detected.

    MESSAGE

    Species an additional message that is printed to the resource's log le when this error is

    detected. The message must be enclosed in double quotes. This message is additional to thestandard message that is dened or the error.

    The MESSAGE keyword is optional. I you omit this keyword, no additional message is printedto the resource's log le when this error is detected.

    Changing the Response to a DBMS Error

    The action that the server ault monitor perorms in response to each DBMS error is preset aslisted in Table B1. To determine whether you need to change the response to a DBMS error,consider the eect o DBMS errors on your database to determine i the preset actions areappropriate. For examples, see the subsections that ollow.

    To change the response to a DBMS error, create an entry in a custom action le in which thekeywords are set as ollows:

    ERROR_TYPE is setto DBMS_ERROR.

    ERROR is set to the error number o the DBMS error. ACTION is set to the action that you require.

    Responding to an Error Whose Eects Are Major

    I an error that the server ault monitor ignores aects more than one session, action by theserver ault monitor might be required to prevent a loss o service.

    For example, see the ollowing error message:

    Illegal attempt to change contents of buffer: %S_BUF.

    No action is preset or Sybase error 835, Illegal attempt to change contents of buffer:%S_BUF. However, this Sybase error indicates that the when a client process completes, AdaptiveServer perorms some cleanup tasks such as closing the buers and releasing the resourcestaken up by the buers. I the client process terminates abnormally, however (or example i theprocess is killed during execution), Adaptive Server might be unable to carry out the

    appropriate cleanup, buers are let open, and Error 835 is raised. I this error aects only a

    OracleSolarisCluster Data Serviceor SybaseASE Guide May2011, RevisionA34

  • 8/6/2019 821-2908

    35/52

    Customizing the Solaris Cluster HA or Sybase ASE Fault Monitor

  • 8/6/2019 821-2908

    36/52

    EXAMPLE 12 Ignoring a DBMS Error

    {ERROR_TYPE=DBMS_ERROR;ERROR=804;ACTION=none;CONNECTION_STATE=*;NEW_STATE=*;MESSAGE="Unable to find buffer 0x%lx holding logical page %ld in sdes0x%lx kept buffer pool for object %.*s.";}

    This example shows an entry in a custom action le that overrides the preset action or DBMSerror 804. This entry species the ollowing behavior:

    The server ault monitor ignores DBMS error 804. This entry applies regardless o the state o the connection between the database and the

    server ault monitor when the error is detected.

    The state o the connection between the database and the server ault monitor must remainunchanged ater the error is detected.

    No additional message is printed to the resource's log le when this error is detected.

    Changing the Response to Logged Alerts

    The Sybase ASE sotware logs alerts in a le that is identied by the Adaptive_Server_Log_File extension property. The server ault monitor scans this le and perorms actions inresponse to alerts or which an action is dened.

    Logged alerts or which an action is preset are listed in Table B2. Change the response tologged alerts to change the preset action, or to dene new alerts to which the server ault

    monitor responds.To change the response to logged alerts, create an entry in a custom action le in which thekeywords are set as ollows:

    ERROR_TYPE is setto SCAN_LOG.

    ERROR is set to a quoted regular expression that identies a string in an error message thatSybase ASE has logged to the Sybase ASE log le.

    ACTIONis set to the action that you require.

    The server ault monitor processes the entries in a custom action le in the order in which theentries occur. Only the rst entry that matches a logged alert is processed. Later entries thatmatch are ignored. I you are using regular expressions to speciy actions or several loggedalerts, ensure that more specic entries occur beore more general entries. Specic entries thatoccur ater general entries might be ignored.

    For example, a custom action le might dene dierent actions or errors that are identied by

    the regular expressions Attempt to dirty non-log and Attempt to unhash buffer. To

    OracleSolarisCluster Data Serviceor SybaseASE Guide May2011, RevisionA36

  • 8/6/2019 821-2908

    37/52

    Customizing the Solaris Cluster HA or Sybase ASE Fault Monitor

  • 8/6/2019 821-2908

    38/52

    Note You are not required to create an entry or the rst timed-out probe. The action that theserver ault monitor perorms in response to the rst timed-out probe is preset.

    For the last allowed timed-out probe, create an entry in which the keywords are set as ollows:

    ERROR_TYPE is setto TIMEOUT_ERROR.

    ERROR is set to the maximum number o consecutive timed-out probes that are allowed.

    ACTION is set to RESTART.

    For each remaining consecutive timed-out probe except the rst timed-out probe, create anentry in which the keywords are set as ollows:

    ERROR_TYPE is setto TIMEOUT_ERROR.

    ERROR is set to the sequence number o the timed-out probe. For example, or the secondconsecutive timed-out probe, set this keyword to 2. For the third consecutive timed-outprobe, set this keyword to 3.

    ACTION is set to NONE.

    Tip To acilitate debugging, speciy a message that indicates the sequence number o thetimed-out probe.

    The ollowing example shows the entries in a custom action le or increasing the maximumnumber o consecutive timed-out probes to ve.

    EXAMPLE 14 Changing the Maximum Number o ConsecutiveTimed-Out Probes{ERROR_TYPE=TIMEOUT;ERROR=2;ACTION=NONE;CONNECTION_STATE=*;NEW_STATE=*;MESSAGE="Timeout #2 has occurred.";}

    {ERROR_TYPE=TIMEOUT;ERROR=3;ACTION=NONE;CONNECTION_STATE=*;NEW_STATE=*;MESSAGE="Timeout #3 has occurred.";}

    {ERROR_TYPE=TIMEOUT;

    ERROR=4;

    OracleSolarisCluster Data Serviceor SybaseASE Guide May2011, RevisionA38

    Ch i h M i N b C i Ti d O P b (C i d)

    Customizing the Solaris Cluster HA or Sybase ASE Fault Monitor

  • 8/6/2019 821-2908

    39/52

    EXAMPLE 14 Changing the Maximum Number o Consecutive Timed-Out Probes (Continued)

    ACTION=NONE;CONNECTION_STATE=*;

    NEW_STATE=*;MESSAGE="Timeout #4 has occurred.";}

    {ERROR_TYPE=TIMEOUT;ERROR=5;ACTION=RESTART;CONNECTION_STATE=*;NEW_STATE=*;MESSAGE="Timeout #5 has occurred. Restarting.";}

    This example shows the entries in a custom action le or increasing the maximum number oconsecutive timed-out probes to ve. These entries speciy the ollowing behavior:

    The server ault monitor ignores the second consecutive timed-out probe through theourth consecutive timed-out probe.

    In response to the th consecutive timed-out probe, the server ault monitor perorms arestart.

    The entries apply regardless o the state o the connection between the database and theserver ault monitor when the timeout occurs.

    The state o the connection between the database and the server ault monitor must remainunchanged ater the timeout occurs.

    When the second consecutive timed-out probe through the ourth consecutive timed-outprobe occurs, a message o the ollowing orm is printed to the resource's log le:

    Timeout #number has occurred. When the th consecutive timed-out probe occurs, the ollowing message is printed to the

    resource's log le:

    Timeout #5 has occurred. Restarting.

    Propagating a Custom Action File to All Nodes in a

    ClusterA server ault monitor must behave consistently on all cluster nodes or zones. Thereore, thecustom action le that the server ault monitor uses must be identical on all cluster nodes orzones. Ater creating or modiying a custom action le, ensure that this le is identical on allcluster nodes or zones by propagating the le to all cluster nodes or zones. To propagate the leto all cluster nodes or zones, use the method that is most appropriate or your clusterconguration:

    Locating the le on a le system that all nodes or zones share

    Chapter 1 Installing and Confguring Solaris Cluster HA or Sybase ASE 39

    L ti th l hi hl il bl l l l t

    Customizing the Solaris Cluster HA or Sybase ASE Fault Monitor

  • 8/6/2019 821-2908

    40/52

    Locating the le on a highly available local le system

    Copying the le to the local le system o each cluster node or zone by using operatingsystem commands such as the rcp(1) command or the rdist(1) command

    Speciying the Custom Action File That a Server FaultMonitor Should Use

    To apply customized actions to a server ault monitor, you must speciy the custom action lethat the ault monitor should use. Customized actions are applied to a server ault monitor

    when the server ault monitor reads a custom action le. A server ault monitor reads a customaction le when the you speciy the le.

    Speciying a custom action le also validates the le. I the le contains syntax errors, an errormessage is displayed. Thereore, ater modiying a custom action le, speciy the le again tovalidate the le.

    Caution I syntax errors in a modied custom action le are detected, correct the errors beore

    the ault monitor is restarted. I the syntax errors remain uncorrected when the ault monitor isrestarted, the ault monitor reads the erroneous le, ignoring entries that occur ater the rstsyntax error.

    How to Speciy the Custom Action FileThat a Server Fault MonitorShould Use

    On a cluster node or zone, become superuser or assume a role that providessolaris.cluster.modify RBAC authorization.

    Set the Custom_action_file extension property o the SUNW.sybase resource.

    Set this property to the absolute path o the custom action le.

    # clresource set -p custom_action_file= flepath server-resource

    -p custom_action_file=flepath

    Species the absolute path o the custom action le.

    server-resourceSpecies the SUNW.sybase resource.

    1

    2

    OracleSolarisCluster Data Serviceor SybaseASE Guide May2011, RevisionA40

    http://www.oracle.com/pls/topic/lookup?ctx=E18752&id=REFMAN1rcp-1http://www.oracle.com/pls/topic/lookup?ctx=E18752&id=REFMAN1rcp-1http://www.oracle.com/pls/topic/lookup?ctx=E18752&id=REFMAN1rdist-1http://www.oracle.com/pls/topic/lookup?ctx=E18752&id=REFMAN1rdist-1http://www.oracle.com/pls/topic/lookup?ctx=E18752&id=REFMAN1rdist-1http://www.oracle.com/pls/topic/lookup?ctx=E18752&id=REFMAN1rcp-1
  • 8/6/2019 821-2908

    41/52

    Solaris Cluster HA or Sybase ASE ExtensionProperties

    For details about system-dened properties, see the r_properties(5) man page and therg_properties(5) man page.

    The SUNW.sybase resource type represents the Sybase ASE application in a Oracle SolarisCluster conguration. The extension properties o this resource type are as ollows:

    Adaptive_Server_Log_ FileThe path to the log le or the adaptive server. Solaris Cluster HA or Sybase ASE continuallyreads this property or error monitoring.

    Deault:None

    Range:Minimum=1

    Tunable:When disabled

    Adaptive_Server_Name

    The name o the data server. Solaris Cluster HA or Sybase ASE uses this property to locatethe RUN server in the $SYBASE/$ASE/install directory.

    Deault:None

    Range:Minimum=1

    Tunable:Any time

    Backup_Server_Name

    The name o the backup server. Solaris Cluster HA or Sybase ASE uses this property tolocate the RUN server in the $SYBASE/$ASE/install directory. I you do not set this property,Solaris Cluster HA or Sybase ASE will not manage the server.

    Deault: Null

    Range:None

    Tunable:When disabled

    AA P P E N D I X A

    41

    Connect cycle

    Solaris Cluster HA or Sybase ASE ExtensionProperties

    http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2679#r-properties-5http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2679#r-properties-5http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2679#rg-properties-5http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2679#rg-properties-5http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2679#rg-properties-5http://www.oracle.com/pls/topic/lookup?ctx=dsc&id=/app/docs/doc/821-2679#r-properties-5
  • 8/6/2019 821-2908

    42/52

    Connect_cycle

    Number o ault-monitor probe cycles beore Solaris Cluster HA or Sybase ASE establishes anew connection.

    Deault: 5

    Range: 1 100

    Tunable:Any time

    Connect_string

    String o ormat userid/password, which species the database user's user ID and password .Solaris Cluster HA or Sybase ASE uses this property or database probes. When you set upthe Solaris Cluster HA or Sybase ASE data service, dene the database user ID and passwordbeore you enable the server resource and the server resource's ault monitor. Do notuse thesa account or the database user. You must set this property, even i you do not set theMonitor_Server_Name property.

    Deault:None

    Range:Minimum=1

    Tunable:Any time

    DB_Wait_List

    List o databases that need to be online beore the resource can be brought online.

    Deault:Null

    Range:None

    Tunable:Any time

    Debug_level

    Debug level or writing to the Solaris Cluster HA or Sybase ASE log.

    Deault:1

    Range: 0 100

    Tunable:Any time

    Environment_File

    File that contains all o the Sybase ASE environment variables. Solaris Cluster HA or SybaseASE requires that you dene the variables SYBASE, SYBASE_ASE,and SYBASE_OCS. Othervariables that you dene are passed as environment variables to the Sybase server.

    The denition o each environment variable must conorm to the ollowing ormat:

    variable=value

    OracleSolarisCluster Data Serviceor SybaseASE Guide May2011, RevisionA42

    Each environment variable that you dene must also be specied, one per line in the

    Solaris Cluster HA or Sybase ASE ExtensionProperties

  • 8/6/2019 821-2908

    43/52

    y p , pEnvironment_File.

    Typically, users use the SYBASE.sh environment le that is created by the Sybase installation.

    Note The value o this property is independent o the shell that is being used by the sybaseuser. Specically, the sybase user can have csh as its deault shell.