SAP Business One Integration Framework B 1 if

SAP Business One Integration Framework (B 1 if) Training Solution Architects Team March 2011 Installation INTE RNA L

B 1 if Training: Installation The following session is designed to show you how to install and configure B 1 if. When you end this training you should be able to: Install B 1 if. Configure B 1 if. © 2011 SAP AG. All rights reserved. 2

Agenda Package details Prerequisites Installation process Configuration Tools & Documentation © 2011 SAP AG.

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” © 2011 SAP AG. All rights reserved. 5

Components SAP Business One Server DI API SAP Business One Integration Framework SAP Business One DI Proxy SAP Business One Event Sender Sbo- common Company 1 . . . Company n SAP Business One Event Sender B 1 i. P Database System © 2011 SAP AG. All rights reserved. 6

Installation prerequisites SAP Business One 8. 81 DI API installed. 1 GB free disk space. Collation settings in SQL Server properties Dictionary order case-insensitive, for use with 1252 Character set, Accent Sensitive (SQL_Latin 1_General_CP 1_CI_AS). See SAP Business One Administrator. Guide_SQL. pdf in System. Setup installation documentation folder. Enable TCP/IP port for the SQL instance of the B 1 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 Administrator. Guide_SQL. pdf document inside the installation package/Documentation/System. Setup folder. © 2011 SAP AG. All rights reserved. 8

Installation – Component selection (1/7) Select the Integration Component from the SAP Business One

Installation – Operating System (2/7) Select your operating system: 32 -Bit or 64 -Bit

Installation – B 1 if admin user (3/7) Enter a password for the B

Installation – Database Type (4/7) Select your B 1 Server SQL Server version: ©

Installation – Database Server (5/7) Enter the B 1 Server name and TCP/IP port (default value 1433, see prerequisites) Database name is B 1 if. 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 © 2011 SAP AG. All rights reserved. 13

Installation – SAP Business One Server (6/7) Enter the information of your SAP Business One server: B 1 if stores SAP Business One DBs information to enable working with dashboards in SAP Business One. All existing databases are automaticaly registered by B 1 i. C ready to be used with dashboards (all new created databases will also be automatically registered by B 1 i. C). © 2011 SAP AG. All rights reserved. 14

Installation – Packages setup (7/7) Select the B 1 i. C out of the

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 Event. Sender 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 Administrator. Guide_SQL. pdf document inside the installation package/Documentation/System. Setup folder. © 2011 SAP AG. All rights reserved. 16

Upgrade B 1 i. C from the SAP Business One Upgrade Wizard: © 2011

B 1 i user Licensing Check the following licenses for B 1 i user have been automatically assigned: B 1 i. INDIRECT_MSS Notes: No other license required for B 1 i user. Ensure you are giving the right password, administrator must setup B 1 i user password from B 1 application (no need to log on to B 1 to change initial password for that user afterwards). B 1 i user should not be used by any formal B 1 user. Recommendation: Set the same B 1 i 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 B 1 i. C framework per each DB. © 2011 SAP AG. All rights reserved. 19

Configure properties B 1 if Server: Xcellerator properties …SAP Business One integrationB 1 i. ServertomcatwebappsB 1 i. Xcelleratorxcellerator. cfg n Change parameter xcl. webdav to 'full‘ to be able to directly open the files inside B 1 if server via XML editors. n Change parameter xcl. http. local. Only to ‘false’ to enable remote access Note: This is only required, if you want to run the B 1 i. C UI (“Integration Framework”) from another machine different to the server; as this could compromise security default value is “true”. n Change parameter xcl. http. session. Timeout to avoid login window popup (default 10 minutes) © 2011 SAP AG. All rights reserved. 20

Config Dev Environment – Vendor Mode Path: Maintenance/Config Dev Environment 1 2 3 1 Enter Mode = Vendor 2 Enter your Development Prefix 3 Enter your Development Long Description 4 Click Save 4 As a partner, development should be done with Vendor mode. © 2011 SAP AG. All rights reserved. 21

Config Dev Environment – Customer Mode Path: Maintenance/Config Dev Environment 1 2 3 1 Enter Mode = Customer 2 Enter your Development Prefix 3 Enter your Development Long Description 4 Click Save 4 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). © 2011 SAP AG. All rights reserved. 22

Excurse: B 1 if and B 1 i. SN 8. 8 SAP Business One Server DI API B 1 i. SN Server B 18. 8 Integration Component - run installer (set up) B 1 i. SN 8. 8 - Content - import archive Content SAP Business One Integration Framework B 1 i. SN 8. 8 - SIM - deploy i. App - import archive Subsidiary Integration i. App common Company 1 SAP Business One DI Proxy . . . Company n SAP Business One Event Sender B 1 i. SN 8. 8 - Technology - run installer (set up) SAP Business One Integration Server B 1 i. P Database System n B 1 if and B 1 i. SN 8. 8 requires mandatory an installation on separate servers n The local B 1 i. P Event Dispatcher will take over the task for dispatching the according events to the assigned processes © 2011 SAP AG. All rights reserved. 23

Excurse: B 1 if and B 1 i. SN 8. 8 Event. Subscriber configuration (new B 1 8. 81 PL 04 (B 1 if 1. 5. 0)) Path: Maintenance/Config B 1 Event Subscriber To maintain the Event Sender properties of each one of the remotes B 1 i servers To maintain the list of remote B 1 i servers connecting to the same B 1 server © 2011 SAP AG. All rights reserved. 24

Excurse: B 1 if and B 1 i. SN 8. 8 Event. Subscriber configuration (new B 1 8. 81 PL 04 (B 1 if 1. 5. 0)) Path: Maintenance/Config B 1 Event Subscriber/[Create] 1 12 B 1 i. SNServer 2 © 2011 SAP AG. All rights reserved. 2 3 4 5 6 7 8 9 10 11 1 Click Create 2 Enter the server host of the remote B 1 i (IP address or server name) 3 Enter the server port of the remote B 1 i 4 Select the protocol used to connect to the remote B 1 i (http or https) 5 If you need a proxy to connect to the remote B 1 i enter the proxy host 6 Enter the port number of the proxy host if needed 7 Select the authentication mode used by the remote B 1 i 8/9 Enter the user name and password to logon to the remote B 1 i (default B 1 iadmin) 10/11 Enter the path and password of the SSL Trust. Store (only needed for https protocol) 12 Click Save 25

Excurse: B 1 if and B 1 i. SN 8. 8 Event. Subscriber configuration (new B 1 8. 81 PL 04 (B 1 if 1. 5. 0)) Path: Maintenance/Config B 1 Event Subscriber/[Subscriber] 2 1 Select a remote B 1 i node 2 Click Subscriber 3 Click Add Condition 4 Enter Sys. Id to which send B 1 events If specified only the B 1 events from the specified Sys. Id (local B 1 i identifier) will be sent to the target URI (* = all Sys. Ids) 5 B 1 object identifier, separated by comas 6 If specified only B 1 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 B 1 i. SNServer 2 1 3 4 © 2011 SAP AG. All rights reserved. 5 6 7 26

Excurse: B 1 if and B 1 i. SN 8. 8 Event. Subscriber configuration (before B 1 8. 81 PL 04 (B 1 if 1. 5. 0)) More information can be found at the B 1 i. SN 8. 8 Administrator_Guide_EN. pdf. Refer to the Event Subscriber schema at Biz. Store path © 2011 SAP AG. All rights reserved. /com. sap. b 1 i. system. eventdispatcher. api/xsd/Event. Subscriber. xsd 27

Tools Add the following URLs of B 1 if 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/B 1 i. Xcellerator/exec/dummy/com. sap. b 1 ip. system. cc/bfd/Admin. Console. bfd? !defdoc=/com. sap. b 1 i. vplatform. ide/ui/v. IDE. xml) SAP B 1 i. P Control Center From the Integration Framework -> Control Center top menu (http: //localhost: 8080/B 1 i. Xcellerator/exec/dummy/com. sap. b 1 ip. system. cc/bfd/Admin. Console. bfd? !defdoc=. . /xml/Control Center. xml) Log-On Information for these tools: User name: B 1 iadmin Password: Your B 1 iadmin’s password © 2011 SAP AG. All rights reserved. 29

Documentation Path: Help Detailed technical documentation about the Integration framework for SAP Business One.

Useful Links and documents Administrator. Guide_SAP. pdf B 1 installation package -> Documentation -> System. Setup folder. Main B 1 i general page https: //service. sap. com/smb/sbo/b 1 i Interesting blog on B 1 i www. sap-b 1 i. com B 1 Innovations https: //service. sap. com/smb/sbo/innovations Integration Technology forum in SDN http: //forums. sdn. sap. com/forum. jspa? forum. ID=161 © 2011 SAP AG. All rights reserved. 32

SAP Business One Integration Framework (B 1 if) © 2011 SAP AG. All rights

Thank You! For more information visit B 1 SDN page at http: //www. sdn. sap. com/irj/sdn/businessone

© 2011 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 Power. Point are registered trademarks of Microsoft Corporation. IBM, DB 2 Universal Database, System i 5, System p 5, System x, System z 10, System z 9, z 10, z 9, i. Series, p. Series, x. Series, z. Series, e. Server, z/VM, z/OS, i 5/OS, S/390, OS/400, AS/400, S/390 Parallel Enterprise Server, Power. VM, Power Architecture, POWER 6+, POWER 6, POWER 5+, POWER 5, POWER, Open. Power, Power. PC, Batch. Pipes, Blade. Center, System Storage, GPFS, HACMP, RETAIN, DB 2 Connect, RACF, Redbooks, OS/2, Parallel Sysplex, MVS/ESA, AIX, Intelligent Miner, Web. Sphere, 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, Post. Script, 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, Meta. Frame, Win. Frame, Video. Frame, and Multi. Win are trademarks or registered trademarks of Citrix Systems, Inc. HTML, XHTML and W 3 C are trademarks or registered trademarks of W 3 C®, World Wide Web Consortium, Massachusetts Institute of Technology. Java is a registered trademark of Sun Microsystems, Inc. Java. Script is a registered trademark of Sun Microsystems, Inc. , used under license for technology invented and implemented by Netscape. SAP, R/3, SAP Net. Weaver, Duet, Partner. Edge, By. Design, SAP Business. Objects Explorer, Stream. Work, 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, Business. Objects, 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, i. Anywhere, 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. 35