Skip to main content

Appendix 3: AE installation on Ubuntu

In the appendix, you will learn about installation on Debian based Linux distributions, such as Ubuntu, OpenSuse, and Kali.

tip

The steps and commands were performed on Ubuntu 18.

Environment check

Perform an environment check for the following:

  • Hostname-IP address resolution

  • Firewall settings

  • Steps and commands performed in Ubuntu 18

Prerequisites

Install and configure the following software:

  • Java

  • PostgreSQL with empty vae database

  • Apache Tomcat

  • Apache ActiveMQ

Make necessary changes to set up the Ubuntu environment.

AE installation

For AE installation, create a directory structure and database for AE, and deploy Automation engine and UI war files on Tomcat server.

Create AE directory structure

Create the top-level directory, AE Base Directory in which all AE software and components are installed. You need to create the following directories and setup AE_HOME environment variable:

AutomationEdgeBase 🡪 \preferred_drive\AutomationEdge.

For example, /home/username/Automationedge

AutomationEdge Tools 🡪 \preferred_drive\AutomationEdge/tools.

For example, /home/username/Automationedge/tools

AutomationEdge Home 🡪 preferred_drive:/AutomationEdge/aehome.

For example, /home/username/Automationedge/aehome

Set environment variable

AE_HOME= "\path for the AE working directory\".

For example, AE_HOME=/home/username/Automationedge/aehome

War files deployment

Perform the following steps to deploy war files:

  1. Use the following command to change the directory to webapps:

cd "/home/user_name/AE_Tools/apache-tomcat-10.1.30/webapps"

  1. Use the following command to delete all out-of-the-box apps directories or files or folders from the webapps directory.

rm -rf \*

  1. Copy AE war files to the webapps directory.
tip

Use WinSCP tool if you are copying from Windows to Linux.

  1. Use following command to rename aeengine.war as follows:

mv aeengine-8.0.0.war aeengine.war

  1. Use following command to rename aeui.war as follows:

mv aeui-8.0.0.war aeui.war

  1. Ensure the following are running:

i. ActiveMQ: Start using super user credentials.

ii. PostgreSQL service.

tip

If Postgres DB user password is different, change it in file /tools/automationedge/conf/database.properties.

ii. Tomcat: Start using super user credentials.

tip

Restart the Tomcat service so that .war files get extracted in webapps directory, and database is populated with objects.