NovellÒ

exteNd Composer

4.2
 

 
 
 SAP Connect

 


            

 

June 2003

Welcome to Novell exteNdTM Composer SAP Connect 4.2.

These release notes include the following sections:

What is new

Enhancements in SAP Connect v4.2

Installation notes

Important information before installing exteNd Composer SAP Connect

Software and hardware requirements

Software and hardware needed to run exteNd Composer SAP Connect

Setup and Configuration

Setup guide for exteNd Composer SAP Connect installation

Features

 

Features in this release of exteNd Composer SAP Connect

Known issues

Known issues with this release of exteNd Composer SAP Connect

What is New

exteNd Composer SAP Connect 4.2 has been enhanced to work with the new Novell exteNd Composer 4.2 and to take advantage of the new and enhanced Actions.

Installation notes

This section provides information about installing and configuring exteNd Composer SAP Connect.

 

exteNd Composer products are installed from the following CDs:

 

­         Novell exteNd Composer

­         Novell exteNd Composer Enterprise Server

If you experience problems with the installation of SAP Connect, contact Novell technical support for manual installation steps.

Installing SAP Java Connector (JCo)

exteNd Composer SAP Connect is designed specifically to integrate with the SAP environment through the SAP JCo (Java Connector) libraries.  Specifically, Composer SAP Connect 4.2 has been tested with SAP Java Connector 1.1.02, 1.1.03 and 1.1.04. 

Registered SAP users may download SAP JCo libraries from the following SAP site: http://service.sap.com.  A valid SAP Service Marketplace user ID and password is required to access this SAP site.

Note: SAP Java Connector 1.1 requires an RFC runtime library of version 6.10 or higher to be installed on the system on which you want to run JCo.

Error Messages

Note: To install exteNd Composer SAP Connect, you must have SAP Java Connector installed.

 

If you do not have SAP Java Connector installed (as described below) prior to installing Composer SAP Connect, the following dialog will be displayed.

 

Also, the log will have the following message:

java.lang.NoClassDefFoundError: com/sap/mw/jco/JCO$PoolChangedListener

 

exteNd Composer SAP Connect Developer

For exteNd Composer SAP Connect Developer, follow the SAP instructions for installing JCO on Windows NT, Windows 2000.

1.      From the SAP site, download jco-ntintel-1.1.04.zip into an arbitrary directory {jco-install-path}.

2.      Unzip the file jco-ntintel-1.1.04.zip into an arbitrary directory {jco-install-path}.

3.      Add the DLLs to the extendComposer\Designer\bin directory.

4.      Add jCO.jar to the exteNdComposer\Designer\lib directory.

5.      Add a <JAR> entry for jCO.jar to the SAP section of xConfig. For example:

<JAR>..\lib\jCO.jar</JAR>)

exteNd Composer SAP Connect Server on Windows NT, Windows 2000

For exteNd Composer SAP Connect Server, follow the SAP instructions for installing JCO on Windows NT, Windows 2000

1.      From the SAP site, download jco-ntintel-1.1.04.zip into an arbitrary directory {jco-install-path}.

2.      Unzip the file jco-ntintel-1.1.04.zip into an arbitrary directory {jco-install-path}.

3.      Add the DLLs to a location within the application server directory tree that is in the path so that they can be found at runtime.  For example, the application server bin directory.

4.      Add jCO.jar to the exteNdComposer\lib directory of the Server.

5.      Add [PATH]\exteNdComposer\lib\jCO.jar to the CLASSPATH of the application server

exteNd Composer SAP Connect Server on Solaris

For exteNd Composer SAP Connect Server, follow the SAP instructions for installing JCO on Solaris.

1.      From the SAP site, download jco-sun-1.1.04.tgz or jco-sun-1.1.04.tar.z into an arbitrary directory {jco-install-path}.

2.      Expand the jco-sun-1.1.04.tgz or jco-sun-1.1.04.tar.z into an arbitrary directory {jco-install-path}.

3.      Add The SOs to a location with the application server directory tree that is in the LD_LIBRARY_PATH so that they can be found at runtime.

4.      Add jCO.jar to the exteNdComposer\lib directory of the Server.

5.      Add [PATH]\exteNdComposer\lib\jCO.jar to your CLASSPATH environment variable.

exteNd Composer SAP Connect Server on AIX

For exteNd Composer SAP Connect Server, follow the SAP instructions for installing JCO on AIX.

1.      From the SAP site, download jco-rs6000-1.1.04.tgz or jco-rs6000-1.1.04.tar.z into an arbitrary directory {jco-install-path}.

2.      Expand the jco-rs6000-1.1.04.tgz or jco-rs6000-1.1.04.tar.z into an arbitrary directory {jco-install-path}.

3.      Add The SOs to a location with the application server directory tree that is in the LIBPATH so that they can be found at runtime.

4.      Add jCO.jar to the exteNdComposer\lib directory of the Server.

5.      Add [PATH]\exteNdComposer\lib\jCO.jar to your CLASSPATH environment variable.

exteNd Composer SAP Connect Server on HP-UX

For exteNd Composer SAP Connect Server, follow the SAP instructions for installing JCO on HP-UX.

1.      From the SAP site, download jco-hp_32-1.1.04.tgz or jco-hp_32-1.1.04.tar.z into an arbitrary directory {jco-install-path}.

2.      Expand the jco-hp_32-1.1.04.tgz or jco-hp_32-1.1.04.tar.z into an arbitrary directory {jco-install-path}.

3.      Add The SLs to a location with the application server directory tree that is in the SHLIB_PATH so that they can be found at runtime.

4.      Add jCO.jar to the exteNdComposer\lib directory of the Server.

5.      Add [PATH]\exteNdComposer\lib\jCO.jar to your CLASSPATH environment variable.

 

Installing exteNd Composer

 

exteNd Composer products are installed from the following CDs:

­   Novell exteNd Composer

­   Novell exteNd Composer Enterprise Server

Uninstalling previous beta versions of exteNd Composer SAP Connect

1.      Before installing this version of the exteNd Composer SAP Connect, you should completely uninstall any beta version of SAP Connect from your machine.  This includes both Server and Developer: We recommend that you use the uninstall program found in the exteNd Composer program group. Select Uninstall exteNd Composer Developer from the program group and follow the instructions.  The other option is, from the control panel choose Add/Remove Programs. Select exteNd Composer SAP Connect and click Remove. Allow the uninstall program to completely remove the beta version of the product.

2.      Follow the instructions to install the Server and Developer portions of this release.

If you have deployed any services using the beta software you need to re-deploy those with the production version of SAP Connect.

Installation Issues:

 

If you experience problems with the installation of SAP Connect, contact Novell technical support for manual installation steps.

Software and hardware minimum requirements

There is no additional hardware or 3rd party software requirement to install or use any Connector within exteNd Composer.  Please see the hardware and software requirements included with both exteNd Composer Enterprise Server and Developer.

Connectors are engineered to work in conjunction with your exteNd Composer core products and are compatible with the same major version of the core products.

Setup and Configuration

Developer Installation

To install the Design time component of SAP Connect, perform the following steps:

1.      Start Windows, if you have not already done so.

2.      Insert the exteNd Composer Developer CDROM into the CDROM drive.

3.      If the program starts automatically – select SAP Connect from the options and simply follow the instructions on the screen.

4.      If the setup program does not automatically start, perform following steps:

a.      From the Start menu, select Run

b.      In the dialog box, enter:

D:\autorun\autorun (you will need to change the drive letter in the command line above to match your current CDROM drive)

5.      Select the exteNd Composer product you want to install.

6.      Follow the instructions given by the setup wizard for correct installation of the product.

What is installed:

SAP Connect setup program updates your exteNd Composer Developer installation to allow the creation of SAP components for use within the exteNd Composer environment.  The following items are added to your installation:

­   Online help files for the SAP Component Editor are added to the Help directory.

­   The SAP Connect runtime libraries are added to the exteNd Composer lib directory.

­   The SAP Connect User Guide is added to Docs directory.

Uninstall Instructions

If you find it necessary to remove the exteNd Composer software from your computer, perform the following steps:

We recommend you use the uninstall program found in the exteNd Composer program group. Select Uninstall exteNd Composer SAP Connect from the program group and follow the instructions. If you have trouble with or do not have the uninstall program please follow the following steps:

1.      Open the Windows Control Panel.

2.      Open the Add/Remove Programs application from Control Panel.

3.      Select exteNd Composer SAP Connect from the list of applications that can be uninstalled by Windows.

4.      Click on the Add/Remove button to uninstall exteNd Composer SAP Connect.

Server Installation

What is installed:

The SAP Connect setup program updates your exteNd Composer Enterprise Server installation to allow the running of SAP components within the exteNd Composer Enterprise Server environment.  The following items are added to your installation:

­   The xconfig.xml file is updated with the information required to enable the SAP component

­   SAP Connect runtime libraries are added to the exteNd Composer lib directory

Microsoft Windows NT/2000

To install the runtime component of SAP Connect, perform the following steps:

1.      Start Windows, if you have not already done so.

2.      Insert the exteNd Composer Enterprise Server CDROM into the CDROM drive

3.      If the program starts automatically – select the product(s) you want to install from the options provided and simply follow the instructions on the screen.

4.      Perform following steps:

a.      From the Start menu, select Run

b.      In the dialog box, enter:

D:\[Application Server]\Windows\install

Where Application Server is Novell, WebSphere or WebLogic

 (you will need to change the drive letter in the command line above to match your current CDROM drive)

5.      Select the exteNd Composer product(s) you want to install.

6.      Follow the instructions given by the setup wizard for correct installation of the product.

Uninstall Instructions

If you find it necessary to remove the exteNd Composer software from your computer, perform the following steps:

We recommend you use the uninstall program found in the exteNd Composer program group. Select Uninstall exteNd Composer SAP Connect from the program group and follow the instructions. If you have trouble with or do not have the uninstall program please follow the following steps:

1.      Open the Windows Control Panel.

2.      Open the Add/Remove Programs application from Control Panel.

3.      Select exteNd Composer SAP Connect from the list of applications that can be uninstalled by Windows.

4.      Click on the Add/Remove button to uninstall exteNd Composer SAP Connect.

5.      If the uninstall program encounters errors, see the following section for manual uninstall instructions.

Note: The Uninstall for WebLogic Server does not work.

Sun Solaris

To install the runtime component of SAP Connect in the Solaris environment, perform the following steps:

The Solaris Volume Management software automatically mounts the CD-ROM to the /cdrom mount point.

Once the CD-ROM drive is mounted, you can install exteNd Composer. You do not need to run the Installation program with root privileges; you can install as any user.

To install exteNd Composer SAP Connect:

1.      Change the directory to the CD-ROM mount port. 

  cd /cdrom/{volume label}

2.      Enter the following at the command prompt: 

./[Application Server]/Solaris/install.bin
 
where Application Server is Novell, WebLogic or WebSphere

3.      The installation script begins.

4.      Follow the instructions given by the setup wizard for the correct installation of the product.

Uninstall Instructions

There are no automated uninstalls available for the Solaris environment in v4.2.  We plan to provide an automated uninstall in the future.  Please contact Novell Technical Support for instructions.

IBM AIX

To install the runtime component of SAP Connect in the AIX environment, perform the following steps:

The AIX Volume Management software automatically mounts the CD-ROM to the /cdrom mount point.

Once the CD-ROM drive is mounted, you can install exteNd Composer. You do not need to run the Installation program with root privileges; you can install as any user.

To install exteNd Composer SAP Connect: 

1.                        Change the directory to the CD-ROM mount port. 
  cd /cdrom/{volume label}

2.      Enter the following at the command prompt: 

./[Application Server]/AIX/install.bin
 
where Application Server is Novell, WebLogic or WebSphere

3.      The installation script begins.

4.      Follow the instructions given by the setup wizard for the correct installation of the product.

Uninstall Instructions

There are no automated uninstalls available for the AIX environment in v4.2.  We plan to provide an automated uninstall in the future.  Please contact Novell Technical Support for instructions.

HP-UX

To install the runtime component of SAP Connect in the HP-UX environment, you must first mount the exteNd Composer Enterprise Server CD-ROM drive.

To mount the CD-ROM:

1.      Create the /cdrom directory to be used as the mount point.

mkdir /cdrom

2.                  Start the pfs_mountd and pfsd daemons if they are not already running.

nohup /usr/sbin/pfs_mountd &

nohup /usr/sbin/pfsd &

3.      Mount the CD-ROM to the mount point.

/usr/sbin/pfs_mount -x unix -t iso9660 /dev/dsk/c1t2d0 /cdrom

where c1t2d0 is the CD-ROM device.

Once the CD-ROM drive is mounted, you can install exteNd Composer. You do not need to run the Installation program with root privileges; you can install as any user.

To install exteNd Composer SAP Connect:

1.      Change the directory to the CD-ROM mount port. 

cd /cdrom/{volume label}

2.      Enter the following at the command prompt: 

./[Application Server]/HPUX/install.bin
 
where Application Server is Novell, WebLogic or WebSphere

3.      The installation script begins.

4.      Follow the instructions given by the setup wizard for the correct installation of the product.

Uninstall Instructions

There are no automated uninstalls available for the HP-UX environment in v4.2.  We plan to provide an automated uninstall in the future.  Please contact Novell Technical Support for instructions.

Tutorial:

There is no tutorial sent with the SAP Connect.  Since every environment is unique, the process for setting up the connections may vary.    You can deploy the SAP components in the same manner that you do XML Map and JDBC components.  Refer to the tutorial provided with the core Server product for NT.

Features in exteNd Composer SAP Connect

The following is a brief description of the feature set provided by Novell exteNd Composer SAP Connect.  For a more detailed look at the features and functionality please read the exteNd Composer SAP Connect User Guide provided with the software and on the CD-ROM.

 

SAP Connect is a separately installable product that integrates directly with your existing exteNd Composer installation and provides you with the ability to integrate your business applications using exteNd Composer SAP Connect.

 

In addition to the features listed below the SAP Connect inherits all the functionality of the exteNd Composer XML Mapping Component Editor.  Please see the exteNd Composer Users Guide for more information.

 

Connectivity - Composer SAP Connect allows the user to create a connection to an SAP system using the SAP Java Connector Object (JCO).

­   Composer SAP Connect provides integration to the BAPI level interface to access information stored in SAP.

­   Composer SAP Connect supports both inbound and outbound calls to SAP BAPIs or other RFC-enabled Function Modules (RFMs).

Visual Integration – Composer SAP Connect provides a visual interface in which the user creates, tests and edits SAP Components.

­   When creating a Composer SAP component, the Create a New SAP Component Wizard presents the standard set of panels to the user.  The Name/Description panel is followed by the Input/Output/Temp Message panel, and finally the Connection panel.

 

­   The Native Environment Panel (NEP) is displayed in the upper right corner.  Within the Composer Native Environment Panel, users will be able to select from a list of existing BAPI functions, and then drag and drop to the inputs and outputs of the BAPI.

 

­   Animating or executing an SAP component will connect to the SAP system, execute the action tree, and then disconnect from the SAP system.

 

­   Composer SAP Connect introduces one new Composer Action, SAP Function Action.   Creating or editing an SAP Function action will display the SAP Function Action dialog.  The SAP Function dialog displays three tabs: the SAP Function Tab, the SAP Request tab and the SAP Response tab.

 

­   Within the SAP Function Action dialog, the SAP Function tab allows a user to search for a BAPI or RFM by specifying a search string.  After entering a search string and pressing the Search button, a list of functions matching the search criteria from a SAP repository is displayed.  The wild card character “*” can be used to replace any part of a literal string.

 

­   After a successful search the user can select a function from the Functions list by double clicking on a function name or by highlighting a function name and pressing enter or the spacebar.  Selecting the function causes the dialog to build the model selection trees on the SAP Request and SAP Response tabs.  BAPI/RFMs may have no Request or Response, only Request, only Response, or both Request and Response options.  The SAP Request and SAP Response tabs are enabled/disabled accordingly. 

 

­   The SAP Request tab allows the user to specify options for setting data into a function prior to execution. 

 

­   The SAP Response tab allows the user to specify options for getting data from a function after execution. 

Known issues

This release has the following known issues (workarounds are specified if known):

Installation

­   A Windows 2000 display problem may occur during SAP Connect installations into the server.

­   During the install on Win2k, the screen may begin to flicker and the entire screen may turn gray. This problem does not harm the install in any way and can be worked around by doing anything that will make the screen repaint (e.g. drag a window).

Console on WebSphere

If you deploy exteNd Composer service components to more than one WebSphere application server you will need to copy the exteNd Composer consoles for 3270 Connect, 5250 Connect, Telnet Connect and SAP Connect to each application server.  This will allow you to monitor the various exteNd Composer Connector connection pools for the specific application servers. 

Instructions which describe how to copy these exteNd Composer Consoles are available for from the exteNd Composer Product Download section on http://www.novell.com/.  Also included in this download is a new file called exteNdComposerConsoles.ear, which is required.

Connection Pool

­   It is possible for two different deployed projects to have the same connection name (pooled) specified, in which case one component in one project may call into the connection pool of the other project.  For an SAP Component, if Component A in Project 1 tries to access a connection of the same name in a pool created by Project 2, Component A will detect this and reinitialize the pool.  This will cause performance degradation.

Workaround: To avoid this problem be sure to uniquely name all connections.

Animation

­   The STOP button does not work during run to the end animation.  When running to a break point, first press Pause to stop the animator then press STOP.