====== Manual testing with oardocker =====
Set user:
<code bash>
APIUSER=docker:docker
</code>
or to get access to privileged commands
<code bash>
APIUSER=oar:oar
</code>

Then set the URL API:
  * from outside oardocker containers
<code bash>
OARAPI=http://$APIUSER@localhost:46668/oarapi-priv
</code>
  * from inside the oardocker frontend container
<code bash>
OARAPI=http://$APIUSER@localhost:6668/oarapi-priv
</code>

Example of GET request:
<code bash>
curl -i -X GET $OARAPI/jobs/1/details.json
</code>
or
<code bash>
curl -i -X GET $OARAPI/jobs/1/details -H'Content-Type: application/json'
</code>


Example of POST request:
<code bash>
curl -i -X POST $OARAPI/jobs/1.json -d '{"method":"delete"}'
</code>
or
<code bash>
curl -i -X POST $OARAPI/jobs/1 -H'Content-Type: application/json' -d '{"method":"delete"}'
</code>

====== Rspec tests in oardocker ======
Supposing you installed oar-docker, launching the API tests is as simple as:

<code bash>
cd ~/src/oar
oardocker init -e jessie
oardocker build install . start -v $PWD:/home/docker/oar
oardocker connect frontend
cd oar/tests/rspec
# workaround for bad apache init
systemctl restart oardocker-apache.service
make APIURI=http://docker:docker@localhost:6668/oarapi-priv/
</code>
  
WARNING: for the Rspec tests to success, OAR must have at least 4 * 2 cores.
====== Rspec tests in oar-vagrant ======
Follow the instructions from the [[oar-vagrant]] page. Set up a 2 nodes cluster with:
<code bash>
OARVAGRANT_NODES_COUNT=2 vagrant up
</code>
===== Connection =====
To get root access on the VMs, you'll have to connect with the vagrant user:
<code bash>
vagrant ssh frontend -- -l vagrant
vagrant@frontend: /home/vagrant $ sudo su -
root@frontend: /root # 
</code>
===== Debian dependencies =====
If you run a Debian appliance:
  * Install dependencies on the "frontend" host:
<code bash>
root@frontend:~# apt-get install ruby-rspec ruby-rest-client
</code>
  * If you want to run the oaradmin tests, you need to install oaradmin:
<code bash>
root@frontend:~# apt-get install libdbd-pg-ruby oar-admin
</code>
===== Centos dependencies =====
If you run a Centos appliance:

* Install RPM dependencies
<code bash>
yum install rubygems
</code>

* Install a recent ruby version, using RVM
<code bash>
curl -L get.rvm.io | bash -s stable
source /etc/profile.d/rvm.sh
rvm requirements
rvm install 1.9.3
rvm use 1.9.3 --default
</code>

* Install required gems
<code bash>
gem install rspec rest_client json
</code>
===== Running the tests =====
  * Copy the test files from the OAR git repository into the current Vagrant directory:
<code bash>
# From your local host, inside the vagrant directory, supposing you have OAR sources into ~/git/oar:
[bzizou@bart|oar-vagrant]$ cp -a ~/git/oar/tests/rspec .
</code>
  * Log on as root on the frontend, ans prepare some more resources (faking more cores)
<code bash>
# Copy/paste this in a root session on the frontend
oarnodesetting -s Dead -h node-2
ssh server oarremoveresource 2
oarnodesetting -a -h node-1 -p cpu=0 -p core=1 -p cpuset=0
oarnodesetting -a -h node-1 -p cpu=1 -p core=2 -p cpuset=0
oarnodesetting -a -h node-1 -p cpu=1 -p core=3 -p cpuset=0
oarnodesetting -a -h node-2 -p cpu=2 -p core=4 -p cpuset=0
oarnodesetting -a -h node-2 -p cpu=2 -p core=5 -p cpuset=0
oarnodesetting -a -h node-2 -p cpu=3 -p core=6 -p cpuset=0
oarnodesetting -a -h node-2 -p cpu=3 -p core=7 -p cpuset=0
</code>
  * If you installed Ruby with RVM (centos appliance), source rvm profile, as user1:
<code bash>
[user1@frontend|rspec]$ source /etc/profile.d/rvm.sh
</code>

  * Launch the tests from the frontend, as user1:
<code bash>
[user1@frontend|rspec]$ cd /vagrant/rspec
[user1@frontend|rspec]$ make APIURI=http://localhost:6668/oarapi/
</code>
**Warning!** Don't forget the trailing slash at "/localhost/oarapi/"!
  * Launch the tests for resources creation, as oar (admin) - This needs oar-admin (not available as packages for Centos):
<code bash>
[user1@frontend|rspec]$ su -
root@frontend:~# su - oar
[oar@frontend|rspec]$ cd /vagrant/rspec
[oar@frontend|rspec]$ make resources_creation APIURI=http://localhost/oarapi/
</code>
**Warning!** Don't forget the trailing slash at "/localhost/oarapi/"!