Automate - Install on Ubuntu Linux

The material in this document is for informational purposes only. This guide assumes that the most recent version of Rampiva Automate is in use unless otherwise noted in the prerequisites. The products it describes are subject to change without prior notice, due to the manufacturer’s continuous development program. Rampiva makes no representations or warranties with respect to this document or with respect to the products described herein. Rampiva shall not be liable for any damages, losses, costs or expenses, direct, indirect or incidental, consequential or special, arising out of, or related to the use of this material or the products described herein.

Introduction

This document outlines the process of installing the Rampiva Automate on Ubuntu Linux.

Prerequisites

Ubuntu 20.04 LTS

Instructions

A. Deploy Dependencies

1	Install OpenJDK 11.	`sudo apt-get update sudo apt install openjdk-11-jre-headless`
2	Download the Nuix Engine. Get the latest release version from https://download.nuix.com/releases/engine/ If using a Linux installation without a graphical interface, use another computer to download the engine and transfer to the Linux system.	`ls engine-dist-linux-x86_64-9.6.7.404.tar`
3	Unzip the Nuix Engine.	`tar -xvf engine-dist-linux-x86_64-9.6.7.404.tar`
4	Move the contents of the Nuix Engine files to `/opt/nuix/engine`.
5	Clean-up the installation files.
6	Install the Nuix Engine dependencies.
7	Update the nofile limits.

B. Install Rampiva Automate

1	Download the latest Rampiva Automate.
2	Install unzip and dos2unix.
3	Unzip Rampiva Automate.
4	Update the end-of-line character of the installer script to Unix.
5	Run the installer.
6	Clean-up the installation files.

C. (Optional) Configure the Rampiva Scheduler Service

1	Open the Scheduler config.yml file for editing.
2	Update the apiSecret value with and random value that will be the same on the Scheduler and all Engine Servers.	Sample beginning of configuration file:
3	By default, no authentication mechanism are enabled. For testing, enable the internalCredentials mechanism.	Sample beginning of configuration file:
4	Manually start the Scheduler service.
5	Confirm that the service started successfully by browsing to the Scheduler webpage.
6	If the webpage is not accessible, inspect the Scheduler logs.
7	Stop the manually started Scheduler service.
8	Create a service file for Scheduler.	File contents:
9	Reload the SystemD configuration and configure the service to start automatically at boot.
10	Reboot the system and confirm that the service starts.
11	Log on to Scheduler and deploy a valid Rampiva license.
12	Open the Settings → Execution Profiles panel, and edit the Default Profile with the following settings: Log Folder: `/var/logs/rampiva` Command-Line Parameters: `-Xmx16g -Dnuix.logdir=/var/logs/rampiva -Duser.language=en -Duser.country=US -Dstorage.wal.allowDirectIO=false` {base_data_folder}: `/fsx/data` {base_case_folder}: `/fsx/cases`

D. (Optional) Configure the Rampiva Engine Server Service

1	Open the Engine Server config.yml file for editing.
2	Update the apiSecret value with the value used in the Scheduler configuration file.	Sample beginning of configuration file:
3	Optionally, if the Engine Server is running on the same system as Scheduler, change the default HTTPS port from 443 to another port.	Sample beginning of configuration file:
4	Manually start the Engine Server service.
5	Confirm that the service started successfully by browsing to the Engine Server webpage.
6	If the webpage is not accessible, inspect the Engine Server logs.
7	Stop the manually started Engine Server service.
8	Create a service file for the Engine Server.	File contents:
9	Reload the SystemD configuration and configure the service to start automatically at boot.
10	Reboot the system and confirm that the service starts.

E. (Optional) Configure Amazon FSx Lustre

1	Install the Lustre client according to the AWS instructions from https://docs.aws.amazon.com/fsx/latest/LustreGuide/install-lustre-client.html .
2	Create a Lustre file system if one is not already available.	https://console.aws.amazon.com/fsx/home?#file-system-create
3	From the AWS file system console, retrieve the attach instructions.	Sample instructions:
4	Run the attach commands.
5	Confirm that the Lustre file system was mounted correctly.	Sample output:
6	Create a service file for mounting the Lustre file system at boot.	Sample file contents (adjust based on attach instructions):
7	Reload the SystemD configuration and configure the service to start automatically at boot.
8	Reboot the system and confirm that the file system was mounted correctly.