Install on Linux

Overview

Data Management can be installed on servers running the x86-64 edition of one of the supported operating systems.

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

4. Select OK.

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

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

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

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

4. Configure additional installation options. Refer to the table below.

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.

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

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 and run the Data Management installer on the workstation computer.

2. When prompted to select the type of installation to perform, choose Client.

3. Select Next to continue.

4. Choose the folder in which to install the software and select Next to continue.

5. When installation is complete, select Finish.

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

7. Under Execution Server, select Server and choose your Execution Server from the list.

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

Install CASS on Linux

1. Get the installer from the Redpoint Download Site. Sample command:

wget https://cdn.redpointglobal.com/rpdm-linux-cass/CASS-V9-2022-05/RedPointDM-CASS-1_9_2-2022-05-01-r20220505204340-for-Linux.tgz

2. Set read/write permissions on the installer file:

chmod 777 RedPointDM-CASS-1_9_2-2022-05-01-r20220505204340-for-Linux.tgz

3. Extract the tgz file:

tar -xvzf RedPointDM-CASS-1_9_2-2022-05-01-r20220505204340-for-Linux.tgz

4. A folder named DMCass_2022-0x will be extracted. Go inside the folder:

cd DMCass_2022_0x

5. Run the installer:

./install.pl

6. A series of questions will be presented. The first one is the license agreement. Press Enter if you agree (default = yes).

7. Next are details on the Base install directory and the Base data directory. Confirm if the data directory is correct. (If an alternate data location is set on a different location other than the default, it should be pointing to that path.)

8. Ready to install? Press Enter to continue.

A successful install looks something similar below:

Installing...
/bin/cp -Rf ./CassUpdate_2022-05/module/* /opt/RedPointDM9/modules/cass/2022-05_2
Setting install date.
Creating DSO symbolic links
Updating dynamic link library system cache...Done

If you encounter the error Can't locate Data/Dumper.pm when running the installer, you might need to install the Perl data dumper package.

Can't locate Data/Dumper error when installing RPDM Modules in Linux

When installing RPDM modules in Linux such as CASS, Geocoder, etc., you might encounter an error when you try to run the installer.

The cause of the error is a missing package called perl-Data-Dumper.x86_64 in the operating system.

The fix is to install the Perl data dumper package:

Debian/Ubuntu

Only use sudo if the stack was installed as root.

sudo apt-get install perl

CentOS/Fedora/RHEL

Only use sudo if the stack was installed as root.

sudo yum install perl perl-Data-Dumper

Update RPDM modules [CASS/SERP/EWS] in Linux

To update RPDM modules [CASS/SERP/EWS] in Linux, follow the steps below:

Make sure to replace the sections marked as <download link address>, <downloaded file name>, <DMModule_2023-05>, and <downloaded zip file> with the actual relevant information in your context.

1. Login to the RPDM server using your credentials.

2. Download the Installer:

   1. Visit the Downloads page on Data Solutions to locate the installer.

   2. Use the wget command to download the installer:

      CODE

      wget <download link address>

3. Change file permissions of the downloaded file to allow unzipping:

   CODE

   sudo chmod 777 <downloaded file name>

4. Unzip the downloaded file using the following command:

   CODE

   sudo tar xvzf <downloaded file name>

5. Navigate to the extracted directory using the cd command:

   CODE

   cd <DMModule_2023-05>

6. Use the ll command to list the files in the directory and verify the extraction:

   CODE

   ll

For example:

7. Start the installation process by executing the install script:

   CODE

   sudo ./install.pl

   1. Choose Yes for all further options to proceed with the installation.

   2. The installation process will begin.
      For example:

      

8. Verify completed installation. After the installation is completed, the output should resemble the following image:

   

9. To save disk space, delete the downloaded and extracted files using the following commands:

   CODE

   sudo rm -r <DMModule_2023-05>
   sudo rm <downloaded zip file>