Installing EntireX using Command Central

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.


Introduction

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.

Post-installation Configuration

Start of instruction setTo configure EntireX after installation with Command Central

Depending on the EntireX components installed, perform the following steps as required:

  1. 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:

      1. Go to Views > Licensing and add a license file.

      2. Go to Views > Landscape > Installations and select the installation you have just installed.

      3. Go to Instances and select any EntireX instance, e.g. EntireX Broker ETB001.

      4. Go to Configuration > Licenses > Edit and specify the license you registered previously.

      The selected license file will be copied automatically to <inst_root>/EntireX/config/license.xml.

  2. 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

    See Port Numbers in EntireX.

  3. 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.1 <installation_number>, and from the context menu choose Stop then Start or Restart

      • 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 Administration Tools > Services > Software AG Platform Manager 10.1 <installation_number>, and from the context menu choose Stop and then Start or Restart.

      • UNIX
        In directory <inst_root>/profiles/SPM/bin, execute the following commands:

        shutdown.sh

        and

        startup.sh

        or

        sagspm101 restart
  4. The Default Broker now appears in Command Central and can be started there.

  5. 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.

See Administering EntireX Components with Command Central.