In this section: |
|
Some iWay adapters require additional steps or files before they can be used. Your adapter may not be available and may not appear in iWay Explorer until these steps are performed. In many cases, this involves copying third-party libraries or JDBC drivers into the iWay \lib directory, for example:
C:\Program Files\iway7\lib
After performing the steps for your adapter, you will need to restart Service Manager if it is currently running. If you deploy components to an application server, you will need to restart the application server.
Note: This document sometimes lists the actual names of required files rather than the generic name of the driver or library. However, your vendor may change file names, update files, or have different versions of the drivers for different releases. Therefore, confirm which files are required by reviewing information provided by your vendor. Ensure that you use the latest version of the driver for the correct release of your target system, data source, or protocol.
Review the topics that follow. If you do not see your adapter listed, check the iWay website or contact a Customer Service representative.
Access to the following legacy mainframe data sources is provided through an iWay (EDA) Full-Function Server component that must be installed and configured on the mainframe.
Access to and from these data sources are accomplished by first connecting to the iWay Server. Adapters for other legacy data sources do not require an iWay Server.
To configure legacy data adapters for use with iWay 7.0.7 SM:
For information on iWay Server installation and configuration, see the WebFOCUS and iWay Server Installation manual and refer to the Server for z/OS chapter.
For information on adding stored procedures, see the iWay Catalog Administrator manual.
The iWay Adapter for Connect Direct requires the following library files:
The CDJAI.jar library file is used to implement Java APIs.
This section provides the supported versions and required library files for the iWay Technology Adapter for ESRI (GEOLoad).
Note: The iWay Technology Adapter for ESRI (GEOLoad) is supported only on Windows platforms.
Supported Versions
Note: ArcSDE is a part of ArcGIS in Version 9.2 and 9.3. However, ArcSDE is still only supported through the ArcSDE API. It is not supported through any other API, including ArcObjects.
Required Library Files
ArcSDE Version 9.0 (For ESRILOAD):
Copy these files into the iWay \lib directory, for example:
C:\Program Files\iway7\lib
ArcSDE Version 9.2 (For ESRILOAD):
Copy these files into the iWay \lib directory, for example:
C:\Program Files\iway7\lib
ArcSDE Version 9.3 (For ESRILOAD):
Copy these files into the iWay \lib directory, for example:
C:\Program Files\iway7\lib
GDT Matchmaker Version 6 (For Geocoding):
On Windows platforms, these files must be copied into the system32 directory, for example:
C:\WINNT\system32
or
C:\WINDOWS\system32
The iWay Integration Solution for FIX requires the B2BITS® FIX Engine.
The B2BITS® FIX Engine is packaged as an archive (B2Bits_jar.zip) and can be downloaded from:
http://techsupport.informationbuilders.com/
For more information on installing the B2BITS® FIX Engine and configuring the iWay Integration Solution for FIX, see the iWay Integration Solution for FIX User’s Guide.
J.D. Edwards EnterpriseOne (OneWorld) Java-based ThinNet API is required. This is normally distributed as JAR files with the J.D. Edwards installation media. These files may vary depending on the J.D. Edwards release. They usually consist of the following:
For J.D. Edwards OneWorld B7333 (XE) and B7334 (ERP8):
Kernel.jar
Connector.jar
For EnterpriseOne 8.10:
Kernel.jar
Connector.jar
jdeutil.jar
log4j.jar
For EnterpriseOne 8.11:
Base_JAR.jar
JdeNet_JAR.jar
System_JAR.jar
Connector.jar
log4j.jar
For EnterpriseOne 8.12 (Tools Release 8.96.2.0):
Base_JAR.jar
JdeNet_JAR.jar
System_JAR.jar
Connector.jar
EventProcessor_EJB.jar
EventProcessor_JAR.jar
log4j.jar
For EnterpriseOne 8.12 (Tools Release 8.97.1.2 and 8.97.2.0):
Base_JAR.jar
JdeNet_JAR.jar
System_JAR.jar
Connector.jar
EventProcessor_EJB.jar
EventProcessor_JAR.jar
commons-httpclient-3.0.jar
jmxri.jar
ManagementAgent_JAR.jar
log4j.jar
For EnterpriseOne 9.0 (Tools Release 8.98):
Base_JAR.jar
JdeNet_JAR.jar
System_JAR.jar
Connector.jar
EventProcessor_EJB.jar
EventProcessor_JAR.jar
commons-httpclient-3.0.jar
jmxri.jar
jmxremote_optional.jar
ManagementAgent_JAR.jar
log4j.jar
For EnterpriseOne 9.10 (Tools Release 9.1.0.4):
Base_JAR.jar
JdeNet_JAR.jar
System_JAR.jar
Connector.jar
EventProcessor_EJB.jar
EventProcessor_JAR.jar
commons-httpclient-3.0.jar
jmxremote.jar
commons-logging.jar
jmxri.jar
jmxremote_optional.jar
ManagementAgent_JAR.jar
log4j.jar
Note: These files are located in the \\system\classes folder on the JDE Client and the Deployment Server.
You must copy the JAR files into the iWay \lib directory, for example:
C:\Program Files\iway7\lib
The DB2/400 JDBC driver (jt400.jar) is required. Copy the driver into the iWay \lib directory, for example:
C:\Program Files\iway7\lib
Before installing iWay Application Protocol Adapter for LDAP, iWay Service Manager (iSM) Version 7.0 or higher must be installed on a system that is running Java 2 Standard Edition (J2SE™) JDK 1.7 or higher. For more information, see Installing iWay 7.0.7 Service Manager Components.
This section lists and describes the required installation files for iWay Application Protocol Adapter for LDAP.
The following file is required for the operation of the LDAP adapter, but is considered optional for a Java VM installation:
jdk_home\jre\lib\ext
where:
Is the root installation directory for your JDK. For example:
c:\jdk1.7.0_45\jre\lib\ext\dnsns.jar
The iWay Application Protocol Adapter for LDAP supports only Simple Bind and Transport (SSL) security. For more information about advanced LDAP security implementations, see the Java Cryptography Architecture Reference Guide on the following Oracle Java web site:
http://docs.oracle.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html
All required .jar library files for the iWay Application Adapter for Microsoft Dynamics 2011 CRM On-Premises are provided in the iWay \lib folder.
Note: The iWay Application Adapter for Microsoft Dynamics CRM (Compatibility Mode) cannot be used with Microsoft CRM 2013.
The iWay Technology Adapter for Microsoft .NET allows you to expose Microsoft .NET assemblies without requiring any additional custom attributes or wrapper code.
Microsoft .NET Versions 2.0 - 4.5 are supported by the adapter.
In iWay Service Manager (iSM) Version 7.0.7, the iWay Technology Adapter for Microsoft .NET supports 32- and 64-bit JVM environments. The required components for both environments are automatically installed. During the iSM installation process, ensure that Microsoft .NET is selected under the Technology Adapters category in the Adapter Selection pane.
The iSM installation process installs the following adapter components in the <ism_home>\lib directory:
Note: Both versions of the iwdotnet DLL file are shipped with the adapter. Depending on the JVM, the adapter will select the appropriate DLL file to load. A 64-bit JVM can load 32 - and 64-bit assemblies. A 32-bit JVM can only load 32-bit assemblies no matter the platform type (32 - or 64-bit).
The iWay Technology Adapter for Microsoft .NET installs the following sample .NET assemblies in the <ism_home>\etc\samples\dotnet\bin directory:
These Microsoft .NET assemblies can be used for adapter testing and verification purposes.
The iWay Application Adapter for mySAP ERP uses the SAP Java Connector (JCo) to communicate with SAP ABAP system targets. The following protocols and document styles are supported:
No other connection methods and interface types are supported.
The official supported platform for the iWay Application Adapter for mySAP ERP is SAP Java Connector (JCo) Version 3.nn for Java Version 1.7nn. In this section, nn refers to release specifications. For a list of supported platforms and exact library names, refer to SAP Note 1077727. Use the SAP note to ensure the JVM and the JCo are compatible for the selected hardware and software platform.
Not all SAP supported platforms are supported by iWay Service Manager. For more information, check the list of iWay supported platforms to ensure compatibility.
The SAP JCo library files must be downloaded from the SAP Service Marketplace. A valid SAP support ID is required to access the SAP Service Marketplace. For assistance, contact your SAP administrator. For more information on installing, configuring, and verifying the iWay Application Adapter for mySAP ERP, see the iWay Application Adapter for mySAP ERP User's Guide.
To install iWay Application Adapter for mySAP ERP (SAP JCo 3.0), ensure that MySAP JCO 30 is selected under the Application Adapters category in the Adapter Selection pane during the iSM installation process.
The iSM installation process automatically adds the iwmysap30.jar file to the <ism_home>\lib directory.
This section lists the SAP library files that are required by the iWay Application Adapter for mySAP ERP (SAP JCo 3.0).
Platform |
SAP Library Files |
---|---|
Windows |
|
Linux/Solaris/OS400 |
|
HP-UX |
|
AIX |
|
This section describes the specific directories where the library files must be copied for the iWay Application Adapter for mySAP ERP (SAP JCo 3.0).
Note: When the sapjco3.jar library file is added to the <ism_home>\lib folder, iWay Service Manager will automatically add this .jar file to the CLASSPATH environment variable at runtime.
The sapjco3.jar library file must always be added to the environment variable locating the system load library path, and must be the first entry in the list of library paths.
Windows
Copy the sapjco3.jar and sapjco3.dll library files to the following directory:
<ism_home>\lib
where:
Is the root installation directory where iSM is installed (for example, C:\Program Files\iway7).
The sapjco3.dll library file will be added to the PATH by iWay Service Manager at runtime if it is located in the <ism_home>\lib folder. Do not install this file into the Windows\System32 folder as this file is not compatible with other versions of the library file and may cause issues if an instance of SAP GUI or other program is found on the system.
Linux
Copy the sapjco3.jar and libsapjco3.so library files to the following directory:
<ism_home>/lib
where:
Is the root installation directory where iSM is installed (for example, /iway/install/iway7).
After installing the libsapjco3.so library file, this file must be added to the path indicated by the LD_LIBARARY_PATH environment variable and be the first library in the list.
HP-UX
Copy the sapjco3.jar and libsapjco3.sl library files to the following directory:
<ism_home>/lib
where:
Is the root installation directory where iSM is installed (for example, /iway/install/iway7).
After installing the libsapjco3.sl library file, this file must be added to the path indicated by the SHLIB_PATH environment variable and be the first library in the list.
AIX
Copy the sapjco3.jar and libsapjco3.so library files to the following directory:
<ism_home>/lib
where:
Is the root installation directory where iSM is installed (for example, /iway/install/iway7).
After installing the libsapjco3.so library file, this file must be added to the path indicated by the LIBPATH environment variable and be the first library in the list.
IBM iSeries
Consult SAP Note 1269638 on configuring the SAP JCo 3.0 on IBM iSeries. The default JVM provided cannot be used with JCo 3.0. SAP Note 1269638 has more information on this topic.
Solaris
There are different packages for different architectures (SPARC, X64, INTEL, or AMD 64 bit processor). Locate and install the correct package. Add the library file to the path indicated by the LD_LIBRARY_PATH environment variable and ensure the file is the first library in the list.
Oracle JDBC driver (ojdbc6.jar) is required by the iWay Application Adapter for Oracle E-Business Suite. You must copy this .JAR file into the iWay \lib directory, for example:
C:\Program Files\iway7\lib
To use iWay Concurrent Program request functionality, you must install and configure Oracle Client on the Oracle database that supports Oracle E-Business Suite.
Installing the iWay Oracle API Wrapper
If you want to use the iWay Application Adapter for Oracle E-Business Suite to interact with Oracle APIs (Stored Procedures and Packages), you must install the iWay Oracle API wrapper. For more information, see the iWay Application Adapter for Oracle E-Business Suite User’s Guide.
Installing the GETCLOB Procedure
The GETCLOB procedure must be installed under the schema the adapter uses to run Oracle APIs. For more information, see the iWay Application Adapter for Oracle E-Business Suite User’s Guide.
This section indicates which combination of releases and system platforms are supported for the iWay Application Adapter for PeopleSoft.
PeopleSoft Platform |
PeopleSoft Release |
PeopleTools Release Level |
---|---|---|
All PeopleSoft supported platforms (Windows, Solaris, AIX, Linux, and HP-UX). |
8.1 8.4 |
8.16.03 - 8.22 8.40.05 - 8.52 |
Note that the adapter goes by the PeopleTools release and not by the PeopleSoft application version.
Note: You must connect with only one version of an EIS at a given point in time. You cannot connect to two different versions of PeopleTools using the adapter. Do not use two versions of an EIS library file simultaneously. You also cannot use the library files for two different versions in the \lib folder.
Required Library Files
This section lists the library files that are required by the iWay Application Adapter for PeopleSoft.
This file provides a low-level interface between client applications and PeopleSoft. This file is provided with PeopleSoft in the <PeopleSoft_Home>\web\PSJOA directory. The psjoa.jar file is different for every version of PeopleSoft. When you upgrade your PeopleTools release, ensure that you copy the psjoa.jar file for the new release into the <iWAY_Home>\lib directory and restart all components.
This file is required for PeopleTools 8.1x. This file belongs in the <PeopleSoft_Home>\web\jmac directory.
For more information on generating the Component Interface Java APIs, see the iWay Application Adapter for PeopleSoft User's Guide.
All the library files for the PeopleSoft adapter must be copied to the specific directory, such as <iWAY_Home>\lib.
iWay Technology Adapter for RDBMS connects iSM to various database engines that have an available JDBC compliant driver from the database or third party vendor. Generally, the JDBC driver should match the database version as well as the version of the JVM that is hosting iSM. Database versions that have reached the end of their vendor supported lifecycle are no longer supported by iSM and the iWay Technology Adapter for RDBMS.
All JDBC drivers are installed in the \lib. For example:
iway7\lib
$IWAYHOME/lib
iSM requires a class 4 DB2 JDBC driver to access functionality database and data types. Currently, the following driver versions are required:
Note: Additional .jar files may be required depending on the specific environment.
The following .jar file is required when Oracle RAC is implemented:
The following .jar files are required when XMLType data types are used:
Mainstream support ended April 12, 2011 and extended support will end April 12, 2016. Contact Microsoft for JDBC driver information.
Extended support ended April 9, 2013.
The iWay Application Adapter for SAP R/3 using SAP JCo 2 is no longer supported. SAP has discontinued support for SAP JCo 2 and as a result, iWay cannot offer the adapter on unsupported versions of the JCo. For all SAP adapter installations, use the iWay Application Adapter for mySAP ERP instead. The installation instructions for mySAP ERP should be followed in any scenario that requires the SAP R/3 adapter. The mySAP ERP adapter will support SAP releases from SAP R/3 4.6C to SAP ERP 7.
For more information, see MySAP ERP (SAP Java Connector Version 3.x).
For Siebel Versions 6.3 - 8.1, Siebel Java Data Bean API is required. This is distributed as JAR files with the Siebel Thin Client.
Copy the required JAR files into the iWay \lib directory, for example:
C:\Program Files\iway7\lib
The required files vary by Siebel release in both content and name. Therefore, the Siebel Thin Client provided with the target Siebel system must always be used with the adapter, for example:
SiebelTcOM.jar SiebelTcCommon.jar SiebelTC_enu.jar SiebelDataBean.jar
SiebelJI_Common.jar SiebelJI_enu.jar
SiebelJI_Common.jar SiebelJI_enu.jar SiebelJI.jar
SiebelJI_enu.jar Siebel.jar
SiebelJI_enu.jar Siebel.jar
The Siebel COM-based API (Windows only) requires the Siebel Thin Client to be installed and accessible to the adapter.
The following files are for English language implementations:
SiebelTC_enu.jar SiebelJI_enu.jar
For non-English installations, the last three letters (_enu) vary.
Siebel Version 6.2 and Lower Connectivity Prerequisites
You must perform additional steps to connect to a Siebel system (version 6.2 and lower) using COM connectivity for an iBSP configuration. For more information, see the iWay Application Adapter for Siebel User's Guide.
Configuring Connection Pooling for Siebel
To configure connection pooling for Siebel, you must create a siebel.properties file for use with the iWay Application Adapter for Siebel. For more information on how to configure the siebel.properties file, see the iWay Application Adapter for Siebel User's Guide.
The iWay Emulation Adapter (3270/5250) links new business applications to mainframe-based business logic through IBM 3270 and 5250 terminal screens and data streams. It enables you to transform your 3270 or 5250 mainframe screens into HTML pages or to create a remote procedure request (RPC) to transform the output of screens into an answer set. The adapter provides a simple, lightweight, and scalable way to reuse the business logic and data of terminal applications.
The iWay Emulation Adapter (3270/5250) requires client components that you must configure after installing iWay. The two client components are:
The iWay Emulation Adapter (3270/5250) includes the Telnet Designer, which is a tool to create screen-based interactions that can run with the adapter. The Telnet Designer is supported on Windows platforms only.
If the adapter is installed on a UNIX platform, then you will need to copy the Telnet Designer component, in binary format, from the UNIX system to the Windows system.
For information about using the adapter, including the Telnet Designer, see the iWay Emulation Adapter (3270/5250) User's Guide.
The following file is required.
tibrvj.jar
Copy this file into the iWay \lib directory, for example:
C:\Program Files\iway7\lib
In addition to the Java file, tibrvj.jar, the iWay Adapter for TIBCO requires several TIBCO binary files. These files are stored in the following TIBCO directory:
C:\tibco\tibrv\bin
This directory must be added to the search PATH variable of any user ID that runs iWay components.
iWay Software |