Installing and Uninstalling Adabas Manager Communicator

Adabas Manager Communicator is installed using the Software AG Installer. It does not require a license key.

You can download the Software AG Installer from the Software AG Empower website at https://empower.softwareag.com/.

This document provides product-specific instructions for installing Adabas Manager Communicator. It is intended for use with Using the Software AG Installer, which explains how to prepare your machine to use the Software AG Installer and how to use the Software AG Installer and Software AG Uninstaller to install and uninstall your products. The most up-to-date version of Using the Software AG Installer is always available in the webMethods product documentation located on the Software AG Empower website (https://empower.softwareag.com/).

This document covers the following topics:


Installation Overview

This product is installed using the Software AG Installer, which you can download from the Software AG Empower website at https://empower.softwareag.com/.

Full functionality of this product requires an Adabas Directory Server installed in your enterprise. If you have a Directory Server already installed at your site from an earlier release of Software AG products, you do not need to install it again; your new products can use the existing installation.

The main function of Adabas Manager Communicator is to enable administration of Entire Net-Work on both LUW and Mainframe systems. As such, the Directory Server must be installed on a machine in your network that can be accessed by all machines where Entire Net-Work will be installed (both Entire Net-Work Server and Entire Net-Work Client). It should be installed on a dedicated system that is operational 24 hours a day.

We recommend that you install one Directory Server for use with all the Software AG products that require it.

The Adabas Manager Communicator can be installed locally with every Adabas Manager instance you have installed, or it can be installed on a different machine. Refer to the Adabas Manager documentation for details on how to configure Adabas Manager to access a remote Communicator.

System Requirements

This section describes the system requirements of Adabas Manager Communicator.

Supported Operating System Platforms

Software AG generally provides support for the operating system platform versions supported by their respective manufacturers; when an operating system platform provider stops supporting a version of an operating system, Software AG will stop supporting that version.

For information regarding Software AG product compatibility with IBM platforms and any IBM requirements for Software AG products, please review the Product Compatibility for IBM Platforms web page.

Before attempting to install this product, ensure that your host operating system is at the minimum required level. For information on the operating system platform versions supported by Software AG products, complete the following steps.

  1. Access Software AG's Empower web site at https://empower.softwareag.com.

  2. Log into Empower. Once you have logged in, you can expand Products & Documentation in the left menu of the web page and select Product Version Availability to access the Product Version Availability screen.

  3. Use the fields on the top of this screen to filter its results for your Software AG product. When you click the Search button, the supported Software AG products that meet the filter criteria are listed in the table below the filter criteria.

    This list provides, by supported operating system platform:

    • the Software AG general availability (GA) date of the Software AG product;

    • the date the operating system platform is scheduled for retirement (OS Retirement);

    • the Software AG end-of-maintenance (EOM) date for the product; and

    • the Software AG end-of-sustained-support (EOSS) date for the product.

Note:
Although it may be technically possible to run a new version of your Software AG product on an older operating system, Software AG cannot continue to support operating system versions that are no longer supported by the system’s provider. If you have questions about support, or if you plan to install this product on a release, version, or type of operating system other than one listed on the Product Version Availability screen described above, consult Software AG technical support to determine whether support is possible, and under what circumstances.

Supported Hardware

For general information regarding Software AG product compatibility with other platforms and their requirements for Software AG products, visit Software AG's Hardware Supported web page.

Supported Browsers

The Adabas Manager requires an Internet browser. For information on supported browsers, see the webMethods System Requirements documentation on the Empower web site.

Firewall Requirements

If you attempt to install and use this software in a system with a firewall in place, be sure that your system administrator has set up the firewall so that the component applications can access the ports they need (including the Adabas Directory Server port and any ports Entire Net-Work dynamically assigns during its own processing). For more information about port usage, read the Port Number Reference found elsewhere in this documentation.

Configuration Considerations

This section describes configuration issues you should consider before you install Adabas Manager Communicator.

Adabas Manager Communicator requires the use of the Adabas Directory Server; so be sure to have already installed the Directory Server before attempting an Adabas Manager Communicator installation or install the Directory Server at the same time as Adabas Manager Communicator.

How Many Adabas Manager Communicators Should You Install?

Install at least one Adabas Manager Communicator with every instance of Adabas Manager you install.

Where Should You Install the Adabas Manager Communicator?

Adabas Manager Communicator can be installed locally with each Adabas Manager instance or on any other machine in the enterprise.

Before You Begin

Before you begin installing this product, ensure that the following prerequisites have been met:

  1. Software AG strongly recommends that you create an installation image of your existing Software products and store the image on your internal network. You should create an image for each operating system on which you plan to run the installation (for example, 32-bit, 64-bit, or both). This will help you reduce WAN traffic and speed up installation and will ensure consistency across installations over time, since the Software AG Installer provides only the latest release of each product.

  2. This product should not be installed over a previous version. Please remove any previous version of the product before installing this product. For some Software AG products, the Software AG Uninstaller will not be able to remove key files that are locked by the operating system if the associated Software AG products are not shut down.

  3. Disable any antivirus software.

  4. Ensure the target computer is connected to the network.

  5. If this product requires a license key file, verify the license key file is copied somewhere in your environment . Products requiring license key files will not run without valid license keys. For more information, read The License Key, elsewhere in this section.

  6. Verify your environment supports the system requirements for this product, as described in System Requirements, elsewhere in this section.

Installation Steps

Adabas Manager Communicator is installed using the Software AG Installer. This installation documentation provides a brief description on how to install the Adabas Manager Communicator directly on the target machine using the installer wizard. For detailed information on the installer wizard, read Using the Software AG Installer.

Note:
Read Using the Software AG Installer also if you want to use console mode, or if you want to install using an installation script or installation image.

Start of instruction setTo install Adabas Manager Communicator, complete the following steps:

  1. Start the Software AG Installer as described in Using the Software AG Installer.

  2. When the first page of the Software AG Installer wizard (the Welcome panel) appears, choose the Next button repeatedly, specifying all required information on the displayed panels, until the panel containing the product selection tree appears.

    All Adabas-related products can be selected for installation within the Adabas Family product selection tree.

    When selected for installation, other dependent products under the Infrastructure tree are automatically selected. Do not uncheck these boxes. The Infrastructure tree must be selected for all Software AG products; it provides the necessary Java runtime environment for this product.

  3. To install Adabas Manager Communicator, select (check) the Adabas Manager Communicator entry from the Adabas Family product selection tree.

  4. On the License panel, read the license agreement and select the check box to agree to the terms of the license agreement and then click Next to continue. If you do not accept the license agreement, the installation will stop.

  5. When the Configure panel appears, specify:

    • The port number that should be used for Adabas Manager Communicator. The default port number is 4980.

    • The URL and port number for the Directory Server that should be used for this installation. The default is tcpip://localhost:4952.

    • Next is the Allow Cross-Origin Resource Sharing (CORS) option. If the selection is “YES”, the user must specify the Access Control Allow-Origin (ACAO) list of sites separated by “;”. The default value is “*”, which means any site can access resources provided by Adabas Manager Communicator.

    Click Next to continue.

  6. On the last panel, review the items you have selected for installation. If the list is correct, choose the Next button to start the installation process.

After Adabas Manager Communicator has been installed, it will start automatically as a system service. You can start and stop it as you would any system service.

Configuring Product Components for Windows Personal Firewall

If you have the default Microsoft Windows personal firewall enabled on a PC and you would like to install and run Adabas and Entire Net-Work components on that PC, you will need to allow communications through the firewall on certain ports. You can do this in one of two ways: you can allow ports for a specific executable program or you can open specific ports. This section covers the following topics:

Note:
If you attempt to install Adabas or Entire Net-Work in a system with a firewall in place, be sure that your system administrator has opened the firewall for the Adabas Directory Server port or the installation may not complete successfully.

Allow Ports for a Specific Executable Program

You can allow a specific executable program to open a port. To do so, issue the following command:

C:\>netsh firewall add allowedprogram program="<path and file name>" 
name="<component-name>" profile=ALL

where <path and file name> is the path and file name of the file you want to allow and <component-name> is a user-specified name to identify the file you are allowing. The following table lists the common Adabas and Entire Net-Work component files that might need to be allowed if Windows personal firewall is enabled:

Component Name Path and File Name
Entire Net-Work Client Service <your-installation-location>\EntireNetWorkClient\bin\wclservice.exe
Entire Net-Work Kernel program <your-installation-location>\EntireNetWorkServer\bin\wcpkernel.exe
Entire Net-Work Server Service <your-installation-location>\EntireNetWorkServer\bin\wcpservice.exe
Adabas Directory Server Service <your-installation-location>\SoftwareAG\SoftwareAgDirectoryServer\bin\xtsdssvcadi.exe

To remove the Adabas or Entire Net-Work component as an allowed program, issue the following command:

C:\>netsh firewall delete allowedprogram program="<path and file name>" 
profile=ALL

where <path and file name> is the path and file name of the file you want to disallow.

Open a Specific Port

To open a specific port for use by an Adabas or Entire Net-Work component in the firewall, issue the following command:

C:\>netsh firewall add portopening protocol=TCP port=nnnn 
name="<component-name>" profile=ALL

where nnnn is the port number you want to open and <component-name> is a user-specified name to identify the port you are allowing.

To avoid port number conflicts, read Port Number Reference for a general list of the ports used by Software AG products.

To close a specific port in the firewall, issue the following command:

C:\>netsh firewall delete portopening protocol=TCP port=nnnn profile=ALL

where nnnn is the port number you want to close.

Uninstallation Steps

You uninstall this product using the Software AG Uninstaller. For information on how to use the uninstaller, read the Using the Software AG Installer guide.

Installing Fixes Using Software AG Update Manager

Adabas Manager Communicator is updated using the Software AG Update Manager (SUM). You should always check whether an update is available immediately after installing the product.

You can download the Software AG Update Manager from the Software AG Empower website at https://empower.softwareag.com/.

This SUM installation documentation on Empower provides a brief description on how to update Software AG products directly on the target machine using the Update Manager wizard. The SUM documentation also includes instructions on how to apply updates in console mode or using scripts.

Start of instruction setTo update Adabas Manager Communicator, complete the following steps:

  1. Download and install Software AG Update Manager for your platform from Empower.

  2. Shut down any running instances of the product. Updates cannot successfully apply if the application is active.

  3. From a console prompt in the SUM /bin directory, enter UpdateManagerGUI.bat (UpdateManagerGUI.sh on UNIX/Linux).

  4. On the opening page of the SUM tool, select Install Fixes from Empower, enter your SAG product directory root location and provide your Empower User ID and password. Click Next.

  5. Expand through the Adabas Family product selection tree to find the entry for this product.

    Tip:
    If the product is not shown in the tree, there is either no update available or the product is not installed in the location you specified.

  6. Select (check) the Adabas Manager Communicator entry in the product selection tree. Click Next.

    Tip:
    You can select more than one product to update before proceeding.

  7. The next screen presents a summary of products that are about to be updated. If any of them require manual pre-installation steps, they will be highlighted in red and you will be directed to read the update readme file for that product before proceeding.

    Complete any pre-installation steps outlined in the readme file and check the box next to Pre-installation steps have been completed. Click Next.

    Note:
    If any pre-installation steps are required, the Next button will be unavailable until you confirm these steps have been completed.

  8. The tool will apply updates to all selected products and present you with a final screen confirming updates have been applied. Click Close to exit SUM or Home to return to the tool's starting panel.

Uninstalling Fixes Using Software AG Update Manager

Start of instruction setTo remove an installed update, complete the following steps:

  1. Shut down any running instances of the product.

  2. Start Software AG Update Manager.

  3. On the opening page, select Uninstall Fixes from the selection panel. Click Next.

  4. If any product selected for uninstall requires manual steps, you will be directed to review the update readme and confirm you have performed any pre-uninstallation steps. Click Next.

  5. The fix(es) you selected for uninstall will be removed and the product(s) returned to their previous state. Click Close to exit SUM or Home to return to the tool's starting panel.