Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

64
Installation and Configuration Guide SAP Sybase IQ 16.0 SP03 Sun Solaris

Transcript of Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

Installation and Configuration Guide

SAP Sybase IQ 16.0 SP03

Sun Solaris

DOCUMENT ID: DC30066-01-1603-01LAST REVISED: December 2013Copyright © 2013 by SAP AG or an SAP affiliate company. All rights reserved.No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission ofSAP AG. The information contained herein may be changed without prior notice.Some software products marketed by SAP AG and its distributors contain proprietary software components of other softwarevendors. National product specifications may vary.These materials are provided by SAP AG and its affiliated companies ("SAP Group") for informational purposes only,without representation or warranty of any kind, and SAP Group shall not be liable for errors or omissions with respect to thematerials. The only warranties for SAP Group products and services are those that are set forth in the express warrantystatements accompanying such products and services, if any. Nothing herein should be construed as constituting an additionalwarranty.SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks or registeredtrademarks of SAP AG in Germany and other countries. Please see http://www.sap.com/corporate-en/legal/copyright/index.epx#trademark for additional trademark information and notices.

Contents

Preparing for Installation ......................................................1About SAP Sybase IQ ....................................................1

Supported Server Platforms ..................................1Supported Client Platforms ....................................1Licensing Requirements ........................................1Installation Media ...................................................2

Planning Your Installation ...............................................2Installing For the First Time ...................................2Upgrading From an Earlier Version ........................2Changing Hardware Platforms ...............................3Planning for Distributed Query Processing or

High Availability .................................................3Preinstallation Tasks .......................................................3

Check for Operating System Patches ....................4Increase the Swap Space ......................................4License Server Requirements ...............................4Manage Shared Memory .......................................4Set the File Descriptor Limits .................................5Verify Network Functionality ..................................5Windows Installer Requires Microsoft Visual C+

+ 2005 SP1 Redistributable Package ................6Licensing Your Software .......................................................7

Available Licenses ..........................................................7Enterprise Edition (EE) ..........................................7Small Business Edition (SE) ..................................9Evaluation Edition ..................................................9Express Edition ......................................................9Single Application Edition (SA) ............................10

Before You Generate Your License ...............................10Read the SySAM Documentation ........................10

Installation and Configuration Guide iii

Decide On the License Model You Want To Use.........................................................................10

Get Your Host ID ..................................................11Determine the Host Name ...................................11Choose a Port Number ........................................11

Generating a SySAM License .......................................11Installing a New License Server ...................................12Starting a License Server .............................................13

Server Installations ..............................................................15Sybase Accounts ..........................................................15Server Components ......................................................15What a Server Installation Does ...................................16SAP Control Center ......................................................18

SCC Installation Scenarios ..................................20SCC Installation Options ......................................20

Other SAP Sybase IQ Installation Options ...................22Installing Server Software .............................................22

Installing in GUI Mode .........................................22Installing from the Command Line .......................23Installing in Unattended (Silent) Mode .................23Setting the Environment Variables .......................24Install Logs ...........................................................25

Solutions to Common Installation Problems .................26Uninstalling SAP Sybase IQ .........................................26

Testing Installed Products ..................................................29Demo Database ............................................................29

Starting the Demo Database ...............................29Table Names ........................................................29

Running SAP Sybase IQ Server ...................................30Stopping Servers ..........................................................32Starting and Stopping the SAP Sybase Control Center

Agent ........................................................................34Running Interactive SQL ...............................................34Post-Installation Tasks ..................................................35

Verify Your License ..............................................35

Contents

iv SAP Sybase IQ

Change the Default Connection Parameters .......39Remove Sample Application Files .......................39

Client Installations ...............................................................41Client Components .......................................................41What a Client Installation Does .....................................41Installing Client Software ..............................................43

Installing in GUI Mode ......................................... 43Installing from the Command Line ......................43Installing in Unattended (Silent) Mode .................43Setting Environment Variables .............................45

Configuration ......................................................................47Using Configuration Files ..............................................47Configuring Client Connectivity .....................................48

Connecting Using ODBC .....................................48Connecting Using JDBC ......................................51Connecting Using OLE DB ..................................51Connecting Using Open Client ............................ 52Running the Client and Server On the Same

System ............................................................ 52Network Issues for SAP Sybase IQ Servers ........53Connecting Across a Firewall ..............................53

Index ..................................................................................55

Contents

Installation and Configuration Guide v

Contents

vi SAP Sybase IQ

Preparing for Installation

Read this section before you install SAP® Sybase® IQ.

About SAP Sybase IQSAP® Sybase® IQ is a high-performance decision-support server designed specifically formission-critical business intelligence, analytics, and data warehousing. ComponentIntegration Services within SAP Sybase IQ provide direct access to relational and non-relational databases on mainframe, UNIX, or Windows servers.

Supported Server PlatformsSAP Sybase IQ is compatible with these platforms and operating systems.

• Sun Solaris 10 (SPARC T) for 64-bit systems – minimum patch level 14 January 2008• Sun Solaris 10 (x64) for 64-bit systems – minimum patch level 11 January 2008. Patch

119961-04 also required

Supported Client PlatformsSAP Sybase IQ includes a network client for all supported server platforms.

All SAP Sybase IQ UNIX and Linux installations include ODBC drivers needed for the clientand Interactive SQL. SAP Sybase IQ Network Client for Windows includes 32-bit ODBCWindows drivers, which allow you to connect to SAP Sybase IQ from third-party 64-bitWindows applications, and 64-bit Windows applications written in C++. Platform support forthe Windows network client includes Windows 2008 R2 SP1 and Windows 7 SP1.

Licensing RequirementsAll product editions except the Evaluation Edition require a license. Optional features are soldand licensed separately.

Whether you install a licensed or evaluation edition, you have 30-day access to all features andoptions. To use an option beyond the 30-day evaluation period, you must purchase and installan appropriate SAP Sybase Software Asset Management (SySAM) license.

The e-mail message or Web key you receive when you purchase an SAP Sybase productprovides specific product and licensing information. Before installing and configuring anyproduct edition, know which features you are licensed to use.

Preparing for Installation

Installation and Configuration Guide 1

Installation MediaSAP Sybase IQ installation media includes software for server and client installations.

Table 1. SAP Sybase IQ Installation Media.

Media Description

SAP Sybase IQ ServerSuite

Installs server components and other support tools.

SAP Sybase IQ ClientSuite

Installs the components required for client connections to a SAP Sybase IQserver.

Planning Your InstallationThe installation process depends on whether you are installing for the first time, upgradingfrom a previous version, or migrating your databases to a new hardware platform.

Installing For the First TimeFollow these steps to install SAP Sybase IQ for the first time.

• Read the release bulletin for the latest information. See the special installation instructionssection for any installation instructions not included in this document.

• Complete all pre-installation tasks. Apply any required operating system patches, check tosee that there is sufficient disk space and memory, and update any necessary configurationchanges.

• Determine the license model you want to use. SySAM supports served and unservedlicense models. See the Sybase Software Asset Management (SySAM) 2 Users Guide todetermine which model is best suited for your environment.

• Use the product and licensing information you received from SAP Sybase to log in to theSAP Sybase Product Download Center at: https://sybase.subscribenet.com or SAPService Marketplace at http://service.sap.com/licensekeys and generate a license key foryour software.

• Install SAP Sybase IQ server components, activate your license, then start and test yourserver.

• Install and configure SAP Sybase IQ client components.

Upgrading From an Earlier VersionFollow these general guidelines when you install a new version of SAP Sybase IQ.

• Choose an appropriate installation directory. You cannot install SAP Sybase IQ in thesame parent directory as an earlier version. Uninstall the version currently installed onyour system, or install in a different parent directory.

Preparing for Installation

2 SAP Sybase IQ

• Upgrade your client tools. Although you can use the current version of the client tools toconnect to an earlier server version, some options, tools, and objects may not be available.

Additional InformationMigration > Database Upgrades

Changing Hardware PlatformsAlthough SAP Sybase IQ Server Suite is no longer available for 32-bit platforms, you canmove a 32-bit database to a 64-bit platform.

Additional Informaiton

• Migration > Hardware Changes > Moving 32-Bit Databases to 64-bit Platforms• Migration > Hardware Changes > Converting to a new hardware platform

Planning for Distributed Query Processing or High AvailabilityDistributed query processing can benefit from an optional high-speed interconnect. Usescalable interconnect technology to connect multiplex nodes.

For best performance, use:

• A high-speed network interconnect providing a local network that connects all multiplexnodes. Use an interconnect bandwidth of 1Gb or higher or the highest bandwidth, lowestlatency interconnect available.

• Two physically separate network interfaces for each multiplex node:• A public network for multiplex interconnection traffic and client traffic.• A private network for multiplex interconnect traffic only, excluding external client

traffic. Currently, multiplex interconnects support only the TCP/IP standard.These two networks improve security, fault-tolerance, and performance.

• A switch that enables high-speed communication between nodes.• Network cards that reside on different fabrics so that the multiplex survives network

failure. Separate the public and private networks physically.• Private interconnect fabrics that contain only links to machines participating in the

multiplex. Private interconnect for all multiplex nodes should connect to the same switch,which connects to no other public switches or routers.

• Redundant network interface cards added to private or public networks if desired. Theprivate and public connection information allows for multiple IP addresses on each.

Preinstallation TasksPerform the following tasks before you install SAP Sybase IQ.

Preparing for Installation

Installation and Configuration Guide 3

Check for Operating System PatchesCheck with your vendor and apply the latest operating system patches. Do not use a patch thatis earlier than the version suggested for your operating system.

Increase the Swap SpaceThe recommended minimum swap space is at least 1GB. Certain operations may cause thememory usage to grow dynamically. Changing the way SAP Sybase IQ uses buffers candramatically change the way it uses memory.

Depending on the load, swap requirements may exceed space allotted. Insufficient swap spacemay result in the system supporting fewer users, and large processes that cannot acquiresufficient swap space may be prematurely killed by the operating system.

See your operating system documentation for information about extending swap space.

License Server RequirementsSAP Sybase IQ requires SySAM license server version v11.6.1 or later, which is distributedon the SAP Sybase IQ Server Suite installation media. Using an older SySAM server cancause the server to become unresponsive. Install the license server before you install SAPSybase IQ.

The SySAM license server is installed as part of a custom install. To check the version of yourcurrent SySAM license server, open a console or command prompt, change to $SYBASE/SYSAM-2_0/bin, and enter:./lmutil lmver lmgrd

If you currently use a license server to host SySAM licenses for other Sybase products:

• Uninstall your current license server• Install the license server distributed on the SAP Sybase IQ Server Suite DVD• Rehost your licenses

Rehost your SySAM licenses after you install the new license server.

Addtional InformationSybase Software Asset Management (SySAM) 2 Users Guide

Manage Shared MemoryIn some cases, increasing the shared memory segment can lead to better network performance.

SAP Sybase IQ uses shared memory for two purposes:

• When the client and server are installed on the same system, shared memory is the defaultcommunication mechanism, not TCP/IP.

Preparing for Installation

4 SAP Sybase IQ

• When you specify the server command-line option -iqwmem, shared memory is used toprovide wired memory.

If the -iqwmem option is used, increase the maximum shared memory segment size parameterin the /etc/system configuration file. Specify a configuration for the largest amount ofwired memory you expect your system to support.

To create a shared segment to support a maximum physical memory of 3350MB for yoursystem, for example, add the following line to the /etc/system file:

set shmsys:shminfo_shmmax=0xffffffff

Never set shmmax to a value greater than 7/8 of physical memory.

Local connections through shared memory are not supported for Sun Solaris x64 systems. Usestandard network connectivity by adding the parameters -host <hostname> and -port<portnumber> to the client connection string.

Additional Information

• Connection and Communication Parameters Reference > Network CommunicationsParameters

• Utility Guide » start_iq Database Server Startup Utility » start_iq Server Options > -iqwmem iqsrv16 Server Option

Set the File Descriptor LimitsTo use the Solaris debugger, add a file descriptor for each thread in addition to the filedescriptors for each dbspace.

Although the Solaris thread limit is not a problem, using the Solaris debugger on IQ requires afile descriptor for each thread in addition to the file descriptors for each dbspace. You need toadjust the number of file descriptors by means of the C shell limit command and by includingset rlim_fd_max=4096 in /etc/system.

Verify Network FunctionalityMake sure your network devices can communicate before you install SAP Sybase IQ.

SAP Sybase IQ uses networking software whenever the client and server components areinstalled on different systems. Use the ping command to and from another computer to verifythat the server where you plan to install SAP Sybase IQ can use TCP/IP to communicate withother devices on your network.

Preparing for Installation

Installation and Configuration Guide 5

Windows Installer Requires Microsoft Visual C++ 2005 SP1Redistributable Package

Launching the installer may return the following exception: Windows error 14001occurred while loading the Java VM.

If you get this error, install the Microsoft Visual C++ 2005 Service Pack 1 RedistributablePackage MFC Security Update before launching the installer again. This service pack isincluded as part of the installation package.

1. Open Windows Explorer.

2. Navigate to \archives\ms-redist-2005 on the installable image.

3. Do this:

• On 32-bit machines, run vcredist_x86.exe• On 64-bit machines, run vcredist_x86.exe and vcredist_x64.exeMicrosoft Visual C++ 2005 Service Pack 1 Redistributable Package MFC Security Updateis also available as a free download from the Microsoft Download Center at: http://www.microsoft.com/en-us/download/details.aspx?id=26347 .

Preparing for Installation

6 SAP Sybase IQ

Licensing Your Software

When you purchase a SAP Sybase product, you receive an e-mail message or a Web key thattells you how to generate SAP Sybase IQ license keys on the Web. The e-mail message or Webkey also provides specific product and licensing information. Use this information when yougenerate your licenses.

Available LicensesAvailable licenses are determined by the product edition and options you purchase.

Enterprise Edition (EE)SAP Sybase IQ Enterprise Edition requires a CPU license and supports several licensingoptions.

Table 2. Enterprise Edition.

Order-ableLi-

cense

ActualLicense

Re-quired

Op-tional

Description

CPU IQ_CORE

• Restricts the number of cores (not CPUs) that a server can use

LOMO IQ_LOB • Allows you to create and use CLOB or LOB columns. The num-ber of LOB licenses must match number of cores.

IQ_LOB license is included for customers who purchase anIQ_UDA license. An IQ_LOB license is also available as a sep-arate purchase option.

Licensing Your Software

Installation and Configuration Guide 7

Order-ableLi-

cense

ActualLicense

Re-quired

Op-tional

Description

VLDBMO

IQ_VLDBMGMT

• Allows you to create multiple tablespaces and additional dbspa-ces beyond the defaults:

• You are allowed one IQ_SYSTEM_TEMP dbspace, oneIQ_SYSTEM_MAIN dbspace, one IQ_SHARED_TEMP,and one additional user defined main store dbspace.

• Additional dbspaces require the IQ_VLDBMGMT license,which restricts the ability to create table partitions. AnIQ_VLDBMGMT is required whenever an SAP Sybase IQserver creates or starts with two or more IQ user dbspaces.

Each VLDB license allows for 1 TB of storage. You will need topurchase one license for each additional TB of storage in themain store.

ASO IQ_SE-CURITY

• Allows you to use column encryption, ECC Kerberos and FIPS.The number of ASO licenses must match cores.

MPXO IQ_MPXNODE

• Allows you to start secondary multiplex nodes (readers/writers).The number of nodes must always be less than cores, as eachmultiplex server must have at least one core.

IDBA-PSO

IQ_UDF • Allows you to define and run high-performance scalar and ag-gregate user-defined functions.

This license is only available with approved third-party libraries.

IQ_IDA • Allows you to build, deploy and run your own C/C++ V4 User-Defined Functions (UDF).

The IQ_IDA license will function as both the InDatabase Ana-lytics Option and Partner Solutions license.

UDA IQ_UDA • Allows you to use the IQ Text Search functionality, which letsSAP Sybase IQ search unstructured and semi-structured data. AnIQ_UDA also includes an IQ_LOB license. This license appliesto TEXT indexes.

Licensing Your Software

8 SAP Sybase IQ

Small Business Edition (SE)SAP Sybase IQ Small Business Edition requires a CPU license.

Table 3. Small Business Edition.

OrderableLicense

Actual License Re-quired

Optional Description

CPU IQ_CORE • Licenses the number of sockets (notCPUs) which an IQ server can use.

Note:

• Server checks out licenses equal to the number of sockets. One license allows one socket,and you can have up to four licenses. The total number of cores should never exceed 4(MAXCP).

• Total concurrent IP connections <= 25 (MC).• Total main store <= 250GB (MS).

Evaluation EditionThe Evaluation Edition does not require a license. The Evaluation Edition is an unlicensedserver, which provides full access to all features and options available in the EnterpriseEdition. To run an unlicensed database beyond a 30-day evaluation period, however, you mustpurchase and install an appropriate license.

Express EditionUnlike the Evaluation Edition, the Express Edition does not expire, but does place some limitson the way you deploy your server.

Available at no cost, the SAP Sybase IQ Express Edition supports all options and featuresavailable in the Evaluation Edition. The Express Edition includes a new IQ_XE SySAMlicense, which is installed as part of the Express Edition server package.

Unlike the Evaluation Edition, which limits server access to a 30-day appraisal period, theIQ_XE SySAM license does not expire. However, the IQ_XE license restricts the aggregatedsize of all IQ main dbspaces to a size of 5GB or less, and does not allow you to add any otherincremental license options. The SAP Sybase IQ Express Edition is not eligible for productiondeployment and is not supported by SAP Sybase Customer Service and Support (CS&S).

Licensing Your Software

Installation and Configuration Guide 9

Single Application Edition (SA)SAP Sybase IQ Single Application Edition requires a CPU license.

Table 4. Single Application Edition.

OrderableLicense

Actual License Required Optional Description

CPU IQ_CORE • Licenses the number of cores (notCPUs) which an IQ server can use.

Note: Other limits set by the SA license

• Total cores per server <= 64 (MAXCP)• Total number of user tables <= 25 (MT)• Total number of columns <= 100 (MV)• Total number of mpx nodes <= 1 (MSN)

Before You Generate Your LicenseFollow these steps before you generate your license.

Read the SySAM DocumentationReview the SySAM documentation for specific information about SySAM licensing, licensemodels, and procedures.

• Sybase Software Asset Management (SySAM) 2 Users Guide introduces assetmanagement concepts and provides instructions for establishing and administeringSySAM 2 licenses.

• SySAM 2 Quick Start Guide tells you how to get your SySAM-enabled SAP Sybaseproduct up and running quickly.

• FLEXnet Licensing End User Guide explains FLEXnet Licensing for administrators andend users and describes how to use the tools which are part of the standard FLEXnetLicensing distribution kit from SAP Sybase.

Decide On the License Model You Want To UseA license model refers to the way you set up your license files for your licensed programs.License files can reside on a central, networked license server in a served license model or onthe machine running the licensed program in an unserved license model.

Decide on the license model you want to use before you generate your license file. Forinformation about served and unserved licenses, and which model is best suited for yourenvironment. See the Sybase Software Asset Management (SySAM) 2 Users Guide.

Licensing Your Software

10 SAP Sybase IQ

Get Your Host IDTo install or use a license server, you need the license server host ID.

FLEXnet Licensing uses different machine identifications for different machinearchitectures. If you have a copy of the FLEXnet licensing utilities installed, you can use thelmhostid utility to print the exact host ID that FLEXnet Licensing expects to use on anygiven machine. lmutil is included in your product distribution, or you can download a copyfrom the FLEXnet Publisher download page at: http://www.globes.com/support/fnp_utilities_download.htm#unixdownload

You can also use a system-level command to find the host ID. For platform-specificcommands and examples, see Hostids for FLEXnet Licensing-Supported Platforms at: http://www.flexerasoftware.com/products/flexnet-publisher/requirements.htm.

Note: Some platforms derive the host ID from the network adapter address. If your machinehas multiple network adapters, the command you use to get the host ID may return one host IDfor each network adapter. If this occurs, choose only one from the list of host IDs. Use thevalue associated with the primary wired Ethernet adapter. Do not use values associated withinternal loopback adapters.

Determine the Host NameYou must specify the host name of the license server for served licenses. Although the hostname is optional for unserved license models, providing the host name for all license types cansimplify future license administration tasks.

Choose a Port NumberIf you plan to install a license server or use an existing license server, you need to know theTCP/IP port number that the license server will use to serve your licenses.

If you do not specify a port number, the license server uses the first available port in the rangeof 27000 to 27009. If you are using three-server redundancy, specify a port number outside ofthis range.

Generating a SySAM LicenseLogin to SAP Sybase Product Download Center or SAP Service Marketplace. Refer to theWeb key or email you received for information about your account.

When you purchase SySAM 2–enabled SAP Sybase products, you must generate, download,and deploy SySAM product licenses.

• Before you generate your license, you need the host ID and host name of the server whereyou plan to install SAP Sybase IQ.

Licensing Your Software

Installation and Configuration Guide 11

• Served licenses require a license server. If you do not plan to use an existing license server,you must install one before you install SAP Sybase IQ.

1. Start your browser, and do one of the following:

• If you purchased your product from SAP Sybase or authorized SAP Sybase reseller:Log in to the SAP Sybase Product Download Center at: https://sybase.subscribenet.com to generate license keys for SAP Sybase products that useSySAM 2-based licenses.

• If you ordered your product under an SAP contract and were directed to downloadfrom SAP Service Marketplace:Log in to the SAP Service Marketplace at: http://service.sap.com/licensekeys togenerate license keys for SAP Sybase products that use SySAM 2-based licenses.

2. Follow the online instructions.

3. Save your license to a temporary location on the local file system. You must save thelicense file with a .lic extension.

Note: The process you use to generate license keys on the Sybase Product DownloadCenter at: https://sybase.subscribenet.com depends on whether you purchased yourproduct directly from Sybase, or from a Sybase reseller.

Installing a New License ServerThe SAP Sybase IQ Server Suite installation media includes SySAM Network License Serverutilities you can use to install a new license server.

Prerequisites

• Stop any servers currently running in the installation directory.

Task

1. Insert the installation media into the drive.

If the installer does not start automatically, mount the drive, then enter:<DVD_mount_directory>/setup.bin

2. On the Welcome screen, click Next.

3. Choose an installation directory, then click Next.

4. Choose Custom as the installation type you want to perform, click Next.

5. Unselect all installation options except SySAM License Utilities.

6. Select SySAM License Server, click Next.

7. Review the installation summary, then click Install.

Licensing Your Software

12 SAP Sybase IQ

Starting a License ServerCopy your license to the license directory, and start the license server from a console orcommand line.

1. From a console or command line, copy the license file you generated to the $SYBASE/SYSAM-2_0/licenses directory on the network license server.

2. Change to $SYBASE/SYSAM-2_0/bin , then refresh or restart the license server:

sysam start Start the license server.

Perform this step if the license server is not running. After you performthis step, repeat step 2 to verify that the server is running.

sysamreread

Make the license server read the new license file.

Perform this step if the license server is already started.

3. To verify that the license server is running, enter sysam status.

Note: The SySAM License Server Installer installs both IPv4-only and IPv4/IPv6 dual-stack license server binaries during installation and configures use of IPv4-only binaries.

Use the sysam configure [IPv6 | IPv4] to configure the appropriate version of the licenseserver. For example, sysam configure IPv6 will configure use of the IPv4/IPv6 dual stackbinaries. For more information, see SySAM Users Guide.

Licensing Your Software

Installation and Configuration Guide 13

Licensing Your Software

14 SAP Sybase IQ

Server Installations

Read this section for step-by-step server installation instructions.

Sybase AccountsCreate a Sybase account to provide consistent ownership and privileges for all installation,configuration, and upgrade tasks.

The sybase user must have privileges from the top (or root) of the disk partition or operatingsystem directory down to the specific physical device or operating system file. If you havealready installed other SAP Sybase software, the sybase user may already exist. If so, verifythat you can log in to the machine using this account.

If there is no sybase account on your system, see your operating system documentation forinstructions about creating new user accounts.

Server ComponentsServer components are grouped by feature. Items marked as default are installed in typicalinstallations. Optional items can be installed in custom installations.

Table 5. SAP Sybase IQ Server Components.

Feature Components De-fault

Notes

SAP Sybase IQ SAP Sybase IQ Server • Installs server software, client tools, ODBCdrivers, and Web application developmenttools.

Additional Connectivity Language Modulessupport character sets for Eastern Europe,Turkey, and Greece.

SAP Sybase IQ Client •

SAP Sybase IQ Web Driv-ers

SAP Sybase IQ ODBCDriver

SAP ControlCenter

Management User Inter-face for SAP Sybase IQ

SAP Control Center (SCC) is a Web-basedadministrative console for Sybase products.At least one SCC server is required to deploySAP Control Center.

Remote Command andControl Agent for SAPSybase IQ

•SAP Control Center Agent is required tomanage SAP Sybase IQ servers within SAPControl Center.

Server Installations

Installation and Configuration Guide 15

Feature Components De-fault

Notes

jConnect jConnect 7.0 for JDBC • jConnect is a Type 4 JDBC driver, which isentirely Java-based. jConnect 7.0 is JDBC4.0 compliant

SySAM SySAM License Server Installs FLEXnet Licensing utilities to sup-port your licensing model.

SySAM License Utilities •

What a Server Installation DoesA typical installation installs the server and other components into a parent directory on thehost machine.

Directory VariablesSAP Sybase IQ uses environment variables that point to different installation directories.

Table 6. Directory Variables.

Variable Description

$SYBASE Points to the parent installation directory. This variable is set by theinstaller.

$IQDIR16 Points to the product installation directory. This variable is set with ashell command after you run the installer.

Note: Do not install SAP Sybase IQ into a destination directory or path that contains spaces.The GUI installer warns you if you try to install to an invalid path; other installation methodsdo not display this warning.

Parent Installation DirectoryThe $SYBASE directory contains the files, scripts, and other objects required to support theserver.

Table 7. Parent Installation Directory.

Directory Contents

charsets Character sets available for compatibility with Adaptive Server Enter-prise.

collate Collation sequences available for compatibility with Adaptive ServerEnterprise.

Server Installations

16 SAP Sybase IQ

Directory Contents

config Various configuration files.

IQ-16_0 Subdirectories, scripts, and property files required to run the server.

jConnect-7_0 JDBC 4.0 compliant driver for SAP Sybase IQ.

jre Java runtime environment.

jutils-3_0 Version 3.0 Java-based utilities, including Ribo, a Tabular Data Streamsutility.

locales Language modules for system messages and date/time formats.

log Installation log files.

OCS-15_0 Open Client tools and utilities.

SCC-3_3 SAP Control Center startup and configuration files.

shared Objects and libraries shared by other components, including the JavaRuntime Environment (JRE).

Sybase_Install_Registry Server registry file that holds information related to the installed prod-ucts. Do not modify.

sybuninstall Subdirectories for scripts that uninstall SAP Sybase IQ and SySAM.

SYSAM-2_0 SySAM licenses and utilities. This directory contains three subdirecto-ries: bin, licenses, and log.

ThirdPartyLegal Third party license terms and agreements.

Product Installation Directory$IQDIR16 is a $SYBASE subdirectory that contains the files, scripts, and other objectsrequired to run the server.

Table 8. Product Installation Directory.

Directory Contents

bin64 Utilities you use to start and manage your server.

demo Sample data and scripts for the demo database.

install Installation history file.

java Different JAR files.

lib64 Various library files.

Server Installations

Installation and Configuration Guide 17

Directory Contents

logfiles SAP Sybase IQ writes log files to this directory.

lsunload Local Store Unload utility.

res Character encoding resource files.

samples Sample SQL Anywhere tools and scripts.

scripts Sample scripts and stored procedures.

sdk Subdirectories for various language utilities.

shared Objects and libraries shared by other components, including the JavaRuntime Environment (JRE).

Sysam Local SySAM configuration information.

tix Tcl/Tk extension library.

unload Various unload scripts, files, and utilities.

SAP Control CenterSAP Control Center is a Web-based administrative console, which lets you manage andmonitor SAP Sybase IQ in a graphical environment.

SAP Control Center (SCC) includes a Management User Interface, Remote Command andControl Agent, and Web client. The Management User Interface, or SCC server, managescommunication between the SCC agent and client. The SCC agent is installed with the SAPSybase IQ server, and continually broadcasts information about the server to subscribingclients via the SCC server. Messages from an SCC client pass through the SCC server to theagent, which in turn, processes the request on the SAP Sybase IQ server.

SCC activities range from simple resource monitoring to complete database administration.Specific user activities are determined by the role assigned to the user initiating the request.

Server DeploymentA single SCC server can monitor up to 250 resources. (The number of resources one SCCserver can effectively monitor depends on the complexity of the monitored resources, thefrequency of data collection, the number of concurrent SCC users, and the hardwareconfiguration of the host on which SCC is running.) To monitor more than 100 resources,install additional SCC servers and distribute the resources among them. The monitoring limitapplies whether you install SCC on the same machine as a managed server or on a dedicatedmachine.

Server Installations

18 SAP Sybase IQ

Installation locationsSCC may collect and store performance data for every server it monitors. Because datacollection can use significant quantities of CPU cycles, disk space, and network resources,SCC can affect the performance of other servers sharing the same host machine. Choose yourinstallation location carefully before installing an SCC server on the same host as a managedserver in a production environment.

Table 9. SCC Installation Locations.

Location Description

Dedicated SCC Host Installing an SCC server on a dedicated host lets you manageall SAP Sybase servers from a single location. This method isrecommended for production environments.

Shared SCC and SAP Sybase IQHost

Installing an SCC and SAP Sybase IQ server on the same host.This deployment method is suitable for test environments, butnot recommended for production.

Existing SCC server Unless the current SCC server is approaching the resourcelimit or requires an upgrade, a separate SCC server installationmay not be necessary.

If you install SCC on the same machine as an SAP Sybase IQ server, consult the systemrequirements for both SCC and the SAP Sybase IQ server and make sure that the host machineprovides ample CPU, RAM, disk, and network resources for both products. The resourcesrequired by an SAP Sybase IQ server vary a great deal based on the server's configuration, asdo the resources required by SCC. In general, SCC uses more resources to manage morecomplex servers. SCC also uses more resources when it is configured to run more frequentdata collections.

Note: For additional SCC installation options, see:

• SAP Control Center Installation Guide – provides complete installation, configuration,and troubleshooting procedures. This document is available on the Web at: http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc01002.0327/doc/html/title.html.

• SAP Control Center for SAP Sybase IQ – includes SAP Sybase IQ configurationprocedures, user assistance, and troubleshooting information.

Server Installations

Installation and Configuration Guide 19

SCC Installation ScenariosReview these SCC deployment scenarios to determine which SAP Sybase IQ installationmethod to use and when.

Dedicated SCC HostInstall SCC and SAP Sybase IQ servers on separate hosts in a production environment.

1. Start the SAP Sybase IQ Installer in GUI or Console mode on the SAP Sybase IQ host.2. Run a Custom Install.3. Unselect the Management User Interface for Sybase IQ option, then complete the

installation.4. Start the SAP Sybase IQ Installer in GUI or Console mode on the SCC host.5. Run a Custom Install.6. Unselect all installation options, except the Management User Interface for Sybase IQ

option, then complete the installation.

Shared SCC and SAP Sybase IQ HostIn a test environment, you may want to install SAP Sybase IQ and SCC on the same host.

1. Start the SAP Sybase IQ Installer in GUI or Console mode.2. Run a Typical Install.3. Follow the instructions on the screen.

Shared SCC ServerTo use an existing SCC server for SAP Sybase IQ.

1. Start the SAP Sybase IQ Installer in GUI or Console mode.2. Run a Custom Install.3. Unselect the Management User Interface for Sybase IQ.4. Click Next, and then follow the instructions on the screen.

SCC Installation OptionsReview these settings and options before you install SCC.

SAP Control Center (SCC) AuthenticationInitial passwords for SCC administrator and SCC agent are set in the SAP Sybase IQ installer.SCC passwords must have at least 6 characters.

Role Requirements

SCC Administrator SCC Administrator is a preconfigured login with access to allSCC administration features. The default SCC Administratoruser name is sccadmin.

Server Installations

20 SAP Sybase IQ

Role Requirements

SCC Agent User SCC Agent User name for authentication of the agent. Thedefault SCC Agent User name is uafadmin.

Network PortsSCC uses TCP ports for a variety of services. You can choose new RMI, HTTP, or HTTPS portnumbers in the installer if the default ports are unavailable.

Table 10. SAP Control Center Port Numbers.

Port Name DefaultPortNumber

Required? Description

RMI 9999 Yes SCC server port used for RMI protocol access.

HTTP 8282 Yes SCC server port used for HTTP Web access to theserver. All HTTP traffic is redirected to the secureHTTPS channel.

HTTPS 8283 Yes SCC server port used for secure HTTPS Web accessto the server. All HTTP traffic is redirected to thesecure HTTPS channel.

Database 3638 Yes SCC server repository database port; used by severalservices.

MessagingService

2000 Yes SCC server messaging port.

Tds 9998 No SCC server port used for Tabular Data Stream™

(TDS) protocol access.

Jini Http 9092 No Jini HTTP port for Jini discovery services.

Jini Rmid 9095 No Jini RMID server port for Jini discovery services.

Ldap 389 No LDAP discovery service adaptor port.

SCC Server Start Up OptionIf you install an SCC server, the SAP Sybase IQ installer includes an option that lets you startthe server from within the installer.

Additional Information

• SAP Control Center Installation Guide > Planning Your Installation > SystemRequirements

Server Installations

Installation and Configuration Guide 21

• SAP Control Center Installation Guide > Planning Your Installation > SCC Network Ports

Other SAP Sybase IQ Installation OptionsInstalling a licensed copy of SAP Sybase IQ Server Suite includes configuration options notavailable in the evaluation edition.

License KeysThe license you downloaded from the SAP Sybase Product Download Center or SAP ServiceMarketplace Web site contains the license key(s) for your software.

Option Action

Specify License Keys Browse to the location of license file and choose the licensefile.

Use License Server Identify the license server Host Name and Port Number.

Install without License Key Click Continue installation without a license key.

If you don't specify a license, you can continue to installwithout a license, but you must obtain the required licensekey(s) within 30 days or the server will stop functioning.

Email AlertsTo configure email alerts, you must provide:

• SMTP server host name• SMTP server port number• Sender email• Recipient emails (for multiple recipients, separate each email address with a comma)• Message severity for email alerts (Information, Warning, Error)

Installing Server SoftwareServer installation media supports GUI, console, and unattended (silent) installs.

Installing in GUI ModeUse this option to set up your software in a graphic user interface (GUI) environment. The GUIinstaller is wizard-driven and supports all product editions and installation types.

1. Insert the installation media into the drive.

If the installer does not start automatically, mount the drive, then enter:<DVD_mount_directory>/setup.bin

Server Installations

22 SAP Sybase IQ

2. Follow the instructions on the screen.

3. Unmount, if necessary, and remove the installation media from the drive.

Installing from the Command LineChoose a command-line installation if you prefer a non-GUI interface or for developingcustom installation scripts. Installing components in console mode is similar to installing inGUI mode, except that you run the installer from the command line, and enter text to select theinstallation options.

1. Insert the installation media into the drive.

If the installation program launches automatically, click Cancel to stop the installer.

2. From a console, change to the setup directory.

The setup directory is the directory that contains setup.bin,installer.properties, and other installation files.

3. Enter:setup.bin -i console

4. Follow the instructions on the screen.

Note: Selecting or deselecting a product feature typically installed with SAP Sybase IQalso selects or deselects all child components associated with that feature. To selectindividual components, omit the number of the main product feature, and choose the childcomponents you want to install.

Installing in Unattended (Silent) ModeUnattended or silent installations are typically used to update multiple systems. Except for theabsence of the GUI screens, all actions of InstallAnywhere are the same, and the result of aninstallation in silent mode is exactly the same as one done in GUI mode with the sameresponses.

Prerequisites

A response file is a text file that contains installation options. You can override or edit thedefault response file, installer.properties, for use in subsequent installations. Tooverride the default installation options, use the -f argument to point to a custom responsefile.

To create a response file:

1. From the command line, enter:setup.bin -r <responseFileName>

Where <responseFileName> includes the absolute path and file name of the response file.

Server Installations

Installation and Configuration Guide 23

2. Run the installer in GUI mode to record your actions in the response file. Use an editor tochange any responses for subsequent installations, if necessary.

Task

1. Insert the installation media into the drive.

If the installation program launches automatically, click Cancel to stop the installer.

2. From a console, change to the setup directory.

The setup directory contains setup.bin, installer.properties, and otherinstallation files.

3. Enter:setup.bin –f <responseFileName> -i silent-DAGREE_TO_SYBASE_LICENSE=true-DSYBASE_PRODUCT_LICENSE_TYPE=license

Table 11. Response File Arguments.

Argument Description

-f <responseFileName> Optional argument that includes the absolute path and filename of the response file. If you omit this argument, theinstaller defaults to installer.properties or

other .properties file in the same installation direc-

tory.

-i silent Switch that starts the silent installer.

-DAGREE_TO_SYBASE_LI-CENSE=true

Argument that indicates you accept Sybase end-user li-cense agreement.

-DSYBASE_PRODUCT_LI-CENSE_TYPE=license

Required to install a licensed version of the software.

- DUNINSTALL_DELETE_DA-TA_FILES=true

Deletes unnecessary files after installation.

Setting the Environment VariablesSet the environment variables required to run the server. The shell scripts that set thesevariables also set the variables needed by Open Client.Do one of the following:

• For the tcsh or C (csh) shell, enter:source $SYBASE/IQ-16_0/IQ-16_0.csh

• For the Korn (ksh), Bash, or Bourne (sh) shells, enter:.$SYBASE/IQ-16_0/IQ-16_0/IQ-16_0.sh

Server Installations

24 SAP Sybase IQ

Install LogsThe installer writes a general log that records all installation activity and individual logs foreach installed component. If an installation problem occurs, start with the IQ_Suite.log,then refer to the component log for specific details.

The installer also creates a set of corresponding .out files for each component .log file.These files capture different component installation activities. If the installer runs normally,these files may remain empty.

Table 12. SAP Sybase IQ Log Files.

File Name Contents

conn_add_lang.log Additional Connectivity Language Modules

conn_lang.log Connectivity Language Modules

iq_agent.log SAP Sybase IQ Agent Plug-in

iq_client_common.log Client components

iq_client_ms.log Windows client components

iq_client_web.log Web Drivers

iq_odbc.log ODBC Driver

iq_server.log Server components

iq_shared.log Shared SAP Sybase IQ Configuration files

IQ_Suite.log SAP Sybase IQ Server Suite installation summa-ry

IQ_Suite_Variable_Refer-ence.log

InstallAnywhere installation variables

jconnect7.log jConnect7 installation summary

jre7.log Java Runtime Environment v7 installation

lang.log Language Modules

open_client.log Open Client installation summary

scc_server.log SAP Control Center installation summary

sysam_util.log SySAM License Utilities installation summary

Server Installations

Installation and Configuration Guide 25

Solutions to Common Installation ProblemsCheck this section for solutions to common installation issues.

Table 13. Troubleshooting installation problems

Problem Possible Cause and Solution

Install fails Check the installer log: $SYBASE/log/IQ_Suite.logThe install log can help you trace the install progress and troubleshootfailed installations. The installer also writes individual logs for com-ponents included as part of the install to this directory.

Installer terminates prema-turely

The installer may terminate prematurely and display the message:Failed to connect to logical domain man-ager: Connection refusedIf this occurs, set the SYBASE_SAM_CPUINFO=OSCMDFORKenvironment variable and rerun the install.

The installer reports:gzip: "Not Found"

The installer cannot find the path to the gzip file. gzip must beinstalled and referenced in the path for the installer to succeed.

The installer expects to find gzip in the /usr/bin directory. Onsome machines, gzip is located in the /usr/contrib/bin/directory. If this is the case, update the path and run the installer.

$SYBASE variable not de-fined

Use these shell commands to set the $SYBASE environment variableto the path of the SAP Sybase IQ parent installation directory.

For the tcsh or C shell (csh):

setenv SYBASE <directory name>For the Korn (ksh), Bash, or Bourne (sh) shells:

SYBASE=<directory name>; export SYBASE

Uninstalling SAP Sybase IQTo uninstall SAP Sybase IQ on UNIX-like operating systems, run the uninstaller from aconsole or terminal. Instructions apply to server and client software.

1. Open a terminal, change to:$SYBASE/sybuninstall/IQSuite

2. Enter:

Server Installations

26 SAP Sybase IQ

./uninstall Starts the uninstaller in GUI mode.

./uninstall –i silent Starts the uninstaller in silent mode.

Note:• For GUI uninstalls, follow the instructions on the screen.• For silent uninstalls, the uninstaller does not delete user files by default. To delete user

files, pass the -DUNINSTALL_DELETE_DATA_FILES=true flag as part of theuninstall –i silent command.

Server Installations

Installation and Configuration Guide 27

Server Installations

28 SAP Sybase IQ

Testing Installed Products

This section tells you how to start SAP Sybase IQ and use the demo database to test yourinstallation.

Demo DatabaseMany of the examples throughout the documentation use the demo database (iqdemo.db)as a data source. The demo database is installed as part of the SAP Sybase IQ Server Suite andresides on the server. Client access is provided by tools installed as part of the SAP Sybase IQClient Suite.

Starting the Demo DatabaseUse the demo database to test your installation.

1. Open a terminal, source the SAP Sybase IQ environment.

2. Change to:$IQDIR16/demo

3. Enter:mkiqdemo.sh

4. To start the demo database, enter:start_iq @iqdemo.cfg iqdemo.db

Table NamesDemo database table names and owners.

Table 14. Demo database table names

Table Name Owner

Contacts GROUPO

Customers GROUPO

Departments GROUPO

Employees GROUPO

FinancialCodes GROUPO

FinancialData GROUPO

Testing Installed Products

Installation and Configuration Guide 29

Table Name Owner

Products GROUPO

SalesOrderItems GROUPO

SalesOrders GROUPO

emp1 DBA

iq_dummy DBA

sale DBA

Running SAP Sybase IQ ServerUse the startup utility, start_iq, to start your server. start_iq is a command line utility that runson all platforms and ensures that all required parameters are set correctly.

Starting a Server or DatabaseTo use start_iq to start a server or database, change to a directory where you have writeprivileges, and use the following command format:

start_iq [ server-options ] [ database-file [ database-options ], ...]

• server-options include the database server name and other options that control thebehavior of the server, for all databases that are running on that server.

• database-file is the file name of the catalog store. You can omit this option, or enter one ormore database file names on the command line. Each of these databases is loaded andavailable for applications. If the starting directory contains the database file, you do notneed to specify the path; otherwise, you must specify the path. You need not specifythe .db file extension.

• database-options are options that you can specify for each database file you start, thatcontrol certain aspects of its behavior.

Default Startup Parametersstart_iq uses a default configuration file ($IQDIR16/scripts/default.cfg ) to setthe default start-up parameters.

Table 15. Parameters set by start_iq

Parameter Value Description

–c 48MB Catalog store cache size.

–gc 20 Checkpoint interval.

Testing Installed Products

30 SAP Sybase IQ

Parameter Value Description

–gd all Allows all users to start the database by connecting.

–gl all Allows all users to load or unload tables.

–gm 10 Default number of connections.

–gp 4096 Catalog store page size.

–ti 4400 Client timeout set to 72 hours. Prevents users with long queries frombeing logged off over a long weekend.

Note: If SQL Anywhere is installed on the same subnet as SAP Sybase IQ, the server musthave a unique name. Both SQL Anywhere and SAP Sybase IQ servers default to the port2638.

Use a new port number for each server. Set each new port number in the $IQDIR16/scripts/default.cfg file. Change the following line in each IQ databaseconfiguration file (for example, $IQDIR16/demo/iqdemo.cfg) to update the portnumber:

–x tcpip{port=2638}

Configuration FilesTo override the default start-up parameters, store your options in a configuration file.

To start a server with a configuration file, use this syntax:start_iq @configuration_filename.cfg dbname.db

This command starts the database and sets parameters named in the (optional) configuration(.cfg) file.

On the start_iq command line, the last option you specify takes precedence, so to overrideyour configuration file, list any options you want to change after the configuration file name.For example:start_iq @iqdemo.cfg –x 'tcpip{port=1870}' iqdemo.db

The –x parameter here overrides connection information in the iqdemo.cfg file.

A configuration file for the demo database (iqdemo.cfg) is installed in the $IQDIR16/demo directory as an example.

Default Server DirectoriesThe directory where the server is started becomes the default directory for all server filescreated by SAP Sybase IQ.

Note: If you run the start_iq utility from $IQDIR16/bin64, the script changes thedirectory to “./..” to avoid creating database files in the /bin directory.

Testing Installed Products

Installation and Configuration Guide 31

Startup and Server LogsSAP Sybase IQ writes start-up and server logs in the $IQDIR16/logfiles directory:

• Startup information is saved in the servername.nnnn.stderr file.

• Server status is logged in the servername.nnnn.srvlog file.

The nnnn variable in the file name indicates the number of times the server has been started.For example, localhost.0004.srvloglocalhost_iqdemo.0006.srvlog.

Additional InformationUtility Guide > start_iq Database Server Startup Utility > start_iq Server Options

Stopping ServersSERVER OPERATOR system privilege is the default permission level required to stop aserver, but you can use the -gk startup option to change the default to ALL or NONE. Settingthe permission level to ALL lets all users stop the server; setting the permission level to NONEmeans that no one can stop the server. In a production environment, only the Server Operatorshould be allowed to stop the database server.

Do not shut down a server while it is still connected to one or more clients. If you try this, youget a warning that any uncommitted transactions will be lost. Disconnect or close all theclients and try again.

Server Shutdown CommandsSeveral commands shutdown the database server.

Command Description

stop_iq Shuts down a server completely without regard for users, connections orload process status. Syntax:

stop_iq [ options ]

dbstop Stops a server or database. Additional options let you stop a server, even ifthere are active connections.

Syntax:

dbstop [ options ] server-name To use dbstop to stop a server, you must specify a server-name, as well asany connection parameters you specified when you started the server.

Testing Installed Products

32 SAP Sybase IQ

Command Description

STOP ENGINE STOP ENGINE is a SQL statement that stops a database server.

Syntax:

STOP ENGINE engine-name [ UNCONDITIONALLY ]The UNCONDITIONALLY argument stops a database server, even ifthere are client connections to the server.

Server Shutdown MethodsThere are several methods to shut down or stop a server.

To stop the serverfrom..

Do this...

Command line Run the stop_iq or dbstop commands.

Interactive SQL Run the stop engine command to to stop a named database server.

Stopping Servers in Cron or At JobsTo use stop_iq in a cron or at job, specify the full path name to the stop_iq executable and theappropriate –stop option:

$SYBASE/IQ-16_0/bin64/stop_iq –stop one

Setting –stop one shuts down a single server, when exactly one running server was started bythe user ID that starts the cron or at job. This prevents accidentally shutting down the wrongserver if several are running.

$SYBASE/IQ-16_0/bin64/stop_iq –stop all

Setting –stop all shuts down all servers that were started by the user ID that starts the cron or atjob.

Additional Information

• Reference: Statements and Options> SQL Statements > STOP ENGINE Statement• Utility Guide> Stopping the Database Server• Administration: Database > Run Database Servers > Database Server Shutdown

Testing Installed Products

Installation and Configuration Guide 33

Starting and Stopping the SAP Sybase Control CenterAgent

(Optional) Launch or shut down the SAP Sybase Control Center agent included with yourSAP Sybase IQ.

SAP Control Center is a Web-based tool for managing and monitoring SAP Sybase servers,including SAP Sybase IQ single-node and multiplex servers. One SCC server can manage andmonitor all the SAP Sybase IQ servers in your enterprise. SCC performs management tasksusing the SCC agent, which is installed with each SAP Sybase IQ server.

For instructions on installing SCC, see the SAP Sybase Control Center Installation Guide. Forinstructions on setting up the SCC agent to run as a service, starting and stopping the SCCagent service, and running the SCC agent from the command line, see SAP Control Centeronline help. SAP Control Center documentation (including the installation guide and onlinehelp) is available at http://sybooks.sybase.com/nav/summary.do?prod=10680.

1. Use the scc script to start the SCC agent.$SYBASE/SCC-3_3/bin/scc.sh

2. Connect to the SAP Control Center server. In your Web browser, enter: https://scc-hostname:8283/scc.

3. Log in.When logging in to a newly installed SAP Control Center for which secure authenticationhas not been configured, use the sccadmin account—the password is set duringinstallation. For more information, see the SAP Sybase Control Center InstallationGuide.

4. In SCC, register and authenticate your SAP Sybase IQ SCC agent.

5. (Optional) Stop the SCC agent. To shut down from the scc-console> prompt, entershutdown.

If you use SCC to manage your SAP Sybase IQ server, leave the SCC agent runningwhenever SAP Sybase IQ is running. The easiest way to do this is to run the SCC agent as aservice that restarts automatically.

Running Interactive SQLInteractive SQL is a utility that ships with SAP Sybase IQ that lets you execute SQLstatements, build scripts, and display database data.

To use Interactive SQL to run a sample query, the demo database must be up and running. Theconnection parameters in this procedure use default login credentials and assume thatiqdemo is running locally. If you installed iqdemo in another location or changed thedefault login, use those values instead.

Testing Installed Products

34 SAP Sybase IQ

1. Open a console, and run dbisql from the $IQDIR16/bin64 directory.

2. On the Connect dialog, enter:

TabName

Field Value

Identifica-tion

Authentication Database

User ID DBA or dba (case-insensitive)

Password sql (case-sensitive)

Action Connect to a running database on this computer

Server name <localhost>_iqdemo

Database name iqdemoNetwork TCP/IP protocol op-

tionsHost <localhost>

Port 2638

3. In the SQL Statements window, enter:SELECT * FROM Employees

4. Press F9 to run the query.

Note: Interactive SQL uses the deprecated iAnywhere JDBC driver.

Post-Installation TasksPerform these tasks after you install and test SAP Sybase IQ.

Verify Your LicenseConnect to the server and run sp_iqlmconfig to verify your license.

To verify your license, connect to the server, and run the sp_iqlmconfig stored procedure inInteractive SQL (dbisql). sp_iqlmconfig returns a set of properties that indicate the state ofyour licenses:Property Value -----------------------------------------------------Licence Notice

Testing Installed Products

Installation and Configuration Guide 35

For Sybase Inc. Internal Testing Use Only Edition EE License Type DT Application Type IQ IQ_CORE License Count in use 2 (CPU core based) Optional license in use : IQ_UDA No Optional license in use : IQ_LOB

Testing Installed Products

36 SAP Sybase IQ

No Optional license in use: IQ_SECURITY No Optional license in use: IQ_MPXNODE No Optional license in use: IQ_VLDBMGMT No IQ_VLDBMGMT License Count in use 0 Optional license in use: IQ_UDF No Optional license in use: IQ_IDA No

Testing Installed Products

Installation and Configuration Guide 37

Optional license in use: IQ_URIDA No Optional license in use: IQ_TS_FSF No Email Severity NONE SMTP Host smtp SMTP Port 25 Email Sender [email protected]

Testing Installed Products

38 SAP Sybase IQ

Email Recipients

All license server status and error messages are written to the SYBASE.log in the logdirectory. To diagnose issues with a license server, check the $SYBASE/SYSAM-2_0/log/SYBASE.log file. You can use iqdemo.db to perform this task.

A line that begins with “Checked out license...” indicates a successful licenseconfiguration. If you see a “Sysam: FLEXnet Licensing error:” message, checkwith your SAP Sybase representative to resolve the issue.

Additional Information

• SySAM 2 Users Guide > Administering License Servers > Managing the License ServerDebug Log

• Troubleshooting SySAM section and the SySAM 2 Users Guide

Change the Default Connection ParametersChange the default connection parameters to protect your system against unauthorized access.

Do not rely on the default connection parameters to secure your database against unauthorizedaccess. Change these parameters to protect your data.

Table 16. Default Connection Parameters

Parameter Default Value

User ID DBA or dba (case insensitive)

Password sql (case sensitive)

Port Number 2638

Additional InformationAdministration: Database > Security Overview

Remove Sample Application FilesBefore you deploy your server in a production environment, remove the sample clientapplications.

The SAP Sybase IQ Server Suite installation may include directories that contain sampleclient applications, which are included for training purposes only. Remove these sampledirectories before you deploy your server in a production environment:

• $IQDIR16/samples• $IQDIR16/sdk

Testing Installed Products

Installation and Configuration Guide 39

Testing Installed Products

40 SAP Sybase IQ

Client Installations

Installing client components lets you connect a client to a network server.

Client ComponentsClient components are grouped by feature. Items marked as default are installed in a typicalinstallation. Optional items can be installed in a custom installation.

Table 17. SAP Sybase IQ Client Components.

Feature Components De-fault

Notes

SAP Sybase IQ SAP Sybase IQ Client • Installs client software, Web applicationdevelopment tools, and ODBC drivers.

SAP Sybase IQ WebDrivers

SAP Sybase IQ ODBCDriver

jConnect jConnect 7.0 for JDBC • jConnect is a Type 4 JDBC driver, which isentirely Java-based. jConnect 7.0 is JDBC4.0 compliant

What a Client Installation DoesA typical client installation installs the network client components into a parent directory on aclient machine.

Directory VariablesSAP Sybase IQ uses environment variables to point to different installation directories.

Table 18. Directory Variables.

Variable Contents

$SYBASE Points to the parent installation directory. This variable is set by theinstaller.

$IQDIR16 Points to the SAP Sybase IQ installation directory

Client Installations

Installation and Configuration Guide 41

Parent Installation DirectoryThe $SYBASE directory contains the files, scripts, and other objects required to support theclient.

Table 19. Parent Installation Directory.

Directory Contents

IQ-16_0 SAP Sybase IQ client components.

jConnect-7_0 JDBC 4.0 compliant driver for SAP Sybase IQ.

shared Shared software components.

Sybase_Install_Registry Client component registry file.

jre Java Runtime Environment directory.

jutils-3_0 Version 3.0 Java-based utilities, including Ribo, a Tabular DataStreams utility.

log Client log file directory.

ThirdPartyLegal Third-party license agreements.

sybuninstall Subdirectories for scripts that uninstall SAP Sybase IQ and SySAM.

Product Installation Directory$IQDIR16 is a $SYBASE subdirectory that contains the files, scripts, and other objectsrequired to run the client.

Table 20. Product Installation Directory.

Directory Contents

bin<platform> Utilities you use to start and manage your server. <platform> value is 64 or32, depending on your installation.

install Installation history file.

java Different JAR files.

lib<platform> Various library files. <platform> value is 64 or 32, depending on yourinstallation.

res Character encoding resource files.

samples Sample SQL Anywhere tools and scripts.

sdk Subdirectories for various language utilities.

Client Installations

42 SAP Sybase IQ

Directory Contents

sun Local copy of the JRE to support Java in the database.

shared Subdirectories for various shared components.

tix Tcl/Tk extension library.

Installing Client SoftwareClient installation media supports GUI, console, and unattended installations. Stop anyservers currently running in the installation directory. Mount the drive, if necessary.

Installing in GUI ModeUse this option to set up your software in a graphic user interface (GUI) environment. The GUIinstaller is wizard-driven and supports all product editions and installation types.

1. Insert the installation media into the DVD/CD drive.

If the installer does not start automatically, mount the drive, then enter:<DVD_mount_directory>/setup.bin

2. Follow the instructions on the screen.

3. Unmount, if necessary, and remove the installation media from the drive.

Installing from the Command LineChoose a command-line installation if you prefer a non-windowing interface or fordeveloping custom installation scripts. Installing components in console mode is similar toinstalling in GUI mode, except that you run the installer from the command line, and enter textto select the installation options.

1. Insert the installation media into the drive.

If the installation program launches automatically, click Cancel to stop the installer.

2. From a console , change to the setup directory.

The setup directory is the directory that contains setup.bin,installer.properties, and other installation files.

3. Enter:setup.bin -i console

4. Follow the instructions on the screen.

Installing in Unattended (Silent) ModeUnattended or silent installations are typically used to update multiple systems. Except for theabsence of the GUI screens, all actions of InstallAnywhere are the same, and the result of an

Client Installations

Installation and Configuration Guide 43

installation in silent mode is exactly the same as one done in GUI mode with the sameresponses.

Prerequisites

A response file is a text file that contains installation options. You can override or edit thedefault response file, installer.properties, for use in subsequent installations. Tooverride the default installation options, use the -f argument to point to a custom responsefile.

To create a response file:

1. From the command line, enter:setup.bin -r <responseFileName>

Where <responseFileName> includes the absolute path and file name of the response file.2. Run the installer in GUI mode to record your actions in the response file. Use an editor to

change any responses for subsequent installations, if necessary.

Task

1. Insert the installation media into the drive.

If the installation program launches automatically, click Cancel to stop the installer.

2. From a console, change to the setup directory.

The setup directory contains setup.bin, installer.properties, and otherinstallation files.

3. Enter:setup.bin –f <responseFileName> -i silent-DAGREE_TO_SYBASE_LICENSE=true -DSYBASE_PRODUCT_LICENSE_TYPE=license

Table 21. Response File Arguments.

Argument Description

-f <responseFileName> Optional argument that includes the absolute path and filename of the response file. If you omit this argument, theinstaller defaults to installer.properties or

other .properties file in the same installation direc-

tory.

-i silent Switch that starts the silent installer.

-DAGREE_TO_SYBASE_LI-CENSE=true

Argument that indicates you accept Sybase end-user li-cense agreement.

Client Installations

44 SAP Sybase IQ

Argument Description

-DSYBASE_PRODUCT_LI-CENSE_TYPE=license

Required to install a licensed version of the software.

- DUNINSTALL_DELETE_DA-TA_FILES=true

Deletes unnecessary files after installation.

Setting Environment VariablesOpen a terminal and set the environment variables required to run SAP Sybase IQ. The shellscripts that set these variables also set the variables needed by Open Client.Do one of the following:

• For the tcsh or C (csh) shell, enter:source $SYBASE/IQ-16_0/IQ-16_0.csh

• For the Korn (ksh), Bash, or Bourne (sh) shells, enter:$SYBASE/IQ-16_0/IQ-16_0/IQ-16_0.sh

Note: For additional information about environment variables, see Reference: BuildingBlocks, Tables, and Procedures > File Locations and Installation Settings > EnvironmentVariables.

Client Installations

Installation and Configuration Guide 45

Client Installations

46 SAP Sybase IQ

Configuration

This section outlines basic configuration concepts and procedures.

Using Configuration FilesUse a configuration file to store server startup options.

The @data option allows you to specify environment variables and configuration files on thecommand line. To specify a configuration file, replace data with the path and name of theconfiguration file:

start_iq @configuration_filename.cfg dbname.db

If a startup parameter is passed from the command line and the same parameter exists inthe .cfg file, the value in the command line overrides the value in .cfg file.

Configuration files can contain line breaks, and can include any set of options, including the@data option. Use a number sign (#) to designate lines as comments. An ampersand (&)character that appears by itself at the end of a line indicates that the previous token is continuedon the next line. See the Utility Guide for a complete list of startup parameters.

Default Configuration FileWhen you start a server and do not include any command line parameters or specify aconfiguration file, IQ retrieves the start-up parameters from a default configuration file,default.cfg, in the $IQDIR16/scripts directory. The default.cfg file is alsothe source of parameters for the Service Manager and multiplex configurations. You canmaintain consistency by editing parameters in default.cfg.

To increase the amount of virtual memory, change the parameters in default.cfg. Toreduce the virtual memory that other programs use, add swap space to machines or reduce IQmemory demands (cache sizes, thread count, stack size, etc.).

Security and Configuration FilesYou can use the dbfhide (File Hiding) utility to encrypt your configuration files. If you specifylog file parameters (-o logfile) in encrypted files, the log is not available to the start_iq utility.You may want to add parameters that do not require encryption on the command line or in aseparate configuration file. For example:

start_iq @encrypt_params @other_params

or

% start_iq @encrypt_params -n myserv -c 400 -o $IQDIR16/logfile/myserv.log

Configuration

Installation and Configuration Guide 47

Configuring Client ConnectivitySAP Sybase IQ supports ODBC and JDBC connectivity.

Connecting Using ODBCOpen Database Connectivity (ODBC) is a standard API that allows a single application toaccess a variety of data sources through ODBC–compliant drivers.

ODBC ConformanceODBC drivers manufactured by different vendors may vary widely in the functions theyprovide. SAP Sybase IQ supports ODBC 3.5.2.

Table 22. ODBC Conformance Levels.

Conformance level Sybase IQ support

Core conformance All core features.

Level 1 conformance All level 1 features, except for asynchronous execution of ODBCfunctions.

SAP Sybase IQ does support multiple threads sharing a singleconnection. The requests from the different threads are serializedby SAP Sybase IQ.

Level 2 conformance All level 2 features, except:

• Three-part names of tables and views. This is not applicablefor SAP Sybase IQ.

• Asynchronous execution of ODBC functions for specifiedindividual statements.

• Ability to time out login requests and queries.

Note:

• Although you can use new ODBC 3.5.x features such as descriptors in your ODBCapplications, ODBC 2.x applications will continue to work with SAP Sybase IQ.

• For more information about ODBC, see the ODBC Programmer's Reference, availablefrom Microsoft Corporation as part of the ODBC software development kit, or from theMicrosoft Web site at: http://msdn.microsoft.com/en-us/library/windows/desktop/ms714177(v=vs.85).aspx.

Configuration

48 SAP Sybase IQ

Installing ODBC DriversServer and client.installations include ODBC drivers. Platform-specific drivers are availablefrom the SAP Sybase Product Download Center and SAP Service Marketplace.

Application LinkingIf you use an ODBC application that uses libodbc.so (libodbc.so.1) orlibodbcinst.so (libodbcinst.so.1), you can create symbolic links to that point to$IQDIR16/lib64/libdbodbc16.so.1 for single-threaded or $IQDIR16/lib64/libdbodbc16_r.so.1 for multi-threaded applications.

If you are creating an ODBC application, you can link directly to libdbodbc16.so fornon–threaded applications and libdbodbc16_r.so for threaded applications. Referencesto ODBC functions are resolved at run-time.

32-bit and 64-bit DriversUNIX 64-bit applications, including many third-party tools, can use 64-bit ODBC drivers toconnect to 64-bit SAP Sybase IQ servers. 32-bit applications can use 32-bit ODBC drivers toconnect to 64-bit IQ servers. (32-bit applications cannot use 64-bit ODBC drivers to connectto 64-bit IQ servers.)

The SAP Sybase IQ Network Client CD supplied with all platforms contains an ODBC driverfor connecting from Windows-based ODBC applications. To connect via ODBC from 32-bitUNIX client applications, download and install the 32-bit ODBC driver kit. Check the EBF/Update information for the appropriate driver.

Using UNIX or Linux–Based Query Tools Through ODBCThere are several ways to use ODBC to connect to UNIX or Linux-based Query tools.

Tools that do not require extensive driver manager services can use symbolic links to connectdirectly to the driver. Tools that require a driver manager may ship with a driver manager.

For information and recommendations about compatible driver managers available forspecific applications, see the documentation for the application.

On UNIX-like operating systems, ODBC data sources are stored in .odbc.ini. Use a text editorto update this file manually, or use the cross–platform iqdsn utility to create an ODBC datasource.

You can use files as data sources instead of databases. File data sources are stored as files withthe extension .dsn.

Configuration

Installation and Configuration Guide 49

Managing ODBC Data SourcesOn UNIX-like operating systems, ODBC data sources are stored in a system information file.Although this file is named .odbc.ini by default, it can have any name.

A system information file can include any connection parameter. This sample DSN connectsto the demo database:[My Data Source]Userid=DBAPassword=sqlEngineName=test_serverCommLinks=tcpip(port=1870)AutoStop=noDatabaseName=iqdemoDatabaseFile=iqdemo.db

System Information File LocationSAP Sybase IQ searches the following locations, in order, for the system information file:

1. The $ODBCINI environment variable2. The $HOME environment variable3. The user's Home directory4. The $PATH environment variable

Note: SAP Sybase IQ clients ignore these environment variables when searching for thesystem information file:

• $ODBC_HOME• $ODBC_INI

Connecting with a Data Source EntryTo use a data source entry to connect to your database, open a terminal, and use dbisql with thedata source entry name in a connection string. For example:% dbisql –c "dsn=sample_dsn"

Note: Any database started from a connection string is, by default, stopped when there are nomore connections to it, and any database that is loaded from a connection string is unloaded assoon as there are no more connections to it when the Autostop connection parameter is set toyes.

Connecting without a Data Source EntryTo connect without using .odbc.ini, open a terminal, and use dbisql all connectionparameters. For example:% dbisql –c "UID=DBA;PWD=sql;AutoStop=no; ENG=<engine name>;DBF=$IQDIR16/demo/iqdemo.db"

Configuration

50 SAP Sybase IQ

This example is shown on multiple lines, however, you must enter the entire command at thecommand prompt on one line.

Additional InformationUtility Guide > iqdsn Database Administration Utility

Command Line Connections to 32-bit ApplicationsUse dbisql to connect to 32-bit applications from the command line.

To connect to a 32-bit application without using a data source, use dbisql to connect from thecommand line. To connect to the iqdemo.db you would use a command similar to this:

dbisql -c "UID=DBA;PWD=sql;AUTOSTOP=no;ENG=<engine name>;DBF=%ALLUSERSPROFILE%\SybaseIQ\demo\iqdemo.db"

Connecting Using JDBCJDBC and jConnect provide access to SAP Sybase IQ for Java-based applications.

Java Database Connectivity (JDBC) is a Java application programming interface (API) thatprovides programmatic access to SAP Sybase IQ. jConnect is a SAP Sybase utility thatprovides high-performance native access to all SAP Sybase products as a standard installationoption.

Interactive SQL (dbisql) can use either JDBC or ODBC connectivity.

The iAnywhere JDBC driver is the default driver for Interactive SQL.

Note: The iAnywhere JDBC driver is deprecated.

Connecting Using OLE DBSAP Sybase IQ includes an OLE DB provider as an alternative to ODBC. OLE DB is a dataaccess model from Microsoft that uses the Component Object Model (COM) interfaces.Unlike ODBC, OLE DB does not assume that the data source uses a SQL query processor.Although OLE DB requires a Windows client, you can use OLE DB to access Windows andUNIX servers.

SAP Sybase IQ OLE DB support differs from SQL Anywhere support. SAP Sybase IQsupports Dynamic (dynamic scroll), Static (insensitive) and Forward only (no–scroll) cursors,but does not support Keyset (scroll) cursors. In SAP Sybase IQ the isolation level is always 3,no matter what you specify.

SAP Sybase IQ supports Dynamic (dynamic scroll), Static (insensitive) and Forward only(no–scroll) cursors, but does not support Keyset (scroll) cursors. In SAP Sybase IQ theisolation level is always 3, no matter what you specify.

SAP Sybase IQ does not support Windows CE or remote updates through a cursor.

Configuration

Installation and Configuration Guide 51

Additional InformationProgramming > OLE DB and ADO Development > OLE DB Connection Parameters

Connecting Using Open ClientClients require a server object in the interfaces file to access server properties and methods.Use the SAP Sybase IQ Directory Services Editor (dsedit) to create the interfaces file entries.These instructions apply to sever installations only.

Prerequisites

• You must be the owner of the SAP Sybase IQ home directory ($SYBASE) to run dsedit

• Make a copy of the interfaces file before you make any changes

Task

1. From a terminal, change to $SYBASE/OCS-15_0/bin2. Start dsedit.

3. On the Directory Service dialog, select a directory service to open (the interfaces file orinterfaces driver is default), then click OK.

4. From the Server Object menu, choose Add, then enter the server name.

5. On the InterfacesDriver window, double click the Server Address row.

6. On the Network Address Attribute dialog, click Add.

7. Choose TCP as the Protocol, enter the Network Address, then click OK.

8. On the Network Address Attribute dialog, click OK, then click OK to return to the mainInterfacesDriver window.

Running the Client and Server On the Same SystemSAP Sybase IQ uses a shared memory segment and several semaphores for communicationbetween the client and server on the same machine.

Shared memory is the default communications mechanism when the client and server are onthe same system. Shared memory is configured automatically, and starts automatically.

Additional InformationAdministration: Database > Connection and Communication Parameters

Configuration

52 SAP Sybase IQ

Network Issues for SAP Sybase IQ ServersProperly configured UNIX servers run under the TCP/IP protocol, which enables non–UNIXclients to communicate with the server.

Verified TCP/IP Protocol StacksFor SAP Sybase IQ to run properly, the protocol stack on the client and server computers mustbe compatible at each layer. Many vendors supply TCP/IP protocol stacks and associatedsoftware. SAP Sybase IQ communications have been explicitly verified with these TCP/IPimplementations:

• TCP/IP For NetWare• Microsoft Winsock version 2.0

User Datagram ProtocolThere are several entries into the TCP/IP protocol stack. SAP Sybase IQ employs the UserDatagram Protocol (UDP). While it is called a transport protocol here and elsewhere, UDPprovides little more than a user interface to the network layer IP. In particular, UDP is not aguaranteed transmission protocol.

Tuning Performance Under TCP/IPAlthough the default packet size for TCP/IP is 1460 bytes, a larger packet size may improvequery response time, especially for queries that transfer a large amount of data between aclient and a server process. You can set the maximum packet size using the database servercommand lines or CommBufferSize (CBSIZE) in the client connection string. This optionmay be used with the start_iq command.

Connecting Across a FirewallSet the CommLinks connection parameters in your application's connection string to connectacross a firewall.

There are restrictions on connections when the client application is on one side of a firewalland the server is on the other. Firewall software filters network packets according to networkport. Also, it is common to disallow UDP packets from crossing the firewall.

• Set the ClientPort parameter to a range of allowed values for the client application to use.You can then configure your firewall to allow these packets across. You can use the shortform CPort.

• Set the HOST parameter to the host name on which the database server is running. You canuse the short form IP.

• Specify the port your database server is using in the ServerPort parameter if it is not usingthe default port of 2638. You can use the short form Port.

• Set the DoBroadcast=NONE parameter to prevent UDP from being used when connectingto the server.

Configuration

Installation and Configuration Guide 53

In this example, the connection string fragment:

• Restricts the client application to ports 5050 through 5060

• Connects to a server named myeng running on the machine at address myhost using theserver port 2020

No UDP broadcast is carried out because of the DoBroadcast option.

CEng=myeng;Links=tcpip(ClientPort=5050–5060;Host=myhost;Port=2020;DoBroadcast=NONE)

Additional InformationAdministration: Database > Connection and Communication Parameters

Configuration

54 SAP Sybase IQ

Index$IQDIR16 16$SYBASE 16

Aagent, Sybase Control Center 34

Cclient

client and server on same system 52command line installation 43components 41directories 41GUI installation 43installation 41ODBC connections 48platform support 1pre-installation steps 43setting variables 45silent installation 43typical installation 41variables 41

client connectionsJDBC 51OLE DB 51

client connections Open Client 52command line

installation 43installations 23

componentsclient 41

configurationfiles 47parameters set by start_asiq 30security 47

connectingacross firewalls 53JDBC 51ODBC 48OLE DB 51Open Client 52

connection parameters 51changing 39

Ddata access

JDBC 51

ODBC 48OLE DB 51Open Client 52

dbisqlrunning 34

See also Interactive SQLdebugger 5default connection parameters

changing 39Demo database

table names 29table owners 29

Demo Database 29Demo/Evaluation Edition

license 9directory

parent 16, 41product 16, 41

Directory Services Editorinterfaces file 52

distributed query processingfault tolerance 3hardware requirements 3network requirements 3planning 3

DQPdistributed query processing 3DVD, installation

Client Suite 2Server Suite 2

E

environmentvariables 45

environmental variables 24Express Edition

license 9

F

file descriptor limits 5file descriptor limits, setting 5firewalls, connecting across 53

Index

Installation and Configuration Guide 55

Ggenerating licenses

SAP Service Marketplace 11Sybase Product Download Center (SPDC) 11

GUI installations 22, 43

Hhardware platform

changing 3high availability

planning 3host ID (licensing) 11host name (licensing) 11

Iinstallation

command line 23, 43common installation problems 26components 15GUI mode 22, 43post-installation 35pre-installation steps 43server 15, 22setting variables 45silent 23silent (client) 43sybase account 15uninstalling servers 26

Installation 2first time 2planning 2

installation directoriesparent 16product 16SAP Sybase IQ server 16

installation mediaClient Suite 2Server Suite 2

installation, preparing 1installations, server

environment variables 24installer

running 12Interactive SQL 34

running 34interfaces file

creating entries 52

IQ serversnetwork connectivity 53

J

JDBC 51

L

license generationhost ID 11host name 11license models 10port number 11SAP Service Marketplace 11SySAM documentation 10

license modelserved licenses 10unserved licenses 10

license serverinstallation 12requirements 4starting 13upgrade 4

licensesEnterprise Edition 7Evaluation Edition 9Express Edition 9Single Application Edition (SA) 10Small Business Edition (SE) 9

licensingavailable licenses 7evaluation period 1host ID (obtaining) 11host name 11license models 10licensed edition 1licensing requirements 1port number 11SAP Service Marketplace 11steps before you generate a license 10Sybase Product Download Center (SPDC) 11SySAM documentation 10Web key 7

limit command 5Linux 64-bit

setting network connectivity 4shared memory restrictions 4

Index

56 SAP Sybase IQ

M

memoryshared 4, 52

multiplex distributed query processinghigh availability 3network requirements 3

N

network connectionsfor Linux 64-bit 4

network functionalityverifying 5

O

ODBC 4832-bit command line connections 51conformance 48connection 48data sources, managing 50installing drivers 49odbc.ini 50, 51UNIX driver managers 49

OLE DB 51Open Client

connecting from 52interfaces file 52

operating system patchesSee preinstallation tasks

P

passwordsprotecting 47

planninginstalls 2platform changes 3

planning installations 2platform changes

planning 3platform support

client 1port number (licensing) 11post-installation

change connection parameters 39removing sample applications 39server 35

Verify Your License 35preinstallation tasks 3, 4

increasing the swap space 4license server upgrade 4managing shared memory 4operating system patches 4set the file descriptor limits 5verify network functionality 5

S

sample applicationsremoving 39

SAP Service Marketplace 11SAP Sybase IQ

about 1SAP Sybase IQ IQ

client platforms 1SCC 34server

client and server on same system 52command line installations 23common installation problems 26directories 16GUI installations 22installation 15installation components 15platform support 1post-installation steps 35silent installations 23sybase account 15typical installations 16uninstalling 26variables 16

server installationsenvironment variables 24

serverinstallinginstalling 22

serversstopping 32

setting 24shared memory 52

setting network connectivity on Linux 64-bit4

shared memory, managing 4silent installations 23, 43Single Application Edition (SA) 10Small Business Edition (SE) 9Solaris debugger 5

Index

Installation and Configuration Guide 57

starting serversat command prompt 30

stoppingservers 32

swap spaceincreasing 4

sybase account 15Sybase Control Center 34Sybase IQ

server platforms 1starting 30stopping 32

SySAMSySAM documentation 10

SySAM licensesavailable licenses 7Enterprise Edition (EE) 7Evaluation Edition 9Express Edition 9host ID (obtaining) 11host name 11license models 10port number 11SAP Service Marketplace 11Single Application Edition (SA) 10Small Business Edition (SE) 9steps before you generate a license 10Sybase Product Download Center (SPDC) 11Web key 7

system information filesodbc.ini 50

TTable Names

demo database 29

owners 29tasks, preinstallation 3

license server upgrade 4managing shared memory 4operating system patches 4set the file descriptor limits 5swap space 4verify network functionality 5

thread limits 5

U

uninstallingservers 26

upgradingplanning 2

utilitiesstart_asiq 30

V

variables$IQDIR16 16$SYBASE 16directory 16, 41environment 16, 41setting 45

W

workflowsinstallation and migration 2upgrading installations 2

Index

58 SAP Sybase IQ