Skip to content

Databridge Installation Guide

Use this guide to install, configure, and run Databridge version 7.0 SP1. Follow the instructions for installing and upgrading the Databridge Host, Enterprise Server, Client, and other products (listed in the Table of Contents). Be sure to see:

To install, configure, and run Databridge, you should be a system administrator familiar with the following:

  • Standard Unisys® operations for MCP-hosted mainframes such as the CS7xxx series, Libra series, ClearPath® NX/LX or A Series

  • DMSII databases and Data And Structure Definition Language (DASDL)

Important

The service names for the "Databridge Client Manager" and "Databridge Director" services were changed to "Micro Focus Databridge Client Manager" and "Micro Focus Databridge Director".

What's New In This Release

  • The install package contains only 64-bit software. The Windows folder replaces the Windows64 and Window32 folders.

  • Added support for the "max_string_size" parameter in the Oracle Client to allow it to use wider varchar2 and raw columns, which is much more efficient than using clob.

  • Added support for the Oracle TIMESTAMP data type in user columns that allows you to have fractions of seconds in time stamps.

  • The configuration file parameter "keep_undigits" was changed to have three values instead of being a boolean. Values of 0 and 1 work in the same way as before. A value of 2 extends 1 to treat undigits in numeric fields like 9s, similar to most MCP COBOL applications.

See the Databridge Release Notes for other changes and fixes.

Reminder

We recommend that you install the Administrative Console on a separate server from the client machine(s) because:

  • The Administrative Console code uses a lot resources, which could impact the client's performance, unless you have a powerful machine with lots of memory.
  • Since the Administrative Console monitors the client machines, using a different machine avoids the chance of a downed client machine that cannot monitor itself.

Security Guidelines

Databridge 7.0 SP1 includes the following security guidelines:

For To decrease security risk
Databridge Host Install Databridge Host to the Unisys mainframe under its own privileged usercode. This is preferable to installing under the usercode of the DMSII database. If you install and run Databridge under multiple usercodes, you must install a copy of DBEngine under each of those usercodes. Alternatively, you can establish DBEngine as a system library (SL).
Databridge Client File security helps to protect Client operations by restricting access to the working directory and its files and subdirectories. Access is limited to the administrators and the system account, and to designated users (or on Windows, user groups). In Windows, you can enable file security via the option Enable File Security at installation, or by running the program setfilesecurity.exe after the installation.

From the UserID box and the DBAdministrator box, specify users who can run Databridge Client and modify the working directory and its files. User IDs specified in the DBOperator box can monitor operations by reading the log files, but cannot run Databridge Client. In UNIX, you restrict file access via the umask entry in the file globalprofile.ini. See Install Databridge Client on UNIX.
Databridge Enterprise Server File security is automatically enabled when you install Databridge Enterprise. File security protects the configuration and log files by restricting privileges on the PC to users who need to modify the configuration. By default, any user in the Administrators group can modify the configuration files and delete the read-only log files. If you create a user group in Windows called DBEAdmins, only the users in that group will be able to alter the configuration files and delete log files. Likewise, if you create a group called DBEUsers, only the users in that group will be able to view the configuration. For more information, see "Implementing File Security" in the Databridge Enterprise Server Help.

System Requirements

Databridge 7.0 SP1 includes support for the following hardware and software:

System Support Updates

Note: Databridge will remove support for operating systems and target databases when their respective software company ends mainstream and extended support.

Databridge Host Unisys mainframe system with an MCP level SSR 59.1 through 62.0

DMSII or DMSII XL software (including the DMALGOL compiler)

DMSII database DESCRIPTION, CONTROL, DMSUPPORT library, and audit files
Databridge Enterprise Server ClearPath PC with Logical disks or MCP disks (VSS disks in MCP format)
-or-
Windows PC that meets the minimum requirements of its operating system:

  • Windows Server 2022
  • Windows Server 2019
  • Windows Server 2016 (CORE mode must be disabled for installation and configuration)
  • Windows Server 2012 R2 (CORE mode must be disabled for installation and configuration)
  • Windows Server 2012
Direct Disk replication (recommended) requires read-only access to MCP disks on a storage area network (SAN)

TCP/IP transport

NOTE: To view the product Help, JavaScript must be enabled in the browser settings to navigate and search Help.
Databridge Administrative Console

One of following platforms can be used for the Administrative Console server:

  • Windows Server 2012 or later
  • Windows 10 x64
  • Intel X-64 with Red Hat Enterprise Linux Release 7 or later.
  • Intel X-64 with SUSE Linux Enterprise Server 11 SP1 or later.
  • Intel X-64 with UBUNTU Linux 14.4 or later.
  • Sun Microsystems SPARCstation running Solaris 11 or later.
Databridge Client We recommend running the Administrative Console on a different machine from the Client to avoid negatively impacting the client's performance.
To access the new Administrative Console, use a browser such as Microsoft Edge or Google Chrome on the client machine.

NOTE: Disk space requirements for replicated DMSII data are not included here. For best results, use a RAID disk array and store the client files on a separate disk from the database storage.

NOTE: Memory requirements do not include the database requirements when running the Client in the server that houses the relational database (consult your database documentation for these). The numbers are for a stand-alone client machine that connects to a remote database server.
Client - Windows Unisys ES7000
-or-
Pentium PC processor 3 GHz or higher (multiple CPU configuration recommended)

2 GB of RAM (4 GB recommended)

100 GB of disk space in addition to disk space for the relational database built from DMSII data)

TCP/IP transport

One of the following operating systems:

  • Windows Server 2022
  • Windows Server 2019
  • Windows Server 2016 (CORE mode must be disabled for installation)
  • Windows Server 2012 R2 (CORE mode must be disabled for installation)
  • Windows Server 2012
  • Windows 10
One of the following databases:

  • Microsoft SQL Server 2019
  • Microsoft SQL Server 2017
  • Microsoft SQL Server 2016
  • Microsoft SQL Server 2014
  • Microsoft SQL Server 2012
  • Oracle 11g release 2, 12c, 18c, 19c, 21c
Client - UNIX and Linux One of the following systems:

  • Sun Microsystems SPARCstation running Solaris 11 or later.
  • IBM pSeries running AIX 7.1 or later.
  • Intel X-64 with Red Hat Enterprise Linux Release 7 or later.
  • Intel X-64 with SUSE Linux Enterprise Server 11 SP1 or later.
  • Intel X-64 with UBUNTU Linux 14.4 or later.

2 GB of RAM (4 GB recommended)

100 GB of free disk space for installation (in addition to disk space for the relational database built from DMSII data)

TCP/IP transport

One of the following databases:
  • Oracle 11g Release 2, 12c, 18c, 19c, 21c.

Databridge product documentation

  • Databridge Documentation - all guides for the current and previous versions
  • Databridge installation image - the Docs folder contains the guides for installation and error codes as well as the administrator's guide for each Databridge product.
  • Databridge Support Resources - includes Knowledge Base articles
  • Product Help (HTML) is available for Databridge Enterprise Server and Databridge Administrative Console.

Unisys MCP Server documentation

For more information about DMSII configuration, refer to your Unisys documentation.

Description of Files on the Installation Image

The table below lists the directories and files on the installation image in alphabetical order. Databridge Host installation files (DISKINSTALL and IMAGE) are located on the root. Only 64-bit versions are provided for all Databridge Clients.

This directory Contains File Description
AIX Tar files for installing Databridge clients on the AIX platform:
DB_AIX64_Ora11g.tar The 64-bit client programs for Oracle 11g
DB_AIX64_Ora12c.tar The 64-bit client programs for Oracle 12c
DB_AIX64_Ora18c.tar The 64-bit client programs for Oracle 18c
DB_AIX64_Ora19c.tar The 64-bit client programs for Oracle 19c
Console Files for installing Databridge Administrative Console, in the following subdirectories:
UNIX databridge-container-master-SNAPSHOT.tar
Windows Installation files for Databridge Administrative Console.
Documentation Databridge Help documentation files in PDF format. Help for Enterprise Server and the Client Console are available from the Help menu of the application.
Kafka Tar file for installing the Kafka client on Linux platforms.
DB_Kafka64_Ora11g.tar The 64-bit programs for Linux platforms using an Oracle 11g database to hold the control tables.
DB_Kafka64_Ora12c.tar The 64-bit programs for Linux platforms using an Oracle 12c database to hold the control tables.
DB_Kafka64_Ora18c.tar The 64-bit programs for Linux platforms using an Oracle 18c database to hold the control tables.
DB_Kafka64_Ora19c.tar The 64-bit programs for Linux platforms using an Oracle 19c database to hold the control tables.
Linux Tar files for installing clients on Intel® x64 series machines running various flavors of Linux including RedHat Enterprise (Release 7 or higher), SUSE or UBUNTU:
DB_Linux64_Ora12c.tar The 64-bit client programs for Oracle 12c
DB_Linux64_Ora12c.tar The 64-bit client programs for Oracle 12c
DB_Linux64_Ora18c.tar The 64-bit client programs for Oracle 18c
DB_Linux64_Ora19c.tar The 64-bit client programs for Oracle 19c

NOTE: Oracle 19c requires Red Hat Enterprise Linux Release 7.
DB_Linux64_Ora21c.tar The 64-bit client programs for Oracle 21c

NOTE: Oracle 21c requires Red Hat Enterprise Linux Release 8.
SunOS Tar files for installing clients on Oracle SPARCstation running Solaris 11 or later:
DB_SunOS64_Ora11g.tar The 64-bit client programs for Oracle 11g
DB_SunOS64_Ora12c.tar The 64-bit client programs for Oracle 12c
DB_SunOS64_Ora18c.tar The 64-bit client programs for Oracle 18c
DB_SunOS64_Ora19c.tar The 64-bit client programs for Oracle 19c
Windows Installation files for Enterprise Server, Databridge Client (Windows).