1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
|
.. This work is licensed under a Creative Commons Attribution 4.0 International License.
.. http://creativecommons.org/licenses/by/4.0
*************************
Feature: Healthcheck
*************************
.. contents::
:depth: 3
Summary
^^^^^^^
The Healthcheck feature provides reports used to verify the health of *PolicyEngine.manager* in addition to the construction, operation, and deconstruction of HTTP server/client objects.
Usage
^^^^^
When enabled, the feature takes as input a properties file named "*feature-healtcheck.properties*" (example below). This file should contain configuration properties necessary for the construction of HTTP client and server objects.
Upon initialization, the feature first constructs HTTP server and client objects using the properties from its properties file. A healthCheck operation is then triggered. The logic of the healthCheck verifies that *PolicyEngine.manager* is alive, and iteratively tests each HTTP server object by sending HTTP GET requests using its respective client object. If a server returns a "200 OK" message, it is marked as "healthy" in its individual report. Any other return code results in an "unhealthy" report.
After the testing of the server objects has completed, the feature returns a single consolidated report.
.. code-block:: bash
:caption: feature-healthcheck.properties
:linenos:
###
# ============LICENSE_START=======================================================
# feature-healthcheck
# ================================================================================
# Copyright (C) 2017 AT&T Intellectual Property. All rights reserved.
# ================================================================================
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
# ============LICENSE_END=========================================================
###
http.server.services=HEALTHCHECK
http.server.services.HEALTHCHECK.host=0.0.0.0
http.server.services.HEALTHCHECK.port=6969
http.server.services.HEALTHCHECK.restClasses=org.onap.policy.drools.healthcheck.RestHealthCheck
http.server.services.HEALTHCHECK.managed=false
http.server.services.HEALTHCHECK.swagger=true
http.server.services.HEALTHCHECK.userName=healthcheck
http.server.services.HEALTHCHECK.password=zb!XztG34
http.client.services=PAP,PDP
http.client.services.PAP.host=pap
http.client.services.PAP.port=9091
http.client.services.PAP.contextUriPath=pap/test
http.client.services.PAP.https=false
http.client.services.PAP.userName=testpap
http.client.services.PAP.password=alpha123
http.client.services.PAP.managed=true
http.client.services.PDP.host=pdp
http.client.services.PDP.port=8081
http.client.services.PDP.contextUriPath=pdp/test
http.client.services.PDP.https=false
http.client.services.PDP.userName=testpdp
http.client.services.PDP.password=alpha123
http.client.services.PDP.managed=false
To utilize the healthcheck functionality, first stop policy engine and then enable the feature using the "*features*" command.
.. code-block:: bash
:caption: Enabling Healthcheck feature
policy@hyperion-4:/opt/app/policy$ policy stop
[drools-pdp-controllers]
L []: Stopping Policy Management... Policy Management (pid=354) is stopping... Policy Management has stopped.
policy@hyperion-4:/opt/app/policy$ features enable healthcheck
name version status
---- ------- ------
controlloop-utils 1.1.0-SNAPSHOT disabled
healthcheck 1.1.0-SNAPSHOT enabled
test-transaction 1.1.0-SNAPSHOT disabled
eelf 1.1.0-SNAPSHOT disabled
state-management 1.1.0-SNAPSHOT disabled
active-standby-management 1.1.0-SNAPSHOT disabled
session-persistence 1.1.0-SNAPSHOT disabled
The output of the enable command will indicate whether or not the feature was enabled successfully.
Policy engine can then be started as usual.
The Healthcheck can also be invoked manually as follows:
.. code-block:: bash
:caption: Manual Healthcheck invokation
# Assuming the healthcheck service credentials have not been changed
# post-installation within the drools container
source /opt/policy/config/drools/feature-healthcheck.conf
curl --silent --user "${HEALTHCHECK_USER}:${HEALTHCHECK_PASSWORD}" -X GET http://localhost:6969/healthcheck | python -m json.tool
End of Document
.. SSNote: Wiki page ref. https://wiki.onap.org/display/DW/Feature+Healthcheck
|
