
	Version 8.0	SEARCH CONTENTS \| PDF PAGE PDF BOOKS \| HOME UP PREV NEXT

— Release Notes —

EntireX Prerequisites

This document describes the product prerequisites for the following EntireX platforms:

z/OS Prerequisites
UNIX Prerequisites
Windows Prerequisites
DCOM Supplementary Table
OS/400 Prerequisites
z/VM Prerequisites
Application Server Prerequisites

Note:
Software AG supports third-party technology, for example operating system versions, products or functionality, only for as long as this technology is officially supported by the third-party vendor.

z/OS Prerequisites

Note:
z/OS 1.8 or higher is required for all components.

Component	Prerequisites
Broker Kernel	Transport options: TCP-based communications: IBM TCP Stack SSL-based communications: IBM GSK NET-based communications: Entire Net-Work. See note below.
Attach Manager	Transport options: TCP-based communications: IBM TCP Stack NET-based communications: Entire Net-Work. See note below. The attach services supplied with Broker Services are still supported in this version but will be replaced in the future.
Broker Stubs	Transport options: TCP-based communications: IBM TCP Stack SSL-based communications: IBM GSK NET-based communications: Entire Net-Work. See note below. Lowest supported applications environment versions: For CICS applications: CICS TS 2.3 For IMS-based applications: IMS 8 For Com-plete based applications: Com-plete 6.5 For Natural-based applications: NAT 4.2
CICS RPC Server	If you are using transport method NET: Adabas Cross-Memory Services. See Installing Adabas Components for EntireX in the EntireX installation documentation for z/OS. If you are using transport method SSL: Relay Manager must be installed, see Relay Manager in the Adminstration section. Optional: IBM LE compilers for z/OS.
Batch RPC Server	If NET transport is to be used with the Broker stub used by the Batch RPC Server, Adabas Cross-Memory Services are required. See Installing Adabas Components for EntireX in the EntireX installation documentation for z/OS. If you are using NET, see note below. Optional: IBM LE compilers for z/OS.
IMS RPC Server	IMS version 8 or above. If NET transport is to be used with the Broker stub used by the IMS RPC Server, Adabas Cross-Memory Services are required. See Installing Adabas Components for EntireX in the EntireX installation documentation for z/OS. If you are using NET, see note below. Optional: IBM LE compilers for z/OS.
EntireX Security	SAF-compatible security system for host z/OS compatible Broker kernel: Resource classes/types and profiles as required by the installed security system. This can require a machine IPL in the case of RACF. Optional: Trusted User ID. See section Trusted User ID. With version 7.4.3 or higher of ADASVC module, all prerequisites are delivered with the EntireX installation kit. Note: If you are using the trusted SAF user ID feature with the CICS TP monitor, set ADAGSET macro parameter SAF=YES when installing the Adabas/CICS link module.
Relay Manager	Lowest supported applications environment versions: For CICS applications: CICS TS 2.3 For IMS-based applications: IMS 8
COBOL Wrapper	To compile the applications generated by the EntireX Workbench component COBOL Wrapper: Compiler supported by the COBOL Wrapper: standard COBOL compiler e.g. IBM Enterprise COBOL for z/OS 3.3.1.
PL/I Wrapper	To compile the applications generated by the EntireX Workbench component PL/I Wrapper: Compiler supported by the PL/I Wrapper: PL/I for MVS & VM V1R1.1, Enterprise PL/I for z/OS and OS/390 V3R3.

Additional Notes for z/OS

Entire Net-Work
- EntireX works with any supported version of Entire Net-Work. We recommend you use the latest version, which for z/OS is currently 6.1. The Adabas version we recommend is 8.1.
- Adabas Cross-Memory Services are required if you are using NET transport or using Adabas as your persistent store. See Installing Adabas Components for EntireX in the EntireX installation documentation for z/OS.

UNIX Prerequisites

Component	Prerequisites
Broker Agent	Java 1.4, Java 1.5 or Java 1.6.
Broker Kernel	Supported transports: SSL and/or TCP/IP.
Broker Stubs	For Location Transparency with LDAP, an LDAP server must be available. (This is not provided with EntireX.) See note below and Configuration of an LDAP Server.
Broker Trace Utility	Java 1.4, Java 1.5 or Java 1.6.
C Wrapper	ANSI C Compiler
COBOL Wrapper	Compiler supported by the COBOL Wrapper. See prerequisites for z/OS or OS/400.
EntireX Workbench	Java 1.4.2, Java 1.5 or Java 1.6. Eclipse SDK 3.3.
EJB Wrapper	Java 1.4, Java 1.5 or Java 1.6. J2EE 1.4 (JBoss, BEA WebLogic, Sun Java System, IBM WebSphere or others) Ant 1.6.1 XDoclet 1.2.1
Java ACI	Java 1.4, Java 1.5 or Java 1.6. If you are using SSL, see SSL Support for Java for details. If you are using Location Transparency, see note below.
Java RPC Runtime, Java RPC Server	Java 1.4, Java 1.5 or Java 1.6. If you are using Location Transparency, see note below. If you are using SSL, see SSL Support for Java for details.
Java Wrapper	Java 1.4, Java 1.5 or Java 1.6.
PL/I Wrapper	Compiler supported by the PL/I Wrapper. See prerequisites for z/OS.
System Management Hub Agents	Java 1.4, Java 1.5 or Java 1.6. Apache web server (optional)
Broker HTTP(S) Agent (formerly Tunnel Servlet)	Java 1.4, Java 1.5 or Java 1.6.
EntireX XML/SOAP Listener (formerly XML Servlet), entirex.war	Java 1.4, Java 1.5 or Java 1.6. Servlet Engine supporting Java Servlet API 2.2 or higher. JAXP-capable XML Parser (SAX). If you are using Location Transparency, see note below. If you are using SSL, see SSL Support for Java for details.
XML/SOAP Wrapper, Web Services Wrapper	Java 1.4, Java 1.5 or Java 1.6. JAXP-capable XML Parser (SAX).
XML/SOAP Wrapper Runtime, XML/SOAP RPC Server	Java 1.4, Java 1.5 or Java 1.6. JAXP-capable XML Parser (SAX). If you are using Location Transparency, see note below. If you are using SSL, see SSL Support for Java for details.

The products listed here have been thoroughly tested and are known to work. In most cases, more recent versions of the required components should also work.

Additional Notes for UNIX

Entire Net-Work
Entire Net-Work is no longer supported as transport method under UNIX. We recommend you use transport method TCP/IP.
Location Transparency with Java Components
- Java 1.4, Java 1.5 or Java 1.6.
- LDAP server must be available (this is not provided with EntireX).
  
  Under Solaris, LDAP version 11.8 or higher is prerequisite when using LDAP.
See Configuration of an LDAP Server.
It is strongly recommended to install the latest operating system and compiler patches.

Additional Notes for Linux x86

Please note that IBM Java or the GCJ Java should not be used with our products for Linux x86 platforms. Use only Sun or Blackdown Java for our products on Linux x86. (Our products only support IBM Java on AIX and Linux for IBM zSeries).

We recommend you install the highest update packages available for Linux. On Red Hat Enterprise Linux AS 4 you must have a minimum of U3 (Update 3) installed, otherwise you will have serious problems during installation. On Red Hat Enterprise Linux AS 4, the package compat-libstdc++-33-3.2.3-47.3 (or a higher version) must be installed.

This installation will fail if you choose sudo authentication while there is option Defaults env_reset in the sudo configuration file (/etc/sudoers). If you insist on sudo option Defaults env_reset, then you must either run this installation as user root or you choose su authentication during installation.

If the system is configured to run in parallel boot mode, the installed rc scripts will not work by default. To work around this problem on SUSE Enterprise Server, simply set RUN_PARALLEL=no in file /etc/sysconfig/boot.

Hardware and Storage Requirements

The following list represents the minimum hardware required to run EntireX. EntireX might also run on machines with smaller configurations, but performance issues may arise. Please contact your customer support organization to determine the exact hardware requirements for your specific installation.

Single processor machine (recommended 2 or more processors) running at 1 GHz or higher.
512 MB of RAM, 1024 recommended. Monitor running at a resolution of 1024 x 768 or higher.
The full installation of EntireX and all necessary third party products, including backup directories created during a patch installation, requires a minimum of 800 MB (Linux). Under Solaris, where neither Eclipse nor JRE is installed, the minimum is 400 MB.
10/100 PCI Ethernet card on a 100 Mbps network.
A DVD drive to install the software.

Windows Prerequisites

Component	Prerequisites
Broker ActiveX Control	To store Tamino or XML files: Internet Explorer 5 or higher Tamino 4.2.1 or higher.
Broker Agent	Java 1.4, Java 1.5 or Java 1.6.
Broker Kernel	Supported transport methods: SSL and/or TCP/IP.
Broker Stubs	Supported transport methods: SSL and/or TCP/IP. For Location Transparency with LDAP, an LDAP server must be available. (This is not provided with EntireX.) See Configuration of an LDAP Server.
Broker Trace Utility	Java 1.4, Java 1.5 or Java 1.6.
C Wrapper	ANSI C Compiler.
COBOL Wrapper	Compiler supported by the COBOL Wrapper. See prerequisites for z/OS or OS/400.
DCOM Examples	C++ Compiler from Microsoft Visual Studio .NET 2005.
DCOM Wrapper	C++ Compiler from Microsoft Visual Studio .NET 2005 or Microsoft Visual Studio 2005.
DCOM Wrapper (generated interface objects)	Microsoft Visual Studio .NET 2005 C/C++ runtime environment.
DCOM Wrapper and .NET Wrapper Plug-ins for Microsoft Visual Studio	Microsoft Visual Studio 2005
EntireX Workbench	Java 1.4.2, Java 1.5 or Java 1.6. Eclipse SDK 3.3.
Java ACI	Java 1.4, Java 1.5 or Java 1.6. If you are using Location Transparency, see note below: If you are using SSL, see SSL Support for Java for details.
Java RPC Runtime, Java RPC Server	Java 1.4, Java 1.5 or Java 1.6. If you are using Location Transparency, see note below: If you are using SSL, see SSL Support for Java for details.
.NET ACI	.NET Framework version 2.0.
.NET Wrapper	.NET Framework 2.0. C# Compiler from Microsoft Visual Studio 2005.
EJB Wrapper	Java 1.4, Java 1.5 or Java 1.6. J2EE 1.4 (JBoss, BEA WebLogic, Sun Java System, IBM WebSphere or others). Ant 1.6.1. XDoclet 1.2.1.
Java Wrapper	Java 1.4, Java 1.5 or Java 1.6.
IDL Extractor for Natural	A Natural RPC server for the respective platform must be available. If you are using a Natural RPC Server under OS/400 the following is required: The Natural RPC Server must be prepared to work together with the IDL Extractor for Natural see Natural RPC Server Configuration for the IDL Extractor for Natural.
PL/I Wrapper	Compiler supported by the PL/I Wrapper. See prerequisites for z/OS.
System Management Hub Agents	Internet Explorer 6 or 7 or above, or Mozilla version 2.
Broker HTTP(S) Agent (formerly Tunnel Servlet)	Java 1.4, Java 1.5 or Java 1.6.
Web Services Examples	Microsoft .NET Framework 2.0. C# and Visual Basic Compilers from Microsoft Visual Studio 2005. Java 1.4 or higher.
EntireX XML/SOAP Listener (formerly XML Servlet), entirex.war	Java 1.4, Java 1.5 or Java 1.6. Servlet Engine supporting Java Servlet API 2.2 or higher. JAXP-capable XML Parser (SAX). If you are using Location Transparency, see note below. If you are using SSL, see SSL Support for Java for details.
XML/SOAP Wrapper, Web Services Wrapper	Java 1.4, Java 1.5 or Java 1.6. JAXP-capable XML Parser (SAX).
XML/SOAP Wrapper Runtime, XML/SOAP RPC Server	Java 1.4, Java 1.5 or Java 1.6. JAXP-capable XML Parser (SAX). If you are using Location Transparency, see note below. If you are using SSL, see SSL Support for Java for details.

The products listed above have been thoroughly tested and are known to work. In most cases, more recent versions of the required components should also work.

Additional Notes for Windows

Entire Net-Work
Entire Net-Work is no longer supported as transport method under Windows. We recommend you use transport method TCP/IP.
EntireX DCOM
- To interoperate with DCOM under Windows, the prerequisite is Windows 2003 or Windows XP.
- EntireX DCOM currently supports only one remote transport protocol, TCP/IP. Windows supports additional protocols. The order in which Windows initializes RPC transports is specified in the registry under the value HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Rpc\DCOM Protocols.
- In order to prevent Windows wasting time trying to initialize RPC transports not supported by EntireX DCOM, you should specify TCP/IP as the first transport to try. To do this, use regedt32 to place ncacn_ip_tcp at the first position in the string value for DCOM Protocols.
Location Transparency with Java Components
- Java 1.4, Java 1.5 or Java 1.6.
- LDAP server must be available (this is not provided with EntireX).
See Configuration of an LDAP Server for Windows.

Hardware and Storage Requirements

Single processor machine running at 500 MHz or higher, 1 GHz recommended.
512 MB of RAM, 1024 recommended.
Monitor running at a resolution of 1024 x 768 or higher.
The full installation of EntireX and all necessary third party products, including backup directories created during a patch installation, require a minimum of 800 MB. The Eclipse Workbench standalone package requires a minimum of 300 MB.
A DVD drive to install the software.

DCOM Supplementary Table

Software Requirements

Platform	Runtime	Runtime + SDK
Linux	SUSE Linux Enterprise Server 10 for x86 (32-bit) Red Hat Enterprise Linux AS 4 and 5 for x86 (32-bit)	gcc 3.3, binutils 2.14, glibc 2.3.2 or higher, or gcc 4.1
Solaris	Sun Solaris 9 and 10 for SPARC-V9 (64-bit)	Sun WorkShop C Compiler 5.8, Sun WorkShop C++ Compiler 5.8

The table above lists configurations that have been thoroughly tested and are known to work. In most cases, more recent versions of the various components required should also work. Please check the platform vendors' internet pages for further information on versions and patches available.

OS/400 Prerequisites

Component	Prerequisites
Broker Stubs	OS/400 with operating system V6R1M0 or above. Controller that supports TCP/IP protocol. Any OS/400 ILE-enabled programming language. TCP/IP connection to an EntireX Broker kernel on a Windows, z/OS or UNIX platform. About 16 MB of disk space for the Broker stub installation and about 50 MB for the RPC server installation. Each process that includes the Broker stub occupies one additional MB of virtual memory.
COBOL Wrapper	To compile the applications generated by the EntireX Workbench component COBOL Wrapper: standard COBOL compiler defined by the operating system.

Component

Prerequisites

Broker Stubs

OS/400 with operating system V6R1M0 or above.
Controller that supports TCP/IP protocol.
Any OS/400 ILE-enabled programming language.
TCP/IP connection to an EntireX Broker kernel on a Windows, z/OS or UNIX platform.
About 16 MB of disk space for the Broker stub installation and about 50 MB for the RPC server installation.
Each process that includes the Broker stub occupies one additional MB of virtual memory.

COBOL Wrapper

To compile the applications generated by the EntireX Workbench component COBOL Wrapper: standard COBOL compiler defined by the operating system.

z/VM Prerequisites

Component	Prerequisites
Broker Stubs	Supported z/VM Version z/VM version 5.2 or above. Adabas Version Adabas version 7.4.4 or above and Entire Net-Work 5.9.1 or above. Note: Maximum message size with NET transport when using the Broker stub under z/VM is 32 KB. Virtual Storage The z/VM Broker stub runs within an IBM Language Environment enclave. This means that if the calling program is not an IBM Language Environment, program an enclave will be automatically created, invisible to the application. However you must allow sufficient virtural storage to allow the Language Environment enclave to be created. A storage size of 16 MB is recommended. ESIZE When using SYSETB under z/VM you must allow sufficient ESIZE. We recommend setting ESIZE=64 KB.

Component

Prerequisites

Broker Stubs

Supported z/VM Version
z/VM version 5.2 or above.
Adabas Version
Adabas version 7.4.4 or above and Entire Net-Work 5.9.1 or above.

Note:
Maximum message size with NET transport when using the Broker stub under z/VM is 32 KB.
Virtual Storage
The z/VM Broker stub runs within an IBM Language Environment enclave. This means that if the calling program is not an IBM Language Environment, program an enclave will be automatically created, invisible to the application. However you must allow sufficient virtural storage to allow the Language Environment enclave to be created. A storage size of 16 MB is recommended.
ESIZE
When using SYSETB under z/VM you must allow sufficient ESIZE. We recommend setting ESIZE=64 KB.

Application Server Prerequisites

The web application components of EntireX (XML/SOAP Listener, XML/SOAP Runtime, EJB Wrapper runtime) are J2EE 1.4.2 compliant. They should therefore run on any Java application server that is J2EE 1.4.2 compliant. The EntireX components have been tested and are supported on the following application servers:

Application Server	Platform
Application Server	Windows	Solaris	Linux	AIX	HP-UX	z/Linux
BEA WebLogic 10	x	x	x		x
IBM WebSphere 6.1	x			x	x	x
JBoss 4.2 or higher	x		x
Tomcat 5.5	x	x	x	x	x	x

SEARCH CONTENTS | PDF PAGE PDF BOOKS | HOME UP PREV NEXT