Skip to content

Aikau Setup (Linux)

Jump to bottom
Martin Doyle edited this page Feb 19, 2015 · 17 revisions

Operating System

These instructions have been run successfully on the following operating systems:

  • Linux Mint 17.1 Cinnamon (Ubuntu-based)

Initial setup

After performing these instructions you will be able to run the automated tests locally:

  • Install Chrome, Git, Maven
    • sudo apt-get update
    • sudo apt-get install -y google-chrome-stable git maven
  • Install NVM (full instructions here)
    • git clone https://github.com/creationix/nvm.git ~/.nvm
    • cd ~/.nvm
    • ``git checkout `git describe --abbrev=0 --tags```
  • Add the NVM startup script to your profile (adjust profile shell-file as appropriate)
    • echo "source ~/.nvm/nvm.sh" >> ~/.bashrc
  • Close and reopen your terminal window
  • Install Node
    • nvm install 0.12
  • Install grunt and selenium server
    • sudo npm install -g grunt-cli
    • sudo npm install -g selenium-standalone
  • Initialise and startup selenium
    • sudo selenium-standalone install
    • sudo selenium-standalone start
  • Open a new terminal window
  • Create a working directory and go to it (choose your own directory as appropriate)
    • mkdir -p ~/develop/git
    • cd ~/develop/git
  • Clone the Aikau project and checkout the develop branch
    • git clone https://github.com/Alfresco/Aikau.git
    • cd Aikau
    • git checkout develop
  • Within the aikau sub-project, install dependencies and start the test server
    • cd aikau
    • npm install
    • mvn clean install jetty:run

Running the tests

  • Open a new terminal window
  • Edit the src/test/resources/config/Suites.js class:
    • Change the name of the variable xbaseFunctionalSuites to baseFunctionalSuites and vice versa (i.e. move the “x”)
    • NOTE: Doing this will limit the number of tests run, so that you can test the setup without waiting for all of the tests to execute
  • Go to your aikau directory and try to run the local tests
    • cd ~/develop/git/Aikau/aikau
    • grunt test_local (Sets up required files)
    • grunt test_local (Performs the tests)
  • NOTE: You will only need to run the test command twice on the very first time you run it

Running the tests on a vagrant VM

  • Open a new terminal window if necessary
  • Install vagrant and virtualbox
    • sudo apt-get update
    • sudo apt-get install -y vagrant virtualbox-4.3
  • Go to your aikau directory and create a vagrant server and try to run some tests on it (make sure you are still using the reduced test-run)
    • cd ~/develop/git/Aikau/aikau
    • grunt vcreate
    • grunt test

Caveats and recommendations

Clone this wiki locally