Automate - Install on Azure App Services

 

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 Azure App Services. A similar deployment is possible on other container services, such as DigitalOcean, 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 

  • Microsoft Azure account


Instructions

A. Install Rampiva Automate

1

Browse to Microsoft Azure at https://portal.azure.com/

 

2

Select the service App Services, or browse to https://portal.azure.com/#view/HubsExtension/BrowseResource/resourceType/Microsoft.Web%2Fsites

3

Click Create to start the configuration of a new service.

4

Create a new resource group named rampiva-automate.

5

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

6

Select the publish option Docker Container.

7

Select the operating system option Linux.

8

Use the default region and Pricing plan.

9

Click Next: Docker >

10

Select the image source option Docker Hub.

 

11

Type in the Image and tag value:

nuix/rampiva.automate.aio: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

12

Click Review + create.

13

Confirm the estimated price and click Create.

 

14

Wait for the deployment to complete and click Go to resource.

15

Copy the application URL.

 

16

Open the copied URL in a new browser tab.

At this step, you will not be able to log in, because no authentication providers were defined.

17

In the Azure App Services tab, select Configuration and add the following new settings using the New application setting link:

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

18

Click Save and Continue, and wait for the application to restart.

19

After the application restarted, you will be prompted to log in. Use the username and password configured at the previous step.

20

Confirm that you can log in with the username and password defined previously.

 

B. Redirect Data to Azure SQL (Optional)

1

Determine if the redirection of data is required.

 

2

Browse to Microsoft Azure at https://portal.azure.com/

3

Select the service SQL servers, or browse to

https://portal.azure.com/#view/HubsExtension/BrowseResource/resourceType/Microsoft.Sql%2Fservers

 

4

Click Create to add a new SQL server.

5

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

6

Select the Authentication method: Use SQL authentication

7

Fill out the Server admin login with the SQL admin username, for example rampiva-sa-admin.

8

Fill out the Password with a strong random password that will be associated with the SQL admin username

9

Fill out the Confirm password.

10

Click Review + create.

11

Confirm the estimated price and click Create.

 

12

Wait for the deployment to complete and click Go to resource.

13

Select the Networking tab.

14

Under the Public access section, select Public network access: Selected networks

15

Scroll down, and select Add a firewall rule

16

Type in the Rule name: Allow all

17

Type in the Start IP: 0.0.0.0

18

Type in the End IP: 255.255.255.255

19

Click OK

 

20

Click Save

 

21

Browse to Microsoft Azure at https://portal.azure.com/

22

Select the service SQL databases, or browse to

https://portal.azure.com/#view/HubsExtension/BrowseResource/resourceType/Microsoft.Sql%2Fservers

 

23

Click Create to add a new SQL database.

24

Name the database automate-db1.

25

Select the SQL server previously created.

26

Select the desired Workload environment: Production.

27

Click Review + create.

28

Confirm the estimated price and click Create.

 

29

Wait for the deployment to complete and click Go to resource.

 

30

Return to the service App Services, or browse to https://portal.azure.com/#view/HubsExtension/BrowseResource/resourceType/Microsoft.Web%2Fsites

 

31

Select the application previously created.

 

32

In the Azure App Services tab, select Configuration and add the following new settings using the New application setting link:

  • RAMPIVA_STORE_APPLICATION_USERNAME: The SQL admin user configured previously.

  • RAMPIVA_STORE_APPLICATION_PASSWORD: The SQL admin password configured previously.

  • RAMPIVA_STORE_APPLICATION_CHARSET: UTF-8

  • RAMPIVA_STORE_APPLICATION_DRIVER_CLASS: net.sourceforge.jtds.jdbc.Driver

  • RAMPIVA_STORE_APPLICATION_URL: jdbc:jtds:sqlserver://SERVER_NAME.database.windows.net:1433/db1;ssl=require , where SERVER_NAME is the name of the SQL server created previously and db1 is the name of the SQL database created previously.

  • 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

33

Verify that the environmental variables have been defined correctly by clicking on Show values.

34

Click Save and Continue, and wait for the application to restart.

 

35

To monitor the application logs, select the Advanced Tools tab → Go → Log stream.

36

Confirm that you can log in with the username and password defined previously.