2 B1if Installation

INTERNAL

SAP Business One Integration Framework (B1if) Training

Solution Architects TeamMarch 2011

Installation

© 2011 SAP AG. All rights reserved. 2

B1if Training: Installation

The following session is designed to show you how to install and configure B1if. When you end this training you should be able to:

Install B1if.

Configure B1if.


Package details

Agenda

Prerequisites

Installation process

Configuration

Tools & Documentation


Agenda

Package details

Prerequisites


Configuration



Software Package

Part of the SAP Business One Installation Wizard as of SAP Business One 8.81

Installed automatically as the framework for running the “Integration Component”


Components

..

.

Sbo- common

Company n

B1iP

Company 1

Database System

DI API

SAP Business One Server

SAP Business OneEvent Sender

SAP Business One DI Proxy

SAP Business One IntegrationFramework

SAP Business One Integration Framework


SAP Business One Event Sender


Package details

Agenda

Prerequisites


Configuration



Installation prerequisites

SAP Business One 8.81 DI API installed.

1GB free disk space.

Collation settings in SQL Server properties Dictionary order case-insensitive, for use with 1252 Character set, Accent Sensitive (SQL_Latin1_General_CP1_CI_AS).See SAP Business One AdministratorGuide_SQL.pdf in SystemSetup installation documentation folder.

Enable TCP/IP port for the SQL instance of the B1 server databases Default port number 1433.

Installation rights in the system.

Database administration user and password.

For more details on how to fulfill the prerequisites please check SAP Business One AdministratorGuide_SQL.pdf document inside the installation package/Documentation/SystemSetup folder.


Installation – Component selection (1/7)

Select the Integration Component from the SAP Business One Autorun executable:


Installation – Operating System (2/7)

Select your operating system: 32-Bit or 64-Bit and press Install:


Installation – B1if admin user (3/7)

Enter a password for the B1if admin user called B1iadmin:


Installation – Database Type (4/7)

Select your B1 Server SQL Server version:


Installation – Database Server (5/7)

Enter the B1 Server name and TCP/IP port (default value 1433, see prerequisites)

Database name is B1if. It not possible to change the name from the installation wizard, if required the name can be changed

from install.ini file before starting installation.

Database user name and password


Installation – SAP Business One Server (6/7)

Enter the information of your SAP Business One server:

B1if stores SAP Business One DBs information to enable working with dashboards in SAP Business One.

All existing databases are automaticaly registered by B1iC ready to be used with dashboards (all new created databases will also be automatically registered by B1iC).


Installation – Packages setup (7/7)

Select the B1iC out of the box packages you want to run in your system and enter their corresponding settings if needed:


Check Services

Check the following services are registered as Windows Services, they are started and startup type is automatic:

SAP Business One Integration Service

SAP Business One EventSender Service

SAP Business One DI Proxy Service and SAP Business One DI Proxy Service Monitor

For more details on any of the installation stpes please check SAP Business One AdministratorGuide_SQL.pdf document inside the installation package/Documentation/SystemSetup folder.


Upgrade

Upgrade B1iC from the SAP Business One Upgrade Wizard:


Package details

Agenda

Prerequisites


Configuration



B1i user Licensing

Check the following licenses for B1i user have been automatically assigned:

B1i

B1iINDIRECT_MSS

Notes:

No other license required for B1i user.

Ensure you are giving the right password, administrator must setup B1i user password from B1 application (no need to log on to B1 to change initial

password for that user afterwards).

B1i user should not be used by any formal B1 user.

Recommendation: Set the same B1i user password in all companies (same as given in the SAP Business One Server installation step (6/7), otherwise you will need to manually set the password in the B1iC framework per each DB.


Configure properties

B1if Server: Xcellerator properties

…\SAP Business One integration\B1iServer\tomcat\webapps\B1iXcellerator\xcellerator.cfg

Change parameter xcl.webdav to 'full‘ to be able to directly open the files inside B1if server via XML editors.

Change parameter xcl.http.localOnly to ‘false’ to enable remote access

Note: This is only required, if you want to run the B1iC UI (“Integration Framework”) from another machine different to the server; as this could compromise security default value is “true”.

Change parameter xcl.http.sessionTimeout to avoid login window popup (default 10 minutes)


Config Dev Environment – Vendor Mode

Path: Maintenance/Config Dev Environment

1 Enter Mode = Vendor

2 Enter your Development Prefix

3 Enter your Development Long Description

4 Click Save

As a partner, development should be done with Vendor mode.

4

12

3


Config Dev Environment – Customer Mode

1 Enter Mode = Customer

2 Enter your Development Prefix

3 Enter your Development Long Description

4 Click Save

Customer mode should be used for production system or customer’s own development.

Modification of SAP or partner scenarios is not allowed (only customer scenarios).

Path: Maintenance/Config Dev Environment

4

12

3


Excurse: B1if and B1iSN 8.8

..

.common

Company n

B1iP

Company 1

Database System

DI API

B1iP

Database System

SAP Business One Server B1iSN Server

B1iSN 8.8 - Technology- run installer (set up)

B1iSN 8.8 - SIM- deploy iApp- import archive

B1iSN 8.8 - Content- import archive

SAP Business One IntegrationServer

Subsidiary Integration iApp

Content

B1if and B1iSN 8.8 requires mandatory an installation on separate servers The local B1iP Event Dispatcher will take over the task for dispatching the according events to the assigned

processes

SAP Business OneEvent Sender


SAP Business One IntegrationFramework

B18.8 Integration Component- run installer (set up)


Excurse: B1if and B1iSN 8.8EventSubscriber configuration (new B1 8.81 PL04 (B1if 1.5.0))

Path: Maintenance/Config B1 Event Subscriber

To maintain the list of remote B1i servers connecting to the same B1 server

To maintain the Event Sender properties of each one of the remotes B1i servers



1 Click Create

2 Enter the server host of the remote B1i (IP address or server name)

3 Enter the server port of the remote B1i

4 Select the protocol used to connect to the remote B1i (http or https)

5 If you need a proxy to connect to the remote B1i enter the proxy host

6 Enter the port number of the proxy host if needed

7 Select the authentication mode used by the remote B1i

8/9 Enter the user name and password to logon to the remote B1i (default B1iadmin)

10/11 Enter the path and password of the SSL TrustStore (only needed for https protocol)

12 Click Save

Path: Maintenance/Config B1 Event Subscriber/[Create]

1

B1iSNServer2 2

34

56

89

7

10

11

12


Path: Maintenance/Config B1 Event Subscriber/[Subscriber]


1 Select a remote B1i node

2 Click Subscriber

3 Click Add Condition

4 Enter SysId to which send B1 eventsIf specified only the B1 events from the specified SysId (local B1i identifier) will be sent to the target URI (* = all SysIds)

5 B1 object identifier, separated by comas

6 If specified only B1 events with the specified event task are sent to the target URI (A (add), U (update), D(delete), C(cancel), L(close).

7 Click Save

1-7 Repeat the same steps per each condition needed

1

4 5 6

7

2

3

B1iSNServer2


Excurse: B1if and B1iSN 8.8EventSubscriber configuration (before B1 8.81 PL04 (B1if 1.5.0))

1. Choose Start -> All Programs -> Integration solution for SAP Business One -> Integration Framework for SAP Business One; choose Control Center.

2. Choose Maintenance and BizStore Download with the following path: /com.sap.b1i.system.eventdispatcher.directory/B1EventSubscriber.xml/B1EventSubscriber.xml(unified)

3. Save the Event Subscriber document in your disk.

4. Maintain the Event Subscriber document as follows: <B1EventSubscriberList xmlns="urn:com.sap.b1i.sim:entity" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:com.sap.b1i.sim:entity ../../com.sap.b1i.system.eventdispatcher.api/xsd/EventSubscriber.xsd”> <B1EventSubscriber SysId="0010000100" TargetURI="/0010000100.inbound/com.sap.b1i.datasync.ipo/P01/P01.ipo/EventConvertor"> <Condition LocalObjectType="22" Task="*"/> <Condition LocalObjectType="17" Task="A"/> </B1EventSubscriber> <RemoteB1i Protocol="http" TargetHost="pvgd50073424a" TargetPort="8080" ProxyHost="" ProxyPort="" Authentification="basic" User="B1iadmin" Password="B1iadmin" SSLTrustStorePath="" SSLTrustStorePassword=""> <B1EventSubscriber SysId="*" TargetURI="/ReceiveB1Events/com.sap.b1i.system.eventdispatcher/ipo/ReceiveB1Events.ipo/ReceiveB1Events"> <Condition LocalObjectType="*" Task="*"/> </B1EventSubscriber> </RemoteB1i> </B1EventSubscriberList>

5. Choose BizStore Upload, provide via Browse the path for the changed Event Subscriber file and the respective URI /com.sap.b1i.system.eventdispatcher.directory/B1EventSubscriber.xml/B1EventSubscriber.xml(unified) to overwrite the existing Event Subscriber document.

More information can be found at the B1iSN 8.8 Administrator_Guide_EN.pdf.

Refer to the Event Subscriber schema at BizStore path/com.sap.b1i.system.eventdispatcher.api/xsd/EventSubscriber.xsd


Package details

Agenda

Prerequisites


Configuration



Tools

Add the following URLs of B1if tools into your browser’s favorites

Integration Framework for SAP Business One

All Programs -> Integration Solution for SAP Business One -> Integration Framework(http://localhost:8080/B1iXcellerator/exec/dummy/com.sap.b1ip.system.cc/bfd/AdminConsole.bfd?!defdoc=/com.sap.b1i.vplatform.ide/ui/vIDE.xml)

SAP B1iP Control Center

From the Integration Framework -> Control Center top menu(http://localhost:8080/B1iXcellerator/exec/dummy/com.sap.b1ip.system.cc/bfd/AdminConsole.bfd?!defdoc=../xml/ControlCenter.xml)

Log-On Information for these tools:

User name: B1iadmin

Password: Your B1iadmin’s password

http://localhost:8080/B1iXcellerator/exec/dummy/com.sap.b1ip.system.cc/bfd/AdminConsole.bfd?!defdoc=/com.sap.b1i.vplatform.ide/ui/vIDE.xml






http://localhost:8080/B1iXcellerator/exec/dummy/com.sap.b1i.datasync.ui/bin/ControlCenter.htm





Documentation

Path: Help

Detailed technical documentation about the Integration framework for SAP Business One.


Documentation

Path: Help

Detailed technical documentation about the Integration framework for SAP Business One.


Useful Links and documents

AdministratorGuide_SAP.pdfB1 installation package -> Documentation -> SystemSetup folder.

Interesting blog on B1iwww.sap-b1i.com

B1 Innovations https://service.sap.com/smb/sbo/innovations

SDN B1if key topic pagehttp://www.sdn.sap.com/irj/sdn/businessone/xxx?

http://www.sap-b1i.com/

https://service.sap.com/smb/sbo/innovations

http://www.sdn.sap.com/irj/sdn/businessone/xxx

Thank You!

For more information visit B1 SDN page at http://www.sdn.sap.com/irj/sdn/businessone

http://www.sdn.sap.com/irj/sdn/businessone


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.

© 2011 SAP AG. All rights reserved

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, special, 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.

Documents

2 B1if Installation