Sybase Adapter for SAP R/3 User manual
Installation Guide
Adapter for SAP R/3
Version 3.9
DOCUMENT ID: 36350-01-0390-01
LAST REVISED: September 2002
Copyright © 1999-2002 New Era of Networks, Inc. International copyright law prohibits illegal reproduction and distribution of this
document.
Software described in New Era of Networks, Inc. documents is furnished under a Software License Agreement and may be copied or
used only as expressly permitted under the terms of the license.
New Era of Networks, Convoy/DM, e-ADK, BizTracker, e-Biz Integrator, e-Biz 2000, EC-Gateway, ECMap, New Era of Networks
MedMerge, New Era of Networks MedPortal, New Era of Networks MedSecure, MicroScript Server, MicroScript Workstation, New Era
of Networks Rules, Formatter, and Messaging, New Era of Networks Web, New Era of Networks Access, New Era of Networks Portal
Server, New Era of Networks Process Server, OpenBroker, New Era of Networks Secure, New Era of Networks Adapter, New Era of
Networks HIPAA Accelerator, and Physician Access are trademarks, and CL/7, MicroScript and Transaction Distribution Manager,
TDM are registered trademarks of New Era of Networks, Inc. and its subsidiaries. Sybase and the SYBASE (logo) are registered
trademarks of Sybase, Inc. MQSeries is a registered trademark of International Business Machines Corporation.
All other product names are copyright and/or registered trademarks/tradenames of their respective owners.
Restricted Rights Legend
Use, duplication or disclosure by the Government is subject to restrictions set forth in subparagraph (c)(1)(ii) of DFARS 52.227-7013
for the DOD and as set forth in FAR 52.227-19(a)-(d) for civilian agencies.
New Era of Networks, Inc., 6550 Greenwood Plaza Blvd., Englewood, CO 80111
Sybase, Inc., One Sybase Drive, Dublin, CA 94568
Contents
Installation Guide iii
About This Book............................................................................................................................ v
CHAPTER 1 Migrating to Adapter for SAP R/3 Version 3.9.............................. 1
Process Overview ............................................................................ 1
Preparing for Upgrade...................................................................... 2
Upgrading from Version 3.0.3 to Version 3.9................................... 2
Upgrading from Version 3.8 to Version 3.9...................................... 3
Changes to Configuration Keys ....................................................... 3
Converting IDoc Formats ................................................................. 5
Example Log File..................................................................... 11
Adjusting for Customization..................................................... 11
Suggestions for Converting IDocs........................................... 11
Example Conversion Tool Configuration File.......................... 12
Converting BAPI Formats .............................................................. 14
Upgrading Rules ............................................................................ 15
CHAPTER 2 Installing Adapter for SAP R/3..................................................... 17
Preparation..................................................................................... 17
Integration Server Support ...................................................... 18
Transport Support ................................................................... 18
Supported Platforms and Compilers ....................................... 19
Installation Environment.......................................................... 20
Disk Space and Memory Requirements......................................... 23
Required Software ......................................................................... 23
Running Executables Before Installing the Adapter on Windows .. 24
Preparing the Installation Environment .......................................... 24
Previous versions.................................................................... 24
CIMRepository......................................................................... 25
Temporary Installation Directory ............................................. 26
Installing Adapter for SAP R/3 ....................................................... 26
Understanding Environment Variables........................................... 32
Contents
iv Adapter for SAP R/3
CHAPTER 3 Uninstalling Adapter for SAP R/3................................................. 33
Starting the Repository................................................................... 33
Uninstalling Adapter for SAP R/3 3.9............................................. 34
Uninstalling Shared Components................................................... 34
Index ............................................................................................................................................. 37
Installation Guide v
About This Book
Audience The primary user of this document is the system administrator who is
responsible for the installation and configuration of the server used for
New Era of Networks Adapter for SAP R/3 (Adapter for SAP R/3).
How to use this book This document describes how to install Adapter for SAP R/3. These
instructions provide information for both a new and an upgrade
installation. For a concurrent installation, contact technical support.
The guide is organized into the following chapters:
• “About This Book” provides documentation, technical support, and
product education information.
• Chapter 1, “Migrating to Adapter for SAP R/3 Version 3.9” provides
information to prepare for an upgrade installation.
• Chapter 2, “Installing Adapter for SAP R/3” provides steps to
prepare for and run an adapter installation.
• Chapter 3, “Uninstalling Adapter for SAP R/3” providesthe stepsfor
uninstalling the product from the server.
Related documents This section describes the available documentation for Adapter for SAP
R/3.
Cross-Platform Documentation The following documentation
comprises the Adapter for SAP R/3 documentation set:
•User’s Guide
•Feature Guide
•Installation Guide
Related Documentation The following open transport documents and
sample configuration files are referenced in this document set to supply
you with specific information that supports this product:
•File Driver Configuration Guide, release 2.6
•MQ Series Driver Configuration Guide, release 2.6
•MSMQ Driver Configuration Guide, release 2.6
vi Adapter for SAP R/3
•JMS Driver Configuration Guide, release 2.6.1
•Tibco Driver Configuration Guide, release 2.6.1
Other related documentation is available from New Era of Networks and
Sybase. Refer to documentation from each of these companies for more detail
about use of applications relevant to this product.
Other sources of
information Use the Sybase Technical Library CD and the Technical Library Product
Manuals web site to learn more about your product:
• The Technical Library CD contains product manuals and is included with
your software. The DynaText reader (included on the Technical Library
CD) allows you to access technical information about your product in an
easy-to-use format.
Refer to the Technical Library Installation Guide in your documentation
package for instructions on installing and starting the Technical Library.
• The Technical Library Product Manuals web site is an HTML version of
the Technical Library CD that you can access using a standard web
browser. In addition to product manuals, you will find links to
EBFs/Updates, Technical Documents, Case Management, Solved Cases,
newsgroups, and the Sybase Developer Network.
To access the Technical Library Product Manuals web site, go to Product
Manuals at http://www.sybase.com/support/manuals/.
Sybase EBFs and
software updates
❖Finding the latest information on EBFs and software updates
1 Point your web browser to the Sybase Support Page at
http://www.sybase.com/support.
2 Select EBFs/Updates. Enter user name and password information, if
prompted (for existing web accounts) or create a new account (a free
service).
3 Select a product.
4 Specify a time frame and click Go.
5 Click the Info icon to display the EBF/Update report, or click the product
description to download the software.
About This Book
Installation Guide vii
❖Creating a personalized view of the Sybase web site (including support
pages)
Set upa MySybaseprofile. MySybaseis a free service thatallows you to create
a personalized view of Sybase web pages.
1 Point your web browser to Technical Documents at
http://www.sybase.com/support/techdocs/.
2 Click MySybase and create a MySybase profile.
Conventions The formatting conventions used in this manual are:
Formatting example To indicate
command names and
method names When used in descriptive text, this font indicates
keywords such as:
• Command names used in descriptive text
• C++ and Java method or class names used in
descriptive text
• Java package names used in descriptive text
myCounter variable
Server.log
myfile.txt
User Guide
Italic font indicates:
• Program variables
• Parts of input text that must be substituted
• Directory and file names.
• Book titles
sybase\bin
A backward slash (“\”) indicates cross-platform
directory information. A forward slash (“/”)
applies to information specific only to UNIX.
Directory names appearing in text display in
lowercase unless the system is case sensitive.
“About This Book” References to chapter titles have initial caps and
are enclosed within quotation marks.
File > Save Menu names and menu items are displayed in plain
text. The angle bracket indicates how to navigate
menu selections, such as from the File menu to the
Save option.
parse|put|get
Name|Address
The vertical bar indicates:
• Options available within code
• Delimiter within message examples
create table
table created
Monospace font indicates:
• Information that you enter on a command line
or as program text.
• Example output fragments
viii Adapter for SAP R/3
If you need help Each Sybase installation that haspurchased a support contract has one or more
designated people who are authorized to contact Sybase Technical Support. If
you cannotresolve a problem using the manuals or online help, please have the
designated person contact Sybase Technical Support or the Sybase subsidiary
in your area.
For more information on Support Services, education, and consulting services,
refer to the Customer Services Reference Guide.
Type the Name of the
attribute.
Click Apply.
GUI field or button name that is the recipient of a
procedural action.
Formatting example To indicate
Installation Guide 1
CHAPTER 1 Migrating to Adapter for SAP R/3
Version 3.9
This chapter explains how to migrate data from an existing database used
with a previous version of Adapter for SAP R/3 to a target database.
Process Overview
For Windows, Solaris, AIX, and HP-UX, the following procedures
comprise the migration process:
• Transferring configuration information from the old configuration
files to the new configuration files using Table 1-1 as a guide for key
mapping.
• Running the IDoc format conversion tool (if applicable)
• Loading BAPI formats using the 3.9 adapter and map fields
Topic Page
Process Overview 1
Preparing for Upgrade 3
Changes to Configuration Keys 3
Upgrading from Version 3.0.3 to Version 3.9 2
Upgrading from Version 3.8 to Version 3.9 3
Converting IDoc Formats 5
Converting BAPI Formats 14
Upgrading Rules 15
Preparing for Upgrade
2Adapter for SAP R/3
Preparing for Upgrade
Note Existing database refers to the database you are currently using.
Target database refers to the database you will use with Adapter for SAP R/3
version 3.9.
Before migrating formats and rules from an existing database to your target
database, verify the following:
• Existing database contains valid rules and formats.
• Integration Server is installed.
• Target database and temporary database are instantiated, contain no data,
and allows sufficient space for rules and formats.
• Adapter for SAP R/3 version 3.9 is installed.
Warning! When upgrading formats and rules to a target database, you
must have three separate database instances: your existing database, a
temporary database, and your target database. Do not attempt to rebuild
your current database after exporting all the data.
Upgrading from Version 3.0.3 to Version 3.9
Upgrading from Adapter for SAP R/3 version 3.0.3 to version 3.9 consists of
the following steps:
• Transfer user-specific configuration information from the version 3.0.3
configuration files to version 3.9 configuration files.
You can do this manually using the sample configuration files in the SAP-
3_9/CFG folder or using the GUI. See “Changes to Configuration Keys”
on page 3 for a table of changes to configuration keys between versions.
• Reload BAPI formats using Adapter for SAP R/3 version 3.9. You must
crate new rules for these formats.
• Migrate IDoc formats using the procedure described in “Converting IDoc
Formats” on page 5.
This manual suits for next models
1
Table of contents
