Quest Central for Sybase Revised Betausdownloads.quest.com.edgesuite.net/Repository/support...Quest...

Copyright 2006 Quest Software, Inc. All Rights Reserved.

Quest Central© for Sybase ASE Version 6.1

Release Notes Revised: October 2006

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . These release notes cover changes to version 6.1 of Quest Central for Sybase, Quest Central’s integrated database management solution for Sybase. They identify requirements, features, and enhancements, known issues, and bug fixes for the 6.1 release. For detailed information on using Quest Central components, see Quest Central online help. You can find Quest Central user guides at: http://www.quest.com/quest_central/documentation_links.asp

http://www.quest.com/quest_central/documentation_links.asp

Quest Central for Sybase, Version 6.1 Release Notes

Contents About Quest Central for Sybase, version 6.1 ................................................................................................. 1

Quest Central Common Components ...................................................................................................... 1 Sybase Product Components ................................................................................................................... 1 Quest Central Third Party Licensing....................................................................................................... 1 Global Operation of Quest Central.......................................................................................................... 2 Quest Central 508 Compliance................................................................................................................ 2

Quest Central Common Components ............................................................................................................. 3 Quest Central requirements....................................................................................................... 3 Quest Central features and enhancements................................................................................. 4 Quest Central known issues and workarounds.......................................................................... 5

Quest Database Management Solutions ......................................................................................................... 7 Quest Database Management Solutions Requirements............................................................. 7 Quest Database Management Solutions Features and Enhancements....................................... 8 Quest Database Management Solutions Known Issues and Workarounds ............................... 8

DataFactory .................................................................................................................................................... 8 Benchmark Factory for Databases.................................................................................................................. 9 Notification Server ......................................................................................................................................... 9

Notification Server requirements .............................................................................................. 9 Notification Server known issues and workarounds ................................................................. 9

Notice Board................................................................................................................................................. 10 Notice Board requirements ..................................................................................................... 10 Notice Board features and enhancements ............................................................................... 10 Notice Board known issues and workarounds ........................................................................ 10

Quest Central for Sybase ASE...................................................................................................................... 11 Quest Central for Sybase ASE requirements .......................................................................... 11 Sybase ASE database requirements ........................................................................................ 11 Privileges ................................................................................................................................ 11 Quest Central for Sybase ASE features—Overview............................................................... 11 Quest Central for Sybase ASE known issues and workarounds ............................................. 12

Spotlight on Sybase ASE.............................................................................................................................. 12 Spotlight on Sybase ASE requirements .................................................................................. 12 Spotlight on Sybase ASE known issues and workarounds ..................................................... 13 Global Operation of Sybase .................................................................................................... 16

SQL Tuning.................................................................................................................................................. 17 SQL Tuning requirements....................................................................................................... 17 SQL Tuning features............................................................................................................... 17 SQL Tuning new features and enhancements ......................................................................... 18 Improved Features .................................................................................................................. 19 ASE 15 Support ...................................................................................................................... 20 Configuring Adaptive Server for SQL Tuning........................................................................ 21 SQL Tuning known issues and workarounds.......................................................................... 24

Contacting Quest Software........................................................................................................................... 26 Contacting Quest Support ....................................................................................................... 26


Quest Central for Sybase, Version 6.1 Release Notes 1

About Quest Central for Sybase, version 6.1 Quest Central for Sybase, version 6.1, comprises the Quest Central Common Components and Sybase product components.

Quest Central Common Components

The Quest Central Common Components provide functionality that can be used across all Quest Central supported database platforms. The following common components are included in the Quest Central for Sybase 6.1 release: • Quest Central Console, 3.3.2. • Notification Server, 5.5. • Notice Board, 5.5. • Web Notice Board, 5.5. • Quest Database Management Solutions, 2.1.

Sybase Product Components

Sybase product components provide functionality specific to Quest Central for Sybase. The following Sybase product components are included in the Quest Central for Sybase 6.1 release: • Spotlight on Sybase ASE 1.5.2. • SQL Tuning for Sybase 2.7.0. • Compatible Quest products that, if installed, can be run in conjunction with the Quest Central console:

• TOAD, 8.6.

• SQL Navigator.

• Foglight Webconsole.

• on 4.5 or higher. Benchmark Factory for Databases, versi

• DataFactory, version 5.3 or higher.

Quest Central Third Party Licensing

Information about the third party libraries, re-distributables, and files used in the creation of Quest Central can be found at http://www.quest.com/quest_central/documentation_links.asp.



Global Operation of Quest Central

This section contains information about installing and operating this product in non-English configurations, such as those needed by customers outside of North America. This section does not replace the materials about supported platforms and configurations found elsewhere in the product documentation. This release supports any single-byte character set. Double-byte or multi-byte character sets are not supported. In this release, all product components should be configured to use the same or compatible character encodings and should be installed to use the same locale and regional options. This release is targeted to support operations in the following regions: North America, Western Europe and Latin America, Central and Eastern Europe. This release has the following known capabilities or limitations: Individual components of Quest Central may also include more specific information in the Globalization section of their readme or release notes. This product was tested and is supported with the Latin-1 (WE8ISO8859P1) character encoding. Other encodings, including most single-byte and Western European character encodings may work correctly, but they are untested and may not be fully supported.

Quest Central 508 Compliance

Quest Software is committed to providing products and solutions that are accessible to all people regardless of their capabilities. Section 508 compliance details are available by product in the Voluntary Product Accessibility Templates (VPATs) published on our web site at: http://www.quest.com/public_sector/section_508.asp.


http://www.quest.com/public_sector/section_508.asp


Quest Central Common Components Information specific to all Quest Central components and database platforms resides in the Quest Central Common Components section of the release notes. These issues include, but are not limited to, requirements, known issues, and workarounds having to do with installation, help files, and operating system platforms.

Quest Central requirements

Review the following system requirements to perform a full installation of Quest Central, including all database platforms. Note: System requirements can vary among features and database platforms. Additional

requirements may be needed for specific product components. It is recommended that you check for requirements specific to the product components that you are installing prior to proceeding with the installation.

Hardware requirements • Computer with minimum Pentium 4 or compatible processor. • Minimum 512 MB of RAM. • Minimum 1.5 GB disk space required for a full installation, which includes temporary setup files that

are removed at completion of install. • CD-ROM drive or Internet connection (required for installation only). • VGA monitor, 1024x768 resolution, small fonts. • Printer (optional) for printing graphs and reports. • Sound card and speakers (optional) for receiving audible alerts. • Mouse (required to access all features).

Note: Hardware requirements are dependent on the database platform installed.

Software requirements • Windows 2000 Professional SP4, Windows XP Professional SP1 or later, Windows 2003 Server.

Note: Quest Central does not install on a Windows NT client. • er 6.0 or later. Internet Explor• Tahoma font. • Administrator privileges are required to install Quest Central. • ASE clie nt software to connect to Sybase Adaptive Server 11.9.2, 12.0, 12.5.0.3, 12.5.1, 12.5.2, and

. Note: , so

ntral for Sybase components do require the Open Client software to be installed.

Ci

• Feature Release – MetaFrame XP 1.0, Feature Release 1, 2, and 3.

12.5.3Quest Central for Sybase – SQL Tuning installs the ASE 15 Open Client softwareyou do not need to have the Open Client software installed before installing SQL Tuning. The other Quest Ce

Citrix Support trix products supported include: • Platform Level – MetaFrame XPa 1.0 Server for Windows.



Quest Central features and enhancements

• Enhanced Quest Central installation The Quest Installer has undergone some changes to better support the new flexible Quest

Central architecture. The new installer supports: • Automatic notification of updates and new products

• Access to the latest product versions as they become available

• Side by side installation of different versions of a product (not available for all products)

To accommodate these changes, the Quest Central installation and upgrade processes have changed. • Quest Central 6.1 is available as a consolidated install file (available on the Quest Central

Installation CD, and for download from SupportLink and Quest.com). Run the install file to install and/or upgrade Quest Central products and components. You can choose which products to install/update.

• Use the Quest Installer – which is installed with Quest Central – to check for new products and updates. The Quest Installer will display a list of available products, with links to product download locations.

To obtain a new product or new version of a product, you should: a) download the product (from SupportLink if you have a license for the product,

or from Quest.com for a trial version) b) install it using the product’s installer.

Note: You cannot download multiple products at once.

• Quest Database Management Solutions — Quest Database Management Solutions provides an intuitive and easy-to-use launch platform that aids with day-to-day database management tasks. Quest Database Management Solutions maps database development and administration tasks to the appropriate Quest Software tools and enables you to quickly launch each tool. Tutorials are available to further assist with skills development and familiarization. Best of all, you can customize Quest Database Management Solutions by adding your own tools and tutorials.

• Independent database tree — The Quest Database Management Solutions tree is now independent of the Quest Central Tree.

Note: In updating to Quest Database Management Solutions 2.1, the database tree is automatically created.

Where a Quest Central tree exists, Quest Database Management Solutions imports the Quest Central tree. This creates a ‘snapshot’ of the tree as it exists at that point in time.

Where a Quest Central tree does not exist, Quest Database Management Solutions searches for any databases available from the current host and imports them into the tree. After importing the tree, Quest Database Management Solutions manages its tree independently from Quest Central.

You can organize the tree in a manner that works best for you. Use the Organize database tree feature to manage the tree structure, search for databases available from the current host and add them to the tree and to create dynamically populated database groups. • Check for updates — Checks for updates and new products. In the Available Products

list, review the product information and follow the links to download the latest product versions. For more information on how to upgrade Quest Central, please refer to the Quest Central for Oracle Installation Guide.


http://www.quest.com/support

http://www.quest.com/

http://www.quest.com/support



• Manage DB2 with access to Quest’s DB2 Products — The Quest Database Management Solutions application now includes support for Quest’s DB2 solutions. You can now launch DB2 tools, display tutorials, and access your DB2 environment directly from within the Quest Database Management Solutions application.

For additional information, see Quest Database Management Solutions on page 7. • Support for Citrix Presentation Server for Windows: Quest Central can be run in conjunction with

Citrix Presentation Server for Windows. For installation notes about running Quest Central and its components in a Citrix environment, see the relevant “Quest Central Installation Guide.”

Quest Central known issues and workarounds

The following issues and workarounds apply to Quest Central.

Installation known issues and workarounds • Quest Central install directory and QC 6.0 and later. Products that have traditionally been part of

Quest Central and have not transitioned to point products are installed in the Quest Central directory. For a new installations the Quest Central directory is set to:

<Quest Software Root Folder>\Quest Central where <Quest Software Root Folder> is the root directory specified at installation (by default, C:\Program Files\Quest Software). When upgrading from a previous version, the Quest Central directory is set to directory selected in the original installation.

• Uninstalling Benchmark Factory leaves behind some large files. These files form the repository database and are used to store the test results. These files can be deleted manually if you no longer require Benchmark Factory.

• Quest Central for Databases cannot be installed on the same system as any other Quest Central product.

• Unable to access installation files: When attempting to install Quest Central you may get an error message that you are unable to access installation files due to network / internet connectivity issues or insufficient disk space. Troubleshooting installation errors:

Open the Quest Installer log file (QILogfile.csl) and locate the failed operation(s). Tip: You can find the location of QILogfile.csl in the Quest Installer Settings – Logging tab –

Log Destination field. If the error is an HTTP error:

1. Using Internet Explorer, try downloading file(s) specified in the errors listed in QILogfile.csl.

2. If you still cannot access the files, then check your proxy settings.

3. If you check your proxy settings and error message persist, contact Quest Support. If you can access the files via the Internet and errors occur:

1. Check the location to which the files are being copied to ensure that there is enough disk space to store the files.

2. If there is sufficient disk space and error messages persist, please contact Quest Support. • Installation of Code Site as part of Quest Central Installer installation. If Code Site is not already

installed on the system to which you are installing Quest Central, Code Site is installed to c:\program files\raize regardless of the installation directory specified by the user.



• Uninstalling standalone product components. If you installed a product using Quest Installer, you must uninstall that product using the Quest Installer. If you uninstall the product using the product’s un-installation program (for example, Spotlight Un-Installer), the Quest Installer presumes that the product is still installed. In this case you cannot re-install the product as the Quest Installer presumes that the product is still installed.

• Power Users cannot install or uninstall Quest Central: Because Power Users do not have privileges to install or modify settings, they cannot install Quest Central as it requires admin privileges to write to the registry. To resolve this issue, install Quest Central as a local administrator. After it has been installed, you can run Quest Central as a normal user.

• Installing Spotlight for multiple database platforms creates multiple desktop icons: When you install Quest Central and select to install multiple Spotlights for various database platforms, Spotlight shortcuts are created for each Spotlight installed. For example, if you have Spotlight on SQL Server installed and you then install Spotlight on Windows (the new one being a 3.0+ version), another shortcut is created.

• Notification for insufficient space: Quest Central provides a warning during installation if insufficient disk space exists for the installation.

• If the installation is a new install, you may continue with the install, but it will fail due to a lack of disk space.

• If the installation is a repair or upgrade, you may continue with the install as it reuses disk space by overwriting the existing files.

• Some components are reset to default settings after upgrading Quest Central: The following components are reset to their Default settings after an upgrade:

• Toolbar

• Taskbar

• Console Preferences

• SQL Trace Preferences

• After you upgrade Quest Central you must reset your settings.

Installation on low-end client PCs: In some cases, performing an installation on a low-end client PC may cause an application error when you complete and exit the Quest Central installation. Please note: This error can be safely ignored and has no effect on the integrity of the client PC or the Quest Central installation. The error will read as follows: “Attempt to release mutex not owned by caller.” If you see this error when you complete the Quest Central installation, please select “Ignore” or “Abort” to exit. To launch Quest Database Management Solutions, select Start | All Programs | Quest Software | Quest

•

Database Management Solutions.

Quest Central Console known issues and workarounds •

ar pink. The pink icons function as normal. To remove the pink background, restart Quest

• The information in the

• stem where there is no web browser

• raphics drivers compatible with your

hardware or select the standard Windows desktop settings.

Quest Central icons display with pink background: When using Quest Central the toolbar icons may appeCentral. Dragging and dropping shortcuts. When dragging and dropping a shortcut from one folder toanother in the Quest Central tree, the shortcut is copied and not moved. “Moving shortcuts” topic in the Quest Central online help is incorrect. Web Browser not installed: Running Quest Central on a syinstalled causes Help>Updates to fail without notification. Display of browser and toolbar icons: Occasionally, the icons in the browser and toolbar do not display properly. To correct this problem, install the latest g



Support Bundle known issues and workarounds • Quest Central support bundle may hang on some machines using nVidia video drivers with the

nVidia Desktop Manager enabled: To resolve this issue, in the Display settings for your computer, disable the nVidia Desktop Manager.

• The Support Bundle Wizard does not collect agent support information using the Help | Support Bundle option. In the Support Bundle Wizard’s Select Products screen, if you elect to collect information for Agents, you will receive an error saying that there are no agents present. You will not be able to proceed to collect Agent support information. Workaround: To collect Agent support information using a support bundle, in the Quest Central tree, drill down to the Agent Node for the host for which you want to collect information. Right-click on the Agent, and then select Support Bundle.

Citrix known issues and workarounds • Publishing Quest Central. When publishing Quest Central, Quest Central should be published with

16-bit color depth or higher. • Using Quest Central with multiple connections: Do not use Quest Central with multiple

connections running with the same user name.

Quest Database Management Solutions

Quest Database Management Solutions, version 2.1 provides a convenient interface from which you can explore the capabilities of the Quest Software products available for each of your database server vendors (SQL Server, Oracle, DB2, or Sybase). When you pass your cursor over a Quest Software tool, the Quest Database Management Solutions window, highlights the tasks and tutorials associated with that tool. Simply click a tutorial to learn more about the tool in question. If the tool is not installed on your system, Quest Database Management Solutions enables you to download the tool. You can also add your own tools and tutorials to the window to better help you organize and launch all your favorite database tools, applications, and tutorials. To launch Quest Database Management Solutions, select Start | Programs | Quest Software | Quest Database Management Solutions. For more information, refer to the Quest Database Management Solutions online help. To access online help, click F1 or select Quest Database Management Solutions Help from the Help menu.

Quest Database Management Solutions Requirements

In addition to U.S. English, Quest Database Management Solutions includes the following language configurations: • French • German • Spanish • Japanese • Korean

The displayed language is displayed is determined by the client regional settings. The default is U.S. English.



Quest Database Management Solutions Features and Enhancements

The Quest Database Management Solutions window provides several ways to obtain information about the Quest Software tools on your system. By viewing the tasks each tool performs and viewing tutorials, you can determine which tool to launch for your particular need. You can: • View the Quest Software tools available or installed on each of your database systems (SQL Server,

Oracle, DB2, or Sybase) • View the tasks a tool performs • Launch a tool • Launch a tutorial • Add your own tools and tutorials • Customize the Quest Database Management Solutions window • Organize the database tree • Check for the latest products and updates available for Quest Central.

Quest Database Management Solutions Known Issues and Workarounds

• Task selection launches associated tool and not specific task within the tool: When you select a task in the Quest Database Management Solutions window, the product corresponding to the selected task is launched. In future releases, the task selection will launch the specific task within the tool.

• Some installed Quest products show as disabled for Non-Administrator users. When logged in as a user without Windows Administrator security privileges the following Quest products display as disabled tools when installed: Capacity Manager for SQL Server, Toad for DB2, and Toad for SQL Server. Non-Administrator users can launch these products from the Start menu or available Desktop shortcuts.

DataFactory

DataFactory is a Quest Central add-on that allows IT professionals to populate test databases with millions of rows of meaningful, syntactically correct data for database testing. DataFactory is installed separately from Quest Central. You can download the installation file for DataFactory from the Quest Web site at www.quest.com. Select Products | All Products A – Z | DataFactory Trial. DataFactory requires a valid DataFactory license key. If you want to license DataFactory, or already have a licensed Data Generator, but do not have a key, visit the License Keys section of the Quest SupportLink at: http://questsupportlink.quest.com/LicensingData Generator functionality can be accessed by selecting Tools | DataFactory from the Quest Central console.




Benchmark Factory for Databases

Benchmark Factory is a Quest Central add-on that identifies database performance and bottleneck issues, facilitating proactive database testing. Benchmark Factory for Databases is installed separately from Quest Central. You can download the installation file for Benchmark Factory for Databases from the Quest Web site at www.quest.com. Select Products | All Products A – Z | Benchmark Factory Trial. Benchmark Factory for Databases requires a valid Benchmark Factory license key. If you want to license Benchmark Factory, visit the License Keys section of SupportLink at: http://questsupportlink.quest.com/LicensingBenchmark Factory functionality can be accessed by selecting Tools | Benchmark Factory from the Quest Central console.

Notification Server

Notification Server requirements

• The host machine to be used as a Notification Server needs to be suitable for reliable 24x7 operation. • Quest Notification Server only runs on Windows: The Quest Notification Server does not run on

UNIX.

Notification Server known issues and workarounds

• If you are using Quest Notification Server, it is recommended that you upgrade the Quest Notification Server to allow communication with the latest Foglight server version 4.2. If you do not upgrade your existing Quest Notification Server, Foglight notices from 4.2 servers will not be read properly, and there may be some difficulty in connecting to the Foglight servers.

• The Quest Notification Console’s keyboard shortcuts and access keys no longer work.



http://questsupportlink.quest.com/Licensing


Notice Board

Notice Board requirements

The ability to receive notices directly from Foglight is available only if a Foglight Operations Console version 3.0.x or greater is installed locally. Note: The Foglight Operations Console is NOT required when receiving notices from Foglight via

the Notification Server (recommended).

Notice Board features and enhancements

• The Notice Board enables you to use the latest Foglight Server (4.2). • Support for Citrix environments: You can run Quest Notice Board with Quest Central in a Citrix

environment. For the Notice Board to directly access Foglight servers, the Foglight Operations Console must be installed on each Citrix box. Each Foglight Operations Console must have connections to the relevant servers. Note: It is recommended that the Quest Notification Service be used to access Foglight

servers – as this mechanism does not require the Foglight Operations Console.

Notice Board known issues and workarounds

• Upgrading from Notice Board 4.5.2: If upgrading from Notice Board 4.5.2 you should also upgrade Spotlight. Database Analysis, and Knowledge Xpert products to ensure that the right-click drilldown links continue working. You also need to upgrade Performance Analysis.

• Restrictions on accessing Foglight servers: If you use the Notice Board to access Foglight servers directly, when using Foglight Operations Console 4.2 you cannot access a 3.02e server.

• Forwarded notices retain Date Acknowledged: When an acknowledged notice is forwarded, or raised again with a different severity or message, the Date Acknowledged is cleared by the Notification Server. However, the Notice Board continues to display the Date Acknowledged for that notice, and disables the Snooze and Acknowledge functions in the Actions menu and the right-click shortcut menu.



Quest Central for Sybase ASE

Quest Central for Sybase ASE requirements

Hardware requirements • Computer with minimum Pentium 4 or compatible processor. • Minimum 512 MB of RAM. • Minimum 809 MB disk space required for full installation. • CD-ROM drive or Internet connection (required for installation only). • VGA monitor, 1024x768 resolution, small fonts. • Printer (optional) for printing graphs and reports. • Sound card and speakers (optional) for receiving audible alerts. • Mouse (required to access all features).

Software requirements • Windows XP Professional SP1 or 2, Windows 2000 Professional SP3 or later, or Windows Server

2003. • rer 6.0 or later. Internet Explo• Tahoma font. • Administrator privileges are required to install Quest Central. • ASE client software to connect to Sybase Adaptive Server 11.9.2, 12.0, 12.5.0.3, 12.5.1, 12.5.2,

Note: Quest Central does not install on a Windows NT client.

Quest Central supports Sybase ASE versions 11.9.2, 12.0, 12.5, 12.5.0.3, 12.5.1, 12.5.2, 12.5.3, and 15.0.

ution that offers performance diagnostics,

t

throughout the Adaptive

n offering SQL performance diagnosis, performance optimization, and performance

management.

12.5.3, and 15.0.

Sybase ASE database requirements

Privileges

Administrator privileges are required to install and run Quest Central and its plug-ins.

Quest Central for Sybase ASE features—Overview

Quest Central for Sybase ASE is a performance management solanalysis, and optimization to ensure maximum performance. Spotlight is one of the Quest Central for Sybase components. It is the monitoring and diagnostic componenof Quest Central for Sybase. Its unique user interface provides you with an intuitive, visual representation of database activity. Graphical flows illustrate the movement of informationServer. Icons and contextual drilldowns provide key statistics and metrics. Another component of Quest Central for Sybase is SQL Tuning. SQL Tuning maximizes applicatioperformance by



Quest Central for Sybase ASE known issues and workarounds

Installation After installing Quest Central for Sybase ASE, a duplicate shortcut for Spotlight appears on the desktop. You can manually delete one of the shortcuts.

Spotlight on Sybase ASE

Spotlight on Sybase ASE v1.5.2 is a monitoring and diagnostic tool for Sybase Administrators. Its unique user interface provides you with an intuitive, visual representation of database activity. Graphical flows illustrate the movement of information throughout the Adaptive Server. Icons and contextual drilldowns provide key statistics and metrics. New features for this version of Spotlight on Sybase ASE include: • Enhanced look and new charts • Sybase ASE 15 support

Spotlight on Sybase ASE requirements

If the monitoring tables for Adaptive Server v12.5.0.3 (or newer) have not been installed, the Spotlight component cannot monitor the Adaptive Server. See instructions for how to install these tables in the “Adaptive Server monitor tables” section of SQL Tuning Sybase ASE on page 18.

Hardware Requirements • Pentium-III or equivalent PC running Windows 2000, Windows 2003, Windows XP • 50 megabytes of free disk space • This application should exist on a local disk drive rather than a network drive • Monitor capable of supporting a resolution of 800x600 or larger

Spotlight is designed to run on a desktop area of 800 by 600 pixels or larger. It is best viewed on a desktop area of 1024 by 768 pixels. You should also set the display to use the 64K color palette (65536 colors) or higher.

• 128 megabytes of RAM (minimum) 256 megabytes of RAM is the recommended configuration. Memory usage is driven by the number of simultaneous Spotlight connections opened.

• CD-ROM drive or Internet connection Spotlight can be downloaded from the Internet or installed from compact disk. The CD-ROM drive should be attached to the PC on which Spotlight is to be installed. A drive mapped to a network device could be used if a local CD-ROM is not available.

• Printer Spotlight reports can be printed on a laser or bubble jet printer.

• Sound card and speakers Spotlight can use sound to alert you when a threshold is reached. You must have a sound card and speakers installed on your PC for this feature to work.

• Mouse To access all the features of Spotlight, you should have a mouse installed on your PC.



Software Requirements • Window 03, or Windows XP

•

•

•

• You may have the System Administrator (‘sa’) user ID and password for the ASE you want to diagnose, or have a DBA who has this account setup utility, before you can use

. llmontables)

run when the Adaptive Server was created or updated, Spotlight cannot use the MDA API. t will break the connection.

AS d w

wing issues are addressed i .5.2: Symptom Cause

s 2000, Windows 20The following specific requirements exist:

Windows 2000, Service Pack 4 must be installed.

Windows XP

• Windows 2003

Sybase Adaptive Server versions 11.9.2, 12.0.x, 12.5.x, and 15 Non sa users can be set up to monitor a Sybase Adaptive Server with the non sa setup utility shipped with the Spotlight on Sybase v1.5.2 product. While most metrics are available to a non sa user, not all are available.

Spotlight to diagnose the Adaptive Server. All metrics are available to sa usersIf an Adaptive Server v12.5.0.3 (or newer) has not had the Sybase script (insta

Spotligh

Spotlight on Sybase

Resolved Issues The follo

E known issues an

n the Spotlight for Sybase v1

orkarounds

Resolution Slow performance when in the User Activity drilldown. Spotlight on Sybase appears to be

nder certain circumstances a large number of users can cause the problem user query to take an xtended amount of time to

complete.

the problem user query to

e normally. locked.

U

e

Time out functionality has been added to query processing. This causesabort but allows other processes to complet

Erroneous value shown under SE Error Log" on Home Page.

The value now displays unviewed error messages in the ASE Error Log.

"A

Kill Process feature noer Activity

t working from the Us drill down

The option is no ning properly.

popup menu.

w functio

Known issues

Symptom Cause Resolution On the Memory drilldown and Data Cache tab, the Data Cache grid numbers appear incorrect and do not add up to the numbers for the data cache pools.

Actually, the numbers are correct, but they represent deltas from the previous poll cycle, while the numbers for the pool are totals.

le this issue. The Data Cache grid values will become totals to match the values in the Data Cache Pool grid.

None for now. A future release is planned to hand



Symptom Cause Resolution Under the User Activity drilldown, after a user hasselected, the first value shown inthe graph for the number of Temp Tables used by a process may, under certain circumstances, show a negative number.

been

d in a

However, this is corrected after the subsequent collection cycle, and adjusts to an accurate number.

This issue will be addressefuture release.

An internal error message is received when launching Spotlight from Quest DatabaseManagement Solutions. The erromessage is repeatedly displayedeach time a message is entered into the Spotlight error log.

r

Displaying the Error Log drilldown will clear the error.

a This issue will be addressed infuture release.

Database drilldown can display an incorrect value for an unallocated space in certain instances. The unallocated space may be shown as larger than the total size of the database.

This issue is a result of a known Sybase error. Refer to Case ID 11191018.

Under certain circumstances, Spotlight prompts the user with an internal error (access violation) message on startup.

Click OK and Spotlight will continue normally. This issue will be addressed in a future release.



Symptom Cause Resolution Total Device space shown in the device’s drilldown, may display an incorrect value if the server’s page size is set to a value other than the standard 2048 bytes.

A hot fix is available from Customer Support. This patch addresses CR157395. If the ASE server being monitored is configured with a page size other than the standard 2048 bytes, the total device size shown in the devices drilldown will be incorrect. This patch corrects the error. This patch is not to be used in conjunction with the UNIX install script - it will produce errors. The install script already includes a fix for this issue. Instructions: 1. The following file should be

copied into C:\Program Files\Quest Software\Spotlight\Plug-ins\SoSyb: sosyb.prc

This will replace the existing file of the same name. Please note that this is the default path and the actual path may vary between installations.

2. Run Spotlight and connect to an ASE server using an account with 'sa' privileges. The updated stored procedures will be installed automatically. (Using a non 'sa' account will result in an error and the updated procedures will not be installed.)

Other issues • When Spotlight is uninstalled, any registry keys that were created by the application will not be

removed. These are related to any customizations that were done. • When the SQL Activity page in the User Activity drilldown is first selected, the SQL Activity grid

may take longer to populate than expected.



• System processes are filtered out of the Sout if the SQL was run prior to system m

QL Activity grid. As a result, SQL processes are also filtered onitoring if the user is no longer logged in.

ains information about installing and operating Spotlight on Sybase ASE in non-English or

datasets are fully supported. Support for non-ASCII

characters and/or non-English configurations may work appropriately, but these configurations have not been tested and this product should be used with caution in these environments. For specific support information, contact Quest Customer Support.

Global Operation of Sybase

This section contnon-ASCII configurations, such as those needed by customers outside the USA. This section does not replace the materials about supported platforms and configurations found elsewhere in the product documentation. Spotlight on Sybase ASE was not enabled / was not tested for international operation. Only U.S. Englishconfigurations of this product and U.S. English



SQL Tuning

SQL Tuning requirements

Hardware Requirements • Computer with Pentium III (Pentium IV recommended) or compatible processor • Minimum 512 MB of RAM • 70MB hard disk space

Software Requirements • Windows XP Professional SP1 or SP2, Windows 2000 Professional SP4 or later, Windows Server

2003 Note: Quest Central for Sybase – SQL Tuning installs the Adaptive Server Open Client

version 15 software, so you do not need to have the Open Client software installed before installing SQL Tuning.

Adaptive Server Monitoring Tables The monitoring tables for Adaptive Server v12.5.0.3 (or newer) must be installed in order for the SQL Inspector module to extract the SQL text from these monitoring tables.

SQL Tuning features

Quest Central’s SQL Tuning component for Sybase enables IT professionals to analyze, predict, preempt, diagnose, optimize, and manage performance changes to ensure that mission-critical business applications run optimally. SQL Tuning maximizes application performance by offering SQL performance diagnosis, performance optimization, and performance management. • Identifies problematic SQL statements in database applications • Diagnoses SQL related performance bottlenecks with visual analysis of Adaptive Server’s

performance metrics • Generates every possible SQL alternative to automatically locate the most efficient SQL statement • Proposes new index scenarios for a SQL statement and identifies performance effects of adding new

indexes to the database system • Analyzes the effect on performance when changing Adaptive Server configuration parameters • Preempts performance degradation before deploying applications to production or when upgrading

Adaptive Server • Identifies unused indexes in the database to free up space and decrease maintenance • Integrates DDL generation for multiple SQL statements and an interface that allows the creation of

scripts and execution of commands



SQL Tuning new features and enhancements

New Features • New Module

Added the Code Finder module which identifies database objects and files that contain specific text. • Test for Scalability

Added the ability to submit Optimized SQL alternatives to Benchmark Factory to identify the best performing SQL under different user load scenarios.

• Create import file for Benchmark Factory Added the ability to create a file from the SQL Scanner, SQL Inspector, or SQL Repository that can be imported into Benchmark Factory.

• Add SQL to the SQL Repository that reference specific tables or views Added a new function to enable you to extract all the SQL statements from database objects that reference specific tables or views and add them to the SQL Repository.

• Filtering the Run Time Results Add a new function to enable you to filter the run time results in the Time and Statistics tabs in the SQL Optimizer window so you can view only those results that meet your performance criteria.

• Loading Data Dictionary Preference Loading the data dictionary when you connect to a database is now optional. In the General page of the General tab in the preferences, you can select the "Do not load database dictionary after database connection". If this option is selected the information from the database is loaded at the time it is needed.

• SQL Parameters Preference Added a SQL Parameters option in the General Preferences to save the values and datatypes for the parameters that are used in SQL statements. These saved values are automatically entered for you the next time the parameter name is used in any SQL statement.

• Added checkboxes to preserve changes made in Analyzers • Added a "Do not rollback changes …" checkbox to the Migration and Configuration

Analyzers so that the changes that you are analyzing can remain permanent in the database after the analysis.

• Added a "Do not drop the indexes ..." checkbox to the Index Impact Analyzer so that the indexes that you are analyzing remain permanent in the database after the analysis.

• Added "Save Abstract Plan" to Analyzer Modules The abstract plan for the SQL statements in the Configuration Analyzer, the Migration Analyzer, and

d in those modules. the Index Impact Analyzer can now be save• Created Wizards for the Add functions

The Add windows in the SQL Scanner, SQL Inspector, SQL Collector, and the SQL Repository were changed to wizards. The New Analysis and Add Scenario windows in the Index Usage Analyzer, Configuration Analyzer, the Migration Analyzer, and the Index Impact Analyzer were changed to wizards. Added Scanning to Inspector Viewer In the Inspector Vie

• wer, the SQL statements that have been filtered can be scanned to identify the

•

n if you are loading a large number of database objects and it is taking a long time to add all of

• Added the ability to open a SQL Inspector file from the SQL Scanner module.

problematic SQL. Added Progress Bar and Abort function to Add Jobs Wizard You can now see the progress of loading the Jobs into the Job Manager and abort the Add Jobs functiothem. Open in SQL Inspector



• Filtering the Run Time Results Added a new function to enable you to filter the run time results in the Time and Statistics tabs in the SQL Optimizer and Index Advisor windows so you can view only those results that meet your performance criteria.

• Sybase Open Client version 15 Sybase Open Client version 15 is deployed with SQL Tuning. This enables SQL Tuning to connect to Sybase ASE version 15 and earlier. SQL Tuning supports ASE 11.9.2 and above.

Improved Features

• Batch Run Criteria • Changed the Run Time Mode option from First Record to First n Record(s) so that you

can determine how many record you would like the Batch Run to retrieve during the testing of the execution time.

• Added the Batch Run Schedule criteria so that you can schedule when to start and stop the Batch Run.

• Added new options for calculating the run time when you select to execute the SQL statement multiple times.

• Added the ability to select the execution order for the SQL alternatives and index alternatives.

• Calculating the size of a table The calculation of the size of a table now uses sp_spaceused instead of dbcc traceon

information. • Optimization Preferences

Added a set of optimization preferences that are specific to Adaptive Server 15 or later which include new settings for selecting an optimization goal and optimization criteria.

Added an additional JOIN syntax preference, "Rewrite SQL using the same JOIN syntax as the source SQL".

Added an option so that you can choose to include or exclude one of the advanced SQL transformation rules when the SQL Optimizer rewrites the syntax of your SQL statements.

• Sca ernn Preference Added a preference to allows you to save the checked SQL when a Job is rescanned.

• Sav g Pin references Settings restore a set of Preferences settings. Added the ability to save and

• SQL Classification Preferences For the Problematic SQL classification, added the "With number of Reformatting greater

" preference.

lowing Preference w

than or equal to• Re enam d Preferences

The fol as renamed: Former Name New Name . Number of worktables es With number of worktabl

greater than or equal to

• Re e The SQL Monitor module was renamed to SQL Collector for Monitor Server.

nam d SQL Monitor



ASE 15 Support

Support for Adaptive Server 15.0 The following Adaptive Server 15.0 features are supported by this version • New keywords for the query plan and its corresponding Plan Help • New keywords for the abstract plan its corresponding Plan Help • A new set of optimization preferences for the SQL Optimizer • Function-based indexes, computed columns, and partitioned objects • Optimization Timeout setting selected from Adaptive Server for optimization • Optimization Goals selected in the Preferences and Optimization Timeout setting from Adaptive

Server 15 are displayed in the Information Panel • Display Partition information from an ASE 15 database in the Database Explorer • XML plan • New tree-like display format for the abstract plan to accommodate changes to the abstract plan in ASE

15 • New datatypes (unitext, bigint, and unsigned integer type) • Large Identifier with maximum length of 255 bytes • Cursor sensitivity and scrollability in the cursor declaration. • New configuration parameters in the Configuration Analyzer and the Migration Analyzer. • Computed columns and function-based indexes in the Add Index wizard in the Index Advisor module

Query Processing Metrics.

Th er 15.0 SQL syntax is supported by this version.

BLE statement

t ent

TE TABLE statement

• FOR XML Subquery, i.e. FOR XML clause in Expression Subquery

• SQL Inspector enhanced to capture top resource intensive SQL from

Support for New SQL Syntax in Adaptive Server 15.0 e following Adaptive Serv• Function-based Index • Computed Column in CREATE TABLE statement • PARTITION clause in CREATE INDEX and CREATE TA• PARTITION clause in INTO clause of SELECT statement • TOP N Clause in SELECT, UPDATE, and DELETE statement • READPAST table option for DELETE and UPDATE statemen• ON SEGMENT clause in INTO clause of SELECT statem• IDENTITY_GAP option in CREA• New syntax in FOR XML clause



Configuring Adaptive Server for SQL Tuning

Sybase ASE database requirements SQL Tuning requires a connection to Adaptive Server using Open Client 11.9.2 or later. An Open Client version for Adaptive Server version 15 is deployed with SQL Tuning. SQL Tuning supports Adaptive Server 11.9.2 or later. The following modules require that you have a later version of Adaptive Server in order to make use of new functionality that has been added to Adaptive Server.

Modules Version of Adaptive Server SQL Monitor 11.9.2 Abstract Plan Manager 12.0 SQL Inspector 12.5.0.3

Privileges and database setup Determine which of the following database setup or user privileges are needed for your environment and then perform the following steps under the respective sections. • SELECT Permission on database objects • sa_role • CREATE PROCEDURE • Adaptive Server Monitoring Tables • mon_role

SELECT permission on database objects If the user is not the owner of the database objects, the user logon accounts must have the SELECT permission on the objects. If the user logon account does not have access to database objects in Adaptive Server, then these objects cannot be used or viewed in SQL Tuning.

sa_role privilege The sa_role privilege is needed for a few functions in Quest Central for Sybase—SQL Tuning. If the logon does not have this privilege, most of the functionality of Quest Central for Sybase—SQL Tuning is still available. Assign ‘sa_role’ to the logins needing the following functionality: • Use of the SQL Monitor module • Abort Run Result function for SQL statements that return data • Retrieve Trace On (dbcc) information

Grant sa_role to the logon using the following command in the SQL Worksheet module or ISQL: grant role sa_role to <logon_name>

Create privileges The CREATE PROCEDURE privilege is required to optimize a SQL statement that runs inside a cursor. A procedure is created when the SQL for Cursor checkbox is selected in the SQL Optimizer window (in the Syntactical SQL Optimizer module) or when the SQL Scanner finds a SQL statement that is executed within a cursor declaration. The stored procedure is created to retrieve the query plan and run time. The stored procedure is executed and then dropped.



Adaptive Server monitor tables The SQL Inspector requires Adaptive Server 12.5.0.3 and later with the Adaptive Server monitoring table installed. Proxy tables for the monitoring tables are not created by default when you configure Adaptive Server. The tables are created using the installmontables script that is included in the Adaptive Server install and is located in the $SYBASE/ASE-12_5/scripts for NT). This script requires that a server named “loopback” be included in sysservers. If the monitoring tables are not installed in your Adaptive Server (12.5.0.3 and later), follow these steps to install the tables:

1. Create a loopback server entry in ISQL. a. Logon to Adaptive Server with sa. b. Execute:

sp_addserver ‘loopback’, null, <ASE server name> go

2. Execute the installmontables script located in the $SYBASE/ASE-12_5/scripts directory (%SYBASE%/ASE-12_5/scripts for NT) using ISQL.

isql –Usa –P(sa password> -S<server name> -n –i%SYBASE%/%SYBASE_ASE%/scripts/installmontables

mon_role privilege The mon_role privilege is needed to run the SQL Inspector module. The sa logon does not have this role by default, so it needs to be added to the sa logon and any other user logon. Assign ‘mon_role’ to the logins using the SQL Worksheet module or ISQL with this command:

grant role mon_role to <logon_name>



Adaptive Server configuration parameters The following modules require specific settings for Adaptive Server configuration parameters. (You can copy, paste, and execute the following script into the SQL Worksheet module.) /* parameters for SQL Inspector module */ /* requires Adaptive Server 12.5.0.3 and later */ sp_configure “enable monitoring”,1

go

sp_configure “sql text pipe active”,1

go

sp_configure “sql text pipe max messages”,1024

go

sp_configure “statement pipe active”,1

go

sp_configure “statement pipe max messages”,5000

go

sp_configure “wait event timing”,1

go

sp_configure “process wait events”,1

go

sp_configure “SQL batch capture”,1

go

sp_configure “max SQL text monitored”,4096

go

/* parameters for retrieving Estimated I/O Cost for query plans */ sp_configure “allow resource limits”,1

go

/* parameters for SQL Monitor module*/ sp_configure “event buffers per engine”,2000

go

sp_configure “max SQL text monitored”,4096

go

/* parameter to access syscomments system table to retrieve DDL for database objects. */ /* Access to the system catalog table, syscomments, is needed to view SQL text for procedures, triggers views, default, and rule objects. If you do not have access to the syscomments system table, a message <SQL Text unavailable> is displayed in the Text tab of the Database Explorer window, and you will be unable to scan database objects in the SQL Scanner module. */ sp_configure “select on syscomments.text”,1

go

/* Parameters for SQL Inspector module using the QP Metrics */ /* Requires Adaptive Server 15.0 and later */ sp_configure 'enable metrics capture',1 go



SQL Tuning known issues and workarounds

• The production key from version 2.5.2 or earlier of Quest Central for Sybase— SQL Tuning will not work in SQL Tuning 2.7.0 (installed with Quest Central 5.6) or SQL Tuning 2.5.3 (installed with Quest Central 5.0). If you need a new production key, contact [email protected].

• Version 2.7.0 is installed in a different directory than version 2.5.2 and earlier. You may want to move your data directory if you are upgrading from these versions.

• Information for some datatypes does not display correctly. The information for some datatypes does not display when records are retrieved from the database. This occurs on the Data tab of the Database Explorer module, the Run Results window in the SQL Optimizer module, and on the Result panel of the SQL Worksheet module. The following table lists the datatypes that do not display.

Datatype Results in Database Explorer (Data tab) binary “Bytes” displays in the column.

varbinary “Bytes” displays in the column.

money Truncated to two decimals.

smallmoney Truncated to two decimals.

text “Memo” displays in the column.

unitext “Blob” displays in the column.

image “Blob” displays in the column.

timestamp “Bytes” displays in the column.

bigint When the integer is very large, it is converted to a float datatype.

ubigint When the integer is very large, it is converted to a float datatype.

unichar Displays this error message; no data displays for the table: Failed to retrieve data. … Field 'columnname' is an unsupported type.

univarchar Displays this error message; no data displays for the

table: Failed to retrieve data. … Field 'columnname' is an unsupported type.

• Support for Optimization Criteria in the Optimizer. New Preferences have been added for

optimization processing when connected to Adaptive Server Enterprise version 15. One set of these preferences—Optimization Criteria–are not fully supported. Currently, if you select any of these criteria for the optimization process and your SQL statement contains a semi-join while connected to Adaptive Server 15 GA and esd #1, the criteria are not rolled back between the creation of each SQL statement. Without the rollback, some of the following query plans are retrieved using optimization criteria that would not normally be set. This affects the results of the optimization process as it compares one query plan to another.

Workaround – When connected to Adaptive Server Enterprise 15 GA, and esd#1 and your SQL statement contains a semi-join, use the Custom setting in the Intelligence Level, then unselect all of the Optimization Criteria and the Optimization Goals when you optimize a SQL statement.


mailto:[email protected]


• Comparison of query plan. In the Analyzer modules, a query plan from Adaptive Server Enterprise version 12.5.3 or earlier cannot be compared to a query plan from Adapter Server Enterprise version 15.

• Structure and details of the XML plan will vary according to the connected Adapter Server Enterprise version.

• SQL Tuning cannot terminate a database connection or an operation when the Adaptive Server transaction log is full. Thus, if the transaction log becomes full while you are using SQL Tuning, the program may hang. This only happens if the Adaptive Server ‘abort tran log full’ option is set on

Workaround – Set the Adaptive Server 'abort tran on log full' option off. You must evaluate whether this is an appropriate setting for your database environment.

• Database Explorer displays the following error message if the connection to Adaptive Server is lost, and repeated attempts are made to reconnect to the database:

Failed to connect to database. Fatal error: in TISybDatabase.Logon

Workaround – There is no workaround for this issue. SQL Tuning must be restarted. • When running SQL Tuning on Windows 2003 and connecting to Adaptive Server 15, if you restart

Adaptive Server after you have opened SQL Tuning, when you open the Database Explorer module you may receive the error message “Failed to show object preview" and SQL Tuning hangs.

• For Indexes that were created with a "LOCAL INDEX" clause, the DDL for the index which is displayed in the Database Explorer module will be missing the " LOCAL INDEX " clause".

• The “WITH INTO_OPTION” syntax in the INTO clause of a SELECT SQL statement is not supported.

• SQL statements that contain "INTO x PARTITION BY" clause are not supported. For example: select * into employees_report partition by range(salary)

, (smallorder values <= (500) on systemer values <= (5000) on system) bigord

from employees



Contacting Quest Software Email: [email protected]

Mail: Quest Software, Inc. World Headquarters 5 Polaris Way Aliso Viejo, CA 92656 USA

Web site: www.quest.com

Please refer to our Web site for regional and international office information.

Contacting Quest Support

Quest Support is available to customers who have a trial version of a Quest product or who have purchased a commercial version and have a valid maintenance contract. Quest Support provides around the clock coverage with SupportLink, our web self-service. Visit SupportLink at http://support.quest.com/supportFrom SupportLink, you can do the following: • Quickly find thousands of solutions (Knowledgebase articles/documents). • Download patches and upgrades. • Seek help from a Support engineer. • Log and update your case, and check its status.

View the Global Support Guide for a detailed explanation of support programs, online services, contact information, and policy and procedures. The guide is available at: http://support.quest.com/pdfs/Global Support Guide.pdf Disclaimer: The information in this document is provided in connection with Quest products. No license, express or implied, by estoppel or otherwise, to any intellectual property right is granted by this document or in connection with the sale of Quest products. EXCEPT AS SET FORTH IN QUEST'S TERMS AND CONDITIONS AS SPECIFIED IN THE LICENSE AGREEMENT FOR THIS PRODUCT, QUEST ASSUMES NO LIABILITY WHATSOEVER AND DISCLAIMS ANY EXPRESS, IMPLIED OR STATUTORY WARRANTY RELATING TO ITS PRODUCTS INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. IN NO EVENT SHALL QUEST BE LIABLE FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL, PUNITIVE, SPECIAL OR INCIDENTAL DAMAGES (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF PROFITS, BUSINESS INTERRUPTION OR LOSS OF INFORMATION) ARISING OUT OF THE USE OR INABILITY TO USE THIS DOCUMENT, EVEN IF QUEST HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Quest makes no representations or warranties with respect to the accuracy or completeness of the contents of this document and reserves the right to make changes to specifications and product descriptions at any time without notice. Quest does not make any commitment to update the information contained in this document.


mailto:[email protected] %3cmailto:[email protected]%3e


http://support.quest.com/support

http://support.quest.com/pdfs/Global Support Guide.pdf

http://support.quest.com/pdfs/Global Support Guide.pdf

Quest Central for Sybase Revised Betausdownloads.quest.com.edgesuite.net/Repository/support...Quest...

Documents

Transcript of Quest Central for Sybase Revised Betausdownloads.quest.com.edgesuite.net/Repository/support...Quest...