Top Banner
Installation and Configuration Guide SAP Sybase IQ 16.0 SP03 Windows
60

Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

May 10, 2023

Download

Documents

Khang Minh
Welcome message from author
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
Page 1: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

Installation and Configuration Guide

SAP Sybase IQ 16.0 SP03

Windows

Page 2: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

DOCUMENT ID: DC30056-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.

Page 3: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

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 ........................2Avoiding Environmental Issues ..............................3Changing Hardware Platforms ...............................3Planning for Distributed Query Processing or

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

Check for Operating System Patches ....................4Increase the Swap Space ......................................4License Server Requirements ...............................4Windows Support Issues .......................................5Verify Network Functionality ..................................6Windows 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

Page 4: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

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 ..............................................................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 .................23Install Logs ...........................................................24

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

Testing Installed Products ..................................................27Demo Database ............................................................27

Starting the Demo Database ...............................27Table Names ........................................................27

Running SAP Sybase IQ Server ...................................28Starting and Stopping the SAP Sybase Control Center

Agent ........................................................................30Running Interactive SQL ...............................................31Post-Installation Tasks ..................................................31

Verify Your License ..............................................32Change the Default Connection Parameters .......35Remove Sample Application Files .......................36

Client Installations ...............................................................37

Contents

iv SAP Sybase IQ

Page 5: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

Client Components .......................................................37What a Client Installation Does .....................................37Installing Client Software ..............................................39

Installing in GUI Mode ......................................... 39Installing from the Command Line ......................39Installing in Unattended (Silent) Mode .................40

Configuration ......................................................................43Using Configuration Files ..............................................43Running SAP Sybase IQ as a Windows Service ..........44

Creating a New Windows Service ....................... 44Suppressing Windows Event Log Messages .......44Granting Administrator Privilege to the SAP

Sybase IQ Service ...........................................45Configuring Client Connectivity .....................................45

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

System ............................................................ 49Network Issues for SAP Sybase IQ Servers ........49Connecting Across a Firewall ..............................50

Index ..................................................................................51

Contents

Installation and Configuration Guide v

Page 6: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

Contents

vi SAP Sybase IQ

Page 7: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

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.

• Microsoft Windows 2008 R2 for 64-bit systems - Service Pack 1• Microsoft Windows 7 for 64-bit systems - Service Pack 1

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

Page 8: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

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.

• Uninstall the version currently installed on your system. Install the new version as if youwere installing for the first time.

Preparing for Installation

2 SAP Sybase IQ

Page 9: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

• 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

Avoiding Environmental IssuesInstalling SQL Anywhere and SAP Sybase IQ on different machines avoids potential start-upproblems.

Install SQL Anywhere and SAP Sybase IQ on different host machines. When you install bothproducts on the same machine, the environment variables for the product installed lastoverwrite those of the product installed first, causing start-up problems for the first product.

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.

Preparing for Installation

Installation and Configuration Guide 3

Page 10: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

• 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.

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

Preparing for Installation

4 SAP Sybase IQ

Page 11: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

Windows Support IssuesReview these issues related to running SAP Sybase IQ on Windows 2008.

Windows SecurityWindows 2008 incorporates a new security model. User Account Control (UAC) is enabled bydefault and may affect the behavior of programs that expect to be able to write files, especiallywhen the computer supports more than one user. Depending on where and how files anddirectories are created, a file created by one user may have permissions that do not allowanother user to read or write to that file. If you install SAP Sybase IQ in the default directories,files and directories that require read/write access for multiple users are set up appropriately.

SAP Sybase IQ Elevated Operations AgentCertain actions require privilege elevation to execute when run under User Account Control.The programs dbelevate11.exe and iqdsn.exe may require elevation in SAP SybaseIQ.The following dll files require elevation when they are registered or unregistered:dbodbc16.dll and dboledb16.dll.

Certain actions require privilege elevation to execute when run under User Account Control.The following programs may require elevation in SAP Sybase IQ:SybaseIQservice16.exe, dbelevate11.exe, and iqdsn.exe.The followingdlls require elevation when they are registered or unregistered: dbodbc16.dll anddboledb16.dll.

On a system with User Account Control activated, you may receive an elevation prompt for theSAP Sybase IQ elevated operations agent. The prompt is issued by the User Account Controlsystem to confirm that you want to continue running the identified program (if logged on as anadministrator) or to provide administrator credentials (if logged on as a non-administrator).

Deployment ChangesThe program dbelevate16.exe is used internally by SAP Sybase IQ components toperform operations that require elevated privileges. This executable must be included indeployments of .SAP Sybase IQ Administrator privileges are required to run dbelevate.

SAP Sybase IQ Executables SignedSAP Sybase IQ executables are signed by Sybase, Inc.

Using an AWE CacheTo use an AWE (Address Windowing Extensions) cache on Windows 2008, you must run thedatabase server as administrator. Starting a non-elevated database server with an AWE cacheresults in a warning that the database server must be run as an administrator to use AWE.

Preparing for Installation

Installation and Configuration Guide 5

Page 12: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

SamplesSamples now correctly handle SAP Sybase IQ installation path names that contain one ormore spaces.

Windows ServicesWindows 2008-compliant services are not allowed to interact with the desktop. SAP SybaseIQ services do not interact with the desktop (even if Allow Interaction with Desktop is enabledin the service definition). SAP Sybase IQ database servers can be monitored using thedbconsole utility or SAP Sybase IQ Control Center.

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.

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

Page 13: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

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

Page 14: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

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

Page 15: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

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

Page 16: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

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

Page 17: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

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

Page 18: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

• 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

• Use an account with Administrator privileges to log in to Windows.• Stop and shut down all programs before you run the installation.

Task

1. Insert the installation media into the drive.

If the installer does not start automatically, start Windows Explorer, change to your DVDdrive, and choose:setup.exe

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.

Licensing Your Software

12 SAP Sybase IQ

Page 19: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

7. Review the installation summary, then click Install.

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

Prerequisites

If you installed your license server on Windows 7, you must use the Run as Administratorcommand to start and stop the license server.

Task

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

Page 20: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

Licensing Your Software

14 SAP Sybase IQ

Page 21: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

Server Installations

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

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.

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 •

Server Installations

Installation and Configuration Guide 15

Page 22: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

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 by theinstaller.

%ALLUSERSPROFILE% Points to the Windows local resources directory. The location of theseresources depends on the Windows version. On Windows 7, theseresources are located in the C:\ProgramData\SybaseIQdirectory.

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 supportthe server.

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.

ini 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.

Server Installations

16 SAP Sybase IQ

Page 23: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

Directory Contents

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

Assembly ADO.NET and .NET assembly files.

Bin32 Libraries required for 32-bit compatibility.

Bin64 Utilities you use to start and manage your server.

demo A readme that identifies the location of the demo database and other localresources.

install Installation history file.

java Different JAR files.

logfiles SAP Sybase IQ writes log files to this directory.

Server Installations

Installation and Configuration Guide 17

Page 24: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

Directory Contents

lsunload Local Store Unload utility.

Scripts Sample scripts and stored procedures.

SDK Subdirectories for various language utilities.

SNMP Not supported by SAP Sybase IQ.

support A Web page with links to online resources.

Sysam Local SySAM configuration information.

unload Various unload scripts, files, and utilities.

Local Resources DirectoryThe %ALLUSERSPROFILE%\SybaseIQ directory contains local resources, including thedemo database, server logs, and utilities.

Directory Contents

demo Sample data and scripts for the demo database.

logfiles Server log files.

Samples Sample scripts, drivers, 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,

Server Installations

18 SAP Sybase IQ

Page 25: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

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.

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

Page 26: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

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

Page 27: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

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

Page 28: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

• 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, start Windows Explorer, change to your drive,and choose:

Server Installations

22 SAP Sybase IQ

Page 29: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

setup.exe2. Follow the instructions on the screen.

3. 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 command line, change to the setup directory.

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

3. Enter:setupConsole.exe -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.exe -r <responseFileName>

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

Server Installations

Installation and Configuration Guide 23

Page 30: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

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 command line, change to the setup directory.

The setup directory contains setupConsole.exe, installer.properties, andother installation files.

3. Enter:setupConsole.exe –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.

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.

Server Installations

24 SAP Sybase IQ

Page 31: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

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

Page 32: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

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.

Uninstalling SAP Sybase IQInstructions apply to server and network client software.

GUI Mode

1. On the Control Panel, choose Add or Remove Programs.2. Choose SAP Sybase IQ from the program list.3. Click Remove.4. Follow the instructions on the screen.

Silent Mode

1. From the command line, change to %SYBASE%\sybuninstall\IQSuite.

2. Enter:uninstall –i silent

Note: The silent uninstaller does not display status messages.

User files are not deleted by default. To delete user files, pass the -DUNINSTALL_DELETE_DATA_FILES=true flag as part of the uninstall –isilent command.

Server Installations

26 SAP Sybase IQ

Page 33: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

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.From the SAP Sybase IQ program group, choose SAP Sybase IQ 16.0 > Start SAP SybaseIQ Demo Database.

The first time you use this option,SAP Sybase IQ may prompt you for some additionalinformation. Scripts that create and load the demo database are located in the%ALLUSERSPROFILE%\SybaseIQ\demo directory.

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

Products GROUPO

SalesOrderItems GROUPO

Testing Installed Products

Installation and Configuration Guide 27

Page 34: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

Table Name Owner

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 from the command line, change to a directorywhere the configuration and database files are located, and use the following commandformat:

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.

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

Testing Installed Products

28 SAP Sybase IQ

Page 35: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

Parameter Value Description

–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, %ALLUSERSPROFILE%\SybaseIQ\demo\iqdemo.cfg) to update the port number:

–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%ALLUSERSPROFILE%\SybaseIQ\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.

Startup and Server LogsSAP Sybase IQ writes start-up and server logs in the %ALLUSERSPROFILE%\SybaseIQ\logfiles directory:

Testing Installed Products

Installation and Configuration Guide 29

Page 36: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

• Startup information is saved in the iq_startup_nt.log 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

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 starting and stopping the SCC agent service and starting and stopping the SCCagent from the command line, see SAP Control Center online help. SAP Control Centerdocumentation (including the installation guide and online help) 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.bat2. 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.

Tip: If you use a Windows account to log in to SCC, enter your user name in the formatusername@domain. Omit top-level domain extensions such as .com or .net—for example,enter fred@sap, not [email protected].

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.

Testing Installed Products

30 SAP Sybase IQ

Page 37: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

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.

1. From the Sybase Program Group, select Sybase IQ 16.0 > Interactive SQL .

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 Employees4. 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.

Testing Installed Products

Installation and Configuration Guide 31

Page 38: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

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 For Sybase Inc. Internal Testing Use Only Edition EE License Type DT Application Type IQ IQ_CORE License Count in use

Testing Installed Products

32 SAP Sybase IQ

Page 39: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

2 (CPU core based) Optional license in use : IQ_UDA No Optional license in use : IQ_LOB 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

Testing Installed Products

Installation and Configuration Guide 33

Page 40: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

0 Optional license in use: IQ_UDF No Optional license in use: IQ_IDA No Optional license in use: IQ_URIDA No Optional license in use: IQ_TS_FSF No Email Severity NONE SMTP Host smtp

Testing Installed Products

34 SAP Sybase IQ

Page 41: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

SMTP Port 25 Email Sender [email protected] 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)

Testing Installed Products

Installation and Configuration Guide 35

Page 42: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

Parameter Default Value

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 the$IQDIR16\SybaseIQ\Samples directory before you deploy your server in a productionenvironment.

Testing Installed Products

36 SAP Sybase IQ

Page 43: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

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 37

Page 44: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

Variable Contents

%ALLUSERSPROFILE% Points to the Windows local resources directory. The location of localresources depends on the Windows version. On Windows 7, theseresources are located in the C:\ProgramData\SybaseIQdirectory.

Parent Installation DirectoryThe %SYBASE% directory contains the files, scripts, and other objects required to supportthe client. The default %SYBASE% directory is C:\Sybase.

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

Assembly SQL Anywhere support files.

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.

Client Installations

38 SAP Sybase IQ

Page 45: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

Directory Contents

support A Web page with links to online resources.

Local Resources DirectoryThe %ALLUSERSPROFILE%\SybaseIQ directory contains local resources, including thedemo database, server logs, and utilities.

Table 21. Local Resources Directory.

Directory Contents

Samples Sample scripts, drivers, and utilities.

Installing Client SoftwareClient installation media supports GUI, console, and unattended installations. Use an accountwith Administrator privileges to install the software. Shut down all programs before you beginthe installation.

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, start Windows Explorer, change to your DVDdrive, and choose:setup.exe

2. Follow the instructions on the screen.

3. 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 command line, change to the setup directory.

Client Installations

Installation and Configuration Guide 39

Page 46: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

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

3. Enter:setupConsole.exe -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 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.exe -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 command line, change to the setup directory.

The setup directory contains setupConsole.exe, installer.properties, andother installation files.

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

Client Installations

40 SAP Sybase IQ

Page 47: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

Table 22. 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.

Client Installations

Installation and Configuration Guide 41

Page 48: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

Client Installations

42 SAP Sybase IQ

Page 49: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

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 43

Page 50: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

Running SAP Sybase IQ as a Windows ServiceRunning SAP Sybase IQ as a Windows service starts the server whenever you restart yourcomputer. Windows services runs in the background as long as Windows is running.

Creating a New Windows ServiceRun SAP Sybase IQ as a Windows service to start the server whenever you restart yourcomputer. Services run in the background as long as Windows is running.

1. Start Sybase IQ Service Manager.

2. Choose Create a New Service.

3. Name the new service.

4. Add the appropriate start-up parameters.

Include the full path to the database file. The server cannot start without a valid databasepath name.

5. Click Apply.

6. Restart Windows.

Because Window service manager reads environmental variables only at system startup,you must restart Windows after you configure SAP Sybase IQ as a Windows service.

Note:

• Copy any input files that you use to load your databases into the directory where the servicestarts, not where the database files are located. On most systems, the services start-updefaults to the %SYSTEMROOT%\system32 directory.

• To use SAP Sybase IQ as a Windows service when raw device access is required, you mustgrant the service Administrator privileges.

• Use Modify an Existing Service or Delete an Existing Service to change or delete SAPSybase IQ services.

Suppressing Windows Event Log MessagesIf you run the database server as a Windows service, you can set the SQL Anywhere registryentry to suppress event log entries.To control event log entries, set the EventLogMask key, which is of type REG_DWORD.

The value is a bitmask containing the internal bit values for the different types of eventmessages:

errors EVENTLOG_ERROR_TYPE 0x0001warnings EVENTLOG_WARNING_TYPE 0x0002information EVENTLOG_INFORMATION_TYPE 0x0004

Configuration

44 SAP Sybase IQ

Page 51: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

If the EventLogMask, for example, is set to 0, no messages appear at all. SettingEventLogMask to 1 logs all errors messages, but surpresses informational and warningmessages. The default setting (no entry present) logs all message types.

Granting Administrator Privilege to the SAP Sybase IQ ServiceAssign Administrator privileges to a SAP Sybase IQ service when raw device access isrequired.

1. On the Control Panel, click Administrative Tools > Services.

2. On the Services dialog, right-click Sybase IQ, choose Properties.

3. On Properties, choose Automatic as the Startup type.

4. Click the Log On tab, then click This account.

5. Assign the account to a user with Administrative privileges. In This account, type theadministrator’s user ID, then enter and confirm the user’s password.

6. Click OK to close Properties.

7. Click File > Close.

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 23. 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.

Configuration

Installation and Configuration Guide 45

Page 52: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

Conformance level Sybase IQ support

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.

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

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

UNIX-like operating systems do not provide a standard ODBC driver manager, but you canuse the driver manager emulation capabilities provided by the SAP Sybase IQ ODBC driver toconnect to the driver.

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.

Creating an ODBC Data SourceOn a UNIX-like operating systems, ODBC data sources are stored in .odbc.ini. Use a texteditor to update this file manually, or use the cross–platform iqdsn utility to create an ODBCdata source. On Windows, use ODBC Administrator to add a new ODBC data source.

1. Click Start > Programs > Sybase > SAP Sybase IQ 16.0.

2. Choose the option appropriate for your operating system:

• ODBC Data Source Administrator 32 bit

Configuration

46 SAP Sybase IQ

Page 53: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

• ODBC Data Source Administrator 64 bit

3. On the ODBC Data Source Administrator dialog, click Add.

4. On the Create New Data Source dialog, choose the Server IQ driver, then click Finish.

5. When you return to the ODBC Configuration dialog, type a Data Source Name in theData Source Name box.

6. Click the Login tab, type a database User ID and Password in the appropriate text boxes.

7. Click the Database tab. What you do next depends on the data source location:

• If the data source is on a remote machine, type the server name and database file name.(The database file is used only if the database is not started automatically on serverstart-up.)

• If the data source is on your local machine, type a start line and database name (withoutthe .db extension).

• If the data source is on a remote system, click the Network tab, and select theappropriate protocol and options.

8. Click OK to return to the ODBC Data Source Administrator.

After you create the data source, use ODBC Data Source Administrator to test the newdata source. See online help for more information.

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"

Adding ODBC Data Source Names on 64-bit Windows SystemsOn 64-bit Windows systems, SAP Sybase IQ installs a 32-bit ODBC driver. Use the ODBCAdministrator to add a new ODBC data source name.

1. Click Start > Programs > Sybase > Sybase IQ 16.0 > ODBC Administrator 64 bit.

2. Run C:\WINDOWS\SysWOW64\odbcad32.exe.Do not launch the ODBC Administrator from the Control Panel or Run box. Attempts toadd a DSN starting the ODBC Administrator incorrectly may returns these errors:• The setup routines for the Adaptive Server IQ ODBC driver

could not be loaded due to system error code 126.• Driver’s ConfigDSN, ConfigDriver, or ConfigTranslator

failed: Could not load the setup or translator library.• The setup routines for the Adaptive Server IQ ODBC driver

could not be found. Please reinstall the driver.

Configuration

Installation and Configuration Guide 47

Page 54: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

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.

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

Configuration

48 SAP Sybase IQ

Page 55: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

Task1. From the command line, 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

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

Using TCP/IP with WindowsWindows ships with TCP/IP software that uses NDIS network drivers. This software allows anSAP Sybase IQ server for Windows or an SAP Sybase IQ client application to use WindowsTCP/IP. Install TCP/IP Protocol from the Network Settings options on the Control Panel.

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, UDP

Configuration

Installation and Configuration Guide 49

Page 56: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

provides 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.

When connecting across a firewall, you must use a set of communication parameters in theCommLinks connection parameter of your application's connection string.

• Set the UseUDP parameter to off to prevent UDP packets from being used to locate theserver. You can use the short form UDP.

• 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.

• If your database server is not using the default port of 2638, you must specify the port it isusing, in the ServerPort parameter. You can use the short form Port.

In this example, the connection string fragment:

• Restricts the client application to ports 5050 through 5060

• Disables UDP packets• Connects to a server named myiq running on the machine at address myhost using the

server port 2020

CommLinks=tcpip(UseUDP=OFF;ClientPort=5050-5060;Host=myhost;Port=2020;Eng=myiq)

Additional InformationAdministration: Database > Connection and Communication Parameters

Configuration

50 SAP Sybase IQ

Page 57: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

Index%ALLUSERSPROFILE% 16%IQDIR15% 16%SYBASE% 16

AAdd Service utility 44adding IQ as a Windows Service 44Administrator privilege

granting to IQ as a Windows service 45agent, Sybase Control Center 30AWE cache, using (Windows) 5

Cclient

client and server on same system 49command line installation 39components 37directories 37GUI installation 39installation 37ODBC connections 45platform support 1pre-installation steps 39silent installation 40typical installation 37variables 37

client connectionsJDBC 48OLE DB 48

client connections Open Client 48code samples (Windows) 5command line

installation 39installations 23

componentsclient 37

configurationfiles 43parameters set by start_asiq 28security 43

connectingacross firewalls 50JDBC 48

ODBC 45OLE DB 48Open Client 48

connection parameters 47changing 35

D

data accessJDBC 48ODBC 45OLE DB 48Open Client 48

dbisqlrunning 31

See also Interactive SQLdefault connection parameters

changing 35Demo database

table names 27table owners 27

Demo Database 27Demo/Evaluation Edition

license 9deployement changes, Windows 5directory

parent 16, 37product 16, 37

Directory Services Editorinterfaces file 48

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

DQPdistributed query processing 3DSN

64-bit 47DVD, installation

Client Suite 2Server Suite 2

E

elevated operations agent 5

Index

Installation and Configuration Guide 51

Page 58: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

enviromental issues 3Event log

suppressing entries 44executables, signed (Windows) 5Express Edition

license 9

Ffirewalls, connecting across 50

Ggenerating licenses

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

GUI installations 22, 39

Hhardware platform

changing 3high availability

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

Iinstallation

command line 23, 39common installation problems 26components 15GUI mode 22, 39post-installation 31pre-installation steps 39server 15, 22silent 23silent (client) 40

Installation 2first time 2planning 2

installation directoriesparent 16product 16SAP Sybase IQ server 16

installation mediaClient Suite 2Server Suite 2

installation, preparing 1installer

running 12Interactive SQL 31

running 31interfaces file

creating entries 48IQ servers

network connectivity 49

J

JDBC 48

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) 11

Index

52 SAP Sybase IQ

Page 59: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

SySAM documentation 10Web key 7

Mmemory

shared 49multiplex distributed query processing

high availability 3network requirements 3

Nnetwork functionality

verifying 6

OODBC 45

32-bit command line connections 4764-bit DSN 47conformance 45connection 45data sources, creating 46installing drivers 46odbc.ini 47UNIX driver managers 46

OLE DB 48Open Client

connecting from 48interfaces file 48

operating system patchesSee preinstallation tasks

Ppasswords

protecting 43planning

enviromental issues 3installs 2platform changes 3

planning installations 2platform changes

planning 3platform support

client 1port number (licensing) 11post-installation

change connection parameters 35

removing sample applications 36server 31Verify Your License 32

preinstallation tasks 4increasing the swap space 4license server upgrade 4operating system patches 4verify network functionality 6Windows support issues 5

privilegeAdministrator 45

S

sample applicationsremoving 36

sample code (Windows) 5SAP Service Marketplace 11SAP Sybase IQ

about 1uninstalling 26

SAP Sybase IQ IQclient platforms 1

SCC 30server

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

serverinstallinginstalling 22

services, Windows 5shared memory 49signed executables (Windows) 5silent installations 23, 40Single Application Edition (SA) 10Small Business Edition (SE) 9SQL Anywhere

environmental issues 3starting servers

at command prompt 28

Index

Installation and Configuration Guide 53

Page 60: Installation and Configuration Guide - SAP Sybase IQ 16.0 SP03

support issues, WindowsAWE cache, using 5deployment changes 5sample code 5security 5services 5signed executables 5

swap spaceincreasing 4

Sybase Control Center 30Sybase IQ

server platforms 1starting 28

Sybase IQ Servicegranting Administrator privilege 45

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

T

Table Namesdemo database 27owners 27

tasks, preinstallation 4license server upgrade 4

operating system patches 4swap space 4verify network functionality 6Windows support issues 5

U

uninstallingSAP Sybase IQ 26

upgradingplanning 2

utilitiesstart_asiq 28

V

variables%ALLUSERSPROFILE% 16%IQDIR16% 16%SYBASE% 16directory 16, 37environment 16, 37

W

Windowssupport issues 5

Windows Serviceadding IQ as 44

Windows support issuesAWE cache, using 5deployment changes 5sample code 5security 5services 5signed executables 5

workflowsinstallation and migration 2upgrading installations 2

Index

54 SAP Sybase IQ