INSTALLATION GUIDE FOR

AGENT, STUDIO & CENTERNetwork License

2

2

Table of ContentsI. INTRODUCTION …………………………………………………………………………… 3

II. INSTALL AKABOT STUDIO & AKABOT AGENT …………………………...…………4

1. Download Installer ..…………………………………………………………………….....4

2. Install akaBot platform .………….………………………………………………………... 4

3. Install web extension .…………………………………………………………………….... 7

II. INSTALL AKABOT CENTER ……………………………………………………………10

1. Install JAVA JDK .......……………………………………………………………………..10

2. Install MySQL .……………………………………………………………………………..14

3. Install TomCat ..…………………………………………………………………………….25

4. Install Apache Active Queue ...…..……………………………………………………….30

5. Install AKABOT CENTER ..……………………………………………………………….33

III. SYSTEM REQUIREMENTS ……………………………………………………………. 37

1. AKABOT STUDIO ……………………………………………………………………....... 37

2. AKABOT AGENT …...……………………………………………………………………..37

3. AKABOT CENTER .…...…………………………………………………………………..38

https://akabot.com

3

I. INTRODUCTION

akaBot is at the forefront of transforming the future of robotic process automation. The

software is designed to serve businesses of different sizes. For businesses with a high

volume of human labor, akaBot provides a reliable technology that adds impetus to their

innovation and profitability.

This document aims to give you a step-by-step instruction on how to install akaBot

Studio, Agent & Center for NETWORK license. NETWORK license is provided as a

package with 1 Center License and a quota on the number of Studio & Agent licenses.

Instead of activating from central license management system, you can generate,

activate and manage Studio & Agent licenses from your akaBot Center.

Start using NETWORK license by installing akaBot Center, Studio & Agent. For

installation, you can install the components in any order, on the same or different

machines, as you wish. However, for activation, you will need to activate Center first,

before moving on to activate Studio & Agent. Please follow this document for details on

installation.

Once installation is completed, please proceed to activate the components. License key

for Center is provided in the Licensing Email. License key for Agent & Studio can be

acquired from Center. More details on Activation is attached in Licensing Email.

Thank you and Enjoy automating with akaBot!

https://akabot.com

3

II. INSTALL AKABOT STUDIO & AKABOT AGENT

Before you start:

1. akaBot Studio & Agent are included in the same installer. By the end of Part II, you will

have both components installed. However, activation will be separate for these

components.

2. Note that this guide is only for Installation. To activate Studio & Agent, you will need to

install & activate Center first, then get the license key for Studio & Agent from Center.

3. Please make sure your machine meet System Requirements.

Step 1: Download Installer

To install the akaBot Studio & akaBot Agent, you will need the installer file in .msi or .exe

format. You can download it from the link provided in the Licensing Email or here.

Successful download will lead you to akaBotPlatform.zip file.

In this file you will see two versions for akaBot Installer: 64-bit and 32-bit. Unzip the

appropriate folder to find the .msi file.

Step 2: Install akaBot platform (Agent + Studio)

Run the Installer. A Setup Wizard will show up as below.

Please follow the steps as specified on the prompt to continue installation process.

Simply hit “Next”.

4

4

https://akabot.com

5

Hit “Next”

Hit “Next”

https://akabot.com

6

6

After the installation is done, you will see the Installation Complete notification as

below. Hit “Close”. Now you should have the shortcuts for akaBot Studio & Agent

successful present on the desktop.

This Installation Prompt will show up.

https://akabot.com

Step 3: Install web extension (Optional)

To facilitate akaBot’s interaction with web applications, you may need to install

akaBot extension on your web browser. Please follow the below steps:

- Open Extensions page on your web browser. E.g. Chrome

- Turn on developer mode

7

7

- Turn on Developer Mode.

https://akabot.com

- This will prompt you to Select Extension prompt as below.

Browse to akaBot BrowerExtentsions folder in C:\Program Files\FPT

Software\akaBot Platform\akaBot\BrowserExtensions in a 64-bit system.

- Choose the browser you want to install the extension on. Then click “Select Folder”

button.

8

- Click on “Load unpacked”

https://akabot.com

9

9

- If you see this confirmation prompt, you have successfully installed akaBot

Web Extension.

https://akabot.comhttps://akabot.com

Before you start:

1. akaBot Center requires some additional programs to be installed. The instruction is

included in this guideline.

A. JAVA JDK 8

B. MySQL Community Server

C. Tomcat

D. Apache Active Queue

2. Please make sure your machine meet the System Requirements.

A. JAVA JDK 8

Step 1: Download Java JDK 8

1. Go to Java SE download site at JAVA SE

2. Scroll down to Java SE Development Kit. You will see a list of versions for different

systems. Download the version for your Operating System.

III. INSTALL AKABOT CENTER

10

10

https://akabot.com

11

https://akabot.com

3. Accept Oracle License Agreement. Click Download. This will lead you to Oracle Login

Website.

4. Log in with your Oracle Account. Successful login will prompt the Download to start.

12

https://akabot.com

Step 2: Install Java JDK 8

1. Run the Installer you have downloaded from Step 1. Make sure you run as

Administrator. You will see a Setup Wizard to guide you through the steps. Simply

click “Next” for all prompts.

13

https://akabot.com

2. After Installation is complete, you will see the Complete Notification as below. Simply

click “Close”. You have successfully installed JDK.

B. MySQL 8.0

Step 1: Download MySQL 8.0

1. Go to MySQL download site at https://dev.mysql.com/downloads/installer/

2. Follow the website instructions to download MySQL. Choose MySQL Community

Installer.

14

https://akabot.com

Step 2: Install MySQL

1. Run the Installer you have downloaded from Step 1. Make sure you run as

Administrator. You will see a Setup Wizard to guide you through the steps.

2. To run akaBot Center, you will need MySQL Server and MySQL Workbench.

Choose “Custom” as the Setup Type. Click “Next”.

14

https://akabot.com

3. Under MySQL Servers > MySQL Server, choose the newest version for MySQL

Server. Add to the download list by clicking the green arrow (i).

4. Similarly, under Application > MySQL Workbench, choose the newest version for

MySQL Workbench. Add to the download list by clicking the green arrow (i).

5. Now you should see MySQL Server and MySQL Workbench in the “Products To

Be Installed” box. Click “Next”.

(i)

6. Click “Execute” to start installation. Wait until all products have been installed.

16

16

https://akabot.com

7. Click “Next”.

8. Click “Next”.

17

17

https://akabot.com

9. Click “Next”.

10. Click “Next”.

18

18

https://akabot.com

11. Click “Next”.

12. Set a MySQL Root Password. It is recommended you set it to the default password

”sis@12345” to avoid having to update Config file later. Click “Next”.

19

19

https://akabot.com

13. Click “Next”.

14. Click “Execute” to apply the changes.

20

20

https://akabot.com

15. Wait till everything is finished. Click “Finish”.

16. Click “Next”.

21

21

https://akabot.com

17. If you see this prompt, we have successfully finished installation. Click “Finish”.

22

https://akabot.com

Step 3: Setup MYSQL account to enable remote connection

Please follow these steps to set up remote connection with MYSQL.

1. Create a MYSQL account and grant access to specific database (akaBot Center

Database in this document)

i. Open MySQL Workbench. Go to “Local instance”. You will see a “Connect to

MySQL Server” prompt. Enter the password for root account, which you have set

in Step 2.12.

23

23

https://akabot.com

ii. If “aka_orchestrator” database has not been created, create it as follows:

1. Click (1) to open Create new database prompt.

2. Input Schema Information as below:

• Name: aka_orchestrator

• Charset/Collation: utf8 ; utf8_general_ci

3. Hit “Apply”.

4. “Apply SQL Script to Database” dialog will show up. Click “Apply”.

5. Click “Finish”.

1

4

5

24

https://akabot.com

Step 4: Test MySQL from remote client using MySQL Workbench

Before installing other software, make sure that MySQL has been set up properly.

1. Re-open MySQL Workbench .

2. Click the “Add Connection” button (see picture below) to open “Setup New

Connection” window.

3. In the “Setup New Connection” prompt, create a Connection Name and enter your

Username (Account created in Step 2.12)

4. Click “Test Connection”.

5. You will see a prompt to enter your credentials. Enter your password. Click “OK”.

6. If you see a prompt confirming successful connection, MySQL has been successfully

installed.

25

25

C. Apache Tomcat 8.5

Step 1: Download TOMCAT

1. Go to MySQL download site at https://tomcat.apache.org/download-80.cgi

2. Choose the appropriate installer for your operating system (64 or 32 bit).

Step 2: Install TOMCAT

1. Run the apache-tomcat-8.5.53.exe file you have downloaded from Step 1. Make sure you

Run as Administrator.

2. In Windows 10, the Windows Defender Smart Screen prompt might show up. Confirm

to run by clicking “Run anyway”.

3. Apache Tomcat Setup prompt will show up. Click “Next”.

26

26

4. Click “I Agree”.

5. Click “Next”.

27

27

6. Leave all fields as Default. Click “Next”.

7. Click “Next”.

28

28

7. Click “Install”.

8. Wait until the Installation is finished.

29

29

9. Click “Finish”.

30

30

D. APACHE ACTIVE MESSAGE QUEUE

Step 1: Download Active Queue

1. Go to ActiveMQ 5.15 download site: https://activemq.apache.org/download-archives

2. Under “All time Apache ActiveMQ releases pages”, select package version 5.15.1.

3. You will be redirected to the page below. Download the Windows Distribution

package.

Step 2: Install Active Queue

1. Unzip the downloaded file in Step 1. You will see the folder below. Open “BIN”.

31

31

2. You will see the folder below. Depending on your current OS, open “WIN32” or “WIN64”.

3. Right click on “InstallService.Bat” and select “Run as administrator”.

Step 3: Verify installation

1. Press Windows + R key to open run dialog, type “services.msc”. Hit “OK”.

32

32

2. You will find the “Services” prompt as below. Click on “ActiveMQ” (1). You will see the

“ActiveMQ Properties” prompt show up. Click “Start” (2).

3. Navigate to URL: http://localhost:8161/

4. If needed, enter the default credential as below

• Username: admin

• Password: admin

5. If you see the result as below, you have successfully installed ActiveMQ.

1

2

33

33

E. AKABOT CENTER

Step 1: Create MySQL Database for CENTER

1. You should already have “aka_orchestrator” database created in Step 3.1.viii.

Step 2: Get CENTER Installation Package

You can acquire CENTER installation package from the Licensing Email, or from this link.

This package contains one .war file (E.g: “akaBot-center-2.0.1.1.war”). Rename this file to

“ROOT.war”.

Step 3: Stop TOMCAT

1. Press Windows + R key to open run dialog, type “services.msc”. Hit “OK”.

2. Click on Apache Tomcat 8. (1)

3. You will see the “Apache Tomcat 8 Properties” prompt show up. Click “Stop” (2).

1

2

34

34

Step 4: Copy root.war into Tomcat8.5\webApps folder

1. Locate Tomcat 8.5/webApps directory. Remove everything in this folder.

2. Copy root.war file to this directory.

Step 5: Start Tomcat to unzip ROOT.war. Verify ROOT.war has been unzipped. Then

Stop TOMCAT.

1. Start Apache Tomcat 8.5 service. The steps are similar as in Step 3.

2. After you start TOMCAT, go back to Tomcat 8.5/webApps. You should see an

unzipped ROOT folder.

3. Stop Apache Tomcat 8.5 service. The steps are similar as in Step 3.

35

35

Step 4: Update credentials information

1. Go back to Tomcat 8.5/webApps. You should see the ROOT folder already

unzipped.

2. Go to ROOT > WEB-INF > classes > config. You will need to update information

into 2 files: “application-prod.yml” and “application-dev.yml”.

3. In each file, update the following information. Make sure you change for both files.

1. Database Credentials (Created from Step 3.12). If you use the default

Credentials (root / sis@12345), you will not have to update this.

2. Database URL: Change the initial part of the URL (See Picture below).

It should be

[IP Address of the machine with akaBot Center]:3306/[Database Name].For example, if your Machine’s IP Address is 10.16.20.16, Database Name is aka_orchestrator, then the

Database URL should be changed to jdbc:mysql:// 10.16.20.16:3306/aka_orchestrator/...

2

1

36

36

Step 6: Verify the result.1. Open your browser and navigate to : http://localhost:8080/#/ . If you are using a

different machine (not the machine where Center is installed), replace “localhost”

with the Center Machine’s IP address.

2. Enter your account to access CENTER

1. Username: admin

2. Password: admin

If you log in successfully, you have successfully installed akaBot Center.

Step 5: Start TOMCAT

Follow the same steps in Step 3 to start TOMCAT again.

37

III.SYSTEM REQUIREMENTS

1. AKABOT STUDIO

HARDWARE REQUIREMENTS

https://akabot.com

Item Pre-requisites Recommended

CPU 1.4 GHz 32-bit (x86) Dual Core 1.8 GHz

RAM 4 GB 4 GB

SOFTWARE REQUIREMENTS

Item Supported Versions

Operating

Systems

Windows 7

Windows 8

Windows 10

Windows Server 2008 R2

Windows Server 2012 R2

Windows Server 2016

.NET

FrameworkMinimum: 4.5.2

2. AKABOT AGENT

HARDWARE REQUIREMENTS

Item Pre-requisites Recommended

CPU 2x1.8 GHz 32-bit (x86) 4x2.4 Hz 64-bit

RAM 4 GB 4 GB

SOFTWARE REQUIREMENTS

Item Supported Versions

Operating

Systems

Windows 7

Windows 8.1

Windows 10

Windows Server 2008 R2

Windows Server 2012 R2

Windows Server 2016

.NET

FrameworkMinimum: 4.5.2

38

3. AKABOT CENTER

HARDWARE REQUIREMENTS

https://akabot.com

Number of

Robots

CPU Cores

(min 2 GHz)

RAM

(GB)

HDD

(GB)

<20 4 8 200

<50 4 8 250

<100 4 8 300

<200 4 8 350

<250 4 8 400

<300 8 16 400

<400 8 16 450

<500 16 16 450

SOFTWARE REQUIREMENTS

Item Supported Versions

Operating Systems

Windows 7

Windows 8.1

Windows 10

Windows Server 2008

R2 Windows Server

2012 R2 Windows

Server 2016

MySQL

Community ServerMinimum: MySQL Community Server version 8.0

JRE (JDK*) Minimum: JRE 8 (JDK 8)

Tomcat Minimum: Tomcat 8.5

Apache Active

Message QueueMinimum: version 1.15.1

*JDK is optional