Update the documentation to Danube release: JIRA: DOCTOR-81
[doctor.git] / docs / installationprocedure / feature.configuration.rst
1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
2 .. http://creativecommons.org/licenses/by/4.0
3
4 Doctor Configuration
5 ====================
6
7 Doctor Inspector
8 ----------------
9
10 Doctor Inspector is suggested to be placed in one of the controller nodes,
11 but it can be put on any host where Doctor Monitor can reach and access
12 the OpenStack Controller (Nova).
13
14 Make sure OpenStack env parameters are set properly, so that Doctor Inspector
15 can issue admin actions such as compute host force-down and state update of VM.
16
17 Then, you can configure Doctor Inspector as follows:
18
19 .. code-block:: bash
20
21     git clone https://gerrit.opnfv.org/gerrit/doctor -b stable/danube
22     cd doctor/tests
23     INSPECTOR_PORT=12345
24     python inspector.py $INSPECTOR_PORT > inspector.log 2>&1 &
25
26 Doctor Monitor
27 --------------
28
29 Doctor Monitors are suggested to be placed in one of the controller nodes,
30 but those can be put on any host which is reachable to target compute host and
31 accessible by the Doctor Inspector.
32 You need to configure Monitors for all compute hosts one by one.
33
34 Make sure OpenStack env parameters are set properly, so that Doctor Inspector
35 can issue admin actions such as compute host force-down and state update of VM.
36
37 Then, you can configure the Doctor Monitor as follows (Example for Apex deployment):
38
39 .. code-block:: bash
40
41     git clone https://gerrit.opnfv.org/gerrit/doctor -b stable/danube
42     cd doctor/tests
43     INSPECTOR_PORT=12345
44     COMPUTE_HOST='overcloud-novacompute-1.localdomain.com'
45     COMPUTE_IP=192.30.9.5
46     sudo python monitor.py "$COMPUTE_HOST" "$COMPUTE_IP" \
47         "http://127.0.0.1:$INSPECTOR_PORT/events" > monitor.log 2>&1 &