AEDAPTIVe AS2 for SAP NetWeaver Release 3.

0 Installation Guide
Target Audience

System Administrators Technology Consultants

Document version: 31 March 2010

 Copyright 20072010, AEDAPTIVe Solutions BV. 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 AEDAPTIVe. The information contained herein may be changed without prior notice. Some software products marketed by AEDAPTIVe and its distributors contain proprietary software components of other software vendors. Microsoft, Windows, Outlook, and PowerPoint are registered trademarks of Microsoft Corporation. IBM, DB2, DB2 Universal Database, OS/2, Parallel Sysplex, MVS/ESA, AIX, S/390, AS/400, OS/390, OS/400, iSeries, pSeries, xSeries, zSeries, System i, System i5, System p, System p5, System x, System z, System z9, z/OS, AFP, Intelligent Miner, WebSphere, Netfinity, Tivoli, Informix, i5/OS, POWER, POWER5, POWER5+, OpenPower and PowerPC are trademarks or registered trademarks of IBM Corporation. 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.

SAP, R/3, mySAP, mySAP.com, xApps, xApp, SAP NetWeaver, MaxDB, 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 in several other countries all over the world. 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 AEDAPTIVe Solutions and its affiliated companies (AEGroup) for informational purposes only, without representation or warranty of any kind, and AEDAPTIVe shall not be liable for errors or omissions with respect to the materials. The only warranties for AEDAPTIVe 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. Some components of this product are based on Java. Any code change in these components may cause unpredictable and severe malfunctions and is therefore expressively prohibited, as is any decompilation of these components. Any Java Source Code delivered with this product is only to be used by AEDAPTIVes Support Services and may not be modified or altered in any way. AEDAPTIVe AS2 incorporates code copyrighted by The Legion of the Bouncy Castle (www.bouncycastle.org). Used with permission.

AEDAPTIVe Solutions BV
P.O. Box 2011 4200 BA Gorinchem The Netherlands T +31/183/693738 www.aedaptive.com

About This Guide | AEDAPTIVe Solutions

Contents

About This Guide............................................................................................................................. 4 1.1 1.2 References .............................................................................................................................. 4 Prerequisites ........................................................................................................................... 4

Installing AEDAPTIVe AS2................................................................................................................ 6 2.1 2.2 2.3 2.4 2.5 2.6 2.7 2.8 Prepare the Installation .......................................................................................................... 6 Installing Unlimited Strength Security JCE Files ...................................................................... 7 Deploying the AS2 Software Component Archive .................................................................. 7 Installing the Adapter Metadata ............................................................................................. 8 Configure the Web Front End ................................................................................................. 9 Installing the License Key ...................................................................................................... 11 Schedule the AS2 Background Polling................................................................................... 11 Restarting all AEDAPTIVe Software Components ................................................................. 13

About This Guide | AEDAPTIVe Solutions

1 About This Guide

This guide describes how to install the AEDAPTIVe AS2 for SAP NetWeaver. This product consists of the following components: AS2 Adapter: to send and retrieve data via the AS2 protocol XML Recognizer: to be able to route XML files more easily then is possible with standard PI. Web Front End: to monitor the AS2 communication and to configure the software

This guide assumes that you have experience with SAP NetWeaver PI administration. We advice you to upgrade your NetWeaver installation to the latest service pack before you install the AEDAPTIVe software. This guide only describes a new installation of AEDAPTIVe AS2. For information about the upgrade of AEDAPTIVe AS2 from a NetWeaver XI/PI 3.0/7.0 installation, please contact AEDAPTIVe Support. Note: Some screens and the names of some options differ slightly between SAP NetWeaver PI 7.1 and SAP EHP 1 for SAP NetWeaver 7.1. This documentation follows SAP NetWeaver PI 7.1. AEDAPTIVe AS2 can be installed on and used with both versions of SAP NetWeaver PI.

1.1

References
The following is a list of additional resources that might be useful in relation to this guide: AEDAPTIVe AS2 Release Notes AEDAPTIVe AS2 Users Guide

These guides can be downloaded from the AEDAPTIVe web site at http://www.aedaptive.com.

1.2

Prerequisites
The following are prerequisites for the installation: The AEDAPTIVe AS2 software bundle or access to the customer part of the AEDAPTIVe web site A valid AEDAPTIVe license key Access to the System Landscape Directory Access to the SAP NetWeaver PI server with the following software: o o o o SAP Logon Java Support Package Manager NetWeaver Administrator Enterprise Services Builder

About This Guide | AEDAPTIVe Solutions

The AS Java and the database have been backed up. If your database is MaxDB, the overwrite mode for the log area has been set.

About This Guide | AEDAPTIVe Solutions

2 Installing AEDAPTIVe AS2

This chapter describes how to install AEDAPTIVe AS2 on SAP NetWeaver PI 7.1 or SAP EHP 1 for SAP NetWeaver 7.1. The installation procedure consists of the following steps: 1. 2. 3. 4. 5. 6. 7. 8. Prepare the installation Install the unlimited strength JCE files Deploy the software Install the adapter metadata Configure the web front end Install the license key Schedule the AS2 Background Polling job Restart all AEDAPTIVe software components

These steps are described in more detail below.

2.1

Prepare the Installation

Before you can install the AEDAPTIVe software, you need to download the latest version of the software and obtain a valid license key from AEDAPTIVe Solutions. Although it is possible to install all components without a license key, the software will not work until you activate the licensed components using a valid license key. License keys will be provided via email to your contact person. The latest software version can be downloaded from the AEDAPTIVe Solutions web site: 1. 2. Go to http://www.aedaptive.com Log on with the username and password you have received. If you do not have a username and password for the AEDAPTIVe web site, please contact your AEDAPTIVe Account Manager. Select Downloads in the Customer Area menu. Click on AEDAPTIVe Software for SAP NetWeaver PI 7.1. Click on AEDAPTIVe AS2 for SAP NetWeaver PI 7.1. Click on Latest Release. Select the software bundle and click Download to obtain the latest of the software. The AEDAPTIVe licence end-user agreement is displayed. You have to agree to this license before you can proceed. Once you have agreed to the end-user agreement, a zip file with the software will be downloaded to your computer. This zip file contains the following files: 6 Installing AEDAPTIVe AS2 | AEDAPTIVe Solutions

3. 4. 5. 6. 7.

8.

 9.

AEDAPTIVe AS2 software:.aedaptive.as2.sca AEDAPTIVe AS2 Adapter RA File: AedaptiveAS2RA.xml

AEDAPTIVe XML Recognizer Adapter RA File: AedaptiveXMLRecognizerRA.xml

After you have downloaded the software, you can download additional documentation from the web site.

2.2

Installing Unlimited Strength Security JCE Files

In order to use 128 bits encryption in your AS2 communication you need to install the "unlimited strength" version of JCE (Java Cryptography Extension) in your SAP PI environment. By default, only limited/full strength jurisdiction is enabled. This chapter describes how to install and enable unlimited strength security on your SAP XI installation. Note: Legal restrictions may be applicable for the use of these policy files. Ensure that the required authorization is given before performing these steps. To install the JCE files, refer to SAP Note 1240081, "Java Cryptography Extension Jurisdiction Policy" files. Install the JCE files provided by SUN Microsystems as the JCE files provided by SAP still limit the key length to some extent. Note: Please also read SAP Note 1133020, How to import a SAP JVM patch into an AS Java, which helps you to determine if you need to reinstall the unlimited strength JCE files after deploying a SAP JVM patch.

2.3

Deploying the AS2 Software Component Archive

Note: During the deployment of AEDAPTIVe AS2 the SAP WAS will be restarted. Before you start make sure that you have fulfilled the JSPM prerequisites. See for more information to the JSPM documentation: http://help.sap.com/saphelp_nw04s/helpdata/en/10/017842b3b1173be10000000a155106/frameset .htm To install the software, proceed as follows: 1. 2. 3. Start Java Support Package Manager (JSPM). Log on to the NetWeaver system with an administrative J2EE user. A message in JSPM will report the inbox directory. Copy the file com.aedaptive.as2.sca to this directory. Select the option New Software Component and click Next. The second step of the deployment wizard appears. AedaptiveAS2 is available in the list of deployable objects.

4.

Installing AEDAPTIVe AS2 | AEDAPTIVe Solutions

5. 6.

Click Next. After a short while the next step of the wizard appears. Validate that the status is OK. Click Start. The software will now be deployed. Please be patient as this can take a considerable amount of time. When the software is deployed, the last step of the wizard appears. You can now close JSPM.

7. 8.

2.4

Installing the Adapter Metadata

Note: You should only perform these actions on your development system. To transport the adapter metadata to other systems, you should use the standard SAP transport tools just as with other PI Repository objects. Perform the following steps to install the adapter metadata: 1. Go to the System Landscape Directory: http://<server>:<port>/sld 2. 3. 4. 5. Click on the link Products. Click New. Select Create a new product and version and click Next. Provide the following information and click Next: 6. 7. Product: AEDAPTIVE Vendor: aedaptive.com Version: 1.0

Type after Unit Name AEDAPTIVE and click Next. Now you are asked to create a new software component version. Provide the following information and click Finish: Name: AEDAPTIVE Version: 1.0 Production Status: released

The new software component version is now created. Note: If you want you can create a product and/or software component with another name and version number. 8. Now we have to import the new Software Component Version into the Repository. Start Enterprise Services Builder using the Process Integration profile. Choose Object New. The window Create Software Component appears. 8 Installing AEDAPTIVe AS2 | AEDAPTIVe Solutions

9.

10. Select Import from SDL and click Display. 11. A list of software component versions appears. Choose the Software Component Version you have created and click Import. 12. Select after Original Language the option English and click Save. 13. In the left pane, right click on the Software Component Version and choose Open Namespace Definitions. 14. Choose Namespace Definition Display/Edit in the menu or click on the Switch between Display and Edit Modes button. 15. Under Namespaces type the namespace http://aedaptive.com/xi and click on the Save button. Note: If you want you can create a product with another name and version number. However you have to specify the namespace exactly as indicated otherwise the software will not work. 16. Active the change in the Change List. 17. Right click in the namespace in the software component version and select New. 18. Select Adapter Objects Adapter Metadata. 19. Type AS2 after Name and click Create. 20. Choose Adapter Metadata Import XML description. 21. Select the file AedaptiveAS2RA.xml that was part of the software bundle and click Open. 22. Save your changes by clicking on the Save button. Note: If NetWeaver is not using English as its default language, you will get warnings about the language tags when you save the adapter metadata. These warnings can be safely ignored. 23. Repeat steps 17 22 with the file AedaptiveXMLRecognizerRA.xml. Use XMLRecognizer as the name of the adapter metadata. 24. Activate the changes in the Change List. 25. You have now successfully imported the adapter metadata. Close Enterprise Services Builder.

2.5

Configure the Web Front End

Before you can use the Web Front End you need to authorize users. To do this you need to create roles and assign users to these roles. These steps will be described in detail below. Proceed as follows: 1. 2. Log on to NetWeaver Administrator. Click on Identity Management.

Installing AEDAPTIVe AS2 | AEDAPTIVe Solutions

3.

After Search Criteria select Role and click Create Role.

4.

After Unique Name type Z_AEDAPTIVE_AS2_MONITOR and specify a description for this role, e.g. Allows monitoring of AS2 messages. This role is used to access the AS2 message monitoring. Click on the tab Assigned Actions. Specify Z_AEDAPTIVE_AS2* in the Get input box and click Go. A list of actions appears. Select the action Z_AEDAPTIVE_AS2_MONITOR and click Add.

5. 6. 7.

8. 9.

Click Save. Repeat the previous steps and create the role Z_AEDAPTIVE_AS2_CONFIG with assigned action Z_AEDAPTIVE_AS2_CONFIG. This role is used to access the AS2 configuration settings. Type after description Allows configuration of the AEDAPTIVE AS2 Adapter.

10. Select the newly create role Z_AEDAPTIVE_AS2_MONITOR in the list. You can use the search functionality to limit the displayed roles in the list.

10

Installing AEDAPTIVe AS2 | AEDAPTIVe Solutions

11. Click Modify. 12. Click on Assigned Users or Assigned Groups and add one or more users and/or groups to this role. 13. Click Save. 14. Repeat the previous steps for the role Z_AEDAPTIVE_AS2_CONFIG. 15. You can now close NetWeaver Administrator. Note: If you want, you can always update the user assignments for these roles later.

2.6

Installing the License Key

To activate the installed adapters and modules you need to add the following file to your adapter installation: license.xml

These files have been sent to you via email. If you have not received these files, please contact your AEDAPTIVe Account Manager. To activate the software, proceed as follows: 1. Copy the two license files in the following directory of your XI installation: /usr/sap/<SID>/<ID>/j2ee/cluster/apps/aedaptive.com 2. If you run NetWeaver PI in a cluster, also install the license files in the other servers of the cluster.

Note: The name and location of the licence files are very critical. Do not rename these files as this can lead to license issues with the software.

2.7

Schedule the AS2 Background Polling

The AS2 background poller checks timeouts of sent messages: 1. Log on to NetWeaver Administrator. The scheduled job will run using this same account, so use an account which credentials wont change by accident! Go to Operation Management Jobs. Click Java Scheduler.

2. 3.

4.

Click Tasks.

11

Installing AEDAPTIVe AS2 | AEDAPTIVe Solutions

5. 6. 7.

Click Add. The job scheduler appears. Select the job AS2Job and click Next. Specify a task name, AS2Job is default. Click Next.

8. 9.

Set Properties: not applicable. Click Next. Specify the End Date and how often you want this task to run, e.g. each 5 minutes. Click Add.

10. Click Finish.

12

Installing AEDAPTIVe AS2 | AEDAPTIVe Solutions

2.8

Restarting all AEDAPTIVe Software Components

Perform the following steps to restart all AEDAPTIVe software components: 1. 2. 3. Start NetWeaver Administrator. Log on to the NetWeaver PI system with a user with NWA Administrator rights. Click on the option Systems under Operation Management.

4. 5. 6.

Click on the option Start and Stop. Click on J2EE Applications in the right menu. A list of deployed applications appears. Type in the filter under Name com.aedaptive to limit the list to AEDAPTIVe software components. Press Enter.

Which components are available in the list depends on the AEDAPTIVe software components you have installed. 7. One by one select the AEDAPTIVe software components. If you select one of the components, in the bottom pane details about the selected application appear. For all AEDAPTIVe components on your system (or at least the components mentioned in the AS2 Release Notes), click Stop -> On All Instances.

8.

13

Installing AEDAPTIVe AS2 | AEDAPTIVe Solutions

9.

Check that all applications are stopped by refreshing the application list.

10. Start all AEDAPTIVe components: one by one select the components and click Start -> On All Instances. 11. Verify that all applications have been started, by refreshing the application list.

12. You can now close NetWeaver Administrator and start using AEDAPTIVe AS2. Note: If one or all application fails to start, please recheck the names and location of the license files. Most installation issues are due to an incorrectly placed or named license files. 13. Check the version numbers of each component: http://<PI-server>:<port>/aedaptiveAS2 and click Version.

14

Installing AEDAPTIVe AS2 | AEDAPTIVe Solutions

AEDAPTIVe Solutions B.V. P.O. Box 2011 4200 BA GORINCHEM The Netherlands

(T) +31-183-693738 (F) +31-183-693747 (I) www.aedaptive.com

AEDAPTIVe Solutions B.V. is a private limited company of the AEgroup and is registered at the Chamber of Commerce with number 11065386.

15

Installing AEDAPTIVe AS2 | AEDAPTIVe Solutions