SAP First Guidance SAP NetWeaver BW 7.3x
SAP Realtime Database Platform
Applicable Releases:
SAP NetWeaver BW 7.30 SP09
SAP NetWeaver BW 7.31 SP07
Sybase IQ Version 15.4
and higher
With this solution, the data volume of the frequently accessed online database can be kept
relatively low. Less frequently accessed data is archived in time partitions on the SAP near-line
storage solution. Data in near-line storage resides in a highly compressed state in cost-efficient
storage with fewer backups to reduce operational costs. As the technical installation steps are the same this SAP First Guidance document should
make an own created customer specific documentation obsolete. It is the complementary
documentation to the existing Notes and Installation Guides.
Please Note that the SAP-NLS Solution can be used with all supported Database Versions
supported by SAP NetWeaver BW 7.3x. The Existence of SAP HANA is not necessary.
The document is work in progress and not intended to be exhaustive, but it contains
everything to successfully implement the SAP-NLS Solution with Sybase IQ.
For more Information please contact [email protected]
First Guidance... SAP NetWeaver BW: Implementation SAP-NLS with Sybase IQ
mailto:[email protected]
SAP First Guidance SAP NetWeaver BW 7.3x
SAP Realtime Database Platform
Version 1.30
September 2013
Copyright 2013 SAP AG. All rights reserved.
No part of this publication may be reproduced or transmitted in any form
or for any purpose without the express permission of SAP 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 software vendors.
Microsoft, Windows, Excel, Outlook, and PowerPoint are registered
trademarks of Microsoft Corporation.
IBM, DB2, DB2 Universal Database, System i, System i5, System p,
System p5, System x, System z, System z10, System z9, z10, z9, iSeries,
pSeries, xSeries, zSeries, eServer, z/VM, z/OS, i5/OS, S/390, OS/390,
OS/400, AS/400, S/390 Parallel Enterprise Server, PowerVM, Power
Architecture, POWER6+, POWER6, POWER5+, POWER5, POWER,
OpenPower, PowerPC, BatchPipes, BladeCenter, System Storage, GPFS,
HACMP, RETAIN, DB2 Connect, RACF, Redbooks, OS/2, Parallel Sysplex,
MVS/ESA, AIX, Intelligent Miner, WebSphere, Netfinity, Tivoli and
Informix are trademarks or registered trademarks of IBM Corporation.
Linux is the registered trademark of Linus Torvalds in the U.S. and other
countries.
Adobe, the Adobe logo, Acrobat, PostScript, and Reader are either
trademarks or registered trademarks of Adobe Systems Incorporated in
the United States and/or other countries.
Oracle is a registered trademark of Oracle Corporation.
UNIX, X/Open, OSF/1, and Motif are registered trademarks of the Open
Group.
Citrix, ICA, Program Neighborhood, MetaFrame, WinFrame, VideoFrame,
and MultiWin are trademarks or registered trademarks of Citrix Systems,
Inc.
HTML, XML, XHTML and W3C are trademarks or registered trademarks
of W3C, World Wide Web Consortium, Massachusetts Institute of
Technology.
Java is a registered trademark of Sun Microsystems, Inc.
JavaScript is a registered trademark of Sun Microsystems, Inc., used
under license for technology invented and implemented by Netscape.
SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAP
BusinessObjects Explorer, StreamWork, and other SAP products and
services mentioned herein as well as their respective logos are
trademarks or registered trademarks of SAP AG in Germany and other
countries.
Business Objects and the Business Objects logo, BusinessObjects,
Crystal Reports, Crystal Decisions, Web Intelligence, Xcelsius, and other
Business Objects products and services mentioned herein as well as their
respective logos are trademarks or registered trademarks of Business
Objects Software Ltd. Business Objects is an SAP company.
Sybase and Adaptive Server, iAnywhere, Sybase 365, SQL Anywhere,
and other Sybase products and services mentioned herein as well as their
respective logos are trademarks or registered trademarks of Sybase, Inc.
Sybase is an SAP company.
All other product and service names mentioned are the trademarks of
their respective companies. Data contained in this document serves
informational purposes only. National product specifications may vary.
The information in this document is proprietary to SAP. No part of this
document may be reproduced, copied, or transmitted in any form or for
any purpose without the express prior written permission of SAP AG.
This document is a preliminary version and not subject to your license
agreement or any other agreement with SAP. This document contains
only intended strategies, developments, and functionalities of the SAP
product and is not intended to be binding upon SAP to any particular
course of business, product strategy, and/or development. Please note
that this document is subject to change and may be changed by SAP at
any time without notice.
SAP assumes no responsibility for errors or omissions in this document.
SAP does not warrant the accuracy or completeness of the information,
text, graphics, links, or other items contained within this material. This
document is provided without a warranty of any kind, either express or
implied, including but not limited to the implied warranties of
merchantability, fitness for a particular purpose, or non-infringement.
SAP shall have no liability for damages of any kind including without
limitation direct, spel, indirect, or consequential damages that may
result from the use of these materials. This limitation shall not apply in
cases of intent or gross negligence.
The statutory liability for personal injury and defective products is not
affected. SAP has no control over the information that you may access
through the use of hot links contained in these materials and does not
endorse your use of third-party Web pages nor provide any warranty
whatsoever relating to third-party Web pages.
SAP How-to Guides are intended to simplify the product implement-
tation. While specific product features and procedures typically are
explained in a practical business context, it is not implied that those
features and procedures are the only approach in solving a specific
business problem using SAP NetWeaver. Should you wish to receive
additional information, clarification or support, please refer to SAP
Consulting.
Any software coding and/or code lines / strings (Code) included in this
documentation are only examples and are not intended to be used in a
productive system environment. The Code is only intended better explain
and visualize the syntax and phrasing rules of certain coding. SAP does
not warrant the correctness and completeness of the Code given herein,
and SAP shall not be liable for errors or damages caused by the usage of
the Code, except if such damages were caused by SAP intentionally or
grossly negligent.
Disclaimer
Some components of this product are based on Java. Any code change
in these components may cause unpredictable and severe malfunctions
and is therefore expressively prohibited, as is any decompilation of these
components.
Any Java Source Code delivered with this product is only to be used by
SAPs Support Services and may not be modified or altered in any way.
Document History
Document Version Description
1.00 First official release
1.10 Sybase IQ 15.4#ESD3, further SAP adaption, Sybase IQ fine tuning
1.20 Optimized DB layout, SCC adaption, corrections
1.21 Software updates, one-off patch instructions, corrections
1.30 Adding smart data storage access IQ-HANA
Typographic Conventions
Type Style Description
Example Text Words or characters quoted
from the screen. These
include field names, screen
titles, pushbuttons labels,
menu names, menu paths,
and menu options.
Cross-references to other
documentation
Example text Emphasized words or
phrases in body text, graphic
titles, and table titles
Example text File and directory names and
their paths, messages,
names of variables and
parameters, source text, and
names of installation,
upgrade and database tools.
Example text User entry texts. These are
words or characters that you
enter in the system exactly
as they appear in the
documentation.
Variable user entry. Angle
brackets indicate that you
replace these words and
characters with appropriate
entries to make entries in the
system.
EXAMPLE TEXT Keys on the keyboard, for
example, F2 or ENTER.
Icons
Icon Description
Caution
Note or Important
Example
Recommendation or Tip
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 1
Table of Contents
1. Implementation SAP-NLS Solution with Sybase IQ .............................................................. 2
1.1 Solution Overview ............................................................................................................. 2
1.2 Checking the Pre Requisites ............................................................................................ 2
1.2.1 Relevant Notes/Information .............................................................................. 2
1.2.2 Default file system layout on the IQ server ....................................................... 3
1.2.3 Software Components for the SAP-NLS Implementation .............................. 4
1.2.4 Sybase IQ Database Server under Linux .......................................................... 7
1.2.5 Sybase IQ Database Server under Windows .................................................... 8
2. Installation of the Components ............................................................................................. 9
2.1 Installation/Configuration of the Sybase IQ database ................................................. 9
2.1.1 Sizing/Architecture/Scalability Overview ........................................................ 9
2.1.2 Installation IQ 15.4 Software ............................................................................ 10
2.1.2.1 Add the IQ ODBC driver 15.4 to the kernel ................ 10
2.1.3 Installation IQ 16.0 Software ............................................................................. 11
2.1.4 Apply a Service Pack (SP) to the IQ 16.0 software ........................................ 21
2.1.4.1 Apply an one-off patch on top of SP01 ..................... 22
2.1.5 Upgrade from IQ from Version 15.4 to 16.0 ....................................................23
2.1.6 Build and configure a new IQ 15.4/16.0 database ......................................... 25
2.1.6.1 Create the IQ database for NLS..................................25
2.1.6.2 start/stop the IQ database ........................................ 29
2.1.6.3 start/stop the Sybase Control Center (SCC) .......... 29
2.1.6.4 Apply the DB Options for the IQ database ............... 32
2.1.6.5 Extend the IQ database (datafiles/temp) ................ 33
2.1.6.6 Check the status of the SAP Sybase IQ database ... 34
2.1.7 Install the SAP components for Sybase IQ .....................................................35
2.1.7.1 Add the ODBC IQ driver to the SAP Kernel .............. 35
2.1.7.2 Add the IQ LibDBSL to the SAP Kernel ..................... 35
2.1.7.3 Configure Smart Data Access - HANA and IQ ......... 36
3. Configuration of the SAP Components ............................................................................... 38
3.1 Sybase IQ related ........................................................................................................... 38
3.1.1 Create/configure SAPDB user ............................................................. 38
3.2 SAP NetWeaver BW related.......................................................................................... 40
3.2.1 Apply the latest corrections for the NLS Solution. ....................................... 40
3.2.2 Transaction DBCO - database connection to IQ ............................................ 41
3.2.3 Transaction RSDANLCON - connection to NLS storage .............................. 42
3.2.4 Monitor the NLS Connection ........................................................................... 42
4. Using the SAP-NLS Solution ............................................................................................... 44
5. Appendix .............................................................................................................................. 45
5.1 Tipps for the IQ Administration ................................................................................... 45
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 2
1. Implementation SAP-NLS Solution with Sybase IQ
1.1 Solution Overview
Documentation:
http://help.sap.com/saphelp_nw73ehp1/helpdata/en/60/cf63e1bbbb49429ee6c35e6ad03a45/conten
t.htm?frameset=/en/4c/75184b167821d1e10000000a42189c/frameset.htm
1.2 Checking the Pre Requisites
1.2.1 Relevant Notes/Information Note 1750249 - SAPBWNews NW BW 7.30 ABAP SP9
Note 1782744 - SAPBWNews NW BW 7.31 ABAP SP07
Note 1796393 - SAP BW near-line solution with Sybase IQ
Note 1737415 - Sybase IQ: Enable remote/secondary connect to Sybase IQ
The BW System you want to use must have either SP09 for BW 7.30 or SP07 for 7.31 applied. The
existence of BW on HANA is not required, as the SAP-NLS Solution works with every Database (unicode
enabled) supported by SAP NetWeaver 7.30 and higher.
The Sybase IQ must be implemented on a separate physical server. It is not recommended to install the
software on an existing server which held already other Database Instances, as IQ leverages the complete
CPU/Memory for its own usage. One IQ server can be used for multiple SAP-NLS implementations.
For the current timeframe the supported OS versions for the SAP-NLS solutions are Windows X64 and
Linux X86-64. Additional OS Versions are under Evaluation.
Please note that the Solution is not available for SAP NetWeaver 7.0x Releases, SAP ERP Releases based
on NetWeaver 7.0x and Non Unicode Systems. Therefore use the NLS Add-On from the Development
Partner PBS http://www.pbs-software.com
http://help.sap.com/saphelp_nw73ehp1/helpdata/en/60/cf63e1bbbb49429ee6c35e6ad03a45/content.htm?frameset=/en/4c/75184b167821d1e10000000a42189c/frameset.htmhttp://help.sap.com/saphelp_nw73ehp1/helpdata/en/60/cf63e1bbbb49429ee6c35e6ad03a45/content.htm?frameset=/en/4c/75184b167821d1e10000000a42189c/frameset.htmhttps://service.sap.com/sap/support/notes/1750249https://service.sap.com/sap/support/notes/1750249https://service.sap.com/sap/support/notes/1782744https://service.sap.com/sap/support/notes/1782744https://service.sap.com/sap/support/notes/1782744https://service.sap.com/sap/support/notes/1796393https://service.sap.com/sap/support/notes/1796393https://service.sap.com/sap/support/notes/1796393https://service.sap.com/sap/support/notes/1737415https://service.sap.com/sap/support/notes/1737415http://www.pbs-software.com/
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 3
1.2.2 Default file system layout on the IQ server
Please provide for now the following file system layout on the designated IQ database server:
Server name: SAPNLS_SERVER
Database name: SAPNLS_DB
User name for SAP NLS schema: SAPNLS
Binary Installation Directory: /usr/sap/sybase/server/ # $SYBASE
Path for SYSTEM DB: /usr/sap/sybase/sapdata/database
Path for SYSTEM LOG: /usr/sap/sybase/sapdata/log
Path for SYSTEM DBSPACE: /usr/sap/sybase/sapdata/system
Path for server MESSAGES: /usr/sap/sybase/sapdata/messages
Path for TEMPORARY Space: /usr/sap/sybase/sapdata/temp # IQ load
Path for TMP Space: /usr/sap/sybase/sapdata/tmp # IQ sort
Path for HTML Query Plans: /usr/sap/sybase/sapdata/html
Path for further DBSPACE: /usr/sap/sybase/sapdata/NLSDBSPACExxx
All following creation scripts should refer to this file structure. Furthermore it is useful to create separate
partitions for the additional directories to prevent any file system overflow.
While the files for DBSPACE/TMP are defined static (and could also be raw devices), the following files or
directories are growing and need special attention: SYSTEM DB/LOG, MESSAGES and HTML.
Resulting Naming convention (this allows several different schemas in one IQ database):
User: SAPNLS
DBSPACE: NLSDBSPACE
Data: ../sapdata//data
Tmp: ../sapdata//tmp
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 4
1.2.3 Software Components for the SAP-NLS Implementation Software Packages can be downloaded from the Software Marketplace (S-User required)
IQ 16.0 Base Installation http://service.sap.com/installations
IQ 15.4 ESD#3, IQ 16.0 SPs http://service.sap.com/patches
Sybase IQ Version 15.4 ESD#3 at http://service.sap.com/patches (Linux and win64)
Or Sybase IQ Version 16.0 GA at http://service.sap.com/installations (Linux and win64)
http://service.sap.com/installationshttp://service.sap.com/patcheshttp://service.sap.com/patcheshttp://service.sap.com/installations
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 5
Sybase IQ ODBC Driver/Client for 15.4 and IQ 16.0 (lightweight client)
at http://service.sap.com/patches
LibDBSL for Sybase IQ for 7.20/7.21 EXT-UC Kernel (included in the Sybase ASE DB Version)
at http://service.sap.com/patches
Please Note that the LibDBSL for SAP Sybase ASE/IQ and the SAP Sybase IQ ODBC driver has to be
applied on every Application Server as well, if they are available.
After the files are applied no restart of the SAP Application Servers necessary.
http://service.sap.com/patcheshttp://service.sap.com/patches
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 6
Optional: Sybase Central Client 6.1 (included in the Sybase IQ 15.4 Client on Windows)
SAP Sybase IQ Client (Win 32-Bit) - DVD51045880
Create a temporary directory structure to store the needed files. Either one of the LibDBSL files
matches your 7.20/7.21 EXT-UC Kernel.
Optional: (if HANA is the main database), get the smart data access drivers for HANA (SP06).
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 7
1.2.4 Sybase IQ Database Server under Linux
Installing For the First Time
Follow these steps to install SAP Sybase IQ for the first time.
Read the release bulletin for the latest information. See the special installation instructions section
for any installation instructions not included in this document.
Complete all pre-installation tasks. Apply any required operating system patches, check to see that
there is sufficient disk space and memory, and update any necessary configuration changes.
Determine the license model you want to use. SySAM supports served and unserved license
models. See the Sybase Software Asset Management (SySAM) 2 Users Guide to determine which
model is best suited for your environment.
Use the product and licensing information you received from SAP Sybase to log in to the SAP
Sybase Product Download Center at: https://sybase.subscribenet.com or SAP Service
Marketplace at http://service.sap.com/licensekeys and generate a license key for your software.
The mentioned licenses can be merged into one file by the time you create them.
Install SAP Sybase IQ server components, activate your license, then start and test your server.
Install and configure SAP Sybase IQ client components
Needed Licenses for the SAP-NLS option:
o 7010846 Sybase IQ Enterprise Edition
o 7010848 Sybase IQ Unstructured Data Analytics
o 7010850 Sybase IQ Very Large Database Management Option
To figure out the correct values for CPU cores and MAC address you can run the following checks:
o Available CPU cores (relevant for the license)
grep -i "processor" /proc/cpuinfo | sort -u | wc l
o Available CPU processors/sockets
grep -i "physical id" /proc/cpuinfo | sort -u | wc l
o MAC address
ifconfig
http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc10083.1600/doc/html/san1282692425799.h
tml
Check out the additional needed license options with the Product Version Enterprise Edition (IQ_EE) here
Unstructured Data Analytics option (IQ_UDA) supports binary large object (BLOB)
Very Large Database Management Option (IQ_VLDBMGMT)
These are bundled in the SAP-NLS License provided by SAP.
http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.infocenter.dc38159.1600/doc/html/r
hi1334847427020.html
https://sybase.subscribenet.com/http://service.sap.com/licensekeyshttp://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc10083.1600/doc/html/san1282692425799.htmlhttp://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc10083.1600/doc/html/san1282692425799.html
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 8
Installation Details: http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc10083.1540/doc/html/title.html
Create the OS user sybase on the Sybase IQ database server. The user requires remote access authorization for remote accesses (TELNET or SSH) to the Sybase IQ database server.
Set up the directory /usr/sap/sybase/server on the Sybase IQ database server. The owner is user sybase. The directory should have at least 10 GB disk storage available for the Sybase software.
For testing purposes: Set up the directory /usr/sap/sybase/sapdata on the Sybase IQ
database server. Owner is user sybase. The directory should guarantee disk space of at least 180
GB.
Productive use: Set up the directory /usr/sap/sybase/sapdata on the Sybase IQ database
server. Owner is user sybase. The directory should guarantee disk space of at least 300 GB. In
addition, there are the partitions of the database instance that are made available via SAN. If a
RAW device-based Sybase IQ database instance should be used, the files
/dev/raw/raw and the RAW control file /dev/rawctl must be owned by user
sybase. The ownership has to be ensured even after the new start of the server.
Set up the directory /usr/sap/sybase/sapdata/tmp according to the sizes above for data. The Amount of disk space and data files for data and temp are equal. The owner is user sybase.
Additionally, set up the following directories:
/usr/sap/sybase/sapdata/db
/usr/sap/sybase/sapdata/log
/usr/sap/sybase/sapdata/system
/usr/sap/sybase/sapdata/messages
/usr/sap/sybase/sapdata/temp
/usr/sap/sybase/sapdata/html
http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc38159.1600/doc/html/rhi13348474270.html
1.2.5 Sybase IQ Database Server under Windows Installation Details: http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc30056.1540/doc/html/title.html
The installation is performed on the Sybase IQ database server under a user with administration rights.
Set up the directory :\usr\sap\sybase\server on the Sybase IQ database server. The directory should have at least 10 GB disk storage available for the Sybase software.
For testing purposes: Set up the directory :\usr\sap\sybase\sapdata on the Sybase IQ database server. The directory should guarantee disk space of at least 180 GB.
Productive use: Set up the directory :\usr\sap\sybase\sapdata on the Sybase IQ database server. The directory should guarantee disk space of at least 300 GB. In addition, there are the partitions of the database instance that are made available via SAN.
Set up the directory :\usr\sap\sybase\sapdata\tmp
according to the sizes above for data. The Amount of disk space and data files for data and temp are equal.
Additionally, set up the following directories like in the description above. The (current) Best Practice Guide for Sybase IQ 15.4 can be found here: http://www.sybase.com.br/files/White_Papers/SybaseIQ15_BestPractices_03012012.pdf
http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc10083.1540/doc/html/title.htmlhttp://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc38159.1600/doc/html/rhi1334847427020.htmlhttp://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc38159.1600/doc/html/rhi1334847427020.htmlhttp://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc30056.1540/doc/html/title.htmlhttp://www.sybase.com.br/files/White_Papers/SybaseIQ15_BestPractices_03012012.pdf
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 9
2. Installation of the Components
2.1 Installation/Configuration of the Sybase IQ database
2.1.1 Sizing/Architecture/Scalability Overview
For a general sizing guideline see the following document:
http://www.sybase.com/files/Technical_Documents/Sybase_IQ_Sizing_Guide.pdf
Simplex Server Architecture
Simplex is a single instance of an SAP Sybase IQ server running on a single node (machine).
In a simplex configuration, the files may be located on a host machine or on a network storage device (or distributed between the host and the storage device).
http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc38159.1600/doc/html/rhi1334847
427020.html
Multiplex Server Architecture
Multiplex are multiple instances of SAP Sybase IQ servers running on multiple machines. SAP Sybase IQ supports read-write transactions from multiple servers in the multiplex.
Each server has its own temporary store and catalog store. The shared IQ Store is common to all servers.
The primary server, or coordinator, manages all global read-write transactions and maintains the global
catalog. The table version log (TLV log) stores information about DLL operations and communicates
information about new table versions to the secondary servers.
http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc38159.1600/doc/html/rhi1334847426786.html
Scalability
SAP Sybase IQs patented design permits databases to scale to contain many terabytes of data.
Its index-based structure allows the database to store your data in a much smaller space than the size of the raw input data, and access it far faster than a traditional relational database. These features make SAP Sybase IQ ideal for storing and accessing very large databases (VLDBs).
Database administrators need to understand the options and features that affect performance, and follow documented guidelines. While many default settings automatically provide the greatest efficiency, you may need to experiment with certain option settings for the fastest results, based on your configuration, your loading requirements, and your queries. Setting these options appropriately is necessary for top performance in any SAP Sybase IQ database, but is especially important as your database grows to the multiterabyte scale.
http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc38159.1600/doc/html/san1283555073531.html
SAP Sybase IQ Development Center
http://scn.sap.com/community/developer-center/analytic-server
http://scn.sap.com/community/sybase-iq
http://www.sybase.com/files/Technical_Documents/Sybase_IQ_Sizing_Guide.pdfhttp://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc38159.1600/doc/html/rhi1334847427020.htmlhttp://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc38159.1600/doc/html/rhi1334847427020.htmlhttp://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc38159.1600/doc/html/rhi1334847426786.htmlhttp://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc38159.1600/doc/html/rhi1334847426786.htmlhttp://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc38159.1600/doc/html/san1283555073531.htmlhttp://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc38159.1600/doc/html/san1283555073531.htmlhttp://scn.sap.com/community/developer-center/analytic-serverhttp://scn.sap.com/community/sybase-iq
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 10
2.1.2 Installation IQ 15.4 Software
After downloading the software (IQ 15.4 ESD#03) and unpacking the executables into a temporary
directory start the Installation on Linux with the user sybase
You can use Putty (0.61) with the Xming Extension. For details how to use it, visit the URL
http://www.straightrunning.com/XmingNotes/
sybase@lt5006:/data/software/sybase/IQ15.4/server> ./setup.bin
On Windows run the setup.exe by double clicking the setup.exe
The detailed Steps are described with the software installation of Sybase IQ 16.0 in Chapter 2.1.3, as the
steps are identical.
2.1.2.1 Add the IQ ODBC driver 15.4 to the kernel
Unpack the SAR file to a temporary directory and copy the files to the SAP Kernel directory located at
/usr/sap//DVEBMGS/exe
A restart of the SAP System is not necessary and the libraries must have 775 as file permission.
sybase@lt5006: /data/software/sybase/IQ15.4/Note1737415>
SAPCAR -xvf _sar\ IQCLIENT154SP01_0-10012189.SAR
SAPCAR: processing archive _sar/IQCLIENT154SP01_0-10012189.SAR (version 2.01)
SAPCAR: 25 file(s) extracted
http://www.straightrunning.com/XmingNotes/
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 11
2.1.3 Installation IQ 16.0 Software Documentation:
http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.infocenter.dc01777.1600/doc/html/
wil1360595831793.html
Details for the sybase control center (SCC) installation http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc010.0327/doc/pdf/scc_installation.pdf
After downloading the software (IQ 15.4 ESD#03) and unpacking the executables into a temporary
directory start the Installation on Linux with the user sybase
You can use Putty (0.61) with the Xming Extension. For details how to use it, visit the URL
http://www.straightrunning.com/XmingNotes/
sybase@lt5006:/data/software/sybase/IQ16_0/server> ./setup.bin
On Windows run the setup.exe by double clicking the setup.exe
http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.infocenter.dc01777.1600/doc/html/wil1360595831793.htmlhttp://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.infocenter.dc01777.1600/doc/html/wil1360595831793.htmlhttp://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc01002.0327/doc/pdf/scc_installation.pdfhttp://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc01002.0327/doc/pdf/scc_installation.pdfhttp://www.straightrunning.com/XmingNotes/
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 12
The directory /usr/sap/sybase/server might already available and the environment variable
$SYBASE will point to /usr/sap/sybase/server
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 13
In case of an Upgrade from IQ 15.4 to Version 16.0 you will find different directories here for the releases.
For the ease of the setup the option Typical contains the selected options from the Install Set Custom.
So you can directly proceed with the Option Typical.
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 14
The Installation of the SySAM License Server is not necessary. The temporary license works for 30 days
and will be replaced by an official purchased license. If you plan to use a License Server for the complete
Sybase Landscape check this with the SAP Sybase Representatives.
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 15
Dont install the Evaluation Version of Sybase IQ 16.0
Select the End-user license agreement and agree to the terms of the Sybase license install location.
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 16
Apply the license in a later step.
Choose Enterprise Edition (EE - for all Options) and CPU License (CP).
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 17
This is an optional step for alerting, mainly license expiring messages.
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 18
HTML ports for the Sybase Central Application (web/java based). Check the Ports with your existing
available Ports, e.g. see - http://scn.sap.com/docs/DOC-116
To connect to Sybase Control Center, direct your browser to: https://:8283/scc
http://scn.sap.com/docs/DOC-11602
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 19
The default user accounts are sccadmin (Sybase Control Center) and uafadmin (SCC agent).
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 20
Starting/Stopping with console prompt: $SYBASE/SCC-3_2/bin/scc.sh and scc.sh --stop
Starting in background: nohup $SYBASE/SCC-3_2/bin/scc.sh 2>&1 > scc-console.out &
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 21
After the software installation is finished you can access the database instance from the Sybase control
center and create the main database.
2.1.4 Apply a Service Pack (SP) to the IQ 16.0 software
By the Availability of a service pack (SP) for the IQ 16.0 download them from the location
http://service.sap.com/patches
http://service.sap.com/patches
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 22
Online Help for Sybase IQ16 SP01
http://infocenter.sybase.com/help/index.jsp?docset=/com.sybase.infocenter.help.iq.16.0.1/doc/html/
title.html&docSetID=1962
The upgrade process is identical as the installation process, see Chapter before.
Make sure the user sa is unlocked before you apply the SP01 Package. Furthermore the Installation
Routine will not detect an existing IQ installation; it will run as a fresh Installation.
2.1.4.1 Apply an one-off patch on top of SP01
Sybase IQ one-off patches are fixing temporary problems as intermediate solution, until the next mayor
Support Package will be available. If already a Patch is available, you can skip the manual procedure as
described and follow the procedure in Chapter 2.1.4
The one-off patch for SP01 (01.01) is fixing the following problems:
SwrID CR Description
------- ------ ------------------------------------------------------
SP01.01 735487 An update statement to update IQ table failed when the statement included the
IsNumeric function.
1> update t set a = '1' where isnumeric(a)=0 2> go Msg 7338, Level 15,
State 0: SQL Anywhere Error -728: Update operation attempted on non-updatable remote query
SP01.01 741466 Alter Table Add Default fails after INSERT into Quoted
Identifier Tablename Example:
CREATE TABLE "/TAB1"(COL1 int not null)
INSERT INTO "/TAB1" values (1);
ALTER TABLE "/TAB1" add COL2 int default 0
SP01.01 739459 If CESU8BIN was selected as collation to create the database, the resource could not
be registered properly. This is now resolved.
To Apply the Correction, please follow the following instructions:
http://infocenter.sybase.com/help/index.jsp?docset=/com.sybase.infocenter.help.iq.16.0.1/doc/html/title.html&docSetID=1962http://infocenter.sybase.com/help/index.jsp?docset=/com.sybase.infocenter.help.iq.16.0.1/doc/html/title.html&docSetID=1962
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 23
Stop the IQ server and the sybase control center (SCC) first
Unpack the TGZ file (AIX, Linux64) with tar xvf LinuxAMD64-iq160_ctrl01.01.tgz
Or Unzip the ZIP file (Win64) Win64-iq160_ctrl01.01.zip into a temporary directory on
your IQ server. Make sure the file properties (user: group) are correct.
Move to the temporary directory and copy the new binaries into the right directories in the $SYBASE
location.
$SYBASE/SCC-3_2/bin/scc.sh --stop
cd /data/software/sybase/IQ16_0/SP01.01
cd iq1600_sp01.01
cp -Rp * /data/sap/sybase/server/IQ-16_0
cd scciq-3_2
cp -Rp * /data/sap/sybase/server/SCC-3_2/plugins
nohup . $SYBASE/SCC-3_2/bin/scc.sh 2>&1 > scc-console.out &
Restart the IQ server and the SCC Instance
Now your Sybase IQ one-off patch on top of SP01 is applied and ready to use.
2.1.5 Upgrade from IQ from Version 15.4 to 16.0
If you started your Implementation with the Version 15.4 ESD#3 or earlier e.g. with the PBS NLS Add-On
and you want to upgrade to the latest Version with CESU-8 support, which is 16.0 SP01.01 you have to
upgrade the existing database software and the content of the database.
Detailed Upgrade procedure is described here:
http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc01825.1600/doc/pdf/iqmigwin.pdf
Update the database software as described in Chapter 2.1.3. Therefore you have to stop the IQ database
Stop the IQ database with
sybase@lt5006:/usr/sap/sybase/server/sapdata/>stop_iq
After the software update you will find a new directory in your $SYBASE root directory called IQ-16_0
http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc01825.1600/doc/pdf/iqmigwin.pdf
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 24
Source the new IQ 16.0 database software
sybase@lt5006:/usr/sap/sybase/server>. IQ.sh
Check the .profile file in the user sybase home directory and the SYBASE.sh file for the correct
settings. The IQ.sh Profile contains the current setting for the correct IQ software Version.
Start the IQ database (for the Upgrade Process) with
sybase@lt5006:/usr/sap/sybase/sapdata/database>
start_iq @database/SAPNLSDB.cfg database/SAPNLSDB.db -iqro 1 -gm 1
Run the I-SQL Interface with
alter database upgrade;
Stop the IQ database with
sybase@lt5006:/usr/sap/sybase/sapdata/database> stop_iq
Start the IQ database again (in normal mode) with
sybase@lt5006:/usr/sap/sybase/sapdata/database>
start_iq @SAPNLSDB.cfg SAPNLSDB.db
Your database IQ is now upgraded to Version 16.0. As a final step apply the DB options again as described in Chapter 2.1.5.2
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 25
2.1.6 Build and configure a new IQ 15.4/16.0 database At this point in time this building step is a manual process which contains steps directly on the server and
some steps via the I-SQL interface from your client PC.
In our example we installed Sybase IQ 16.0 on a Linux server with 16x4 Core CPU cores (necessary later
for the data stripping) and 256GB RAM. The Sybase IQ ODBC client is installed on the Windows client as
64-Bit application. The Software contains the Sybase Central 6.1 which can be used for the
Administration of the IQ database.
The Sybase Central Client picks the local language from your PC, so you see some screenshots in
German. Our used server is lt5006 and the SAP system SID is . The notation of the NLS
database follows the naming convention of a SAP database instance: SAPNLS_DB
Check the .profile file in the user sybase home directory and the SYBASE.sh file for the correct
settings. The IQ.sh Profile contains the current setting for the correct IQ software Version.
. /usr/sap/sybase/server/IQ-16_0/IQ-16_0.sh
cd /usr/sap/sybase/sapdata/database
2.1.6.1 Create the IQ database for NLS
To create the database instance for the NLS solution the process has to initialize with the start of a
default DB which allows creating the main database. This can be done with the option n followed by
the database instance name. This database is called utility_db.
The build process for 15.4 and 16.0 is identical and the Sybase Central 6.1 tool is usable with both
database Versions. More Details about the Database Creation with SQL is described here:
http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc01771.1600/doc/html/san1283555
474735.html
Log on with the user sybase and change to the sybase main directory
sybase@lt5006:/usr/sap/sybase/sapdata/database> start_iq n utility_db
Please note that the directory you started the utility_db is the root, where all other files which are
created in the DB creation are related to. So please make sure you start the temporary DB in the correct
directory /usr/sap/sybase/sapdata/database
Now that we started the default IQ database, we can use now the I-SQL Interface provided by the Sybase
Client to create the main database. This step can also be done via Sybase Control Center (SCC)
The default Port of the utility_db is 2638. If this port is occupied by other processes you can also
specify any other Port during the startup with the option -x tcpip{port=}
Start the on your local PC
http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc01771.1600/doc/html/san1283555474735.htmlhttp://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc01771.1600/doc/html/san1283555474735.html
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 26
With F9 you can call the Window for the connection profiles
This is now the first time to connect to the database via DBA/sql and the default Port 2638 to the
utility_db.
Now you can call the I-SQL interface by right-mouse-click on the database symbol SAPNLSDB-DBA
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 27
In the I-SQL Interface paste the following SQL script for the creation of the main database.
The collation option CESU8BIN and encoding option CESU8 are only available in the latest 15.4 Patch
ESD#3 and 16.0 Sybase IQ Versions provided by SAP. The path can be created in an absolute or relative
relation. The file size specification might be necessary as well in the main database.
Assuming the utility_db is started in directory /usr/sap/sybase/sapdata/database
/* ============================================================*/
/* create_database.sql */
/* Sybase IQ database instance "SAPNLSDB" - CREATE DB */
/* V.20130320-01 */
/* ============================================================*/
create database 'SAPNLSDB.db'
log on '../log/SAPNLSDB_log.log'
collation 'CESU8BIN'
encoding 'CESU8'
temporary path '../tmp/SAPNLSDB_tmp_001.iqtmp'
iq path 'SAPNLSDB_main_001.iq'
message path '../messages/SAPNLSDB_msg.iqmsg'
iq page size 131072
iq size 8192
temporary size 8192
jconnect on
java on
blank padding on
;
After the creation process is finished you can stop the utility_db and start the new created database
sybase@lt5006:/usr/sap/sybase/sapdata/database> stop_iq
To start the IQ database you will need a configuration file. You can copy the following example and put the
file SAPNLSDB.cfg to the database directory
sybase@lt5006:/usr/sap/sybase/sapdata/database>
start_iq @ SAPNLSDB.cfg SAPNLSDB.db
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 28
/* -----------------------------------------------------------*/
/* @(#)SAPNLSDB.cfg */
/* Sybase IQ database instance "SAPNLSDB" - CONFIGURATION */
/* V.20130320-01 */
/* -----------------------------------------------------------*/
#### Name of the server
-n SAPNLS_SERVER
#### Cache memory for Anywhere
#### -c 512 increased on 201307 to support 2 GB files as client blob loading
-c 4096m
-gc 20
-gd all
#### adjust according the existing memory we have 256GB HW.
#### Use 80% of existing RAM and reserve 1/3 for every parameter
-iqlm 68267
-iqtc 68267
-iqmc 68267
#### we have 16x4 core CPU hardware this forces on Intel to do more parallel
-iqnumbercpus 64
#### location of the temp dir for IQ
-dt ./temp
#### network
-x tcpip{port=2641}
#### everybody is allowed to load table statement
-gl all
#### >Number of connections in the server
-gm 100
-gp 4096
-ti 4400
#### timeout for debugging
-tl 600
#### Prevent UDP connection support
-sb 0
#### we force clients to use large size as default
-p 16000
#### Displays diagnostic communication messages
-z
#### log activities on the server
#-zr all
#### LOG DIAGNOSTIC
-o ./log/SAPNLSDB_DIAG.log
#### Name of log file
-zo ./log/SAPNLSDB_PROTOCOL.log
#### size of the log file
-zs 10m
#### Number of log files
-zn 5
#### size of iqmessagefile in mb
-iqmsgsz 100
#### versions of iqmessagefile
-iqmsgnum 5
Now your database SAPNLSDB is ready for the next steps like options and extending.
Details on the sizing guidelines for Sybase IQ 16.0 can be found here:
http://scn.sap.com/docs/DOC-41455
http://scn.sap.com/docs/DOC-41455
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 29
2.1.6.2 start/stop the IQ database
With a short script where you paste this line in a command you can ease the startup
sybase@lt5006:/usr/sap/sybase/sapdata/database> start_SAPNLSDB
# -----------------------------------------------------------------------------
# @(#)start_SAPNLS_DB
# start Sybase IQ database instance "SAPNLSDB"
# V.201320-01
# -----------------------------------------------------------------------------
start_iq @SAPNLSDB.cfg SAPNLSDB.db
Additional Information about start_iq can be found here:
http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc00168.1510/html/iqutil/CHDFHBJB
.htm
To stop the IQ database you can use the following script:
# -----------------------------------------------------------------------------
# @(#)start_SAPNLS_DB
# start Sybase IQ database instance "SAPNLS_DB"
# V.201320-01
# -----------------------------------------------------------------------------
dbstop -c "uid=DBA;pwd=sql;eng=SAPNLS_SERVER;dbn=SAPNLSDB"
With a short script where you paste this line in a command you can stop now the IQ database exclusively,
e.g. you have more than one IQ database installed one physical server
sybase@lt5006:/usr/sap/sybase/sapdata/database> stop_SAPNLSDB
Additional Information about dbstop and stop_iq can be found here:
http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc00168.1510/html/iqutil/BABBFBFC.htm
2.1.6.3 start/stop the Sybase Control Center (SCC)
http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.infocenter.dc01777.1601/doc/html/wil1352994883361.html
Starting/Stopping with console prompt: $SYBASE/SCC-3_2/bin/scc.sh and scc.sh --stop
SCC> shutdown
Starting/Stopping in background: nohup ./scc.sh 2>&1 > scc-console.out &
The default user accounts are sccadmin (Sybase Control Center) and uafadmin (SCC agent).
Please make sure that you have created the following Link and restarted the SCC service for the correct usage of the SCC Agent.
ln -s /usr/bin/env /bin/env
http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc00168.1510/html/iqutil/CHDFHBJB.htmhttp://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc00168.1510/html/iqutil/CHDFHBJB.htmhttp://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc00168.1510/html/iqutil/BABBFBFC.htmhttp://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc00168.1510/html/iqutil/BABBFBFC.htmhttp://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.infocenter.dc01777.1601/doc/html/wil1352994883361.htmlhttp://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.infocenter.dc01777.1601/doc/html/wil1352994883361.html
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 30
Logon to the Sybase Control Center (SCC) with sccadmin and
https://server.domain.ext:8083/scc
https://server.domain.ext:8083/scc
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 31
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 32
2.1.6.4 Apply the DB Options for the IQ database
Paste the following SQL script into the I-SQL Interface for the creation of the main database.
These Values are based on the current experiences with the Sybase IQ database. To activate these
settings you have to restart the database.
/* -----------------------------------------------------------*/
/* @(#)options.sql */
/* Sybase IQ database instance "SAPNLSDB" - SET OPTIONS */
/* V.20130320-01 */
/* -----------------------------------------------------------*/
### main setting for the SAP-NLS solution set option public.allow_read_client_file='ON';
set option public.append_load='ON';
set option public.default_disk_striping='ON';
set option public.default_kb_per_stripe=128;
set option public.force_no_scroll_cursors='ON';
set option public.index_advisor='ON';
set option public.index_advisor_max_rows=1000;
set option public.main_reserved_dbspace_mb=12000;
set option public.minimize_storage='ON';
set option public.os_file_cache_buffering='OFF';
set option public.os_file_cache_buffering_tempdb='OFF';
set option public.query_detail='ON';
set option public.query_plan='ON';
set option public.query_plan_after_run='ON';
set option public.query_plan_as_html_directory='./html';
set option public.query_temp_space_limit=0;
set option public.query_timing='ON';
set option public.temp_reserved_dbspace_mb=12000;
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 33
2.1.6.5 Extend the IQ database (datafiles/temp)
Now the database has to be extended to use the optimum from the existing hardware resources like CPU
and RAM.
As a starting point we would normally split the data/tmp devices on a 50:50 basis as a starting point. Over
time we can add more devices for data and may at some point arrive at a 60:40 ratio based on usage,
content and query profiles of our user base.
The general rule is then to subtract 100-Gb from the available (raw) device size and to then create
([#cores] * 2) additional devices all of an equal size to consume the remaining free disk space in the disk
array.
This results in the following (raw) disk definition. However, this also works with a standard file system.
Please Note that this step will take some time depending on the hardware resources.
/* -----------------------------------------------------------*/
/* @(#)extend.sql */
/* Sybase IQ database instance "SAPNLSDB" - Extend DB */
/* V.20130320-01 */
/* -----------------------------------------------------------*/
CREATE DBSPACE NLSDBSPACE001 USING
FILE NLSDBSPACE001_001 '../NLSDBSPACE001/NLSDBSPACE001_001.iq' size 12288,
FILE NLSDBSPACE001_002 '../NLSDBSPACE001/NLSDBSPACE001_002.iq' size 12288,
FILE NLSDBSPACE001_003 '../NLSDBSPACE001/NLSDBSPACE001_003.iq' size 12288,
FILE NLSDBSPACE001_004 '../NLSDBSPACE001/NLSDBSPACE001_004.iq' size 12288,
FILE NLSDBSPACE001_005 '../NLSDBSPACE001/NLSDBSPACE001_005.iq' size 12288,
FILE NLSDBSPACE001_006 '../NLSDBSPACE001/NLSDBSPACE001_006.iq' size 12288,
FILE NLSDBSPACE001_007 '../NLSDBSPACE001/NLSDBSPACE001_007.iq' size 12288,
FILE NLSDBSPACE001_008 '../NLSDBSPACE001/NLSDBSPACE001_008.iq' size 12288,
FILE NLSDBSPACE001_009 '../NLSDBSPACE001/NLSDBSPACE001_009.iq' size 12288,
FILE NLSDBSPACE001_010 '../NLSDBSPACE001/NLSDBSPACE001_010.iq' size 12288,
FILE NLSDBSPACE001_011 '../NLSDBSPACE001/NLSDBSPACE001_011.iq' size 12288,
FILE NLSDBSPACE001_012 '../NLSDBSPACE001/NLSDBSPACE001_012.iq' size 12288,
FILE NLSDBSPACE001_013 '../NLSDBSPACE001/NLSDBSPACE001_013.iq' size 12288,
FILE NLSDBSPACE001_014 '../NLSDBSPACE001/NLSDBSPACE001_014.iq' size 12288,
FILE NLSDBSPACE001_015 '../NLSDBSPACE001/NLSDBSPACE001_015.iq' size 12288,
FILE NLSDBSPACE001_016 '../NLSDBSPACE001/NLSDBSPACE001_016.iq' size 12288
STRIPING ON
STRIPESIZEKB 128;
ALTER DBSPACE IQ_SYSTEM_TEMP ADD
FILE SAPNLSDB_tmp_002 '../tmp/SAPNLSDB_tmp_002.iqtmp' size 12288,
FILE SAPNLSDB_tmp_003 '../tmp/SAPNLSDB_tmp_003.iqtmp' size 12288,
FILE SAPNLSDB_tmp_004 '../tmp/SAPNLSDB_tmp_004.iqtmp' size 12288,
FILE SAPNLSDB_tmp_005 '../tmp/SAPNLSDB_tmp_005.iqtmp' size 12288,
FILE SAPNLSDB_tmp_006 '../tmp/SAPNLSDB_tmp_006.iqtmp' size 12288,
FILE SAPNLSDB_tmp_007 '../tmp/SAPNLSDB_tmp_007.iqtmp' size 12288,
FILE SAPNLSDB_tmp_008 '../tmp/SAPNLSDB_tmp_008.iqtmp' size 12288,
FILE SAPNLSDB_tmp_009 '../tmp/SAPNLSDB_tmp_009.iqtmp' size 12288,
FILE SAPNLSDB_tmp_010 '../tmp/SAPNLSDB_tmp_010.iqtmp' size 12288,
FILE SAPNLSDB_tmp_011 '../tmp/SAPNLSDB_tmp_011.iqtmp' size 12288,
FILE SAPNLSDB_tmp_012 '../tmp/SAPNLSDB_tmp_012.iqtmp' size 12288,
FILE SAPNLSDB_tmp_013 '../tmp/SAPNLSDB_tmp_013.iqtmp' size 12288,
FILE SAPNLSDB_tmp_014 '../tmp/SAPNLSDB_tmp_014.iqtmp' size 12288,
FILE SAPNLSDB_tmp_015 '../tmp/SAPNLSDB_tmp_015.iqtmp' size 12288,
FILE SAPNLSDB_tmp_016 '../tmp/SAPNLSDB_tmp_016.iqtmp' size 12288,
FILE SAPNLSDB_tmp_017 '../tmp/SAPNLSDB_tmp_017.iqtmp' size 12288
;
set option public.default_dbspace='NLSDBSPACE001';
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 34
2.1.6.6 Check the status of the SAP Sybase IQ database
After you logged on with the I-SQL interface you can run the following procedure to check the status of
the SAP Sybase IQ database and the usage of the correct license. Please Note, that some of the optional
License Options might not active, as long as there are not used so far (e.g. IQ_LOB)
sp_iqstatus;
sp_iqlmconfig;
sp_iqcheckoptions;
sp_iqcheckdb 'allocation database';
sp_iqcheckdb 'dropleaks database';
sp_iqdbspace;
sp_iqdbspaceobjectinfo SAPNLSDB;
sp_iqfile SAPNLSDB;
The tmp files will be added to the existing main temp space, while data files are created additionally.
See also the different file extensions for the different file types.
http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc38159.1600/doc/html/rhi1334847
427020.html
Additional useful System Stored Procedures for IQ16 can be found here:
http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.infocenter.dc38151.1540/doc/html/s
an1278453250070.html
Note 1843189 - SAP Sybase IQ Troubleshooting and diagnostics collection checklist
check this Note for more Information.
http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc38159.1600/doc/html/rhi1334847427020.htmlhttp://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc38159.1600/doc/html/rhi1334847427020.htmlhttp://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.infocenter.dc38151.1540/doc/html/san1278453250070.htmlhttp://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.infocenter.dc38151.1540/doc/html/san1278453250070.htmlhttp://service.sap.com/sap/support/notes/1843189
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 35
2.1.7 Install the SAP components for Sybase IQ
2.1.7.1 Add the ODBC IQ driver to the SAP Kernel
Unpack the SAR file to a temporary directory and copy the files to the SAP Kernel directory located at
/usr/sap//DVEBMGS/exe
A restart of the SAP System is not necessary and the libraries must have 775 as file permission.
sybase@lt5006: /data/software/sybase/IQ16.0/Note1737415>
SAPCAR -xvf _sar\IQCLIENT160SP01_0.SAR
SAPCAR: processing archive _sar/IQCLIENT160SP01_0.SAR (version 2.01)
x dblgen16.res
x dblgen_iq16.res
x dblgja16_eucjis.res
x dblgja16_sjis.res
x dblgja16_utf8.res
x dblgja_iq16_eucjis.res
x dblgja_iq16_sjis.res
x dblgja_iq16_utf8.res
x dblgzh16_cp936.res
x dblgzh16_eucgb.res
x dblgzh16_utf8.res
x dblgzh_iq16_cp936.res
x dblgzh_iq16_eucgb.res
x dblgzh_iq16_utf8.res
x libdbicu16.so
x libdbicu16_r.so
x libdbicudt16.so
x libdbodbc12.so
x libdbodbc16_n.so
x libdbodbc16_r.so
x libdbodbcansi16_r.so
x libdbodbcinst16_r.so
x libdbodm16.so
x libdbtasks16.so
x libdbtasks16_r.so
SAPCAR: 25 file(s) extracted
2.1.7.2 Add the IQ LibDBSL to the SAP Kernel
sybase@lt5006:/data/software/sybase/IQ16.0/Note1737415>
SAPCAR -xvf _sar\lib_dbsl_427-10010165.sar
SAPCAR: processing archive lib_dbsl_427-10010165.sar (version 2.01)
x dbsybslib.so
x dbsybslib.pdb
x patches.mf
x SIGNATURE.SMF
SAPCAR: 4 file(s) extracted
sybase@lt5006: /data/software/sybase/IQ16.0/Note1737415>
copy * /usr/sap//DVEBMGS/exe
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 36
2.1.7.3 Configure Smart Data Access - HANA and IQ
Note 1868209 - SAP HANA Smart Data Access: Central Note
Note 1868702 - SAP HANA Smart Data Access: Remote DataSource Drivers
Note 1879294 - SAP HANA smart data access SP1
You can find the Detailed Description for the Smart Data Access
http://help.sap.com/hana/SAP_HANA_Administration_Guide_en.pdf (SPS6 Document Version: 1.1 - 17-07-2013) - Chapter 16.3 - About SAP HANA Smart Data Access
Unpack the file IMDB_SDA100_1-20011324.SAR into a temporary directory and run the setup to install
the ODBC drivers for HANA. Please note that the Directory /usr/sap//federation had to be
created beforehand.
sybase@lt5006:/data/software/temp>
SAPCAR -xvf _sar\IMDB_SDA100_1-20011324.SAR
SAPCAR: processing archive IMDB_SDA100_1-20011324.SAR (version 2.01)
sybase@lt5006:/data/software/temp>./ install.sh -s
Update the adm profile so that the two environment variables are set as shown:
ODBC_IQ=libdbodbc16_r.so
LD_LIBRARY_PATH=:/usr/sap//federation
Create an empty .odbc.ini file in the home directory of the adm of the HANA user with the
following structure:
lt5006: /usr/sap//home> more .odbc.ini
[IQSOURCE]
Driver= libdbodbc16_r.so
ServerName=
CommLinks=tcpip(host=;port=)
After these manual settings, you have to restart the HANA server to make the changes active.
lt5006:/usr/sap//HDB07> HDB stop
lt5006:/usr/sap//HDB07> HDB start
https://service.sap.com/sap/support/notes/1868209https://service.sap.com/sap/support/notes/1868702https://service.sap.com/sap/support/notes/1879294http://help.sap.com/hana/SAP_HANA_Administration_Guide_en.pdf
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 37
Use a SAP HANA Studio Version from SP06 onwards to configure a new remote source to an existing IQ
server.
Create a virtual Table based on an existing Table located in the IQ Server.
The Table is now visible in the SAP Schema of the BW on HANA System
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 38
3. Configuration of the SAP Components
Documentation:
http://help.sap.com/saphelp_nw73ehp1/helpdata/en/e8/395401e46f4edca50aefeead7f3a44/framese
t.htm
3.1 Sybase IQ related
3.1.1 Create/configure SAPDB user You can use the Sybase Control to create the necessary user
http://help.sap.com/saphelp_nw73ehp1/helpdata/en/e8/395401e46f4edca50aefeead7f3a44/frameset.htmhttp://help.sap.com/saphelp_nw73ehp1/helpdata/en/e8/395401e46f4edca50aefeead7f3a44/frameset.htm
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 39
Alternative you can create the user as well with the following script. In case the authorizations
read/write client file is not supported anymore by the server, use the role DBA.
/* -----------------------------------------------------------*/
/* @(#)user.sql */
/* Sybase IQ database instance "SAPNLSDB" - create USER */
/* V.20130320-01 */
/* -----------------------------------------------------------*/
create user SAPDB identified by '**********';
grant BACKUP, READCLIENTFILE, RESOURCE to SAPDB
grant DBA to SAPDB
If we have more than one System connect to the IQ database, the logon is handled differently to separate the access of the user data.
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 40
3.2 SAP NetWeaver BW related
3.2.1 Apply the latest corrections for the NLS Solution.
Therefore go to the Note search http://service.sap.com/notes and use the Keywords SAPKW73010 NLS:
BW-WHM-DST-ARC 1829770 Incorrect authorization check for NLS archiving
BW-WHM-DST-DTP 1836448 P31:DTP:WO-DSO:Extraktion nicht Requestweise wenn Archiviert
BW-BEX-OT-OLAP 1859947 Systemfehler in Klasse CL_RSDRC_SEL_ELSE_SPLITTER
BW-WHM-DST-DTP 1860199 P31:DTP:BATCH:DBIF_RSQL_INVALID_RSQL:No Ressources DB-Conn.
BW-WHM-DST-ARC 1861437 Relative Zeitselektion auf kundenspezifischem Merkmal stoppt
BW-BEX-OT-OLAP 1812383 Error message for NLS+NOP combination
BW-BEX-OT 1814001 Changed query setting in MPRO not active in query
BW-BEX-OT 1814364 Changed NLS option in PartProvider not visible in query
BW-WHM-DST-ARC 1818411 Exception CX_RS_PROGRAM_ERROR during lookup on NLS data
BW-WHM-DST-ARC 1822328 Smart merge trigger for SAP HANA DB after archiving
BW-BEX-OT 1824151 Addition to SAP Note 1814364: NLS read mode using timestamp
BW-WHM-DBA-MD 1661251 SP31:New Master data deletion - Enhancements
Use the Transaction SNOTE to upload several Notes at once and apply the corrections
These are the Notes after applying NetWeaver 7.30 SP10:
BW-WHM-DST-ARC 1858550 11 Downport von NLS IQ nach BW 7.0x
BW-WHM-DST-ARC 1884712 1 Fehler COMPUTE_BCD_OVERFLOW bei DAP-Archivierung
BW-BEX-OT-OLAP 1891983 2 NLS: System gibt Fehler mit Bezug auf SFK_MESSAGE-02- aus
BW-BEX-OT-VC 1893890 1 Query auf NLS mit Selektion von Nav.Attributen langsam
BW-WHM-DST-ARC 1900909 2 Lookup auf NLS verliert where-Bedingung
BW-WHM-DST-ARC 1901325 1 Schreibvariante NLS/ADK zeigt in Prozesskette initiale Werte
http://service.sap.com/noteshttp://service.sap.com/~sapidb/012003146900000011122013http://service.sap.com/~sapidb/012003146900000131752013http://service.sap.com/~sapidb/012003146900000577032013http://service.sap.com/~sapidb/012003146900000580282013http://service.sap.com/~sapidb/012003146900000603422013http://service.sap.com/~sapidb/012006153200000122062013http://service.sap.com/~sapidb/012006153200000152042013http://service.sap.com/~sapidb/012006153200000158752013http://service.sap.com/~sapidb/012006153200000231732013http://service.sap.com/~sapidb/012006153200000297002013http://service.sap.com/~sapidb/012006153200000328932013http://service.sap.com/~sapidb/012006153200000593322011http://service.sap.com/~sapidb/012003146900000553542013http://service.sap.com/~sapidb/012006153200000617292013http://service.sap.com/~sapidb/012006153200000763882013http://service.sap.com/~sapidb/012006153200000802522013http://service.sap.com/~sapidb/012006153200000939992013http://service.sap.com/~sapidb/012006153200000947202013
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 41
3.2.2 Transaction DBCO - database connection to IQ
Note 1737415 - Sybase IQ: Enable remote/secondary connect to SAP Sybase IQ
Now that the LibDBSL for IQ is available in the SAP executables directory, it is now possible to create a DB
connection with the Transaction DBCO. Use the following parameter for the connection:
Connection info: SYBASE_SERVER=..
SYBASE_PORT= e.g. 2640
SYBASE_IQ_ENGINE=SAPNLSDB
SYBASE_DBNAME=SAPNLSDB
SYBASE_CONTYPE=IQ
SYBASE_IQ_LOAD=1
SYBASE_IQ_CESU-8=1
SYBASE_IQ_BUFFER_SIZE=500000
SYBASE_IQ_LOCKWAIT=600
The general format of the connection info is: key_1= key_2= ....
key_n= the key value pairs are separated by a space character.
SYBASE_SERVER, SYBASE_PORT, SYBASE_IQ_ENGINE, SYBASE_DBNAME, SYBASE_CONTYPE are
mandatory keys.
SYBASE_IQ_LOAD, SYBASE_IQ_LOCKWAIT, SYBASE_IQ_BUFFER_SIZE are optional.
Furthermore you can test the connection with the following ABAP Program ADBC_TEST_CONNECTION
A detailed test is done as well with the creation of the connection of the NLS storage.
https://service.sap.com/sap/support/notes/1737415
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 42
3.2.3 Transaction RSDANLCON - connection to NLS storage
With the Transaction RSDANLCON you create the connection to the NLS storage on top of the DB
connection.
Connection info: Name of the class: CL_RSDA_SYB_CONNECTION
Destination: N/A
Conn. Parameter: DBCON=SAPNLSDB
Note 1876142 - BW NLS IQ: SQL error 0 in DB connection ...
3.2.4 Monitor the NLS Connection
With the Report RSDA_SYB_PARTITION_MONITOR you can monitor the NLS connection at this time.
https://service.sap.com/sap/support/notes/1876142
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 43
Double-click on the row you want to analyze
For Monitoring Details you can also check the Log from the used Background Process via SM50
If you want to establish a SSL connection, please refer to the following Note:
Note 1820202 - SYB: Set up SSL encryption for secondary SAP connections
https://service.sap.com/sap/support/notes/1820202
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 44
4. Using the SAP-NLS Solution
Now that the solution is installed and configured, you can go to the Administrator Workbench and start to
distribute your data to the IQ based storage.
For Details on How to Create Data Archiving Requests consult the SAP help portal
http://help.sap.com/saphelp_nw73ehp1/helpdata/en/4c/75184b167821d1e10000000a42189c/conten
t.htm?frameset=/en/4c/75184b167821d1e10000000a42189c/frameset.htm
See also the Blog of Rainer Schlachter (Senior Developer, SAP AG) with additional Details.
SAP BW 730: What's New in the SAP BW Near-Line Storage Solution
The Overview of the SAP-NLS Solution on the SCN - http://scn.sap.com/docs/DOC-39944
http://help.sap.com/saphelp_nw73ehp1/helpdata/en/4c/75184b167821d1e10000000a42189c/content.htm?frameset=/en/4c/75184b167821d1e10000000a42189c/frameset.htmhttp://help.sap.com/saphelp_nw73ehp1/helpdata/en/4c/75184b167821d1e10000000a42189c/content.htm?frameset=/en/4c/75184b167821d1e10000000a42189c/frameset.htmhttp://scn.sap.com/people/rainer.schlachter/blog/2011/02/17/sap-bw-730-whats-new-in-the-sap-bw-near-line-storage-solutionhttp://scn.sap.com/docs/DOC-39944
SAP First Guidance SAP NetWeaver BW-NLS Implementation with Sybase IQ
September 2013 45
5. Appendix
5.1 Tipps for the IQ Administration
www.sap.com/contactsap
http://scn.sap.com/docs/DOC-7856