AEDAPTIVe AS2 for SAP NetWeaver Release 3.

0 Update Guide
Target Audience

System Administrators Technology Consultants

Document version: 25 November 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

Updating AEDAPTIVe AS2 ............................................................................................................... 5 2.1 2.2 2.3 2.4 Prepare the Installation .......................................................................................................... 5 Deploying the AS2 Software Component Archive .................................................................. 5 Configure the AS2 job ............................................................................................................. 6 Restarting all AEDAPTIVe Software Components ................................................................... 7

About This Guide | AEDAPTIVe Solutions

1 About This Guide

This guide describes how to update the AEDAPTIVe AS2 package for SAP NetWeaver. This package 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 AS2 Job: This job checks if there are missing asynchronous MDN messages.

Each component does have its own version number, which can be displayed using the URL: http://<PI-server>:<port>/aedaptiveAS2 and click Version. The version number of each component in the AS2 packages is listed in the Release Notes.

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: AEDAPTIVe AS2 Release 3.0 is installed and you have a valid license. The AEDAPTIVe AS2 software bundle or access to the customer part of the AEDAPTIVe web site Access to the SAP NetWeaver PI server with the following software: o o o SAP Logon Java Support Package Manager NetWeaver Administrator

The AS Java and the database have been backed up.

About This Guide | AEDAPTIVe Solutions

2 Updating AEDAPTIVe AS2

This chapter describes how to update 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. Prepare the installation Deploy the software Configure the AS2 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: 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: 9. AEDAPTIVe AS2 software:.aedaptive.as2.sca

3. 4. 5. 6. 7.

8.

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

2.2

Deploying the AS2 Software Component Archive

Before you start make sure that you have fulfilled the JSPM prerequisites. See for more information to the JSPM documentation:

Updating AEDAPTIVe AS2 | AEDAPTIVe Solutions

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 Single Support Packages and Patches and click Next. The second step of the deployment wizard appears. AedaptiveAS2 is available in the list of deployable objects. 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.

4.

7. 8.

2.3

Configure the AS2 job

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. 5. 6.

Click Tasks. Click Add. The job scheduler appears. Select the job AS2Job and click Next.

Updating AEDAPTIVe AS2 | AEDAPTIVe Solutions

7.

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.

2.4

Restarting all AEDAPTIVe Software Components

Perform the following steps to restart all AEDAPTIVe software components: 1. 2. Start NetWeaver Administrator. Log on to the NetWeaver PI system with a user with NWA Administrator rights.

Updating AEDAPTIVe AS2 | AEDAPTIVe Solutions

3.

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.

9.

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

Updating AEDAPTIVe AS2 | AEDAPTIVe Solutions

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.

Updating 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.

10

Updating AEDAPTIVe AS2 | AEDAPTIVe Solutions