Blame view

README.md 1.76 KB
c79ba61c0   Alexandre Chapellon   fix readme file
1
  # Alfresco benchmark playbook
e17e20eee   Alexandre Chapellon   first stage playbook
2
3
  
  This ansible playbook allows one to easily deploy an Alfresco benchmark infrastructure on multiple servers.
c79ba61c0   Alexandre Chapellon   fix readme file
4
  ## Requirements
e17e20eee   Alexandre Chapellon   first stage playbook
5

381487b32   Alexandre Chapellon   Add requirements ...
6
  ### Software requirement
e17e20eee   Alexandre Chapellon   first stage playbook
7
8
9
10
  The playbook has been written and tested with Ansible 2.2. Some additionnal modules have been added to the playbook:
  
   * ansible-xml by cmprescott (requires python-lxml on remote end)
   * selenium
381487b32   Alexandre Chapellon   Add requirements ...
11
12
13
  ### Architectural requirement
  
  This playbook doesn't deploy SSH keys so please make sure you're using it on nodes that already have the needed SSH keys.
e17e20eee   Alexandre Chapellon   first stage playbook
14
  At the moment the target hosts need to have direct acces to internet as we are using public repos.
381487b32   Alexandre Chapellon   Add requirements ...
15
  Also all names used in the inventory file need to be fully qualified DNS names resolvable by all hosts.
c79ba61c0   Alexandre Chapellon   fix readme file
16
  ## How to use:
e17e20eee   Alexandre Chapellon   first stage playbook
17

381487b32   Alexandre Chapellon   Add requirements ...
18
19
20
  Edit the _inventory_ file and add your (FQDN) hostnames to the appropriate section. If you don't understand the roles of each server, you should probably start reading [Derek Huley's documentation](https://github.com/AlfrescoBenchmark/alfresco-benchmark/tree/master/docs) about the [Alfresco benchmark framework](https://github.com/AlfrescoBenchmark).
  
  To start using the playbook simply start it with:
e17e20eee   Alexandre Chapellon   first stage playbook
21

381487b32   Alexandre Chapellon   Add requirements ...
22
23
24
25
26
27
28
29
30
  ```
  $ ansible-playbook -i inventory alfbm.yml
  ```
  
  If you're loging in as a normal user and need to "sudo", use the command bellow:
  
  ```
  $ ansible-playbook -i inventory alfbm.yml -b -K
  ```
43afd6014   Alexandre Chapellon   update readme fil...
31
  If some options need to be changed (e.g. java or tomcat version, etc...), edit the group_vars/all file or the host_vars/<HOSTNAME> if the variable is host specific.
c79ba61c0   Alexandre Chapellon   fix readme file
32
  ## TODO
e17e20eee   Alexandre Chapellon   first stage playbook
33
34
35
  
   * Make it possible to download software from the Ansible machine instead of target machine (in case target cannot access internet).
   * Allow Oracle JDK usage
381487b32   Alexandre Chapellon   Add requirements ...
36
   * Allow non-key based play of the book
8e6d68230   Alexandre Chapellon   Having x11vnc att...
37
   * Attach real VNC server to be able to see what selenium actually doing headless
381487b32   Alexandre Chapellon   Add requirements ...
38