Chapter 2 Uninstalling New Era of
Networks e-ADK

e-Adapter Development Kit Installation Guide

Chapter 1 e-ADK 3.9 Installation

Chapter 1

e-ADK 3.9 Installation

This chapter describes how to prepare for and run an installation on a Windows NT, Windows 2000, Solaris, AIX, or HP-UX server.

Reviewing Supported Products

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

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.

On the server, you need the following:

Operating system, applicable to the platform
Compiler
One of the integration servers listed in "Settings for Integration Servers"
Capability to perform software builds using a make process

Supported Integration Servers

New Era of Networks e-ADK, release 3.9, supports the following integration servers:

e-ADK, version 3.6
e-ADK, version 2.0.2
WebSphere MQ Integrator, version 2.1

Settings for Integration Servers

The following combinations of integration server, OT driver, schema loader, and serializer can be used with e-ADK 3.9.

Settings for Integration Servers
Integration Server	Open Transport Driver	Schema Loader	Serializer
MQSI 2.0.2 MQSI 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

Supported Transports

New Era of Networks e-ADK uses Open Transport (OT) 2.6. 1. Open Transport 2.6.1 supports the following transport drivers:

EMQ Driver for Open Transport 2.6.1
File Driver for Open Transport 2.6.1
MQSeries Driver for Open Transport 2.6.1
MSMQ Driver for Open Transport 2.6.1

Supported Platforms and Compilers

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
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
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

Disk Space and Memory Requirements

Installation Media: CD-ROM

Server Requirements

Disk space

270 MB for e-ADK 3.9

250 MB for temporary directory used during installation

Memory

256 MB for product files

Preparing the Installation Environment

Previous Releases

If you have a previous version of e-ADK 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 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.

If a CIM Repository does exist:

If it is on the local machine where you are installing and the repository is running, the installer uses that repository by default. The Repository Information window does not appear.
If it is on the local machine where 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 Information window appears. You can either manually start the existing repository and then provide the Repository Information or install a new repository.
If the repository is 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.

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 one.

To start a repository

If the repository is already installed, you must provide the server, port number, and user information for the existing repository. Default values are provided.

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 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 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 on the default temporary directory.
Launch the installer using a different temporary directory:

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>

Installing e-ADK 3.9

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 Directory".

Before you begin the installation, the repository must be running.

You can verify whether the repository is running by doing one of the following:

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

In Unix, type

ps -ef | grep dbsrv7

Commands are written for Windows; for Unix, substitute a forward slash for the backward slash.

To install e-ADK using the InstallShield Wizard:

These installation instructions assume you are logged onto the server with administrative rights. 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 e-ADK 3.9.

Insert the CD-ROM and go to the step for your operating system:
On Windows NT and 2000:
If your machine is configured to autorun from the CD-ROM, the InstallShield Wizard automatically starts.
If your machine is not configured to autorun from the CD-ROM, do the following:
1. Choose Start>Run from the Windows Start menu.
2. In the Run dialog box, browse to locate the following file:
  <CD-ROM drive>:\setup.exe
3. Click OK
  The Installer window appears.
4. Got to step 6.
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, type the following, and press ENTER:
```
%cd /mnt_point
```
4. To start the installer, type the following and press ENTER:
```
 %./setup
```
  The Installer window appears.
5. Got to step 6.
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, type the following, and press ENTER:
```
%cd /mnt_point
```
4. To start the installer, type the following and press ENTER:
```
%./setup
```
5. The Installer window appears.
  You may get a NULL error message at the end of the installation. Ignore the message.
6. Got to step 6.
On HP-UX:
1. Mount the CD-ROM.
  Some of the files that are being installed may 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, type the following and press ENTER:
```
% cd mnt_point
```
4. To start the installer, type the following and press ENTER:
```
%./setup
```
  The Installer window appears.
5. Got to step 6.
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.
Do one of the following:
1. If your repository is running, the Select Products To Install window appears. Go to step 10.
2. If you do not have a repository installed or it is installed on a remote machine, the Repository Connection Information window appears. Go to step 9.
  You can verify whether the repository is running by doing one of the following:
  In Windows, go to Windows Task Manager>Processes. If dbsrv7.exe is listed as running in then the repository, the repository is active.
  In Unix, type
```
ps -ef | grep dbsrv7
```
In the Repository Information window, do one of the following:
- To install a new repository, go to step 9a.
- To use an existing repository, go to step 9b.
Figure 1-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 appears displaying the repository components that will be installed.
  3. Click Next.
    The Repository Installation window appears showing the progress of the installation. When the repository installation is complete, the Select Products to Install window appears.
    Installation of a new repository may take a few minutes. After it is installed and started, the Select Products To Install window appears.
2. If the CIM Repository is already installed and the Repository Information (Figure 1-1) window appears:
  1. Choose Use an existing repository.
  2. Accept the defaults for Repository Connection Information if possible. The defaults are shown in Figure 1-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 appears displaying the progress of the installation.

Click Finish when the following message appears:

The InstallShield Wizard has successfully installed e-ADK 3.9.

For Windows, reboot the machine.

The software is now installed in the specified installation directory. The New Era of Networks e-ADK software is located in <install dir>\ADK-3_9.

The <install directory>\ADK-3_9 directory contains the following subdirectories:

/<install dir>/Sybase/ADK-3_9
Subdirectory	Description
/bin	contains executables and shared libraries for New Era of Networks products
/examples	contains product directories containing sample makefile and configuration files
/include	contains product directories containing header files needed for e-ADK
/lib	contains static libraries used to build against e-ADK These libraries are not available on Solaris, AIX, or HP-UX.
/NNSYCatalogues	contains ctg message and error files
/share	contains data files

Understanding Environment Variables

The e-ADK does not use system environment variables. All required environment variables are set by wrapper scripts at runtime. Complete configuration information is supplied in e-ADK Developer's Guide and should be used after verifying the installation and before using e-ADK.


	Expand Search