Install on Linux

Data Management can be installed on servers running the x86-64 edition of one of the following supported operating systems: Red Hat Enterprise Linux 7 or 8 (64-bit); CentOS 7, 8, or 9 (64-bit); Ubuntu 20.04 LTS; Amazon Linux 2. Note that the Data Management client application is Windows-only, and is not installed on Linux.

Installing Data Management creates services that run the following executables:

• rpdm_siteserver: The Data Management Site Server. This service manages meta-data, version control, settings, security, logging, and licensing. It communicates with one or more Execution Servers.

• rpdm_executionserver: The Data Management Execution Server. This service manages the execution of Data Management projects and automations. It must communicate with a Site Server to function.

• rpdm_wspserver: The Data Management Web Proxy Server. This service manages Data Management realtime web services. It must communicate with a Site Server and an Execution Server to function.

These services are independent and can be installed on the same or different computers. A simple installation will have all services on one computer. A larger installation will typically install all services on a main computer, and install Execution Servers on secondary "worker" computers in the computation cluster. A single Web Proxy Server may be installed on the main computer or on a secondary computer. These secondary computers talk to the main computer's Site Server to obtain shared meta-data, security, version controlled storage, logging, and other services.

Data Management servers can inter-operate between Windows and Linux. For example, a Site Server on Linux can communicate with an Execution Server on Windows. For help configuring such advanced installations, contact Data Management support.

Linux installation prerequisites

Installing Data Management for Linux requires some planning. All installations must be performed with root privileges.

Linux system libraries

Data Management for Linux requires a number of system libraries, which are provided by your Linux distribution. If the installer does not detect the required libraries, it will display an error and halt installation. If this happens, install the missing libraries and then retry the installation.

Write and execute permissions on the /tmp directory

The Data Management Linux installer for Linux requires write and execute permissions on the /tmp directory to confirm that the system can supply entropy sufficient to support the enhanced encryption introduced in Version 9. Without these permissions, installation will fail.

Entropy and cryptography

Data Management for Linux requires an entropy pool sufficiently large to support cryptography. If the installer determines that the system has insufficient entropy bandwidth, will display an error and halt installation. If this happens, install rng-tools and then retry the installation.

Linux service user

If you want the Data Management services to run as a user other than root, you must create the desired user before installing Data Management. Consult the documentation for your OS for details.

Open service ports

In order for the Data Management client to be able to access the Data Management services, you must open the firewall ports associated with those processes. Consult the documentation for your OS for details.

Requires write and execute permissions on the /tmp directory.

Linux, JDBC, and databases

Data Management for Linux includes JDBC support for the following databases:

• AWS Aurora MySql

• AWS Redshift

• Azure Data Warehouse

• Azure SQL

• DB2

• Greenplum

• Microsoft SQL Server

• MySQL

• Netezza

• Oracle

• PostgreSQL

• SAP HANA

• Snowflake

• Teradata

• Vertica

Contact Redpoint Support for information about specific database driver versions supported.

To install the JDBC framework:

1. Download your vendor’s JDBC driver(s).

2. Install JDBC drivers into the jdbc_drivers directory.

3. Refer to the database vendor documentation for specific installation instructions.

Upgrade Data Management

If you have a previous version of Data Management installed, you should back up your repository before installing version 9.5:

To back up the repository

1. Launch the Data Management client and connect to your Data Management installation.

2. Go to the repository, right-click the repository icon, and then select Create archive:

3. In the Create Archive dialog, select the root Repository node and then select OK.

4. Specify a location outside the Data Management installation directory where your repository backup should be saved, and then select Save.

Install Data Management

After you have installed the prerequisite software and defined users, follow these steps.

If you are upgrading from a previous Data Management version, back up your repository before proceeding.

Step 1: Obtain installation package

To install the Data Management software, you will need to download the Data Management server installer for your Linux distribution:

• Red Hat Enterprise Linux-based distributions:
  RedpointDM-Server-x.y.z.b-for-CentOS.run (where x.y.z.b is the version information).

• Ubuntu:
  RedpointDM-Server-x.y.z.b-for-Ubuntu.run (where x.y.z.b is the version information).

Contact Data Management support or pre-sales support for download information.

Step 2: Run the installer

From the command prompt, type a command of the form:
admin_user@server_name-ubn16-1:~$ sudo ./RedpointDM-Server-9.0.1.1999-for-Ubuntu.run

You must have super user (root) privileges to install Data Management, even if you are going to run the services as a different user (see Linux installation prerequisites).

You will be presented with a series of questions. Each question is supplied with a default answer, which is capitalized.

Questions that have Yes/No answers accept any answer starting with a Y or y as a yes. Any other answer is treated as no.

1. Agree to the Data Management Use License (y).

2. Specify your installation type:

   • 1. Enterprise: Install all Data Management components.

   • 2. Worker: Install a Data Management worker node. A Site Server and Data Management repository must be available elsewhere on the network, and you will need to know that Site Server’s hostname and port number.

   • 3. Repository: Install the Data Management Site Server and repository.

You cannot install individual services.

3. Configure additional installation options:

Option	Explanation
Upgrade/migration	If the installer detects an existing Data Management Version 8 installation, you may elect to migrate it into your Version 9 installation, importing projects and some settings from the previous version. Note that Advanced Security and custom JVM settings are not automatically migrated. If you have these configured in your version 8 installation, you may need to configure the enable_advanced_security, jvm_memory_mb, and jvm_options properties manually in the file CoreCfg.properties.
Installation folder	Choose the installation directory, or accept the default location /opt/RedpointDM9. This is the primary location for the Data Management product. If the specified directory does not exist, it will be created. If the installer detects that the installation directory is not empty, you will be prompted to keep or purge the directory's contents.
Data folder	Choose the data directory, or accept the default location /opt/RedpointDM9. This is where Data Management will store the repository, log files, reference data, and other non-program information. This can be the same as the install directory. If the specified directory does not exist, it will be created.
Site Server address Site Server port	If you selected Worker in step 3, specify the address and port of the Data Management Site Server.
Site Server configuration	If any ports in the range 20420-20426 are already in use, specify an available base port.
Enable Advanced Security	Advanced security mode maps each Data Management user to an OS logon, applying the access privileges that the OS user has when logged on directly to the OS. If Enable Advanced Security is selected, you must run Data Management as root.
Map OS user to Administrator logon	If you enabled Advanced Security, you may optionally map an OS user to the Administrator logon.
Execution Server configuration	Specify the Site Server's Execution Server name and Execution Server network address, or accept the default values.

4. Review your selected installation options, and then press Enter to begin installation.

5. If you selected Worker in step 3, when installation completes, you must copy crypto_keys from the installation directory of your Site Server to the installation directory of your Worker install.

Step 3: Verify the installation

To verify the installation, check that the Data Management processes are running:

[sqa@cdh-ha-en ~]$ ps -ef | grep rpdm
root 1263 1 0 Dec05 ? 00:07:51 /opt/RedpointDM9/program/rpdm_executionserver -daemon
root 1264 1 0 Dec05 ? 00:18:27 /opt/RedpointDM9/program/rpdm_siteserver -daemon
root 1270 1 0 Dec05 ? 00:19:59 /opt/RedpointDM9/program/rpdm_wspserver -daemon

Connect the client to a Linux host

The Data Management client software runs only on Microsoft Windows.

To install the Data Management client

1. Download or obtain on CD-ROM/DVD-ROM the Data Management installer for Windows.

2. Run the Data Management installer on the workstation computer. When prompted to Select the type of installation to perform, choose Client. Select Next to continue.

3. Choose the folder in which to install the software. Select Next to continue.

4. When installation is complete, select Finish.

5. Run the Data Management client from the Windows Start menu. In the Logon dialog box, enter the default User Name and Password (Administrator / Administrator) and your Linux Hostname:

Under Execution Server, select Server and choose your Execution Server from the list, and then select OK. If no Execution Server is shown, or the client fails to connect, confirm that your services are running, that your Windows client can resolve the Linux server host name, and that no firewall is blocking network access to the IP ports used by Data Management (20420-20426).

Contact Data Management support for assistance if the client is unable to connect.