EntireX can also be installed using Command Central instead of the Software AG Installer.
The installation itself is described in the separate Command Central product documentation, also available under Cross-Product Guides on the Software AG documentation website. The key sections are Creating and Updating Product and Fix Repositories (if you have not already done so) and Working with Standalone Product Installations > Install Products.
This document provides EntireX-specific information and describes the post-installation configuration steps that are required.
See also Template-based Provisioning.
When installing EntireX using Command Central, no parameters can be specified. This means:
The installation does not demand a license file. Copy a valid EntireX license file after installation as described below.
The Administration Service/Daemon is started automatically when the installation is finished. Free TCP and SSL ports are determined automatically by the installation. You can modify these ports after installation as described below.
The number of the TCP/IP port for the Application Monitoring Data Collector is set to 57900 (same default as standard installation) and the autostart option is not set.
The default broker ETB001 is created, but the autostart option is not set. This means it is not started automatically when the installation is finished. Free TCP and SSL ports are determined automatically by the installation. You can modify these ports after installation as described below.
To configure EntireX after installation with Command Central
Depending on the EntireX components installed, perform the following steps as required:
Provide a valid license file, using one of the methods below. This step is mandatory.
Copy a valid EntireX license file to directory <inst_root>/EntireX/config and rename to license.xml if necessary.
or
Register a license file with the License File Manager of Command Central, using the following steps:
Go to
and add a license file.Go to
and select the installation you have just installed.Go to Instances and select any EntireX instance, e.g. EntireX Broker ETB001.
Go to
and specify the license you registered previously.The selected license file will be copied automatically to <inst_root>/EntireX/config/license.xml.
You can modify the port numbers for Broker Administration Service/Daemon and Default Broker in file <inst_root>/EntireX/config/entirex.config:
TCP port for Broker Administration Service/Daemon: property entirex.etbadm.tcp.port
SSL port for Broker Administration Service/Daemon: property entirex.etbadm.ssl.port
TCP port for Default Broker: property entirex.default.broker.tcp.port
SSL port for Default Broker: property entirex.default.broker.ssl.port
If you modified any port numbers, perform the following steps for these new settings to take effect (skip this step if you did not modify any ports).
Restart the Broker Administration Service/Daemon manually:
Windows
Select the broker instance with Administration Tools > Services > Software AG EntireX Broker Admin 10.3 <installation_number>, and from the context menu choose then or
UNIX
In directory <inst_root>/EntireX/bin, execute the following commands:
sagexx stop
and
sagexx start
or
sagexx restart
Restart the Software AG Platform Manager manually:
Windows
Select the Windows service , and from the context menu choose and then or .
UNIX
In directory <inst_root>/profiles/SPM/bin, execute the following commands:
shutdown.sh
and
startup.sh
or
sagspm103 restart
The Default Broker now appears in Command Central and can be started there.
If applicable, change the port number of the TCP/IP port for the Application Monitoring Data Collector as described under Configuration for Application Monitoring and start the Data Collector as described under Starting and Stopping the Application Monitoring Data Collector in the Application Monitoring documentation.