Adding upstream version 1.10.2.upstream/1.10.2upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 60 insertions, 0 deletions

diff --git a/doc/04-Getting-started.md b/doc/04-Getting-started.md
new file mode 100644
index 0000000..1db80d6
--- /dev/null
+++ b/doc/04-Getting-started.md
@@ -0,0 +1,60 @@
+<a id="Getting-started"></a>Getting started
+===========================================
+
+When new to the Director please make your first steps with a naked Icinga
+environment. Director is not allowed to modify existing configuration in
+`/etc/icinga2`. And while importing existing config is possible (happens for
+example automagically at kickstart time), it is a pretty advanced task you
+should not tackle at the early beginning.
+
+Define a new global zone
+------------------------
+
+This zone must exist on every node directly or indirectly managed by the
+Icinga Director:
+
+```icinga2
+object Zone "director-global" {
+  global = true
+}
+```
+
+Create an API user
+------------------
+
+```icinga2
+object ApiUser "director" {
+  password = "***"
+  permissions = [ "*" ]
+  //client_cn = ""
+}
+```
+
+To allow the configuration of an API user your Icinga 2 instance needs a
+`zone` and an `endpoint` object for itself. If you have a clustered
+setup or you are using agents you already have this. If you are using a
+fresh Icinga 2 installation or a standalone setup with other ways of
+checking your clients, you will have to create them.
+
+The easiest way to set up Icinga 2 with a `zone` and `endpoint` is by
+running the [Icinga 2 Setup Wizard](https://docs.icinga.com/icinga2/latest/doc/module/icinga2/chapter/distributed-monitoring#distributed-monitoring-setup-master).
+
+Take some time to really understand how to work with Icinga Director first.
+
+
+Other topics that might interest you
+------------------------------------
+
+* [Working with agents](24-Working-with-agents.md)
+* [Understanding how Icinga Director works](10-How-it-works.md)
+
+What you should not try to start with
+-------------------------------------
+
+Director has not been built to help you with managing existing hand-crafted
+configuration in /etc/icinga2. There are cases where it absolutely would
+make sense to combine the Director with manual configuration. You can also
+use multiple tools owning separate config packages. But these are pretty
+advanced topics.
+
+