X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=README;h=f2bfa10927425c87fc22a5d9aab0e0ce6993626b;hb=4a5eb5e9a97fac1ad51a1e7be94c460d2f071ae3;hp=7371c46e3fcd6f86a64b4e13086bed313bc143ae;hpb=70a3f7daeac51f82b5d81dedc5ad8ca267d72173;p=sysdb.git
diff --git a/README b/README
index 7371c46..f2bfa10 100644
--- a/README
+++ b/README
@@ -16,11 +16,35 @@
like a software system. Both, hosts and services, may reference a list of
attributes which represent further information about the respective host or
service object. For example, attributes may specify static information like
- a host's architecture or the software version or reference performance data
- like the current memory utilization or much more.
+ a host's architecture or the software version. A host may also reference a
+ list of metrics which are references to performance data stored about the
+ host. SysDB supports querying the respective time-series from a backend's
+ data store.
SysDB is free and open source software, licensed under the 2-clause BSD
- license. See COPYING for details.
+ license. See COPYING for details. Changes between all SysDB releases can be
+ found in the file ReleaseNotes.
+
+
+
+Configure and install SysDB
+---------------------------
+
+ To configure, build and install SysDB with the default settings, run
+ â./configure && make && make installâ. For detailed, generic instructions
+ see INSTALL. For a complete list of configure options and their description,
+ run â./configure --helpâ.
+
+ Various third-party packages are required for a full installation of SysDB.
+ See the section âPrerequisitesâ below for details. A summary of
+ user-supplied and auto-detected build settings is displayed at the end of
+ each âconfigureâ run. Consult this first for trouble-shooting.
+
+ By default, SysDB will be installed into â/opt/sysdbâ. You can adjust this
+ setting by specifying the â--prefixâ configure option - see INSTALL for
+ details. If you pass DESTDIR= to âmake installâ, will be
+ prefixed to all installation directories. This might be useful when creating
+ packages for SysDB.
Prerequisites
-------------
@@ -46,11 +70,10 @@ Prerequisites
- * asciidoc, xsltproc, xmlto:
+ * asciidoc, xmlto:
The AsciiDoc text document format is used to write the manpages.
-
* libedit or libreadline:
@@ -82,30 +105,34 @@ Testing
tests will be disabled automatically.
For the latest build status, see:
-
+
Code coverage testing using Gcov may be enabled when using the
â--enable-gcovâ configure option.
For the latest coverage report, see:
-
+
-Configuring / Compiling / Installing
-------------------------------------
+Documentation
+-------------
- To configure, build and install SysDB with the default settings, run
- â./configure && make && make installâ. For detailed, generic instructions
- see INSTALL. For a complete list of configure options and their description,
- run â./configure --helpâ.
+ All documentation for SysDB is available as manual pages (in roff and HTML
+ formats) and shipped alongside the source code in the doc/ subdirectory.
+ Also, it is available online at .
- By default, SysDB will be installed into â/opt/sysdbâ. You can adjust this
- setting by specifying the â--prefixâ configure option - see INSTALL for
- details. If you pass DESTDIR= to âmake installâ, will be
- prefixed to all installation directories. This might be useful when creating
- packages for SysDB.
+Getting Help
+------------
+
+ Various channels for asynchronous and real-time communication with
+ developers and users are available. See for
+ details about the mailing list, IRC channel, and social media.
Author
------
Sebastian âtokkeeâ Harl
+ See the file THANKS for credits and inspiration.
+
+ Want to contribute? Check out the website for details.
+