Installation Guide New Era of Networks Adapter for Flat Files Version 3.
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.
Contents Chapter 1: Introduction ............................................................................. 1 About This Document...................................................................................................................................... 2 Integration Server Support............................................................................................................................... 2 Transport Support ....................................................................
Uninstalling Previous Releases .............................................................................................................. 26 Installing New Era of Networks Adapter for Flat Files................................................................................. 27 Setting Environment Variables...................................................................................................................... 30 Verifying the Environment Variables ..........................................
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 Platforms n Disk Space and Memory Requirements n New Era of Networks Adapter for Flat Files Documentation Set n Product Support & Education New Era of Networks Adapter for Flat Files Installation Guide 1
Chapter 1 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.
Introduction 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.
Chapter 1 Supported Platforms Server Operating System DBMS Compiler Windows NT 4.0 (Service Pack 5 or higher) Windows 2000 (Service Pack 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 11 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.
Introduction New Era of Networks Adapter for Flat Files Documentation Set This section describes the available documentation.
Chapter 1 Document Conventions The following document conventions are used in this guide. Text Convention Example code courier command line display courier The message successfully parsed.
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.
Chapter 2 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 Releases NOTE: Review the printed Release Bulletin included with this package for any last-minute updates to this Installation Guide.
Windows Server Installation 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.
Chapter 2 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. 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.
Windows Server Installation Verifying the Installation Verify that the following sub-directories are installed for New Era of Networks Adapter for Flat Files.
Chapter 2 Verifying Environment Variables The Windows installation process for New Era of Networks products automatically sets the system environment variables as described in the following table. To verify that the environment variables are correctly set: 1. Go to Settings→Control Panel→System. 2. Select the Environment tab. 3. Use the information provided in the following table to verify that the values are correct.
Chapter 3 Solaris Installation This chapter describes how to prepare for and run an installation on Solaris. It includes the installation of all components.
Chapter 3 Preparing for a Solaris 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 Releases NOTE: Review the printed Release Bulletin included with this package for any last-minute updates to this Installation Guide.
Solaris Installation Installing New Era of Networks Adapter for Flat Files If you are installing the product for the first time, accept the default setting to install all packages. This selection installs all components and associated dependencies and allows you to make full use of the product. Use the option to install selected packages only if you are reinstalling a specific component. To start pkgadd and install New Era of Networks Adapter for Flat Files: 1. Log in as root. 2.
Chapter 3 /opt/nnsy/ Subdirectory Description bin/ Executables and shared libraries for New Era of Networks products. Any specifically applicable to SQL will be located in the NNmssql65\ subdirectory of bin. books/ User documentation in PDF format for online viewing. This documentation is formatted for best viewing on-screen but may be printed if desired. share/ Resources for XML serializer/deserializer. ffa38/examples/ sample configuration files ffa38/nnscripts/ Used for AWK scripts.
Solaris Installation New Era of Networks Product Environment Variables Variable Command Syntax NNSY_ROOT export NNSY_ROOT=/opt/nnsy ICU_DATA export ICU_DATA=/opt/nnsy/share/icu/data PATH export PATH=/opt/nnsy/bin/:$PATH LD_LIBRARY_PATH export LD_LIBRARY_PATH=/opt/nnsy/bin/ :$LD_LIBRARY_PATH Verifying the Environment Variables Using the env command, verify that the system variables for your operating environment are set properly: n New Era of Networks product environment variables identified in
Chapter 3 18 New Era of Networks Adapter for Flat Files Installation Guide
Chapter 4 HP-UX Installation This chapter describes the steps to prepare for and run an installation on HPUX.
Chapter 4 Preparing for an HP-UX 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 Releases NOTE: Review the printed Release Bulletin included with this package for any last-minute updates to this Installation Guide. Installing Required Software Supported Platforms on page 4 identifies the operating systems and DBMS applications required for this product.
HP-UX Installation Example: export DISPLAY=xxx.xxx.xxx.xxx:0.0 4. To begin the installation operation, type the following and press ENTER: swinstall The SD Install Software Selection and the Specify Source windows appear. 5. In the Specify Source window, select CDROM and type the Source Host Name and Source Depot Path at Source Depot Type. Source Depot Path example: /{cdrom}/nnsy where {cdrom} is the CD-ROM mounted in step 1. 6. Click OK.
Chapter 4 11. Click OK to continue. The Confirmation window appears. 12. Click Yes to start the installation. When the installation completes, the status displays Completed in the Install Window. 13. From the Install window, do any of the following to review installation details: n Click Product Summary to view the installation status of components. n Click Logfile to view a log of actions that occurred. 14. Click Done to close the Install Window. 15.
HP-UX Installation Setting Environment Variables After installation and before installing the database schema, you must create the environment variables identified in the following table. To set the environment variables: Choose one of the following: n Add each variable to your profile using the command in the table. n Enter the information on the command line each time you start and executable.
Chapter 4 24 New Era of Networks Adapter for Flat Files Installation Guide
Chapter 5 AIX Installation This chapter describes how to prepare for and run an installation on AIX. It includes the installation of all components.
Chapter 5 Preparing for an AIX Installation This section describes the steps you should take before you run the installation procedure: n Installing Required Software n Verifying the Database Environment n Uninstalling Previous Releases NOTE: Review the printed Release Bulletin included with this package for any last-minute updates to this Installation Guide. Installing Required Software Supported Platforms on page 4 identifies the operating systems and DBMS applications required for this product.
AIX Installation Installing New Era of Networks Adapter for Flat Files If you are installing the product for the first time, accept the default setting to install all packages. This selection installs all components and associated dependencies and allows you to make full use of the product. Use the option to install selected packages only if you are reinstalling a specific component.
Chapter 5 SMIT Prompt Response Mount as a removable file system? Type Yes if you are using a removable drive. Type No if you are not. Mount as a Read Only system? Type Yes to mount as a read only system. Disallow device access via this mount? Type Yes to disallow device access. Type No to allow device access. Disallow execution of suid and sqid programs in this file system? Type Yes to disallow execution of suid and sqid programs. Type No to allow execution of suid and sqid programs. 8.
AIX Installation SMIT Prompt Response EXTEND file systems if space needed? Click Yes. If you already chose Yes for the AUTOMATICALLY install requisite software? prompt, click No. OVERWRITE same or newer versions? Click No. You can not choose the same response as you chose for AUTOMATICALLY install requested software? VERIFY install and check file sizes? Click Yes. Include corresponding LANGUAGE filesets? Click No. Detailed output? Click Yes. (For AIX Version 4.
Chapter 5 Setting Environment Variables After installation and before installing the database schema, you must create the environment variables identified in the following table. To set the environment variables: Choose one of the following: n Add each variable to your profile using the command in the table. n Enter the information on the command line each time you start an executable.
Chapter 6 Uninstalling New Era of Networks Adapter for Flat Files This chapter describes how to uninstall a previous version of New Era of Networks Adapter for Flat Files from a Windows, Solaris, HP-UX, or AIX server.
Chapter 6 Uninstalling from a Windows Server Before uninstalling New Era of Networks Adapter for Flat Files, you must manually delete all user files. The InstallShield wizard removes only the files and directories that were put there by the InstallShield. To uninstall New Era of Networks Adapter for Flat Files components on Windows 1. From the Windows Control Panel, choose Add/Remove Programs. 2. Select the Install/Uninstall tab. 3. Scroll down and select New Era of Networks Component Installer. 4.
Uninstalling New Era of Networks Adapter for Flat Files n Modify - select some or all of the parts of the selected component to uninstall. n Repair - reinstall the selected program components. n Remove - uninstall the selected program components. The default method is Modify. b. Select Remove to delete all of the selected components and click Next. c. Click OK on the confirmation prompt to completely remove the selected application and all of its components. d.
Chapter 6 Uninstalling from Solaris To uninstall New Era of Networks Adapter for Flat Files from Solaris: 1. Login as root. 2. Use one of the following methods to view all software that is installed on your machine: n At the command prompt, type pkginfo and press Enter. n At the command prompt, type pkgrm and press Enter. NOTES: If you have multiple New Era of Networks products installed on your machine, the Component Installer displays all the products.
Uninstalling New Era of Networks Adapter for Flat Files Uninstalling from HP-UX To uninstall New Era of Networks Adapter for Flat Files from HP-UX: 1. Log on as root. 2. Type swremove. The SD Remove Software Selection window appears. NOTES: If you have multiple New Era of Networks products installed on your machine, the Component Installer displays all the products. Select All allows maintenance on New Era of Networks Adapter for Flat Files and any other New Era of Networks component listed.
Chapter 6 Uninstalling from AIX To uninstall New Era of Networks Adapter for Flat Files from AIX: 1. Log on as root. 2. Type smit. The main SMIT window appears. 3. From the SMIT window, choose Software Installation and Maintenance. 4. Choose Software Maintenance & Utilities→Remove Installed Software. The Remove Installed Software window appears.
Uninstalling New Era of Networks Adapter for Flat Files After the uninstall is complete, remarks are displayed in the output section of the Remove Installed Software window. You can scroll to view remarks for all of the software removed. To exit this window, click Done, and then Cancel. TIP: Multiple packages can be removed simultaneously. In the Name of Software field, either type each package (separated by a space) that you want to remove or use the List option to select the packages.
Chapter 6 38 New Era of Networks Adapter for Flat Files Installation Guide
Glossary abend Acronym for abnormal end. More commonly known as a crash. accelerator keys A combination of keystrokes that bypasses the menu system to carry out an action. action An action defines a function to perform in a subscription. The Reformat and Put Message actions are predefined and the user can provide generic actions as well. An action must contain at least one option name-value pair.
structures, and functions that can be used by an application program to invoke New Era of Networks Rules, Formatter, and Messaging services. Plural: APIs. argument In the New Era of Networks Rules GUI, an argument is evaluation criteria made up of fields from a message and associated operators. ASCII Abbreviation for American Standard Code for Information Interchange. asynchronous In electronic messaging, a method of operation in which receiving applications are loosely coupled and independent.
Glossary get A request for the next message in a queue. Compare to put. GUI Abbreviation for graphical user interface. heterogeneous Composed of different parts of different kinds. Having dissimilar constituents. hex Hexadecimal means 16. The base 16 numbering system is used to represent binary numbers. literal One or more symbols or letters in data that represents itself.
protocol A set of rules that govern the transmission and reception of data. put A request to store a message in a queue. Compare to get. regular expression Strings which express rules for string pattern matching. rule A rule is uniquely defined by its application group, message type, and rule name. It contains evaluation criteria (a rules expression) and is associated with subscriptions to perform if the rule evaluates to true. Rules also have permissions that determine user access.
Glossary transaction An activity or request. Additions, changes, and deletions are typical transactions stored in a computer. transaction management A method of handling electronic messaging such that only committed messages are sent and only messages received and committed are considered delivered. transaction processing A method of handling computer operations in which the operations take place immediately upon receipt of the processing request. Also called real-time or online system.
44 New Era of Networks Adapter for Flat Files Installation Guide
Index A AIX installing New Era of Networks Adapter for Flat Files 27 setting product environment variables 30 starting installp 28 uninstalling e-ADK 36 on Windows 2000 9 on Windows NT 9 installp 28 integration servers 3 L LD_LIBRARY_PATH 16, 23 C chapter organization 2 M D memory requirements 4 MQSI 2.0.
software requirements 14 uninstalling e-ADK 34 Solaris installation 13 SparcWorks 4 supported platforms 4 system variables 16, 23 U uninstalling e-ADK from AIX 36 from Solaris 34 uninstalling New Era of Networks Adapter for Flat Files from HP-UX 35 from Windows 32 W Windows uninstalling New Era of Networks Adapter for Flat Files 32 Windows 2000 installing New Era of Networks Adapter for Flat Files 9 Windows Installation preparing for 8 Windows NT installing New Era of Networks Adapter for Flat Files 9 se
