From 3e02d5aff85babc3ffbfcf52313f2108e313aa23 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sat, 13 Apr 2024 13:46:43 +0200 Subject: Adding upstream version 2.12.1. Signed-off-by: Daniel Baumann --- doc/01-About.md | 93 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 93 insertions(+) create mode 100644 doc/01-About.md (limited to 'doc/01-About.md') diff --git a/doc/01-About.md b/doc/01-About.md new file mode 100644 index 0000000..7df51d1 --- /dev/null +++ b/doc/01-About.md @@ -0,0 +1,93 @@ +# About Icinga Web 2 + +Icinga Web 2 is a powerful PHP framework for web applications that comes in a clean and reduced design. +It's fast, responsive, accessible and easily extensible with modules. + +## Installation + +Icinga Web 2 can be installed easily from packages from the official package repositories. +Setting it up is also easy with the web based setup wizard. + +See [here](02-Installation.md#installation) for more information about the installation. + +## Configuration + +Icinga Web 2 can be configured via the user interface and .ini files. + +See [here](03-Configuration.md#configuration) for more information about the configuration. + +## Authentication + +With Icinga Web 2 you can authenticate against relational databases, LDAP and more. +These authentication methods can be easily configured (via the corresponding .ini file). + +See [here](05-Authentication.md#authentication) for more information about +the different authentication methods available and how to configure them. + +## Authorization + +In Icinga Web 2 there are permissions and restrictions to allow and deny (respectively) +roles to view or to do certain things. +These roles can be assigned to users and groups. + +See [here](06-Security.md#security) for more information about authorization +and how to configure roles. + +## User preferences + +Besides the global configuration each user has individual configuration options +like the interface's language or the current timezone. +They can be stored either in a database or in .ini files. + +See [here](07-Preferences.md#preferences) for more information about a user's preferences +and how to configure their storage type. + +## Modules + +Modules extend Icinga Web 2 with additional functionality. They allow the integration of +capabilities into existing views and even other modules. Be it a graph provider such as +[Graphite](https://github.com/Icinga/icingaweb2-module-graphite) or a UI for the Icinga 2 +configuration like the [Director](https://github.com/Icinga/icingaweb2-module-director). + +See [here](08-Modules.md#modules) for information on how to install and configure modules. + +### The monitoring module + +> **Note for Icinga DB Users** +> +> This module is only for the IDO backend. Use [Icinga DB Web](https://github.com/Icinga/icingadb-web) instead. + +This is the core module for most Icinga Web 2 users. + +It provides an intuitive user interface for monitoring with Icinga 2. +There are lots of list and detail views (e.g. for hosts and services) +you can sort and filter depending on what you want to see. + +You can also control the monitoring process itself by sending external commands to Icinga. +Most such actions (like rescheduling a check) can be done with just a single click in the UI. + +More details about this module can be found in [this chapter](../modules/monitoring/doc/01-About.md#monitoring-module-about). + +### Documentation + +With the documentation module you can read the documentation of the framework (and any module) directly in the user interface. + +The module can also export the documentation to PDF. + +More details about this module can be found in [this chapter](../modules/doc/doc/01-About.md#doc-module-about). + +### Translation + +Icinga Web 2 and all modules by Icinga utilize gettext to provide translations into other languages from the default +English (en_US). However, the actual language specific files (locales) are not separately included in every project. + +Icinga uses a central repository to manage locales: https://github.com/Icinga/L10n + +If you want to provide or update a translation for your own language, please head over there where you will find +[instructions](https://github.com/Icinga/L10n/blob/main/CONTRIBUTING.md) on how to contribute. + +## Accessibility + +In the Icinga Web 2 interface even the blind can see - +easy navigation with a screen reader and specific themes for different kinds of vision deficiencies +make it possible for everyone to monitor their systems without impairments. -- cgit v1.2.3