X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=README;h=c78ec5fea715d77fb60c15c477e8a567a9f15f2f;hb=0d93606de8723dfe170b43883b9edc09f2bf060d;hp=e7054c9a90378b0a9e28c8ba5bdfed64d8274400;hpb=25fd28ea404f11cd68e399eb1b0f3fe5de5034e5;p=sysdb.git
diff --git a/README b/README
index e7054c9..c78ec5f 100644
--- a/README
+++ b/README
@@ -2,15 +2,47 @@
===============================================================
âSystem DataBaseâ (SysDB) is a multi-backend system management and inventory
- collection service. It may be used to (continuously) collect information
- about your systems from various backends (inventory services, monitoring
- services, etc.) and provides a unique interface to access the information
- independent of the active backends. This is done by storing and mapping the
- backend objects to generic objects and correlating the attributes to create
- a single hierarchical view of your infrastructure.
+ collection service. It stores system and inventory information about
+ hardware and software systems. This information is (continuously) collected
+ from various configurable backends (inventory services, monitoring services,
+ etc.) and stored in a graph-like hierarchy of generic objects. The store may
+ be queried through a generic interface independent of the active backends.
+ Object names are canonicalized before they are added to the store to ensure
+ a consistent view of your infrastructure.
+
+ The central object type is a host, which generally represents a physical or
+ virtual machine or any other type of physical resource. Hosts, in turn, may
+ reference a list of services which represent any kind of logical resource
+ 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.
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
-------------
@@ -19,27 +51,86 @@ Prerequisites
* A build environment: autotools, libtool, C compiler, ...
+
+
+
+
+
+
+ * When building from Git, you also need the flex lexical analyzer generator
+ and bison parser generator (other lex and yacc compatible tools might work
+ as well if you are lucky).
+
+
+
+
* A POSIX + Single UNIX Specification compatible C library.
- * asciidoc, xsltproc, xmlto:
+
+
+ * asciidoc, xmlto:
The AsciiDoc text document format is used to write the manpages.
-Configuring / Compiling / Installing
-------------------------------------
+
+
- 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'.
+ * libedit or libreadline:
+ A readline compatible command line editor and history library is used for
+ handling input in the sysdb client program.
- 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.
+
+
+
+ The following optional libraries may be used by various plugins:
+
+ * libdbi:
+ The database independent abstraction layer is used for database access by
+ the puppet::store-configs plugin.
+
+
+
+Testing
+-------
+
+ Unit and integration tests for SysDB are shipped along with the source code
+ in the âtâ subdirectory. Run âmake testâ to run all available tests.
+
+ Some tests require the âfopencookieâ function as provided by the GNU libc
+ library. It used used to mock I/O related functions. In case this function
+ is not available, the respective tests will be disabled automatically.
+
+ The integration tests require valgrind. If it is not available, integration
+ 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:
+
+
+Documentation
+-------------
+
+ 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 .
+
+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
+ Sebastian âtokkeeâ Harl
+
+ See the file THANKS for credits and inspiration.
+
+ Want to contribute? Check out the website for details.