SAP Data Services Document Version: 4.2 Support Package 8 (14.2.8.0) 2017-01-18 PUBLIC
Content 1 Introduction.... 3 1.1 Documentation set for SAP Data Services....3 2 Deployment environment requirements.... 6 3 Runtime requirements....7 3.1 Option 1: Using Linux X Window console.... 7 3.2 Option 2: Remote X Window....7 3.3 Create an SAP HANA user account for the Data Services Repository....8 4 Installation....9 4.1 Graphical User Interface (GUI) mode installation....9 4.2 Command line mode installation....14 4.3 Validating the installation....15 4.4 Uninstall....15 2 P U B L I C Content
1 Introduction The SAP Data Services rapid deployment package is a customized, pre-deployed package for SAP HANA-specific configurations. It contains the following deployed software versions: SAP BusinessObjects Information platform services (IPS) 4.2 SP2, using bundled SQL Anywhere for the IPS repository. SAP Data Services 4.2 SP8 using SAP HANA or bundled SQL Anywhere for the Data Services repository. 1.1 Documentation set for SAP Data Services Become familiar with all the pieces of documentation that relate to your SAP Data Services product. The latest Data Services documentation can be found on the SAP Help Portal. Table 1: Document What this document provides Adapter SDK Guide Information about installing, configuring, and running the Data Services Adapter SDK. Administrator Guide Configuration Guide for CTS + Customer Issues Fixed Information about administrative tasks such as monitoring, lifecycle management, security, and so on. System landscape information and detailed steps for CTS+ configuration. Information about customer issues fixed in this release. Note In some releases, this information is displayed in the Release Notes. Designer Guide Documentation Map Installation Guide for UNIX Installation Guide for Windows Integrator Guide Management Console Guide Master Guide Information about how to use Data Services Designer. Information about available Data Services books, languages, and locations. Information about and procedures for installing Data Services in a UNIX environment. Information about and procedures for installing Data Services in a Windows environment. Information for third-party developers to access Data Services functionality using web services and APIs. Information about how to use Data Services Administrator and Data Services Metadata Reports. Information about the application, its components and scenarios for planning and designing your system landscape. Information about SAP Information Steward is also provided in this guide. Introduction P U BL IC 3
Document Performance Optimization Guide Reference Guide Release Notes Sizing Guide Technical Manuals What this document provides Information about how to improve the performance of Data Services. Detailed reference material for Data Services Designer. Important information you need before installing and deploying this version of Data Services. Guidelines and recommendations on hardware requirements and software considerations for your implementation. A compiled, searchable, master PDF of core Data Services books: Administrator Guide Configuration Guide for CTS+ Designer Guide Reference Guide Management Console Guide Performance Optimization Guide Integrator Guide Supplement for Adapters Supplement for Google BigQuery Supplement for J.D. Edwards Supplement for Oracle Applications Supplement for PeopleSoft Supplement for SAP Supplement for Siebel Workbench Guide Text Data Processing Extraction Customization Guide Text Data Processing Language Reference Guide Tutorial Upgrade Guide What's New Workbench Guide Information about building dictionaries and extraction rules to create your own extraction patterns to use with Text Data Processing transforms. Information about the linguistic analysis and extraction processing features that the Text Data Processing component provides, as well as a reference section for each language supported. A step-by-step introduction to using Data Services. Information to help you upgrade from previous releases of Data Services and release-specific product behavior changes from earlier versions of Data Services to the latest release. Highlights of new key features in this SAP Data Services release. This document is not updated for support package or patch releases. Provides users with information about how to use the Workbench to migrate data and database schema information between different database systems. In addition, you may need to refer to several Supplemental Guides. Table 2: Document Supplement for Adapters Supplement for Google BigQuery Supplement for J.D. Edwards Supplement for Oracle Applications What this document provides Information about how to install, configure, and use Data Services adapters. Information about interfaces between Data Services and Google BigQuery. Information about interfaces between Data Services and J.D. Edwards World and J.D. Edwards OneWorld. Information about the interface between Data Services and Oracle Applications. 4 P U B L I C Introduction
Document Supplement for PeopleSoft Supplement for SAP Supplement for Siebel What this document provides Information about interfaces between Data Services and PeopleSoft. Information about interfaces between Data Services, SAP Applications, and SAP Net Weaver BW. Information about the interface between Data Services and Siebel. We also include these manuals for information about SAP BusinessObjects Information platform services. Table 3: Document Information platform services Administrator Guide Information platform services Installation Guide for UNIX Information platform services Installation Guide for Windows What this document provides Information for administrators who are responsible for configuring, managing, and maintaining an Information platform services installation. Installation procedures for SAP BusinessObjects Information platform services on a UNIX environment. Installation procedures for SAP BusinessObjects Information platform services on a Windows environment. Introduction P U BL IC 5
2 Deployment environment requirements Use the following information to plan for your deployment. Data Services Server: SUSE Linux Enterprise Server (For the supported version, see the Product Availability Matrix (PAM) at https://apps.support.sap.com/sap/support/pam.) SAP HANA ODBC driver which is compatible with the supported HANA Server. Data Services Supported SAP HANA Server version (See SAP Note1600140 ) on the same or separate machine. Minimum hard ware requirements: 60 GB disk space 4 CPU 16 GB RAM The following ports must be unused on the system. You can change the ports after installing. Table 4: Port numbers Used for 7400, 7410 CMS,SIA 18005, 18080, 18443 Tomcat 2638 SQL Anywhere 3500 Data Services Job server 4011, 4012 Data Services View Data Services (VDS) 4013, 4014 Data Services Meta Data Services (MDS) 6 P U B L I C Deployment environment requirements
3 Runtime requirements If the target system box has the X11 Window system installed, there are two options to allow you to start the GUI installer mode. 3.1 Option 1: Using Linux X Window console Before launching the ezdeploy GUI: 1. Run the xlogo command to determine whether you have permission to connect to the X-server. You may need a root account to grant permissions. If so, run the xhost + command as a root user. 2. On the Linux box, configure the DISPLAY environment variable to redirect the X Window display to your Windows machine. For example, export DISPLAY=<windows IP address>:0.0 3.2 Option 2: Remote X Window Use the remote X Server application to output the Linux GUI to a remote Windows desktop. The following is an example, including the steps to configure Xming. 1. Download xming from http://sourceforge.net/projects/xming/files/latest/download. 2. Configure the xming shortcut to add -ac in target field. See below. 3. Run the xlogo command to determine whether you have permission to connect to the X-server. You may need a root account to grant permissions. If so, run the xhost + command as a root user. Runtime requirements P U BL IC 7
4. On the Linux box, configure the DISPLAY environment variable to redirect the X Window display to your Windows machine. For example, export DISPLAY=<windows IP address>:0.0 3.3 Create an SAP HANA user account for the Data Services Repository 1. Log in to SAP HANA Studio wiht an administrator account. 2. 1. Navigate to Catalog Authorization User, right click on User, and select New User. Keep in mind the following: A user named dsuser must be on the system and be a member of the dsuser group. dsuser may not be a member of any other user group. Both Information platform services and dsuser will reside in /build Information platform services and Data Services can only be installed in /build/dshana The home folder for dsuser must be /build/dsuser Example commands to create group and user: Create group with root account: groupadd dsuser Create user with root account: useradd dsuser -d/build/dsuser -G -g dsuser -m Change password for user: passwd dsuser 8 P U B L I C Runtime requirements
4 Installation To begin the installation: 1. Log in to the system with a dsuser account. 2. Launch sh ezdeploy.sh When you launch ezdeploy.sh, it will detect the availability of X Window. If X Window is present, the installer will launch in GUI mode. The installation will go through the Graphical User Interface (GUI) mode, if an X Window system is installed and using a local console or remote X Windows server, it will launch X Window GUI on Linux console or Windows desktop. If X Window is not present, the installer will launch in command-line interactive mode. See Option 2: Remote X Window [page 7] for more information about configuring X Window. Note The installation log file can be found at /build/dsuser/ezdeploy.log. 4.1 Graphical User Interface (GUI) mode installation Follow the GUI wizard to complete the installation. Installation P U BL IC 9
10 P U B L I C Installation
Installation P U BL IC 11
12 P U B L I C Installation
Installation P U BL IC 13
4.2 Command line mode installation You will need to provide a CMS password, a Data Services license key, and SAP HANA connection information, as shown in the following screen. 14 P U B L I C Installation
4.3 Validating the installation After the installation is finished, you can validate whether Data Services is deployed successfully to your machine. Example The following is an example of a successful deployment on a Linux SuSE machine (PALL00520173a). Check the following locations to verify the deployment: Install location: /build/dshana Verify that this directory was created and that it is populated. Central Management Console: http://palloo520173a:18080/boe/cmc Verify that the CMC opens after you log in, and that Data Services appears on the home page of the CMC. Data Services Management Console: http://pall00520173a:18080/dataservices Verify that the Management Console opens after you log in. 4.4 Uninstall If the Rapid Deployment installation already exists on your machine, you must uninstall before re-installing. All configurations will be uninstalled as well. If X-Window is enabled, it will use the GUI mode. Otherwise, it will use the command line interactive mode Installation P U BL IC 15
Launch sh ezdeploy.sh. If there was an existing Rapid Deployment installation, it will select uninstall by default. 16 P U B L I C Installation
Important Disclaimers and Legal Information Coding Samples 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 to 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, unless damages were caused by SAP intentionally or by SAP's gross negligence. Accessibility The information contained in the SAP documentation represents SAP's current view of accessibility criteria as of the date of publication; it is in no way intended to be a binding guideline on how to ensure accessibility of software products. SAP in particular disclaims any liability in relation to this document. This disclaimer, however, does not apply in cases of willful misconduct or gross negligence of SAP. Furthermore, this document does not result in any direct or indirect contractual obligations of SAP. Gender-Neutral Language As far as possible, SAP documentation is gender neutral. Depending on the context, the reader is addressed directly with "you", or a gender-neutral noun (such as "sales person" or "working days") is used. If when referring to members of both sexes, however, the third-person singular cannot be avoided or a gender-neutral noun does not exist, SAP reserves the right to use the masculine form of the noun and pronoun. This is to ensure that the documentation remains comprehensible. Internet Hyperlinks The SAP documentation may contain hyperlinks to the Internet. These hyperlinks are intended to serve as a hint about where to find related information. SAP does not warrant the availability and correctness of this related information or the ability of this information to serve a particular purpose. SAP shall not be liable for any damages caused by the use of related information unless damages have been caused by SAP's gross negligence or willful misconduct. All links are categorized for transparency (see: http://help.sap.com/disclaimer). Important Disclaimers and Legal Information P U BL IC 17
go.sap.com/registration/ contact.html 2016 SAP SE 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 of SAP SE or an SAP affiliate company. The information contained herein may be changed without prior notice. Some software products marketed by SAP SE and its distributors contain proprietary software components of other software vendors. National product specifications may vary. These materials are provided by SAP SE or an SAP affiliate company for informational purposes only, without representation or warranty of any kind, and SAP or its affiliated companies shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP or SAP affiliate company products and services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty. SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP SE (or an SAP affiliate company) in Germany and other countries. All other product and service names mentioned are the trademarks of their respective companies. Please see http://www.sap.com/corporate-en/legal/copyright/ index.epx for additional trademark information and notices.