HP XML Accelerator for SAP NetWeaver Process Integration User Manual
HP XML Accelerator for SAP NetWeaver PI User Guide
Version 1.0
HP Part Number: AM313-9001A
Published: January 2010
Edition: 1
Copyright © 2010 Hewlett-Packard Development Company, L.P.
Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial
Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under
vendor's standard commercial license. The information contained herein is subject to change without notice. The only warranties for HP products
and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as
constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.
Warranty
To obtain a copy of the warranty for this product see the warranty information website:
http://h18004.www1.hp.com/products/servers/platforms/warranty/
Table of Contents
1 Installing the XML Accelerator.......................................................................................4
Introduction............................................................................................................................................4
What is being installed?..........................................................................................................................4
What is the SAP XML Accelerator?........................................................................................................4
Prerequisites...........................................................................................................................................5
Hardware...........................................................................................................................................5
Software.............................................................................................................................................5
System Installation Instructions.............................................................................................................6
HP XML Acceleration Software Installation...........................................................................................6
SAP NetWeaver PI Update ....................................................................................................................7
For more information.............................................................................................................................8
General information..........................................................................................................................8
2 XML Accelerator Administration...................................................................................9
Introduction............................................................................................................................................9
What form does the GUI take?...............................................................................................................9
What functionality does the GUI provide?............................................................................................9
3 Using the HP XML Converter for SAP NetWeaver PI...............................................10
Getting Started......................................................................................................................................10
Exporting SAP Mappings.....................................................................................................................10
Converting SAP Mappings...................................................................................................................11
Testing a Compiled Mapping File........................................................................................................13
Using an Accelerated Mapping............................................................................................................13
4 Using the HP XML Adapter for SAP NetWeaver PI..................................................15
Getting Started......................................................................................................................................15
Driver Tab.............................................................................................................................................15
System Mode...................................................................................................................................15
Loading and Unloading the Driver.................................................................................................16
The Driver Info section displays the following information about the XML adapter driver:........16
Device Tab.............................................................................................................................................16
Board Info Diagnostics....................................................................................................................17
Memory Diagnostics........................................................................................................................17
Temperature Diagnostics.................................................................................................................17
Performance Diagnostics.................................................................................................................17
Agent Diagnostics............................................................................................................................17
5 Support and other resources.......................................................................................18
Contacting HP.......................................................................................................................................18
Before you contact HP.....................................................................................................................18
HP contact information...................................................................................................................18
Subscription service.........................................................................................................................18
Documentation feedback.................................................................................................................18
Typographic conventions......................................................................................................................18
A System updates executed by HP installer..................................................................20
B Error guide....................................................................................................................21
Table of Contents 3
1 Installing the XML Accelerator
Introduction
What is this chapter for? Who should read it? What is being installed?
This document explains the prerequisites and how to install the XML Accelerator. This is an
advanced install guide for system administrators only. Casual users should consult their support
group before continuing.
What is being installed?
The SAP XML Accelerator GUI which allows the user access to the Converter and the Adapter
tools. The GUI is an XWindows application that is run on the same server that PI is installed on.
The GUI communicates with server components that expose the functionality and configuration
options of the XML Accelerator system.
What is the SAP XML Accelerator?
The SAP XML Accelerator is integrated software and special-purpose hardware that is used to
accelerate the mappings in SAP NetWeaver XI and PI systems, increasing overall performance.
The hardware component is an HP XML Accelerator PCIe card. The software components interface
between NetWeaver PI and the XML Accelerator hardware, allowing for transparent use of the
Accelerator in normal NetWeaver operation. Included in the software components are facilities
for converting graphic mappings to objects that use the Accelerator and tools controlling the
configuration and runtime performance of the accelerator. The mapping step that is accelerated
by the XML Accelerator can be seen in the NetWeaver PI 7.1 System overview below as ‘MM’
The card looks like the following:
4 Installing the XML Accelerator
Prerequisites
What is needed before the install can begin?
This chapter will detail the software and hardware that the GUI depends on and where to find
it.
Hardware
The XML Accelerator software stack and GUI depend on the installation of the XML Accelerator
board. This must be installed and correctly configured in the PI system before continuing.
NOTE: The converter component of the XML Accelerator GUI does not require the hardware
to be installed, the Adapter GUI does, however.
Software
XML Accelerator Software
The XML Accelerator GUI depends on the XML Accelerator software. To check if this is installed,
open a command line on your server and run the following command:
cpp_manager -h
If the command is not found, the required XML Accelerator software is not present, please consult
the User Manual that accompanied your XML Accelerator Board.
Java
The Java Virtual Machine version 1.5.0_12 or later is also required. Open a command line and
type the following:
java -version
If the command is not found or the version is found not to be 1.5.0_12 or later please download
and install the correct version from http://java.sun.com.
Prerequisites 5
System Installation Instructions
1. Install the server following the HP DL580 server installation instructions, see the DL580 User
Guide for more information.
NOTE: The server is factory configured with the following options:
• SUSE SLES10 is factory installed on the XML Accelerator. Any operating system
installation steps should be omitted.
• The XML Accelerator is factory configured with a default processor and memory
configuration.
• The XML Accelerator is factory configured with SAS disks, a Networking expansion
card, and fibre channel HBA to support SAN storage.
• The XML Accelerator is factory configured to accept up to a total of 16 SAS disks without
requiring the instillation of an additional disk cage or SAS HBA.
• The XML Accelerator is factory configured with redundant hot plug power supplies.
• The XML Accelerator is factory configured with the battery backed up SAS HBA write
cache
2. Connect and configure networking configurations per site requirements.
3. Install SAP NetWeaver PI per site requirements.
NOTE: The minimum supported release level is PI 7.1.
HP XML Acceleration Software Installation
The base version of the acceleration software comes pre-installed on the server. It can be found
on the system at /usr/local/Tarari/. Updated versions are available from the HP software
depot. Personalized download instructions will provided separately from this document.
NOTE: Installation must be done as user “root”.
1. Copy the installer binary file to any directory.
NOTE: An example directory would be /tmp, and example release filename would be
hpxmlacce_1.2.1.2.bin.
2. Stop the SAP application if it is running. The installation will fail and report an error if SAP
NetWeaver is running
3. Navigate to installer directory (e.g. /tmp).
4. Make sure the downloaded installation file is marked as executable by running 'chmod +x
hpxmlacce_1.2.1.2.bin'.
5. Run the installer hpxmlacce_1.2.1.2.bin.
6. Respond to the prompts as needed.
a. Installation Directory Prompt: Enter the desired directory. The recommended default
location is /usr/local/Tarari.
b. Kernel Source Directory Prompt: Update the directory if the default directory does not
match the current location.
c. Rename Previous Directory: Enter "Yes" if prompted to rename the existing installation
directory.
d. SAP JVM: Enter the current SAP JVM home if the default Java Directory does not match
the SAP JVM directory
6 Installing the XML Accelerator
NOTE: An example would be /sapmnt/<SID>/exe/jvm/linuxx86_64/
dapjvm_5.1.015/sapjvm_5.
e. SAP Instance: A list of SAP instances is displayed. Choose which SAP instance is to be
used by the HP XML Acceleration Software.
f. SAP Profile: A list of SAP profiles is displayed. Choose the profile for the SAP instance
that will be using the HP XML Acceleration Software.
7. Add the following to the JVM(s) classpath using the SAP config tool:
• /<Installation directory>/lib/tarari_xtr_load.jar:/<Installation
director>/lib/tarari_raxj.jar
NOTE: An example would be /usr/local/Tarari/lib/
tarari_xtr_load.jar:/usr/local/Tarari/lib/tarari_raxj.jar
8. Start SAP NetWeaver PI as normal.
9. Import the modified SAP system profile using transaction RZ10. (Utilities->Import profiles
-> Of active servers)
SAP NetWeaver PI Update
In order for NetWeaver PI to utilize the XML Accelerator, a link must be created between PI and
the XML acceleration libraries. The linkage is created by importing the XML acceleration jar file
into SAP Enterprise Service Builder. This operation must be performed for the initial installation
and all subsequent upgrades of the XML acceleration software.
1. Create a new Third-Party Software Component Version in the System Landscape Directory.
NOTE: The new Software Component Version details should reflect the name and version
of the XML Acceleration package being installed, for example:
product version: HPXML 1.2 of HP.com
unit: xmlacc
vendor hp.com
name: XTR
version: 1.2.1.2
2. Start the SAP Enterprise Service Builder.
3. Create a new Software Component Version by the "Import from SLD" method.
a. Select the newly created SoftwareComponent Version created in step 1 from the System
Landscape Directory.
b. Create a new Namespace within the Software Component Version, for example:
http://accel.hp.com/xmlacc.
4. Copy "/usr/local/Tarari/lib/tarari_xtr.jar" to a client machine.
5. Upload the tarari_xtr.jar file as an "Imported Archive" into the newly created
namespace.
6. Create a dependency from any Software Component Version that will use accelerated
mappings to the newly created XTR Software Component Version.
a. Open the target Software Component Version screen in the Enterprise Service Builder.
b. Switch to the “Details” tab.
c. Add the XTR Software Component Version as an “Underlying Software Component
Version”.
SAP NetWeaver PI Update 7
For more information
General information
HP XML Accelerator
http://www.hp.com/go/SAP/xmlaccelerator
SAP NetWeaver PI
http://www.sap.com/platform/netweaver/components/pi/index.epx
8 Installing the XML Accelerator
2 XML Accelerator Administration
Introduction
What is this section for, what is the SAP XML Accelerator GUI, what kind of GUI is it? What does the
GUI allow me to do?
This section is for users of the HP XML Accelerator For NetWeaver PI. It is a guide to the
administration functions and use of the browser for the Converter and Adapter components of
the system. .
What form does the GUI take?
The GUI is a web based interface that is hosted by the same server that PI is installed on. The
GUI communicates with server components that expose the functionality and configuration
options of the XML Accelerator system.
What functionality does the GUI provide?
The GUI provides access to the two main components of the system, the Converter and the
Adapter. The Converter allows the user to convert SAP graphical mappings to work with the
Adapter to use the XML Accelerator. The Adapter also has user features which enable control,
diagnostics and monitoring of the accelerator system.
The Convertor allows the user to compile and test the Message Mappings for the XML Accelerator.
The Adapter user interface features include a component for the driver and a component for the
physical XML card. The driver component allows the user to load, unload, inspect and configure
the device drivers that are currently operating the XML Accelerator card. The card or hardware
component allows the user to activate, deactivate, diagnose, inspect and configure the physical
card installed in the SAP server system.
Each of these component features will be expanded upon later in with detailed descriptions of
all the configuration options, actions and data views.
Introduction 9
Loading...