Professional Documents
Culture Documents
Release 3.0
Installation Guide
Target Audience
System Administrators
Technology Consultants
AEDAPTIVe Solutions BV
P.O. Box 2011
4200 BA Gorinchem
The Netherlands
T +31/183/693738
www.aedaptive.com
Contents
References .............................................................................................................................. 4
1.2
Prerequisites ........................................................................................................................... 4
2.2
2.3
2.4
2.5
2.6
2.7
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:
These guides can be downloaded from the AEDAPTIVe web site at http://www.aedaptive.com.
1.2
Prerequisites
The AEDAPTIVe AS2 software bundle or access to the customer part of the AEDAPTIVe web site
SAP Logon
NetWeaver Administrator
If your database is MaxDB, the overwrite mode for the log area has been set.
2.
3.
4.
5.
6.
7.
2.1
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.
Go to http://www.aedaptive.com
2.
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.
3.
4.
5.
6.
7.
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.
8.
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.
After you have downloaded the software, you can download additional documentation from the web
site.
2.2
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
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.
A message in JSPM will report the inbox directory. Copy the file com.aedaptive.as2.sca to this
directory.
4.
5.
Click Next. After a short while the next step of the wizard appears. Validate that the status is OK.
7
6.
Click Start. The software will now be deployed. Please be patient as this can take a considerable
amount of time.
7.
When the software is deployed, the last step of the wizard appears.
8.
2.4
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.
2.
3.
Click New.
4.
5.
Product: AEDAPTIVE
Vendor: aedaptive.com
Version: 1.0
6.
7.
Now you are asked to create a new software component version. Provide the following information
and click Finish:
Name: AEDAPTIVE
Version: 1.0
Now we have to import the new Software Component Version into the Repository. Start Enterprise
Services Builder using the Process Integration profile.
9.
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
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.
3.
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.
5.
6.
Specify Z_AEDAPTIVE_AS2* in the Get input box and click Go. A list of actions appears.
7.
8.
Click Save.
9.
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
2.6
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
2.
Log on to the NetWeaver PI system with a user with NWA Administrator rights.
3.
11
4.
5.
6.
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.
8.
For all AEDAPTIVe components on your system, click Stop -> On All Instances.
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
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
(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.
14