Professional Documents
Culture Documents
Adaptive Server IQ Multiplex Implementation Guide
Adaptive Server IQ Multiplex Implementation Guide
Adaptive Server IQ Multiplex Implementation Guide
Document History
Template Version: 3.5, 13-Sep-98
Project: ASIQ
Document ID: IQMCookbook.doc
Status: Draft
Caveat: Sybase Business Intelligence
Version No: 1.0
Version Date: 12 Sept 2001
, Status:
Table of Contents
1. Introduction..................................................................................................................1
1.1 Audience..............................................................................................................1
1.2 Scope....................................................................................................................1
1.3 Distribution..........................................................................................................1
1.4 References............................................................................................................1
2. Installation Planning..................................................................................................3
2.1.1 Hardware and Software Assessment............................................................3
2.1.2 Create a sybase user account........................................................................3
2.1.3 Modify the environment for the sybase user account..................................3
3. Adaptive Server IQ-M Software Installation..........................................................4
3.1 Server Installation................................................................................................4
3.1.1 Release Bulletin...........................................................................................4
3.1.2 Installation and Configuration Guide...........................................................4
3.1.3 Install the Adaptive Server IQ from CD......................................................4
3.1.4 Download the latest software patches from the Sybase support site...........4
3.1.5 Have the UNIX SA create links to the agreed upon database devices........4
3.1.6 Start the Sybase Central Agent....................................................................5
3.2 Client Installation.................................................................................................5
3.3 Creating the Database..........................................................................................5
3.3.1 Using Sybase Central...................................................................................5
3.3.2 Set the Main and Temp memory for the ASIQ-M Server...........................7
3.3.3 Important ASIQ-M Database Options.........................................................7
4. Creating Database Objects........................................................................................9
4.1 Database Security.................................................................................................9
4.1.1 Database Level Security..............................................................................9
4.1.2 Creating Database Users and Groups..........................................................9
4.1.3 Create Tables.............................................................................................10
4.1.4 Index Creation............................................................................................11
4.1.5 Managing User Permissions......................................................................12
4.2 Loading Tables with Data..................................................................................12
5. Monitoring ASIQ-M................................................................................................13
5.1.1 Monitoring which USERS are Connected.................................................13
5.1.2 Monitoring Client Connections and SQL..................................................13
5.1.3 Using the IQ Message Log to Monitor Activity........................................13
5.1.4 Sybase Adaptive Server IQ Performance Monitor....................................14
5.1.5 UNIX IO STAT.........................................................................................15
, Status:
1. Introduction
The Adaptive Server IQ Multiplex Implementation Guide is a technical guide
to setting up and tuning Sun server systems with Sybase Adaptive Server IQ
Multiplex (ASIQ-M). It provides high-level overview information about Sun
Solaris and Sybase ASIQ-M technology followed by guidelines for installing,
configuring and monitoring the ASIQ-M Server.
This document does not go through all details of the Solaris and ASIQ-M
products. Sun and Sybase provide comprehensive documentation on their
respective products. Only the features and techniques relevant to the
configuration and tuning of the Solaris and Sybase Adaptive Server IQ
Multiplex are covered here. The reader is directed to the product manuals and
the reference list for more details.
1.1 Audience
The primary audiences of this document are systems engineers and other
technical staff who deal with configuration and performance issues of ASIQ
12.4.3 on Solaris Servers. This document will be useful to a wide variety of
technical people working with Sun and Sybase Data Warehousing products.
1.2 Scope
This document covers products announced by Sun Microsystems Inc. and
Sybase, Inc. as of August 2001. The specific versions of Solaris and Sybase
ASIQ discussed are Solaris 2.8 and Sybase Adaptive Server IQ-M 12.4.3
respectively. Though in general the discussion may be valid for previous or
subsequent releases of these products, please refer to the release notes of the
specific product release and to the product manuals for up to date information.
1.3 Distribution
This document may not be copied in whole or in part, or presented to other
parties without the prior written consent of Sybase Business Intelligence.
1.4 References
Adaptive Server IQ 12.4.3 (Generic)
Adaptive Server IQ Administration and Performance Guide
Adaptive Server IQ Reference Manual
Introduction to Adaptive Server IQ
Adaptive Server IQ 12.4.3 (Platform Specific)
Adaptive Server IQ Release Bulletin for Sun Solaris
Adaptive Server IQ Installation and Feature Guide for Sun Solaris
Adaptive Server IQ Cover Letter for Sun Solaris 64bit EBF 2
Error: Reference source not found Page: 1 Version: 1.0, 12 Sept 2001
Sybase Business Intelligence
, Status:
2. Installation Planning
Error: Reference source not found Page: 2 Version: 1.0, 12 Sept 2001
Sybase Business Intelligence
, Status:
3.1.4 Download the latest software patches from the Sybase support site
Download the latest Software Release (SWR) for the ASIQ-M Major Version
and Operating System that you are planning to run.
Uncompress the Software Release (SWR) and review the Cover Letter for the
Software Release check for information about upgrade procedures and any
additional operating systems patches.
3.1.5 Have the UNIX SA create links to the agreed upon database devices
File system links are created using the ln command
Links provide a level of abstraction from the device physical name; this
allows the database devices to be referenced in a consistent manner across
any number of Servers that will be used in a multiplex configuration
Change the ownership and permissions of the underlying physical devices
so that the sybase user has read write access to the devices and all other
users can not access the devices
Error: Reference source not found Page: 3 Version: 1.0, 12 Sept 2001
Sybase Business Intelligence
, Status:
Error: Reference source not found Page: 4 Version: 1.0, 12 Sept 2001
Sybase Business Intelligence
, Status:
Specify the Multiplex Server Name; each ASIQ-M Server will have a
distinct name within the multiplex configuration
Specify the path to the top level directory of the multiplex, the top
level directory is a shared directory which is accessible by all Servers
in the multiplex configuration
Specify the path to the IQ Store (Main Store), use the link name for the
raw device where the ASIQ-M will store data. The size of the raw
device will be calculated automatically and cannot exceed 128 GB in
size, click the IQ Store is a Raw Device check box
Specify the name of the database, the database name is consistent
across all the servers within the configuration
The Database Page Size is the size that Data Pages are brought into IQ-
M Main Cache and written out to the IQ Main Store. The Page Size is
not modifiable after the database is created and changing the Page Size
requires rebuilding the Database and reloading it. The Page Size
should be selected based on the amount of memory available and the
size of the largest table.
Specify the link name to the temporary dbspace, each multiplex server
within a multiplex configuration will have a separate temporary
dbspace. This device should be placed on a raw device and should be
separated from other database devices
Accept the rest of the defaults:
Install base Java Classes
Install jConnect Meta-Information Support
Ignore trailing blanks in comparisons
Case sensitive for all Names and Values
Page Size for the new (catalog store) database – 4096 bytes
Collation Sequence of ISO_BINENG
Password: SQL
Review the summary information and then click the finish button. The
database and server will be created and with the initial configuration. If a
problem is encountered during the installation the Sybase Central Agent log
file should be reviewed to pinpoint the problem. Once the problem has been
identified re-run the “create database” wizard after making any necessary
corrections.
Error: Reference source not found Page: 5 Version: 1.0, 12 Sept 2001
Sybase Business Intelligence
, Status:
3.3.2 Set the Main and Temp memory for the ASIQ-M Server
The memory configuration can be adjusted by modifying the params.cfg file
Temp is normally configured with 60 to 70% of available cache
Main is normally configured with 30 to 40 % of available cache
Main is configured by adding the -iqmc switch to the params.cfg file,
specify the main cache size in MB
Temp is configured by adding the -iqtc switch to the params.cfg file,
specify temporary cache size in MB
Restart the multiplex for the new memory configuration to take affect
Launch dbisql or dbisqlc and run the sp_iqstatus command
Review the memory configuration of the ASIQ-M Server; the new
memory configuration should be in effect
An example setting cache size in the params.cfg file, 4 GB main cache and 12
GB temporary cache:
-iqmc 4096
-iqtc 12288
Error: Reference source not found Page: 6 Version: 1.0, 12 Sept 2001
Sybase Business Intelligence
, Status:
Error: Reference source not found Page: 7 Version: 1.0, 12 Sept 2001
Sybase Business Intelligence
, Status:
Error: Reference source not found Page: 8 Version: 1.0, 12 Sept 2001
Sybase Business Intelligence
, Status:
Error: Reference source not found Page: 9 Version: 1.0, 12 Sept 2001
Sybase Business Intelligence
, Status:
Care must be taken when creating tables with isql because the default
connection settings are different when connecting through open client
See the Adaptive Server IQ Administration and Performance Guide
CHAPTER 3 for detailed information about ASIQ-M tables
The sp_iqtable stored procedure can be used to view information about
all tables or a specific table
See the Adaptive Server IQ Reference Manual CHAPTER 13 for
detailed information about System Stored Procedures
Error: Reference source not found Page: 10 Version: 1.0, 12 Sept 2001
Sybase Business Intelligence
, Status:
Error: Reference source not found Page: 11 Version: 1.0, 12 Sept 2001
Sybase Business Intelligence
, Status:
5. Monitoring ASIQ-M
There are several tools that are useful for monitoring the ASIQ-M Server and
resources at the operating system level. This section provides a high level
view of some of the different monitoring methods.
Error: Reference source not found Page: 12 Version: 1.0, 12 Sept 2001
Sybase Business Intelligence
, Status:
Each time it inserts the number of records specified in the NOTIFY load
option, Adaptive Server IQ sends a message like this:
The first line shows how many rows Adaptive Server IQ has read since the last
notification message, and the number of seconds taken reading them. Even if
Adaptive Server IQ reads the same number of messages each time, the amount
of time will vary depending on the data read (for example, how many data
conversions are required). Reported time intervals smaller than 1 second are
usually reported as “0 Secs”.
This information was split into two sections to make it more readable:
Active Main Cache
Users Finds HR% Reads/Writes GDirty Pin% Dirty% InUse%
2 24873652 99.9 194118/282041 60 0.1 6.7 100.0
2 0 0.0 0/0 0 0.1 6.7 100.0
2 0 0.0 0/0 0 0.1 6.7 100.0
2 0 0.0 0/0 0 0.1 6.7 100.0
2 1204 100.0 0/0 0 0.1 6.8 100.0
2 0 0.0 0/0 0 0.1 6.8 100.0
2 0 0.0 0/0 0 0.1 6.8 100.0
Temp Cache
Finds HR% Reads/Writes GDirty Pin% Dirty% InUse%
1377806 100.0 0/1248 0 0.0 0.9 1.0
0 0.0 0/0 0 0.0 0.9 1.0
0 0.0 0/0 0 0.0 0.9 1.0
0 0.0 0/0 0 0.0 0.9 1.0
2 100.0 0/0 0 0.0 0.9 1.0
0 0.0 0/0 0 0.0 0.9 1.0
Error: Reference source not found Page: 13 Version: 1.0, 12 Sept 2001
Sybase Business Intelligence
, Status:
Error: Reference source not found Page: 14 Version: 1.0, 12 Sept 2001