Installation

Installation

This page describe instructions to install almond automation.
If you have docker in your machine then you can use docker-compose file to install Almond Automation.

Using Docker Compose

Create below docker-compose.yaml

selhub:
  image: selenium/hub
  ports:
    - 4444:4444
nodeff:
  image: selenium/node-firefox-debug
  ports:
    - 5900
  links:
    - selhub:hub
nodechrome:
  image: selenium/node-chrome-debug
  ports:
    - 5900
  links:
    - selhub:hub
almond-automation:
  image: dharmendra82/almond-automation:latest
  ports:
    - 8080:8080
    - 3306:3306
  links:
    - selhub:hub

Run below command to start Almond Automation

docker-compose up -d

It will create Mariadb, Selenium grid and Almond Automation. Access Almond Automation at

http://localhost:8080/automation

If you don't have docker installed then follow below instructions.

Prerequisite

Almond Automation is web based automation tool written in java.

You need to have following software before started installing Almond Automation.

1. You need to have Java 7+ installed.
2. Mariadb Database

Create Mariadb Database and User

Create Mariadb database automation and user to access new database

create database <<database name>>;
create user '<<database user>>'@'%' identified by '<<database password>>';
grant all privileges on *.* to '<<database user>>'@'%' identified by '<<database password>>';
grant all privileges on *.* to '<<database user>>'@'localhost' identified by '<<database password>>';

Update database name, user and password as per your need.

Install Almond Automation

1. Download latest automation.jar and run below command
   

   java -jar automation.jar -Ddb.host=<<database-server>> -Ddb.port=<<database-port>> -Ddb.name=<<database-name>> -Ddb.user=<<database-user>> -Ddb.password=<<database-password>>

   I start my server by running below command

   java -jar automation.jar -Ddb.host=localhost -Ddb.port=3306 -Ddb.name=automation -Ddb.user=automation -Ddb.password=automation

2. By default automation.jar uses 8080 port. If you want to use different port then run below command by passing httpPort parameter

   java -jar automation.jar -Ddb.host=<<database-server>> -Ddb.port=<<database-port>> -Ddb.name=<<database-name>> -Ddb.user=<<database-user>> -Ddb.password=<<database-password>> -httpPort=9999

Verify Installation

Go to http://localhost:8080/automation/.

You should see page like

If you don't see above page then please check database credentials and server log.