This article is a step by step guide on how to install standalone SAP BODS Batch Job Server, Client Components, Web based Administrative Console and how to configure the same.

SAP BusinessObjects Data Services Setup Guide

Follow the instructions below on how to setup SAP BusinessObjects Data Services:

  • After having the licensed version of SAP BODS XI, Click the installation icon "setup.exe" to launch installer.

    BODS Setup

  • Click Next
  • Check the option "I accept the License Agreement" and Click the Next button.

    BODS License Agreement

  • Click on the Next button and provide the license information as provided by SAP.

    BODS License User Information

  • Full Name: XYZ.
  • Organisation: XYZ CORP.
  • Product Key: SAP Provided License Information.
  • Click Next button to continue.
  • Change the software installation directory to D:\Business Objects\BusinessObjects Data Services\
    You can install in any local directory of your choice and also on SAN drive.

    BODS Installation Directory

  • Click the Next button.
  • Select the features to install.

    BODS Components

    By default the server, client and web components are selected.
    Real time services i.e. Message Client Components are not available in this license copy.

  • Click the Next button to continue.

    BODS Local Repository Setup

  • Select the option Use an existing database server.
  • Click the Next button to continue.
  • Provide the pre configured database connection information. (MSSQL Server in this case)

    BODS Local Repository Connection Information

  • Database Type: Microsoft SQL Server
  • Database Server Name: EDWDEVETL
  • Database Name: DEVETLREPO
  • User name: DEVETLREPO
  • Password:

  • Click on the button Get Version to check whether the service can connect to database.

    BODS Local Repository Connection Check

  • Click the Ok button.
  • Next check the Create option and click the Next button to continue.
  • This will create local metadata repository of SAP BODS.
  • Click the Next button to configure the Job Server.

    BODS Job Server Configuration

  • Check the option - Configure a new Job Server
  • Job Server name: JS_DEVETLREPO
  • Job Server port: 3500
  • Next click on the Advanced button, to change Cache Directory for this job server.

    BODS Job Server Cache Directory

  • Change the Cache folder as D:\Business Objects\CacheDir
  • Leave the ports as default. Click the OK button.
  • Click the Next button to continue with the Service Login Information.

    BODS Service Login Information

  • Check the option Use system account and click the Next button to continue.

    Three BODS services namely BOE120Tomcat, BusinessObjectsAddressServer and DI_JOBSERVICE will be created under this system account. Click Next to Continue.

    BODS Access Server for Real Time Jobs

  • Next check the option Skip Access Server Configuration and click the Next button to continue. Since we are not using Real Time Data Services we skip this configuration step.
  • Click Next to install the web application server.

    BODS Web Application Server

  • Check the option Install Tomcat application server and click the Next button to continue.

    BODS WAS Tomcat Configuration

  • Leave the ports as default and click the Next button to continue installation.

    This tomcat web application server will host the Data Services web based management console.

  • Click Next to finalize the installation. The list of programs and services to be installed are displayed.

    BODS Install Finalisation

    BODS Install Finalisation

  • Click the Next button to start the SAP BODS installation.

    After successful installation of SAP Business Objects Data Services reboot to reflect configuration changes.

    BODS Install Success

  • Click Finish to exit installation.
  • Next Restart the System to configure BODS installation.

    BODS After Install Restart

  • Click Yes.

    After machine restart do the initial validation to check the SAP BODS Services and Programs installed. Click Start then All Programs, next check the SAP BODS Installed programs.

    BODS Programs

    In this part of the article, we will see how to change the default Log file directory of SAP BODS, Create Local, Central (Secured version control for multi-user environment) and Profiler (Data profile) repositories, Configure Job Server, Configuring DS Management Console, Add/Remove license information and Configuring SAP BODS Metadata Integrator with SAP BOXI.

BODS Directory Structure

BODS automatically creates an environment variable, called LINK_DIR which points to the root folder where BODS is installed. In our case, this root folder is:

LINK_DIR="D:\Business Objects\BusinessObjects Data Services"

For the sake of future conveniences and logical grouping, we may also create the following directory structure for SAP BODS.

Custom Directory Structure for BODS

Cache: "D:\Business Objects\CacheDir"
Log: "D:\Business Objects\LogDir"
Scripts: "D:\Business Objects\ParamDir"
Target Files: "D:\Business Objects\TgtFiles"
Source Files: "D:\Business Objects\SrcFiles"

Separating the directories in the above fashion, makes it easy for us to quickly access them later.

We need to create the folders in windows and use them for the purpose defined above. For example to point the source or target file to proper directory either enter the directory path in the Root directory option of the File Format or you can also use Substitution Parameters for each environment.

Changing default location of BODS Log Directory

For BODS Log files, the default log directory is :

D:\Business Objects\BusinessObjects Data Services\log 

But you may change the default log directory location to some other folder, eg. the below folder for quicker access:

D:\Business Objects\LogDir 

In order to do this, Open the file DSConfig.txt in the location:

D:\Business Objects\BusinessObjects Data Services\bin\DSConfig.txt 

DSConfig

Modify the line

AL_JobServerLogDirectory1=

As below

AL_JobServerLogDirectory1=log
AL_JobServerLogReDir1=D:\Business Objects\LogDir

DSConfig

Next Restart the BODS Job Server or BODS Services and you are done.

Next we will see how to create SAP BODS LOCAL REPOSITORY.

Create SAP BODS Local Repository

Businessobjects Data Services(SAP BODS) solutions are built over 2 different types of meta-data repositories called central and local repository. While the local repositories can be used by the individual ETL developers to store the metadata pertaining to their ETL codes, the central repository is used to "check in" the individual work and maintain a single version of truth for the configuration items (e.g. ETL code). Without the necessity of installation of the additional modules, it supports the team work in the ETL projects. The central repository allows adding tested scripts and then import them to local repositories or check them out and open them in exclusion mode. Versioning is also fully supported.

In the next section we will see how can we create and configure a local repository. Go to SAP BODS Repository Manager and enter the following information to configure the Local Repository:

Repository type: Local
Database type: Oracle (or whatever database you are using)
Database connection name: ORCL
User name: DEVETLREPO_L1
Password: (specify password here)

Local Repository Connection Test

Click on Get Version button, first to check it is able to connect to database. Next Click on Create button to create the metadata tables.

Local Repository Creation

Local Repository was successfully created.

Next we will see how to create SAP BODS SECURED CENTRAL REPOSITORY.

How to Create SAP BODS Secured Central Repository

As discussed in the previous page, Businessobjects Data Services (SAP BODS) solutions are built based on a central repository which is independent from the local repositories of the ETL developers. The central repository, among other things, supports the team work in the ETL projects. Versioning is also supported. Here is how to configure the central repository.

Go to SAP BODS Repository Manager and enter the following information to configure the metadata of the Central Repository:

Repository type: Central
Check Enable Security
Database type: Oracle (or whatever database you are using)
Database server name: EDWDEVETL
Database connection name: ORCL
User name: DEVETLREPO_CENTRAL
Password: (specify password here)

Central Repository Connection Test

Click on Get Version button, first to check it is able to connect to database. Next Click on Create button to create the metadata tables.

Central Repository Security Key

Central Repository Creation

The above message shows that the Central Repository is successfully created.

Purpose of SAP BODS Central Repository

Central repository is used for the sole purpose of version control check-in and check-out functionality ideal for multi-user development environment. You cannot run the jobs or you cannot configure a job server to point to a central repository.

Next we will see how to create SAP BODS PROFILER REPOSITORY.

How to create SAP BODS Profiler Repository

A profiler repository is a special repository that contains the profiling information for the objects. Among other things, this repository stores the column level details including cardinality, max, min and Null values etc. A job server needs to be associated with the profiler repository. Next we will see how to configure a profiler repository. Go to SAP BODS Repository Manager and enter the following information to configure the metadata of the Profiler Repository:

Repository type: Central
Check Enable Security
Database type: Oracle
Database server name: EDWDEVETL
Database connection name: ORCL
User name: DEVETLREPO_PROFILER
Password: (your password here)

Profiler Repository Connection Test

Click on Get Version button, first to check it is able to connect to database. Next Click on Create button to create the metadata tables.

Profiler Repository Creation

Profiler Repository was successfully created.

Note:- Profile repository is used for the sole purpose of performing column level profiling of the DW tables. You must configure or associate a Job Server with the Profiler Repository.

Next we will learn how to CONFIGURE JOB SERVER USING DS SERVER MANAGER for the Profiler repository.

How to Configure Job Server using DS Server Manager

You need to configure a Job server before you are able to execute data services ETL jobs. Job server needs to be configured on some local repository that you have already created. Here we will see how may we configure a BODS job server. Go to SAP BODS Server Manager.

Data Services Server Manager

Click the button Edit Job Server Config.

Job Server Configuration Editor

Click Add and enter the Name of the Job Server and associate it with the local repository.

Job Server name: JS_DEVETLREPO_PROFILER
Job Server port: 3501

Next click the Add button to associate the repository to the Job Server.

Database type: Oracle
Database connection name: ORCL
Username: DEVETLREPO_PROFILER
Password: 

Check the option Default repository.

Click Apply.

Job Server Properties

Next Click OK.

Job Server Added Successfully

Next Click OK.

Job Server Restart

Next click Restart Button to restart BODS Services.

Next we will learn how to CONFIGURE SAP BODS MANAGEMENT CONSOLE.

How to Configure SAP BODS Management Console

Click on the Data Services Management Console. Login as admin/admin.

Management Console Login

You will be greeted with the below screen once you login.

Management Console Administrator

Next Click on Administrator to Register the Repositories. Following screen will appear. You may click on the image below to enlarge the same.

Management Console Repositories

On the left hand pane Click on Management list item and then Click on Repositories.

Next Click the Add button to register a repository in management console. Enter the repository credentials.

Repository name: DEVETLREPO
Database type: Oracle
Machine name: localhost
Database port: 1521
Service name/SID: ORCL
User name: DEVETLREPO
Password:

Click Test.

Management Console Add Repository

Click Apply.

Management Console Local Repository

Next register the Profiler Repository as above mentioned steps.

Management Console Add Profiler Repository

Management Console Profiler Repository

Similiarly add the Central Repository.

Management Console Add Central Repository

Management Console Central Repository

Next we will learn how to ADD CENTRAL REPOSITORY USERS AND GROUP in BODS

How to add Central Repository Users and Group in BODS

Go to Administrator, Central Repositories, DEVETLREPO_CENTRAL. Click on Users and Groups.

Management Console Central Repositories

Click Add.

Enter Group Name as Grp_Central_Repo.

Central Repository Group Information

Next Click Apply.

Central Repository Group

Next Click on the Users tab.

Central Repository Users

Click Add and then Enter the new user credentials.

  
User name: DEVETLREPO_CENTRAL
Enter Password and confirm password.
Display name: DEVETLREPO_CENTRAL
Default Group: Grp_Central_Repo
Status: Active
Member of: Grp_Central_Repo

Central Repository User Information

Click Apply.

Central Repository User

Next we will learn how to ADD PROFILER REPOSITORY USER

Go to Management, Users and Click the add button.

Profiler Repository User

Next enter the Repository user credentials:

  
User name: DEVETLREPO_PROFILER
Enter Password and confirm password.
Display name: DEVETLREPO_PROFILER
Role: Profiler Administrator
Status: Active
Profiler Repository: DEVETLREPO_PROFILER

Profiler Repository User

Now you will be able to connect to the Profiler Repository using this User.

Profiler Repository User Created Successfully

BODS DESIGNER

Login to the Local Repository we created earliar:

BODS Designer Login

  
Database type: Oracle
Database connection name: ORCL
User name: DEVETLREPO
Password:                 

Click OK, to login to local repository.

BODS Designer

Next Check the JOB SERVER STATUS.

Look at the bottom right hand corner for job server symbol. On pointing the mouse it will show Job server JS_DEVETLREPO is running.

Designer Job Server running

Next CONNECT TO PROFILER SERVER.

Look at the bottom right hand corner for Profiler Server symbol. On pointing the mouse it will show Profiler Server is not running. Double click the Profiler server, or go to Tools and click Profiler Server Login... to enter the login credentials.

Profiler Server Login

Host: localhost
Port: 28080
User name: DEVETLREPO_PROFILER
Password:
Click on Test button.

Profiler Server Running

Next Click on Connect button.

Profiler Server Connected

Now On pointing the mouse to the Profiler Server will show the server running and the user connected.

Profiler Server Connected

Next CONNECT TO CENTRAL REPOSITORY. Go to Tools and click on Central Repositories...

Central Repository Connections

Next click Add button.

Enter the Login Credentials as follows:

  
Repository Name: DEVETLREPO_CENTRAL
Check Secure
Database type: Oracle
Database connection name: ORCL
Next click the button Read Security Key
Select the default key in the location, which was generated during Central Repository Creation.
User name: DEVETLREPO_CENTRAL
Password:

Central Repository Editor

Note: You can create separate Logins to central repository for individual developers from Management Console and provide the same to the developers who will connect to Check-In and Check-Out Objects.

Next click OK.

Secure Central Repository Configured

Click the Activate button and enter the password again to activate central repository with this current local repository.

Secure Central Repository Activate

Pointing the mouse over the secure central repository will show the details.

Secure Central Repository Details

Next CONNECT TO Management Console from Designer.

Click on the Data Services Management Console icon shown above to connect from the designer GUI. Else go to Tools, Data Services Management Console..

Data Services Management Console

Login to Management Console as 
User Name: admin
Password:
Click Login.

Data Services Management Console Login

Next use SAP BODS LICENSE MANAGER to Add new license information using the Add button or to remove existing old license information using Remove button.

Regarding installation and configuration of SAP BODS METADATA INTEGRATOR we will discuss in another topic as this particular component need to be installed in BOXI server machine. So both BOXI and BODS can reside in the same machine or in different machine. But the metadata integrator component should be installed and configured at the BOXI server or precisely where the BOXI CMS resides so that we can take the full advantage of lineage and impact analysis of the target report fields with their counterpart source columns.


Have a question on this subject?

Ask questions to our expert community members and clear your doubts. Asking question or engaging in technical discussion is both easy and rewarding.

Are you on Twitter?

Start following us. This way we will always keep you updated with what's happening in Data Analytics community. We won't spam you. Promise.

  • Data Services Metadata Query Part 1

    Data Services provides full access to the repository metadata tables and views for metadata analysis. To access this metadata either we can use SQL SELECT statements or use the metadata reporting from Management Console.

  • Data Services Scenario Questions Part 3

    In this tutorial we will discuss some scenario based questions and their solutions using SAP Data Services. This article is meant mainly for Data Services beginners.

  • XML file generation using SAP Data Services

    This article will demonstrate how to generate XML target files using SAP Data Services. Here our objective is to generate XML file with employee and department information.

  • SAP Data Services Analytic Functions

    In this tutorial we will learn how to implement Cumulative Sum in SAP Data Services (BODS). Since there is no available in-built Analytic Functions in SAP Data Services, we will achieve the end result by exploiting some in-built Data Services...

  • Data Services Scripting Language

    We can use the Data Services Scripting Language to write scripts and custom functions to address complex logical expressions.

  • DENSE RANK in Data Services

    In this article, we will learn how to implement DENSE RANK operation in SAP Data Services.

  • Getting Started SAP BODS

    This article is a step by step guide to learn the basic of SAP BODS. Starting from the Basic we will cover the essential topics like SCD implementation, Fact loading, CDC Mechanisms, Persistent Cache, Substitution Parameters, Variables and...

  • How to use Data Services Reverse Pivot Transformation

    In this article, we will learn how to use SAP Data Services Reverse Pivot Transform. The Reverse Pivot transformation combines data from several rows into one row by creating new columns. For each unique value in a pivot axis column and each...

  • Top 50 SAP Business Objects Data Services (BODS) Interview Questions with Answers

    Learn the answers of some critical questions commonly asked during SAP BO Data Services interview.

  • RANK in Data Services

    In this article, we will learn how to implement RANK operation in SAP Data Services.