Under UNIX and Windows, EntireX is now installed using the Software AG Installer, which you download from the Software AG Empower website at Empower. You can view the documentation for the Software AG Installer under http://documentation.softwareag.com > webMethods Product Line > webMethods Product Suite 9.9 > System Requirements, Installation, and Upgrade.
This document assumes you have already installed EntireX using the Software AG Installer. It covers installation instructions for components not included in the Software AG Installer; instruction on how to verify the installation and set up EntireX Security. It covers the following topics:
Note:
The functionality provided by the EntireX Mini Runtime of EntireX version 9.7 and below is now delivered as a separate component
under > >
in the Software AG Installer. See Software AG documentation Installing Software AG Products.
After installation you will find the files at the following location:
| Windows 32-bit | <inst_root>\common\EntireX\exx_32\bin |
| Windows 64-bit | <inst_root>\common\EntireX\exx_32\bin (for the 32-bit versions) and |
| <inst_root>\common\EntireX\exx_64\bin (for the 64-bit versions) |
If check box Turn on Autostart for default EntireX Broker is checked, the installation starts the default broker ETB001. This broker instance listens on the TCP/IP and SSL ports defined in the custom panel during installation. Default port numbers are 1971 (TCP/IP) and 1958 (SSL).
To change the default port of the default broker
Stop the broker, using one of the following methods:
Use System Management Hub. See Stopping a Local Broker.
Use the Windows start menu entry .
Edit the configuration file config/entirex.configand change the TCP/IP and SSL port numbers to a different value. For other broker instances, see PORT under Broker Attributes.
Start the broker, using one of the following methods:
Use System Management Hub. See Starting a Local Broker.
Use the Windows start menu entry .
The broker service etbsrv.exe must be active on every machine where a broker instance is running. The installation procedure installs it with startup type "automatic" and with status type "started". etbsrv.exe is in the bin subdirectory of the EntireX installation directory.
The Administration Service is started or stopped by the broker service etbsrv.
When the broker has been started successfully, the Administration Service waits for messages from other started brokers. This wait period lasts around 90 seconds.
After this wait period, all brokers are started that have an Autostart value of "yes" that have not already started.
When the Administration Service is restarted, it takes a maximum of 90 seconds until the current system status is displayed correctly.
Eclipse is an optional component of EntireX. For EntireX Workbench, it is required.
If you have not already installed Eclipse at your site, you can install Eclipse and the EntireX Workbench from the installation medium. If you wish to install the EntireX Workbench into an existing Eclipse environment, use the Eclipse update mechanism to deploy the EntireX feature.
When you migrate from one EntireX version to a higher version you have to change the license file setting to the new license file.
To set a new license file
Go to the Preference pages in Eclipse () and select the page .
If you want to install the Workbench plug-ins in standalone mode, that is, not as part of the full webMethods EntireX installation, see Installing the EntireX Workbench Plug-ins in Standalone Mode.
To verify successful installation, you can use the
etbinfo utility. It queries the Broker for information
as described below.
If you have not already created a default Broker, create one using System Management Hub. See Creating a Local Broker.
Start the Broker using SMH.
Run etbinfo to get back a response from the
broker. Start a Command Prompt session, change your directory to the EntireX
bin directory, for example
C:\SoftwareAG\EntireX\bin, and use the following
command:
etbinfo -blocalhost -dBROKER -pbroker.pro
This assumes that you use the default port 1971. Otherwise use the command:
etbinfo -blocalhost:port -dBROKER -pbroker.pro
where port is the port number of your broker.
This should display a simple formatted report with information about the broker.
This section covers the following topics:
Note:
You must set up EntireX Security for broker kernel and - if your
application(s) use API version 7 or below - also for broker stubs.
To set up EntireX Security for broker kernel under Windows
Determine that all prerequisites for EntireX components have been met before setting up EntireX Security. See Windows Prerequisites.
Insert the following statement into the broker-specific section of the attribute file. See Broker-specific Attributes under Broker Attributes.
SECURITY=YES
Modify the security-specific section of the broker attribute file according to your requirements. See Security-specific Attributes under Broker Attributes. These parameters are used to determine whether you will use Windows local security or LDAP-based authentication. If you are using LDAP-based authentication, authorization rules are not available to you.
Note:
Authentication: Windows authentication calls LogonUser() with the
flag LOGON32_LOGON_INTERACTIVE.
Note:
If you are running your application(s) at ACI version 7 or below, the
following steps are required to install EntireX Security for the Broker
stubs in all environments where applications execute either as clients or
servers. See List of Components per Platform for where
EntireX Security for broker stubs is supported.
These steps are
not required if you are running your application(s) at ACI version 8 or above.
To install EntireX Security for broker stubs on Windows
When requested to specify the installation type, choose Custom and check the Security box.
(The required directories including secuexit.dll are copied to your computer during installation.)
Notes:
 |
Warning: If stub tracing level is > 1, unencrypted contents of the send/receive buffers are exposed in the trace. |
Installation of EntireX Security for Broker stubs is now complete. Now you can install the security components for the Broker stubs on the remaining operating systems where your application components are located.
If you need the EntireX Mini Runtime with your application, extend the PATH variable to <inst_root>\EntireX\bin before starting your application.
To install the Tutorial
Load all objects of SYSETB.TRA in the ETC subdirectory, using the Natural utility SYSOBJH. See Object Handler in the Natural Tools and Utilities documentation for more information.
Logon to Natural library SYSETB and issue the CATALL command to catalog all the programs in the library.
Before you can use the Broker ActiveX Control (file ebx.dll) and/or the TOR Editor (file toredit.exe) you have to register the Broker ActiveX Control as a COM component. Start the program regsvr32 with "Run as Administrator":
regsvr32 <path>\ebx.dll
On a Windows 32-bit operating system, files ebx.dll and toredit.exe are located in the Entirex\bin directory of the installation.
On a Windows 64-bit operating system, files ebx.dll and toredit.exe are located in the Entirex\bin\x86 directory of the installation.
Note:
Only program ebx.dll needs to be registered as a COM component.