Chapter 1 Migrating to Adapter for
SAP R/3 Version 3.9

Chapter 3 Uninstalling Adapter for SAP R/3

Installation Guide New Era of Networks Adapter for SAP R/3 3.9

Chapter 2 Installing Adapter for SAP R/3

Chapter 2

Installing Adapter for SAP R/3

Review the printed Release Bulletin included with this package for last-minute updates to this Installation Guide.

Preparation

This section describes the areas you must consider before you run the installation procedure.

Integration Server Support
Transport Support
Platform and Compiler Support
Disk Space and Memory Requirements
Required Software
Installation Environment

Integration Server Support

Adapter for SAP R/3, version 3.9, supports the following integration servers:

e-Biz Integrator, version 3.6
MQSeries Integrator, version 2.0.2
WebSphere MQ Integrator, version 2.1

MQSeries Integrator version 2.0.2 does not support multi-byte data.

Settings for Integration Servers

The following combinations of integration server, OT driver, schema loader, and serializer can be used with Adapter for SAP R/3, version 3.9.

Settings for Integration Servers
Integration Server	Open Transport Driver	Schema Loader	Serializer
MQSI 2.0.2 WMQI 2.1	MQSeries	NNT56 Schema Loader	NCF Serializer XML Serializer
e-Biz Integrator 3.6	EMQ MQSeries MSMQ Flat File	NNT56 Schema Loader	NCF Serializer XML Serializer

Transport Support

Adapter for SAP R/3, version 3.9, uses Open Transport (OT). Open Transport supports the following transport drivers:

Server transport support
Driver	Version	Supported Platforms
Flat File	2.6	NT, Solaris, HP-UX, AIX
MQSeries	2.6	NT, Solaris, HP-UX, AIX
MSMQ	2.6	NT
Tibco	2.6.1	NT
JMS	2.6.1	NT, Solaris

Supported Platforms and Compilers

"Supported Platforms and Compilers" identifies the operating systems and compilers required for this product. Use this table to identify the software required for installation.

Server
Operating System	DBMS	Compiler
Windows NT 4.0 (Service Pack 6a or higher) Windows 2000 (Service Pack 2 or higher)	Sybase ASE 12 Sybase ASE 12.5 Microsoft SQL Server 2000 Microsoft SQL Server 7 Oracle 8i r3 (8.1.7) Oracle 9i DB2 UDB 7.1 DB2 UDB 7.2	Microsoft Visual C++, version 6.0
Solaris 8	Sybase ASE 12 Sybase ASE 12.5 Oracle 8i r3 (8.1.7) Oracle 9i DB2 UDB 7.1 DB2 UDB 7.2	SparcWorks C++, version 6.0, update 1
HP-UX 11.00	Sybase ASE 12 Sybase ASE 12.5 Oracle 8i r3 (8.1.7) Oracle 9i DB2 UDB 7.1 DB2 UDB 7.2	HP aC++, version A.03.15
AIX 4.3.3	Sybase ASE 12 Sybase ASE 12.5 Oracle 8i r3 (8.1.7) Oracle 9i DB2 UDB 7.1 DB2 UDB 7.2	VisualAge C++, Professional version 5.0.2

Installation Environment

Previous Releases

If you have a previous version of New Era of Networks Adapter for SAP R/3 installed, it is suggested that you uninstall that version before installing the current release. However, if you plan to continue to use your older version of the software, it can remain on the same server. Installation of the current release does not overwrite the previous installation and does not affect any files you might have added.

CIM Repository

The CIM (common information model) repository shares installation information across Sybase and New Era of Networks products, tracking version and path information for each product installation. If the repository is already installed, you do not need to install a new CIM Repository. However, the repository must be running before you can install products.

If a CIM repository does exist:

on the local machine on which you are installing, and the repository is running, the installer uses that repository by default. The Repository Information window does not appear.
on the local machine on which you are installing and the repository is not running, the installer tries to start the existing repository. If it cannot start the repository, a warning message appears stating that a repository was found but could not be started. The Repository window will appear for you to provide the repository information and start the repository.
on a remote machine, the Repository Information window appears even if the repository is running on the remote machine. If you want to use an existing repository, start it manually and provide the information required by the installer for the existing repository.

If a CIM repository does not exist or cannot be found by the installer, a window appears, prompting you to install a new CIM Repository or use an existing repository.

To start a repository

If the repository is already installed, you must provide the server, port number, and user information for the existing repository. The system populates the screen with default values for the server, port number, and user information, but you can modify the values if necessary.

Use platform specific commands to start the repository:
1. On Windows, enter the following:
```
cd <install dir>\CIMRepository-3_0_0\bin
```
```
repository.bat
```
2. On UNIX, enter the following:
```
cd <install dir>/CIMRepository-3_0_0/bin
```
```
./repository.sh
```

Temporary Installation Directory

The installer uses a temporary location during the installation process. The default temporary location on Windows is defined in the system environment variables and is usually set to C:\temp. The default temporary location on UNIX is /var/tmp.

If enough space is not available in the default temporary location, the installer might not start, or it might start, but notify you that sufficient space is not available. Either case requires providing sufficient space in the temporary directory. You can do one of the following:

Move or delete files to provide space on the default temporary directory.
Launch the installer using a different temporary directory.

To install on a temporary directory other than the default directory:

Use platform specific commands to specify an install directory:
1. On Windows, enter the following:
```
setup -is:tempdir <full path
to alternate temp directory>
```
2. On UNIX, enter the following:
```
setup -is:tempdir <full path
to alternate temp directory>
```

Do not use spaces or special characters in your UNIX path.

Disk Space and Memory Requirements

Disk space

NT: 183 MB for adapter and temporary directory used during installation

UNIX: 208 MB for adapter and 160 MB for temporary directory

Memory

256 MB for product files

Required Software

"Supported Platforms and Compilers" identifies the operating systems and compilers required for this product. Use this table to identify the software required for installation.

The following must be installed or configured on the server before installing the adapter:

Windows operating system
SAP R/3, version 3.1H or higher; 4.0B or higher to work with XML formats.
DBMS server database application.
Compiler if you plan to write any of your own code.
One of the integration servers listed in "Integration Server Support".
Internet Explorer version 5.5, Service Pack 2.

Running Executables Before Installing the Adapter on Windows

You must run the following executables or .msi files from the Adapter for SAP R/3 Server CD before you install the Adapter for SAP R/3 on Windows.

From your CD-ROM drive, open the vbruntime-6_0 folder and double-click on vbrun60sp4.exe to install Visual Basic runtime. This is used by the GUI. When the install is finished, click OK.
From your CD-ROM drive, open the mmc-1_2 folder and double-click on immc2.exe to install the Microsoft Management Console, which is used by the GUI. When the install is finished, click OK.
From your CD-ROM drive, open the mdac-2_6 folder and double-click on the mdac_typ.exe file to install the proper version of MDAC. When the install is finished, click OK.
For Windows NT, from your CD-ROM driver, open the msvc-6_0 folder and double-click on the vcredist.exe file to install the proper version of MSVC runtime. When the install is finished, click OK.

After you have completed installing these four applications, you can continue with the next steps to complete the install.

If you are installing Adapter for SAP R/3 on the same machine as your database server, you may not have to install a separate database client; instead, you can connect directly to the database server.

Preparing the Installation Environment

Previous versions

If you have a previous version of Adapter for SAP R/3 installed, it is suggested that you uninstall that version before installing the current version. However, if you plan to continue to use your older version of the software, it can remain on the same server. Installation of the current version does not overwrite the previous installation and does not affect any files you may have added.

CIMRepository

The Common Information Model (CIM) Repository shares installation information across Sybase and New Era of Networks products, tracking version and path information for each product installation. If the repository is already installed, it is not necessary to install a new CIM Repository. However, the repository must be running before you can install products. After the installation has been completed, you can stop the CIM Repository to save resources.

If a CIM Repository does exist:

on the local machine and is running, the installer uses that repository by default. The Repository Information window does not appear.
on the local machine and is not running, the installer tries to start the existing repository. If it cannot start the repository, a warning message appears stating that a repository was found but could not be started. The Repository Information window appears and you can provide the repository information and start the repository.
on a remote machine, the Repository Information window appears even if the repository on the remote machine is running. To use an existing repository, start it manually and provide the information required by the installer for the existing repository as detailed in "To start a repository".

If a CIM Repository does not exist or cannot be found by the installer, a window displays with the prompt to either install a new CIM Repository or use an existing repository.

To start a repository

To start the repository on Windows, enter the following:
cd <install dir>\CIMRepository-3_0_0\bin
repository.bat
To start the repository on UNIX, enter the following:
cd <install dir>/CIMRepository-3_0_0/bin
./repository.sh

Temporary Installation Directory

If enough space is not available in the default temporary location, the installer may not start or may start but notify you that sufficient space is not available. You can do one of the following:

Move or delete files to provide space.
Launch the installer using a temporary directory on a different drive (Windows) or location (UNIX).

To install on a temporary directory other than the default directory:

For Windows, enter the following:
setup -is:tempdir <full path to alternate temp directory>
For Unix, enter the following:
./setup -is:tempdir <full path to alternate temp directory>
Do not use spaces or special characters in your UNIX path.

Installing Adapter for SAP R/3

For all installation instructions, <install dir> refers to the default installation directory.

If installing on Windows, the default is C:\Sybase.
If installing on Unix, the default is /user/u/Sybase. When installing on Unix, do not use spaces or special characters in the path.

If the installation directory does not exist, you can either create the directory or the installer will create the installation directory when installation begins. If you get a memory error while installing, see "Temporary Installation Directory".

Before you begin the installation, the repository must be running unless you plan to install a new one. If you plan to use an existing repository, you can verify whether the repository is running by doing one of the following:

On Windows, go to Task Manager > Processes. If dbsrv7.exe is listed as running, the repository is active.

On Unix, type

ps -ef | grep dbsrv7

To install Adapter for SAP R/3 using the InstallShield Wizard:

These installation instructions assume you are logged onto the server with administrative rights/user permissions. When installing on UNIX, it is best to perform the install directly on the target machine in the Common Desktop Environment (CDE) single window mode. Use the CD-ROM to install Adapter for SAP R/3.

Insert the CD-ROM and go to the step for your operating system:
Start the installer.
1. On Windows NT and 2000
  1. Verify that you have installed all prerequisite software.
  2. Select Start>Run from the Windows Start menu.
  3. In the Run dialog box, browse to locate the setup file:
```
 <CD-ROM drive>:\setup.exe
```
  4. Click OK.
    The Installer Welcome window appears.
  5. Got to step 3 of the main procedure.
2. On Solaris:
  1. Mount the CD-ROM.
    For example:
```
pfs_mount <CD
DEVICE> /mnt_point
```
  2. Set the IP address:
```
export DISPLAY=<IP
address:0.0>
```
  3. To change to the /mnt_point directory, enter:
```
%cd mnt_point
```
  4. To start the installer, enter:
```
%./setup
```
    The Installer Welcome window appears.
  5. Got to step 3 of the main procedure.
3. On AIX:
  1. Mount the CD-ROM.
    For example:
```
pfs_mount <CD
DEVICE> /mnt_point
```
  2. Set the IP address:
```
export DISPLAY=<IP
address:0.0>
```
  3. To change to the /mnt_point directory, enter:
```
%cd mnt_point
```
  4. To start the installer, enter:
```
%./setup
```
    The Installer Welcome window appears.
  5. Got to step 3 of the main procedure.
4. On HP-UX:
  1. Mount the CD-ROM.
    Some of the files that are being installed might have names longer than 31 characters or have mixed-case file and directory names, so you must enter the following mount commands:
```
nohup pfs_mountd &
```
```
nohup pfsd &
```
```
pfs_mount <cd
device> /mnt_point
```
  2. Set the IP address:
```
export DISPLAY=<IP
address:0.0>
```
  3. To change to the /mnt_point directory, enter:
```
%cd mnt_point
```
  4. To start the installer, enter:
```
%./setup
```
    The Installer Welcome window appears.
  5. Got to step 3 of the main procedure.
To initiate the installation process, click Next on the Installer Welcome window.
The Installer window appears.
To specify an installation directory, choose one of the following:
1. To accept the default directory, click Next.
2. To use a different directory, click Browse, select the directory, and click Next.
  For optimum performance, install all Sybase and New Era of Network products into the same directory.
To configure the repository, do one of the following:
1. If your repository is running, the Select Products To Install window appears. Go to step 7.
2. If you do not have a repository installed or it is installed on a remote machine, the Repository Information window appears. Go to step 6.
  You can verify whether the repository is running by doing one of the following:
  On Windows, go to Task Manager > Processes. If dbsrv7.exe is listed as running, the repository is active.
  On Unix, type
```
ps -ef | grep dbsrv7
```
In the Repository Information window, do one of the following:
- To install a new repository, go to step 6a.
- To use an existing repository, go to step 6b.
Figure 2-1: Repository Information
1. To install a new repository, based on requirements detailed in "CIMRepository":
  1. Choose Install a new repository.
    The Repository Connection Information is not visible in the Repository Information window.
  2. Click Next.
    The Repository Installation window displays the repository components to be installed.
  3. Click Next.
    The Repository Installation window displays the progress of the installation. Installation of a new repository may take a few minutes.
    When the repository installation is complete, the Select Products To Install window appears.
2. If the CIM Repository is already installed and the Repository Information window appears:
  1. Choose Use an existing repository.
  2. Accept the defaults for Repository Connection Information if possible. The defaults are shown in Figure 2-1.
    If you use an existing repository, the repository must be running to continue the installation.
  3. Click Next.
    The Select Products to Install widow appears.
From the Select Products to Install window, accept the default settings and click Next.
The Installation Summary window appears displaying the products that will be installed and the approximate disk space that they will take.
Click OK.
The Installation Summary window displays the progress of the installation.
Click Finish when the following message appears:
```
The InstallShield Wizard has successfully installed New Era of Networks Adapter for SAP 3.9.
```
If you get a NULL error message at the end of the installation, ignore the message.
If you are installing on Solaris 7, you might receive error messages when finishing the installation. The product installed correctly; you can ignore the errors.
For Windows, reboot the machine.

Adapter for SAP R/3 and the Sybase shared components are located in the user specified installation directory <install dir>. The Adapter for SAP R/3 software is located in <install dir>\SAP-3_9.

/<*install dir*>/SAP-3_9
Subdirectory	Description
/bin	contains wrapper scripts for executables and shared libraries
/CFG	contains sample configuration files
/NNSYCatalogues	contains ctg message and error files
/share	contains data files

Understanding Environment Variables

Required environment variables are set by wrapper scripts at runtime. The GUI executable installation defines system environment variables of SAP39_ROOT and CGC39_ROOT with a value of <install dir> and the variable RFC_INI with a value of <install dir>\CFG\saprfc.ini. Complete configuration information is supplied in Adapter for SAP R/3 User's Guide and should be used after verifying the installation and before using Adapter for SAP R/3.


	Expand Search