Sybase New Era of Networks Adapter for Flat Files 3.8 Installation Manual
Installation Guide
New Era of Networks Adapter for Flat Files
Version 3.8
DOCUMENT ID: 36402-01-0380-01
LAST REVISED: December 4, 2001
Copyright © 2001 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 BizTracker, New Era of Networks Portal Server, New Era of Networks Process Server, OpenBroker, e-Biz Integrator for
Impact, New Era of Networks Secure, New Era of Networks Adapter, and Physician Access are trademarks, and CL/7, MicroScript
and Transaction Distribution Manager, TDM are registered trademarks of New Er a of Networks, Inc. and its subsidia r ies. 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 t heir respective owners.
Restricted Rights Legend
Use, duplication or di sclosure by the Govern ment is subject to restrictions set forth in subparagraph (c)(1)(ii) of DFARS 52.2277013 for the DOD and as set forth in FAR 52.227-19(a)-(d) for civilian agencies.
New Era of Networks, Inc., 6550 Greenwood Pla za Blvd., Englewood, CO 80111
Sybase, Inc., 6475 Christie Avenue, Emeryville, CA 94608
New Era of Networks Adapter for Flat Files iii
Installation Guide
Contents
Chapter 1: Introduction ............... ................. .. ................. ... ................ ... .. .. 1
About This Document...................................................................................................................................... 2
Integration Server Support............................................................................................................................... 2
Transport Support............................................... ...... .................................. ...... ..... .......................................... 2
Settings for Integration Servers.......................................................................................................................3
Supported Platforms........................................................................................................................................4
Disk Space and Memory Requirements ..........................................................................................................4
Server Requirements ................................................................................................................................4
New Era of Networks Adapter for Flat Files Documentation Set...................................................................5
Cross-Platform Documentation................................................................................................................5
Related Documentation............................................................................................................................ 5
Document Conventions............................................................................................................................6
Product Support & Education.......................................................................................................................... 6
Chapter 2: Windows Se rv e r Ins t a lla t i on ..... ............................... .............. 7
Preparing for a Windows Installation................................................... ...... ...... ...............................................8
Installing Required Software....................................................................................................................8
Verifying the Database Environment....................................................................................................... 8
Uninstalling Previous Releases ................................................................. ..... ...... ....................................8
Installing New Era of Networks Adapter for Flat Files...................................................................................9
Verifying the Installation.............................................. ...... .................................. ..... ...... .... ...................11
Verifying Environment Variables....................... ...... ...... .................................. ..... ...... ..................................12
Chapter 3: Solari s In s tallation ........... ... .............. ... .. .. ............... .. ... .. .......13
Preparing for a Solaris Installation......................................................................................... .......................14
Installing Required Software..................................................................................................................14
Verifying the Database Environment.....................................................................................................14
Uninstalling Previous Releases ................................................................. ..... ...... ..................................14
Installing New Era of Networks Adapter for Flat Files.................................................................................15
Setting Environment Variables...................................................................................................................... 16
Verifying the Environment Variables....................................................................................................17
Chapter 4: HP-UX In sta llation... .. ........................................... ... .. ... ......... 19
Preparing for an HP-UX Installation.................. .................................................................... ...... ................. 20
Installing Required Software..................................................................................................................20
Verifying the Database Environment.....................................................................................................20
Uninstalling Previous Releases ................................................................. ..... ...... ..................................20
Installing New Era of Networks Adapter for Flat Files.................................................................................20
Setting Environment Variables...................................................................................................................... 23
Verifying the Environment Variables....................................................................................................23
Chapter 5: AIX Installation .......... ... .. ........................................... ... .. .. .....2 5
Preparing for an AIX Installation............................. ...... .................................. ..... ...... ..................................26
Installing Required Software..................................................................................................................26
Verifying the Database Environment.....................................................................................................26
iv New Era of Networks Adapter for Flat Files
Installation Guide
Uninstalling Previous Releases ................................................................. ..... ...... ..................................26
Installing New Era of Networks Adapter for Flat Files.................................................................................27
Setting Environment Variables...................................................................................................................... 30
Verifying the Environment Variables....................................................................................................30
Chapter 6: Uninstalling New Era of Networks Adapter for Flat Files..31
Uninstalling from a Windows Server............................................................................................................32
Uninstalling from Solaris ............................................... ..... .................................. ...... ..... .............................34
Uninstalling from HP-UX.............................. ..... ...... .................................. ...... ..... ........................................35
Uninstalling from AIX........................................ ...... ...... ............................................................................... 36
Glossary....................................................................................................39
Index.......................................................................................................... 45
New Era of Networks Adapter for Flat Files 1
Installation Guide
Chapter 1
Introduction
This chapter includes the following sections:
n
About This Document
n
Integration Server Support
n
Transport Support
n
Settings for Integration Servers
n
Supported Platfo rms
n
Disk Space and Me mory Requirements
n
New Era of Networks Adapter for Flat Files Documentation Set
n
Product Support & Education
Chapter 1
2 New Era of Networks Adapter for Flat Files
Installation Guide
About This Document
This document describes how to install New Era of Networks Adapter for Flat Files for the first
time. To upgrade a current installation of New Era of Networks Adapter for Flat Files, contact
Technical Support as shown in the section below, Product Support & Education on page 6.
The primary user of this document is the integration systems engineer who is responsible for the
installation of New Era of Networks Adapter for Flat Files.
This guide is organized into the following chapters:
n
Chapter 1: Introducti on lists supported integration servers, platforms and databases, disk space
and memory requirements, and provides documentation, technical support and product
education information.
n
Chapter 2: Windows Server Installation provides steps to prepare for and run an installation on
Windows and verify the environment variables.
n
Chapter 3: Solaris Installation details the steps to prepare for and run an installation on Solaris
and verify the environment variables.
n
Chapter 4: HP-UX Installation provides steps to prepare f or and run an installation on HP-UX
and verify the environment variables.
n
Chapter 5: AIX Installation outlines the steps to prepare for and run an installation on AIX and
verify the environment variables.
n
Chapter 6: Uninstalling New Era of Networks Adapter for Flat Files provides the steps for
uninstalling the product from the server.
n
Glossary contains a Glossary listing terms used in describing adapters.
Integration Server Support
New Era of Networks Adapter for Flat Files is compatible with the following integration servers:
n
e-Biz Integrator, versions 3.2, 3.6
n
MQSeries Integrator, versions 2.0.1 , 2.0.2
n
WebSphere MQ Integrator, version 2.1
n
e-Biz 2000, version 3.4.1
Transport Support
New Era of Networks Adapter for Flat Files uses Open Transport (OT) 2.3. Open Transport 2.3
supports the following transports:
n
e-Biz 2000 Driver for Open Transport 2.3
n
EMQ Driver for Open Transport 2.3
n
File Driver for Open Transport 2.3
n
MQSeries Driver for Open Transport 2.3
n
MSMQ Driver for Open Transport 2.3
Introduction
New Era of Networks Adapter for Flat Files 3
Installation Guide
Settings for Integration Servers
The following table provides information that you need when setting up your configuration files.
Knowing the driver, schema loader, and serializer that is used with your integration server guides
you in selecting configuration keys for your configuration files.
Integration Server
Open Transport Driver
Schema Loader Serializer
e-Biz Integrator 3.2, 3.6 EMQ
MQSeries
(use RFH2)
MSMQ
File
NNT54 SchemaLoader
NCFSerializer
XMLSerializer
MQSI 2.0.1,2.0.2 MQSeries
(use RFH2)
NNT54 SchemaLoader
NCFSerializer
XMLSerializer
WMQI 2.1 MQSeries
(use RFH2)
NNT54 SchemaLoader
NCFSerializer
XMLSerializer
e-Biz 2000 3.4.1 e-Biz 2000 eBizSchemaPlugin XMLSerializer
Chapter 1
4 New Era of Networks Adapter for Flat Files
Installation Guide
Supported Platforms
Server
Disk Space and Memory Requirements
Installation Media: CD-ROM
Server Requirements
Disk space: 50 MB for New Era of Networks Adapter for Flat Files executables
Memory: 256 MB.
Operating System DBMS Compiler
Windows NT 4.0
(Service Pac k 5 or
higher)
Windows 2000
(Service Pac k 2 or
higher)
Microsoft SQL Server 6.5
Microsoft SQL Server 7
Microsoft SQL Server 2000
Oracle 8.0.x
Oracle 8.1.6
Oracle 8.1.7
DB2 UDB 6.2
Microsoft Version 6.0 C++
Solaris 7 Sybase ASE 1 1
Sybase ASE 12
SparcWorks 4.2 C++
HP-UX 11 Oracle 8.0.x
Oracle 8.1.6
Oracle 8.1.7
HP C++A 10.34
IBM AIX 4.3.2,
4.3.3
Oracle 8.0.x
Oracle 8.1.6
Oracle 8.1.7
DB2 UDB 6.2
VisualAge C++Professional
for AIX Version 5
Introduction
New Era of Networks Adapter for Flat Files 5
Installation Guide
New Era of Networks Adapter for Flat Files Documentation Set
This section describes the available documentation.
Cross-Platform Documentation
The New Era of Networks Adapter for Flat Files documentation set includes:
n
Installation Guide
n
User Guide
n
Feature Guide
n
Release Bulletin
Related Documentation
The following documents are referenced in this document set to supply you with specific
information that supports this product:
n
MQSeries Driver for Open Transport Configuration Guide
n
MSMQ Driver for Open Transport Configuration Guide
n
EMQ Driver for Open Transport Configuration Guide
n
File Driver for Open Transport Configuration Guide
n
e-Biz 2000 Driver for Open Transport Configuration Guide
Other related documentation is available from New Era of Networks, Sybase, and IBM. Refer to
other documentation from each of these companies for more detail about use of applications
relevant to this product.
To access the Technical Library Product Manuals Web site, go to Product Manuals at http://
www.sybase.com/support/manuals.
Chapter 1
6 New Era of Networks Adapter for Flat Files
Installation Guide
Document Conventions
The following document conventions are used in this guide.
Product Support & Education
For more information on Support Services, education, and consulting services, refer to the
Customer Services Reference Guide.
Text Convention Example
code courier <user ID> <password>
command line displa y courier The message successfully
parsed.
command line entry courier bold NNFAD-t
command line prompt courier Enter the input file name:
book names bold, italic User Guide
chapter and section
names
italic NT Installation
New Era of Networks Adapter for Flat Files 7
Installation Guide
Chapter 2
Windows Server Installation
This chapter describes how to prepare for and run an installation on a
Windows NT server. It includes the installation of all components. Once
installed, New Era of Networks Adapter for Flat Files can be used with a
New Era of Networks Rules and New Era of Networks Formatter repository.
This chapter includes the following:
n
Preparing for a Windows Installation
n
Installing New Era of Networks Adapter for Flat Files
n
Verifying Environment Variables
The steps to follow after installing the server files are:
n
Verifying the installation by ensuring all the necessary sub-directories
are in place using the procedures documented at the end of the
installation chapter.
n
Configuring your adapter using the New Era of Networks Adapter for
Flat Files User Guide.
Chapter 2
8 New Era of Networks Adapter for Flat Files
Installation Guide
Preparing for a Windows Installation
This section presents the steps you should take before you run the installation procedure:
n
Installing Required Software
n
Verifying the Database Environment
n
Uninstalling Previous Releas es
N
OTE
:
Review the printed Release Bulletin included with this package for any last-minute updates to this
Installation Guide.
Installing Required Software
Supported Platfo rms on page 4 identifies the operating systems, DBMS applications, and
compilers required for this product. Use that table to identify which software is required for this
installation.
At the minimum you need the following software installed on your server:
n
Windows operating system.
n
DBMS software for storage of formats on the integration server.
n
Compiler if you plan to write any of your own code.
n
One of the integration servers listed in Integration Server Support on page 2.
Verifying the Databas e En vironment
New Era of Networks Adapter for Flat Files accesses a designated database through the integration
engine on the server where the integration server resides. Verify that you can connect to this
database before installing the New Era of Networks Adapter for Flat Files software. For additional
information about the integration server database environment, see the Installation Guide for the
integration server.
Uninstalling Previous Releases
If you currently have a previous release of New Era of Networks Adapter for Flat Files installed,
you may want to uninstall that version before installing the current release. Installation of the
current release does not overwrite the previous installation and does not affect any files you may
have added .
Windows Server Installation
New Era of Networks Adapter for Flat Files 9
Installation Guide
Installing New Era of Networks Adapter for Flat Files
It is recommended that you perform a typical installation, which automatically installs all
components and their dependencies.
To install New Era of Networks Adapter for Flat Files using the InstallShield Wizard:
1. Insert the CD into the CD-ROM drive and do one of the following:
n
If your machine is configured to autorun from the CD-ROM, the InstallShield Wizard
automatically starts.
n
If your machine is not configured to autorun from the CD-ROM, do the following:
a.Choose Start→Run from the Windows Start menu.
b.In the Run dialog box, browse to locate the following file:
<CD drive>:\n6nrf54_<*>\Setup.exe
The New Era of Networks Components Installer window appears.
2. Carefully read the License Agreement that appears and respond to it appropriate ly.
3. To begin the installation process, click Next.
The Install New Era of Networks Components window appears.
4. To select components for installation, choose one of the following:
n
To accept the default installation (all components), click Next.
n
To install only selected components, deselect the components you do not want to install,
and click Next.
The Setup Type window appears.
N
OTE
:
Install all components to make full use of the product. If you are reinstalling one of
the components, deselect the components that you do not want to install, and click
Next.
Chapter 2
10 New Era of Networks Adapter for Flat Files
Installation Guide
5. The Setup Type window appears for each component being installed. The options are:
n
Typical install for all components?
n
Customize selected component installs?
The default and preferred method to install the full group of packages is Typical.
To complete the installation process and restart your computer, click Finish.
If you select: Then:
Typical install 1. Click Next to begin the installation of all product
components.
2. Click Next on the Select Components Root Path window to
accept the default location for the installation and its
dependencies.The default location is:
C:\nnsy
This is the default location for all New Era of Networks products.
3. The Setup Status window appears for each component
installation.
After component installation is complete, the following
prompt appears:
Install default New Era of Networks database schema now?
Custom install 1. The Setup type window appears for each component being
installed. The options are:
n
Typical - installing all of the required parts of the
component.
n
Compact - inst all ing th e sam e as Typical ex cept that the
documentation is not installed.
n
Custom - allowing the user to decide what parts of the
component to install.
The default and preferred method is Typical. Click Next to
begin the installation of that component.
2. Click Next to accept the selected setup type for each
component when the window appears.
3. After each component is installed, the Select Components
Program Folder appears for identi fication of the S ta rt menu’ s
program folder. It is suggested that all New Era of Networks
products appear under the default folder of:
New Era of Networks
4. Click Next to accept the default folder name.
Windows Server Installation
New Era of Networks Adapter for Flat Files 11
Installation Guide
Verifying the Installation
Verify that the following sub-directories are installed for New Era of Networks Adapter for Flat
Files.
C:\nnsy\
Subdirectory Description
bin\ executable and shared libraries for New Era of Net-
works products
books\ user documentation
ffa38\examples\ sample makefile and configuration files
ffa38\nnscripts\ used for AWK scripts
share\ resources for XML serializer/deserializer
NNSYCatalogues\en_US language designation and message catalogues
Loading...