Installing the Event Replicator Target Adapter Data Mapping Tool

#### Search Results

Search

# Installing the Event Replicator Target Adapter Data Mapping Tool

This document describes the installation and uninstallation of Event Replicator Target Adapter Data Mapping Tool. It covers the following topics:

- Installation Overview

- System Requirements

- Prerequisite Products

- Before You Begin

- Installation Steps

- Uninistallation Steps

- Installing Fixes Using Software AG Update Manager

- Uninstalling Fixes Using Software AG Update Manager

## 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/.

The Software AG Installer offers typical development installations of Software AG products. When you select a typical development installation, the installer automatically groups and selects the Software AG products and components that make up that installation.

- The Event Replicator Target Adapter Administration is part of the Event Replicator Target Adapter product suite. It is installed separately from Event Replicator Target Adapter Data Mapping Tool and the Event Replicator Target Adapter.

- The Event Replicator Target Adapter Data Mapping Tool is part of the Event Replicator Target Adapter product suite. It is installed separately from Event Replicator Target Adapter Administration and the Event Replicator Target Adapter.

- The Event Replicator Target Adapter installation is part of the Event Replicator Target Adapter product suite. It is installed separately from the Event Replicator Target Adapter Administration and the Event Replicator Target Adapter Data Mapping Tool. Included in the installation of the Event Replicator Target Adapter is the installation of an internal component called the Software AG ERTA Administration Service. This service enables running the Event Replicator Target Adapter as a system service and also allows communication with a remote administration console (for example on platforms, such as HP and zLinux, where the Event Replicator Target Adapter Administration tool cannot be installed)

  The Infrastructure entry in the Software AG Installer includes the installation of Java. Java should be installed so it can be accessed by all products in the Event Replicator Target Adapter product suite and by the Software AG Installer.

You cannot ungroup installations that have been paired or grouped. However, you can select multiple installation configurations for installation at the same time. To configure your installation of these products and create effective production environments, work with your system administrators and Software AG Global Consulting Services.

## System Requirements

This section describes the system requirements of Event Replicator Target Adapter Data Mapping Tool.

- Supported Operating System Platforms

- Supported Hardware

- Supported Browsers

- Supplied Third-Party Software

- Space Requirements

- Memory Requirements

- Windows Requirements

- Firewall Requirements

Note
We recommend that you read the install.txt file in the CD root directory for last-minute information regarding the installation of the Event Replicator Target Adapter. We also recommend that you read the Event Replicator Target Adapter ReadMe.txt files for last-minute information regarding its operation. The Event Replicator Target Adapter readme.txt file can be found in the CD root directory.

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

The Event Replicator Target Adapter Administration and the Event Replicator Target Adapter Data Mapping Tool are not supported in AIX, HP-UX, Solaris or zLinux environments because the Eclipse RCP port is not available in those environments. You will need to have a Windows or Linux installation of the Administration Tool and Mapping Tool to use them. The Administration Tool can remotely manage Event Replicator Target Adapter installations on those platforms where the Eclipse RCP is not supported.

### 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

For information on supported browsers, see the webMethods System Requirements documentation on the Empower web site.

### Supplied Third-Party Software

Event Replicator Target Adapter Data Mapping Tool uses Eclipse RCP Kepler (Version 4.5.2) and Eclipse RCP DeltaPack (Version 4.3.2). The Software AG Installer manages the installation of this third-party software.

Note
If a third-party vendor drops support for a version of one of their products or even for an entire product, Software AG automatically drops support for that version or product as well.

### Space Requirements

A minimum of 100 MB disk space (assuming all components are selected for installation) is required to run all of the following products: Event Replicator Target Adapter Administration, Event Replicator Target Adapter Data Mapping Tool, and the Event Replicator Target Adapter.

Note
Additional space is needed to store log files. The amount of space needed depends entirely on the level of logging you select.

### Memory Requirements

At least 2GB system memory is required to run this software.

1024 MB or more random access memory (RAM) may be needed, depending on the size of your transactions.

### Windows Requirements

In Windows environments, be sure to install Microsoft Visual Studio 2008 Redistributable Package.

### 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. For more information about port usage, read the Port Number Reference found elsewhere in this documentation.

## Prerequisite Products

This section describes prerequisite products for Event Replicator Target Adapter Data Mapping Tool.

- JRE Requirements

- Natural DDM Requirement

- Event Replicator for Adabas Requirements

- Entire Net-Work Administration Requirements

- X-Windows Graphical Environment Requirement

- Relational Database Requirements

Note
If a third-party vendor drops support for a version of one of their products or even for an entire product, Software AG automatically drops support for that version or product as well.

### JRE Requirements

The Software AG Installer installs the appropriate Java Runtime Environment (JRE) along with its infrastructure. This JRE does not interfere with any other JRE that might already exist on the same host machine on which Event Replicator Target Adapter Data Mapping Tool is installed.

### Natural DDM Requirement

A data definition module (DDM) of your Adabas database must be generated from Software AG's Natural or Predict products. For more information, read your Natural or Predict documentation. A sample DDM of the Adabas Employees demo file is included in the Data Mapping Tool installation.

### Event Replicator for Adabas Requirements

You must have Event Replicator for Adabas Version 3.3 SP2 or later installed to use the redefines and composite key features of the Data Mapping Tool.

### Entire Net-Work Administration Requirements

Software AG's Entire Net-Work Administration Version 6.2 SP1 or later is required only if you intend to upload GFBs directly from the Data Mapping Tool.

### X-Windows Graphical Environment Requirement

UNIX and LINUX installations require an X-Windows graphical environment to run the Data Mapping Tool.

### Relational Database Requirements

Java Database Connectivity (JDBC) drivers are required to communicate with an RDBMS to display existing table and column information in the Data Mapping Tool's middle pane. However, it is possible to use the Data Mapping Tool without communicating with an RDBMS. The following table lists the relational databases supported by the Data Mapping Tool as well as the required JDBC drivers for each.

Note
The official and complete list of supported RDBMS versions can be found in the ReadMe file for this release. However, the list of relational databases supported at the time of the release of this product is provided in Supported Relational Databases.

Download the appropriate JDBC driver files from your relational database vendor or obtain them from an installation package and copy them to the appropriate Data Mapping Tool subdirectory:

Note
This location is different from previous versions of Event Replicator Target Adapter Mapping Tool.

Platform | Directory
--- | ---
Windows | C:\<installation-directory>EventReplicatorTargetAdapterMappingTool\JDBC_Libraries. By default, the <installation-directory> is "SoftwareAG".
UNIX | $SAG/EventReplicatorTargetAdapterMappingTool/JDBC_Libraries.

## 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. Close (stop) all open applications, especially those applications interacting with or depending on your Adabas databases. This includes Natural, Adabas Manager, the Adabas DBA Workbench, and prior releases of any other Adabas products. To be on the safe side, also shut down all Software AG services.

   Important
   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

Event Replicator Target Adapter Data Mapping Tool 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 installation documentation provides a brief description on how to install the Event Replicator Target Adapter Data Mapping Tool 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.

To install Event Replicator Target Adapter Data Mapping Tool, 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 (including Software AG Directory Server) can be selected for installation within the Adabas Family product selection tree.

   In addition to the Adabas Family product selection tree, two other trees, Event-Driven Architecture and Infrastructure (which includes the System Management Hub installation) are available for installation. The Infrastructure tree must be selected for all Software AG products; it provides the necessary Java runtime environment for the Software AG Installer as well as Event Replicator Target Adapter Data Mapping Tool.

3. To install Event Replicator Target Adapter Data Mapping Tool, select (check) the Event Replicator Target Adapter Data Mapping Tool 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. 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 Event Replicator Target Adapter Data Mapping Tool has been installed, you will need to manually start it. For more information, read Starting the Data Mapping Tool under the section entitled Data Mapping Tool User Interface and Mechanics.

## Uninistallation 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

Event Replicator Target Adapter Data Mapping Tool is updated using the Software AG Update Manager (SUM).

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.

To update Event Replicator Target Adapter Data Mapping Tool, 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 Event Replicator Target Adapter Data Mapping Tool 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

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

### On this page

- Installation Overview
- System Requirements
- Prerequisite Products
- Before You Begin
- Installation Steps
- Uninistallation Steps
- Installing Fixes Using Software AG Update Manager
- Uninstalling Fixes Using Software AG Update Manager