SAP BusinessObjects Predictive Analysis Installation and Configuration Guide SAP BusinessObjects Predictive Analysis 1.

2012-04-25

Copyright

2012 SAP AG. All rights reserved.SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAP BusinessObjects Explorer, StreamWork, SAP HANA 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. Crossgate, m@gic EDDY, B2B 360, B2B 360 Services are registered trademarks of Crossgate AG in Germany and other countries. Crossgate 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.These materials are subject to change without notice. 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 the materials. The only warranties for SAP Group 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. 2012-04-25

Contents

Chapter 1

About This Guide.....................................................................................................................5 Who Should Read This Guide..................................................................................................5 What This Guide Contains.......................................................................................................5 Overview of SAP BusinessObjects Predictive Analysis.........................................................7

1.1 1.2
Chapter 2

Chapter 3

Installation...............................................................................................................................9 System Requirements..............................................................................................................9 Prerequisites for installing SAP BusinessObjects Predictive Analysis.......................................9 Installing SAP BusinessObjects Predictive Analysis...............................................................10 Uninstalling SAP BusinessObjects Predictive Analysis...........................................................12 Configuration........................................................................................................................13 Configuring the R Environment...............................................................................................13 Configuring Predictive Analysis to read data from different databases....................................13 Configuring Trace Logs..........................................................................................................14 Security Guidelines...............................................................................................................17 Security Aspects....................................................................................................................17 More Information...................................................................................................................19

3.1 3.2 3.3 3.4

Chapter 4

4.1 4.2 4.3

Chapter 5

5.1
Appendix A

2012-04-25

Contents

2012-04-25

About This Guide

About This Guide

1.1 Who Should Read This Guide

This guide is designed for the following user audiences, to help them to set up and manage the SAP BusinessObjects Predictive Analysis deployment: System administrators - who install and configure the SAP BusinessObjects Predictive Analysis solution. Professional data analysts and information designers who want to install, configure, and operate SAP BusinessObjects Predictive Analysis.

1.2 What This Guide Contains

This guide provides: Instructions on how to install SAP BusinessObjects Predictive Analysis Instructions on how to configure the R environment Information on security aspects that you must consider when operating SAP BusinessObjects Predictive Analysis

2012-04-25

About This Guide

2012-04-25

Overview of SAP BusinessObjects Predictive Analysis

Overview of SAP BusinessObjects Predictive Analysis

SAP BusinessObjects Predictive Analysis is a statistical analysis and data mining solution that enables you to build predictive models to discover hidden insights and relationships in your data, from which you can make predictions about future events. This application can access data from various data sources, such as flat files, relational databases, in-memory databases, and SAP BusinessObjects universes, and can operate on different volumes of data, from a small matrix of data in a CSV file to a very large dataset in SAP HANA. With SAP BusinessObjects Predictive Analysis, you can perform various analyses on the data, including time series forecasting, outlier detection, trend analysis, classification analysis, segmentation analysis, and affinity analysis. This application enables you to analyze data using different visualization techniques, such as scatter plot matrices, parallel coordinates, cluster graphs, decision trees, and ad hoc graphs. SAP BusinessObjects Predictive Analysis offers a range of predictive analysis algorithms, supports the use of the R Open Source statistical analysis language, and offers in-memory data mining capabilities for handling large volume data analysis in an efficient manner.

2012-04-25

Overview of SAP BusinessObjects Predictive Analysis

2012-04-25

Installation

Installation

3.1 System Requirements

The SAP BusinessObjects Predictive Analysis solution has the following software requirements: Operating Systems: Microsoft Windows 7 (both 32-bit and 64-bit operating systems are supported) Java Runtime Environment (JRE) version 1.6.0 and above For a detailed list of supported environments and hardware requirements, refer the SAP Note 1676333.

3.2 Prerequisites for installing SAP BusinessObjects Predictive Analysis

Before installing SAP BusinessObjects Predictive Analysis, ensure that, You have installed Java Runtime Environment (JRE) version 1.6.0 or above If you have not installed JRE on your system, you can download the latest JRE 1.6.x installer from the following site: http://www.java.com/en/download/index.jsp You have set the following environment variables: 1. PATH environment variable should point to the Java executable binary (java.exe) in JRE. For example, if your java executables are available in the path C:\Program Files\Java\jre6\bin, then you must add this path to the beginning of the existing PATH environment variable value.
C:\Program Files\Java\jre6\bin;%SystemRoot%\system32;%SystemRoot%;%SystemRoot%\System32\Wbem

2. TEMP and TMP environment variables should point to a location to which there is no access restrictions. By default, these environment variables are pointed to %USERPROFILE%\AppDa ta\Local\Temp. However, you can change the TEMP and TMP location. After updating the environment variables, you need to restart your machine for the settings to take effect. You have administrative privileges on the system on which you want to install SAP BusinessObjects Predictive Analysis. If you want to use R algorithms in SAP BusinessObjects Predictive Analysis, you need to install the R 2.11.1 environment. To install and configure the R 2.11.1 environment, refer the How to Set up

2012-04-25

Installation

and Configure the R Environment on Windows 7 guide available on SCN at: http://scn.sap.com/docs/DOC-23271
Note: If you are installing SAP BusinessObjects Predictive Analysis 32-bit version, then ensure that you have installed the 32-bit R environment and 32-bit JRE. If you are installing SAP BusinessObjects Predictive Analysis 64-bit version, then ensure that you have installed the 64-bit R environment and 64-bit JRE.

3.3 Installing SAP BusinessObjects Predictive Analysis

To install SAP BusinessObjects Predictive Analysis, perform the following steps: 1. Run the setup.exe file. The "User Account Control" dialog appears with a warning message. 2. Choose Yes in the confirmation prompt. The "SAP BusinessObjects Predictive Analysis 1.0 Prerequisite Check" screen appears with the list of software prerequisites. Ensure that you have installed all the required softwares. 3. Choose Next. 4. Choose Next. 5. If you agree the terms, select I accept the terms in the license agreement and choose Next. 6. Enter the user name and organization details and choose Next. 7. Choose Next to install the application to the default folder or specify the destination installation folder and choose Next. Note: When you change the default installation path, ensure that you have sufficient privileges to run and execute the application from the specified path. 8. Select one of the repository configuration options: Install new version of Sybase SQL Anywhere: Select this option, if you have not installed any database and you would like to install SQL Anywhere as the default database for SAP BusinessObjects Predictive Analysis. Use existing DB: Select this option, if you have already installed SQL Anywhere or MySQL database and you would like to configure the existing database. If you select this option, continue with step 11. 9. If you select to install the Sybase SQL Anywhere database, choose Next to configure the repository. 10. On the "Repository Configuration" screen, perform the following steps to configure the new SQL Anywhere database: a. Enter a name for the database. b. Enter a port number for the database. Do not use the default port number (2639) of the SQL Anywhere database server. Ensure that you provide a unique port number which is not used by any other services.

10

2012-04-25

Installation

For example, 4545. c. Enter the database service name. For example, predictiveanalysis. d. Enter a user name. e. Enter a password. f. Choose Next. After configuring the SQL Anywhere database, continue with step 12. 11. If you select to use the existing database, select the database to configure from the drop-down list, and choose Next. To configure the SQL Anywhere database, perform the following steps on the "SQL Anywhere Configuration" screen: a. Enter the name or IP address of the machine on which the database server is installed. b. Enter the database server port. c. Enter a user name. d. Enter a password. e. Enter the database service name. f. Choose Next. To configure the MySQL database, perform the following steps on the "MySQL Configuration" screen: a. Enter the name or IP address of the machine on which the database server is installed . b. Enter the database server port number. Do not use the default port number (3306) of the MySQL database server. Ensure that you provide a unique port number which is not used by any other services. c. d. e. f. Enter the MySQL server user name. Enter the MySQL server password. Enter a schema name. Specify the location of the JDBC driver for MySQL. For example, mysql-connector-java-x.x.x-bin.jar.

g. Test the database connection by choosing Test Connection. h. Choose Next. To configure SAP HANA, perform the following steps on the "SAP HANA Configuration" screen: a. b. c. d. e. Enter the IP address of the SAP HANA server. Enter the SAP HANA server port number. Enter the SAP HANA server user name. Enter the SAP HANA server password. Enter a schema name.

12. On the "Algorithms Configuration" screen, select the algorithms you want to configure, and choose Next. SAP Algorithms - SAP Algorithms such as Linear Regression, Logarithmic Regression, Geometric Regression, Exponential Regression, Triple Exponential Smoothing, Inter Quartile Range, and Nearest Neighbour Outlier are installed by default. R Algorithms - Select this option, if you want to configure statistical algorithms from the R library.

13. If you select R, on the "R Algorithms Configuration" screen, perform the following steps:

11

2012-04-25

Installation

a. Select the database connection type. b. Specify the R installation folder which contains R binaries. For example, C:\Program Files\R\R-2.11.x-x64\ c. Choose Next. 14. Check the install summary and begin the installation by choosing Install. After the installation is complete, we recommend you to restart your system.

3.4 Uninstalling SAP BusinessObjects Predictive Analysis

1. Go to Start > Control Panel > Programs. 2. Select Uninstall a program. 3. Right-click SAP BusinessObjects Predictive Analysis and click Uninstall. 4. Choose Yes in the confirmation prompt. Note: Uninstalling SAP BusinessObjects Predictive Analysis does not remove the application installation folder. You must manually delete the installation folder after the uninstallation is complete.

12

2012-04-25

Configuration

Configuration

4.1 Configuring the R Environment

To use R algorithms in your analysis, you must install the R 2.11.1 environment and configure it for use with the SAP BusinessObjects Predictive Analysis application. For information on how to install and configure R and its packages, see the How to Set up and Configure the R Environment on Windows 7 guide available on SCN at: http://scn.sap.com/docs/DOC-23271 Following are the steps to configure the R environment: If the R environment is already installed before installing SAP BusinessObjects Predictive Analysis: While installing SAP BusinessObjects Predictive Analysis, 1. On the "Algorithms Configuration" screen, select R Algorithms. 2. On the "R Algorithms Configuration" screen, specify the database connection type, R environment installation folder, choose Next, and complete the installation. If you have installed the R environment after installing SAP BusinessObjects Predictive Analysis or if you have already configured R but want to change its settings: Perform the following steps to configure the R environment: 1. 2. 3. 4. Run the SAP BusinessObjects Predictive Analysis installer again. Select the Modify option and choose Next. On the "Algorithms Configuration" screen, select R Algorithms. On the "R Algorithms Configuration" screen, specify the database connection type and the R environment installation folder. 5. Choose Next. After configuring the R environment, we recommend you to restart the system for the R settings to take effect.

4.2 Configuring Predictive Analysis to read data from different databases

13

2012-04-25

Configuration

When creating an analysis, to use the JDBC Reader or JDBC Writer component to connect to Oracle, MySQL, MS SQL Server, SQL Anywhere, MaxDB, SAP HANA, or DB2 database, you need to configure the SAP BusinessObjects Predictive Analysis application to use the corresponding JDBC driver. To configure Predictive Analysis to read data from different databases, perform the following steps: 1. Navigate to the <PA_INST_DIR>/plugins folder. 2. Open the corresponding database configuration file. For example, Oracle: Oracle_Config.xml MySQL: MySQL_Config.xml MS SQL Server: MSSQL_Config.xml DB2: DB2_Config.xml SAP HANA: NewDB_Config.xml MaxDB: MAXDB_Config.xml SQL Anywhere: SQLAnywhere_Config.xml Sybase IQ: SybaseIQ_Config.xml 3. Change the <DriverPath> to point to the correct JDBC driver location. For example, for Oracle database, change the driver path to,
<DriverPath><![CDATA[C:/ojdbc6.jar]]></DriverPath>

if the oracle JDBC driver is located at: C:/ojdbc6.jar

4.3 Configuring Trace Logs

You use this procedure to enable the SAP BusinessObjects Predictive Analysis application to record information about the execution of the application. This log information helps you identify issues when the application fails or encounters a problem. 1. Create a folder in any location for generating logs. Note: Ensure that you have "write" permission to the folder. For example, C:\logs. 2. Create the BO_Trace.ini file and add the following trace details to it.
active=false; severity='E'; importance=xs; size=1000000; keep_num=437; alert=true;

14

2012-04-25

Configuration

The table below lists the general parameters used for configuring server tracing.
Parameter Possible Values

Description

active

false, true

If set to true, trace messages that meet the threshold set in the importance parameter will be traced. If set to false, trace messages will not be traced based on their "importance" level. Default value is false. Specifies the threshold for tracing messages. All messages beyond the threshold will be traced. Default value is m (medium).

importance

'<<', '<=', '==', '>=', '>>', xs, s, m, l, xl Note: importance = xs or importance = << are the most verbose options available while importance = xl or importance = >> are the least.

alert

false, true

If set to true, trace messages that meet the threshold set in the severity parameter will be traced. If set to false, the trace messages will not be traced based on their "severity" level. Default value is true.

severity

' ', 'W', 'E', 'A', success, warning, error, asSpecifies the threshold severity over which sert massages can be traced. Default value is 'E'. Possible values are integers >=1000 Specifies the number of messages in a trace log file before a new one is created. Default value is 100000. Specifies the number of logs to keep.

size

keep_num Possible values are integers >=1000

15

2012-04-25

Configuration

Parameter Possible Values

Description

administrator

Strings or integers

Specifies an annotation to use in the output log file. For example, if

administrator = "hello"

this string is inserted into the log file. log_dir For example, C:\logs. Specifies the output log file directory. By default log files are stored in the Logging folder. Specifies if the log file should be closed after a trace is written to the log file. Default value is off.

alon, off ways_close

3. Save and close the BO_trace.ini file. 4. Place the BO_Trace.ini file under C:\logs. 5. Set up the following environment variables: BO_TRACE_LOGDIR = C:/logs BO_TRACE_CONFIGDIR = C:/logs BO_TRACE_CONFIGFILE = C:/logs/BO_Trace.ini 6. Restart the application. The application logs are generated in the specified location. For example, C:\logs.

16

2012-04-25

Security Guidelines

Security Guidelines

5.1 Security Aspects

Consider the following security guidelines when operating SAP BusinessObjects Predictive Analysis: To enable secure connection for accessing a database, refer to the security documentation of the respective database. SAP BusinessObjects Predictive Analysis 1.0 is a single user, standalone desktop application. Therefore, only the user who install the software can use it on the desktop. SAP BusinessObjects Predictive Analysis does not support data-level security such as authorization, authentication, and user management. Therefore, the authorization and confidentiality of the data used for analysis is the responsibility of the user who provided the data for analysis. The application only enables the user to perform analysis on the data and does not store any personal information. MDR and ESR database user requires Create, Drop, Insert, Delete, Select, and Update privileges for using the application. If you change the MDR or ESR database password after installing SAP BusinessObjects Predictive Analysis, you need to reconfigure the application through the installer using the Repair option. SAP BusinessObjects Predictive Analysis logs security events in the security log file. Information about database connection configuration details and security-related events, such as configuration changes or failure to access external systems such as databases and SAP BusinessObjects BI systems, is logged in the security file. The security log files are located at: <PA_INST_DIR>\Secu rityLogs\PASSecurity_<timestamp>.log

17

2012-04-25

Security Guidelines

18

2012-04-25

More Information

More Information

Information Resource

Location

SAP BusinessObjects product information

http://www.sap.com Navigate to http://help.sap.com/businessobjects and on the "SAP BusinessObjects Overview" side panel click All Products. You can access the most up-to-date documentation covering all SAP BusinessObjects products and their deployment at the SAP Help Portal. You can download PDF versions or installable HTML libraries. Certain guides are stored on the SAP Service Marketplace and are not available from the SAP Help Portal. These guides are listed on the Help Portal accompanied by a link to the SAP Service Marketplace. Customers with a maintenance agreement have an authorized user ID to access this site. To obtain an ID, contact your customer support representative. http://service.sap.com/bosap-support > Documentation Installation guides: https://service.sap.com/bosap-instguides Release notes: http://service.sap.com/releasenotes

SAP Help Portal

SAP Service Marketplace

The SAP Service Marketplace stores certain installation guides, upgrade and migration guides, deployment guides, release notes and Supported Platforms documents. Customers with a maintenance agreement have an authorized user ID to access this site. Contact your customer support representative to obtain an ID. If you are redirected to the SAP Service Marketplace from the SAP Help Portal, use the menu in the navigation pane on the left to locate the category containing the documentation you want to access. https://cw.sdn.sap.com/cw/community/docupedia

Docupedia

Docupedia provides additional documentation resources, a collaborative authoring environment, and an interactive feedback channel. https://boc.sdn.sap.com/

Developer resources https://www.sdn.sap.com/irj/sdn/businessobjects-sdklibrary

19

2012-04-25

More Information

Information Resource

Location

SAP BusinessObjects articles on the SAP Community Network

https://www.sdn.sap.com/irj/boc/businessobjects-articles These articles were formerly known as technical papers. https://service.sap.com/notes

Notes These notes were formerly known as Knowledge Base articles. Forums on the SAP Community Network https://www.sdn.sap.com/irj/scn/forums http://www.sap.com/services/education Training From traditional classroom learning to targeted e-learning seminars, we can offer a training package to suit your learning needs and preferred learning style. http://service.sap.com/bosap-support Online customer support The SAP Support Portal contains information about Customer Support programs and services. It also has links to a wide range of technical information and downloads. Customers with a maintenance agreement have an authorized user ID to access this site. To obtain an ID, contact your customer support representative. http://www.sap.com/services/bysubject/businessobjectsconsulting Consulting Consultants can accompany you from the initial analysis stage to the delivery of your deployment project. Expertise is available in topics such as relational and multidimensional databases, connectivity, database design tools, and customized embedding technology.

20

2012-04-25