Automate - Install on DigitalOcean Apps

Owned by Daniel Boteanu (Unlicensed)
Last updated: Nov 01, 2023

 

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 article describes the steps required to perform a basic installation of Rampiva Automate on a container hosted by DigitalOcean Apps. A similar deployment is possible on other container services, such as Azure, AWS or Google Cloud.

This deployment mode renders Rampiva Automate accessible from the Internet using a valid HTTPS certificate is recommended for the following scenarios:

  • Running native workflows

  • Running or evaluating Legal Hold Notifications

  • Evaluating the Rampiva Automate features and user interface

If you encounter any issues with the installation, please post a message on the https://community.rampiva.com/.

Prerequisites 

  • DigitalOcean account

Instructions

A. Create a Database Cluster

1

Browse to DigitalOcean Databases at https://cloud.digitalocean.com/databases.

 

2

Select Create Database.

3

Select the desired datacenter region.

4

Select the database engine PostgreSQL.

5

Select the Basic plan with 1 vCPU and 1 GB RAM.

6

Name the database db-rampiva-automate-company, where company is the name of your company.

7

Confirming the estimated cost.

8

Scroll to the bottom of the page and click Create Database Cluster.

9

Wait for the database to be created.

 

10

Scroll down to the Connection Details section and take note of the connection details.

Click on the show link to show the masked password.

B. Install Rampiva Automate

1

Browse to DigitalOcean Apps at https://cloud.digitalocean.com/apps

 

 

2

Select Create App.

3

Select the Service Provider Docker Hub.

4

Type in the Repository value:

nuix/rampiva-automate-aio
5

Type in the Tag value:

8.0.0-preview

The latest tag correspond to the latest Rampiva version from the Quarterly Channel. See https://downloads.rampiva.com/automate/release/index.html

6

Click Next.

7

Click Edit in the Web Service rampiva-rampiva-automate-aio.

 

8

Click Edit in the line HTTP Port.

 

9

Change the port to 80.

10

Click Save.

11

Click Back.

12

Click Edit Plan.

13

In the Size section, select at a minimum the option 2 GB RAM | 1 vCPU.

14

Change the containers count to 1.

15

Click Back.

16

Click Next.

17

In the Environment Variables Global section, click Edit.

 

18

Add the following values:

  • RAMPIVA_AUTH_INTERNAL_USERNAME: The name of the user to log in with for the initial configuration, for example rampiva-admin.

  • RAMPIVA_AUTH_INTERNAL_PASSWORD: Choose a strong random password that will be associated with the user.

  • RAMPIVA_STORE_APPLICATION_USERNAME: The database username from the previous step, for example doadmin

  • RAMPIVA_STORE_APPLICATION_PASSWORD: The database password from the previous step

  • RAMPIVA_STORE_APPLICATION_CHARSET: UTF-8

  • RAMPIVA_STORE_APPLICATION_DRIVER_CLASS: org.postgresql.Driver

  • RAMPIVA_STORE_APPLICATION_URL: jdbc:postgresql://HOST:25060/defaultdb?ssl-mode=require , where HOST is the database host value from the previous step.

  • RAMPIVA_STORE_LOGGING_REDIRECT_TO_APPLICATION: true

  • RAMPIVA_STORE_UTILIZATION_REDIRECT_TO_APPLICATION: true

  • RAMPIVA_STORE_APPLICATION_SCHEDULER_MIN_CONNECTIONS: 4

  • RAMPIVA_STORE_APPLICATION_SCHEDULER_MAX_CONNECTIONS: 8

  • RAMPIVA_STORE_APPLICATION_SERVER_MIN_CONNECTIONS: 1

  • RAMPIVA_STORE_APPLICATION_SERVER_MAX_CONNECTIONS: 1

19

Click Save.

20

Click Next.

21

In the App Info section, click Edit.

22

Name the app rampiva-automate-company, where company is the name of your company.

23

Click Save.

24

Select the desired region and click Save.

25

Click Next.

26

Scroll to the bottom of the page and click Create Resources.

27

Wait for the app to be deployed.

28

Click Live App to navigate to the application URL.

29

Confirm that you can log in with the internal username and password set in the previous step.