Manual installation

  1. For Linux :

    1. Requirements :

      1. MySQL/MariaDB server and client (If you want to use MySQL, you must get the 5.6.x version)

      2. Java 1.8 (package name on debian/ubuntu : openjdk-8-java)

      3. glassfish server (4.1.1) : you can download it on their website (if you are on CLI, just use wget on the download url)

        1. You’ll have to add MySQL JDBC connector drivers that you can get there : http://dev.mysql.com/downloads/connector/j/

        2. You must add AS_JAVA="path/to/java/folder/" in glassfish/config/asenv.conf

    2. Cerberus installation :

      1. Download the last release of Cerberus Testing on the sourceforge : https://sourceforge.net/projects/cerberus-source/files/

      2. Setup your MySQL/MariaDB database :

        1. Connect on your MySQL/MariaDB server (Default : mysql -u root -proot)

        2. Type these commands :

          1. CREATE USER 'cerberus'@'%' IDENTIFIED BY 'toto';

          2. GRANT USAGE ON * . * TO 'cerberus'@'%' IDENTIFIED BY 'toto';

          3. GRANT USAGE ON * . * TO 'cerberus'@'localhost' IDENTIFIED BY 'toto';

          4. CREATE DATABASE IF NOT EXISTS cerberus ;

          5. GRANT ALL PRIVILEGES ON cerberus . * TO 'cerberus'@'%';

      3. Edit the file (CerberusFolder/bin/)00Config.sh with your connection parameters and set the GLASSFISHPATH to the path to the bin folder of glassfish

      4. If you are using MariaDB, you’ll have to edit (CerberusFolder/bin/)01AppServerConfig.sh, comment the line under MySQL and uncomment the line under MariaDB.

      5. Run (CerberusFolder/bin/)01AppServerConfig.sh it will set the default configs of Cerberus Testing like the connection to the Cerberus database

      6. Run (CerberusFolder/bin/)02DeployApp.sh it will check that there’s no deployed Cerberus App and deploy the Cerberus App in the contextroot specified (Default : /Cerberus)

      7. You’re done ! You should be able to access to your Cerberus App from your website (example : http://localhost:8080/Cerberus)

Docker

  1. For Windows :

    1. Install Git for Windows -→ https://git-for-windows.github.io/

    2. Install Docker for Windows -→ https://docs.docker.com/docker-for-windows/

    3. Install Docker Toolbox for Windows -→ https://docs.docker.com/toolbox/toolbox_install_windows/

    4. Clone Cerberus-source to the desired location :

      1. Go to the desired location folder

      2. Right click into the folder, and click Git Bash Here gitBashHere

      3. Type the following command into Git Cmd Prompt : "git clone https://github.com/cerberustesting/cerberus-source.git" gitBashPrompt

      4. Wait for cerberus-source to clone…​

    5. Run Docker. /!\ You may have to go into Docker settings to "share the drive" on which you put cerberus

    6. Run Windows Command Prompt as administrator, navigate to your desired location, then subfolders compositions/cerberus-glassfish-mysql winCmdPrompt

    7. Execute the following command :

      1. either "docker-compose up" to run the docker-compose normally

      2. or "docker-compose up -d" to run the docker-compose asynchronously

      3. or "docker-compose up -d --remove-orphans" to run the docker-compose and remove already existing images

      4. or "docker-compose scale selenium-node-firefox=3 selenium-node-chrome=3" to add more nodes to your Selenium Grid

    8. Wait for the images to startup

    9. Open your favorite browser and go to <docker_host>:18080/Cerberus, where <docker_host> is your Docker host

  1. For Mac :

  2. For Linux :