summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorOleksandr Kravchuk <oleksandr.kravchuk@pelagicore.com>2018-09-18 15:14:17 +0200
committergunnarx <gunnarx@users.noreply.github.com>2018-09-20 12:36:01 +0200
commit03b95fee8254a29f1a770a78fa89f46b408db084 (patch)
treec967d4d1ad1d1e4ce4da75944d1c9fbfd60c2161 /README.md
parent5adefcddf40dbe6f8e20a2f2c9e4b251956c8f13 (diff)
downloadnode-health-monitor-03b95fee8254a29f1a770a78fa89f46b408db084.tar.gz
README: rename to README.md1.3.6
Signed-off-by: Oleksandr Kravchuk <oleksandr.kravchuk@pelagicore.com>
Diffstat (limited to 'README.md')
-rw-r--r--README.md88
1 files changed, 88 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3ce6d89
--- /dev/null
+++ b/README.md
@@ -0,0 +1,88 @@
+NodeHealthMonitor (NHM) README
+==============================
+
+About
+-----
+
+This is the official source of the NodeHealthMonitor (NHM). The NHM is a system
+software component that observes the system health and initiates configurable
+actions, if issues are identified. An overview about the architecture and how
+the component interacts with the other GENIVI components is available at:
+
+http://wiki.projects.genivi.org/index.php/Lifecycle_cluster
+
+Source repository
+-----------------
+
+The offical git repository of the NHM is located at:
+http://git.projects.genivi.org/lifecycle/node-health-monitor.git
+
+Mailing list
+------------
+
+The mailing list for the NHM and other GENIVI Lifecycle components is:
+https://lists.genivi.org/mailman/listinfo/genivi-lifecycle
+
+Bug reports
+------------
+
+NHM bugs can be reported at:
+http://bugs.genivi.org/
+
+License
+-------
+
+For licensing info see the COPYING file, distributed along with this project.
+
+Authors
+-------
+
+Please see the AUTHORS file, distributed with the project.
+
+Coding style
+------------
+
+Please see the CODING_STYLE document, distributed with the project.
+
+Requirements
+------------
+
+For compilation the NHM needs development versions of the following packages
+installed:
+
+ - automotive-dlt >= 2.2.0
+ - glib-2.0 >= 2.30.0
+ - node-state-manager >= 1.2.0.0
+ - persistence_client_library >= 7.0.0
+ - dbus >= 1.6.4
+ - systemd >= 187
+
+Include and library paths for the packages are obtained via "pkg-config".
+
+Build instructions
+------------------
+
+The NHM is a GNU Build system (autotools) project. An own version of the NHM can
+be set up, configured, compiled, checked and installed by using the following
+commands:
+
+autoreconf -vfi
+./configure <configure-flags>
+make
+make check
+make install
+
+An overview of the possible configuration parameters (especially needed for
+cross compilation) can be retrieved by calling "./configure --help".
+The generated Makefiles will support all "standard targets for users" defined
+by the GNU makefile conventions.
+
+Quality
+-------
+
+The NHM is delivered with a unit test that is executed when "make check" is
+called. The code coverage of the unit test can be measured with tools like
+"gcov". The coverage currently is > 80 % and shall always stay at this level.
+The unit test can be executed using "valgrind" to detect memory leaks. The
+source code of the NHM should be checked with Klocwork when it is available.
+