content-sync - KNW-2136 translation started, pick-25

Author: thomaskoslowski

src/common/de/intro_setup_monitor.asciidoc

@@ -467,8 +467,6 @@ Dabei stehen mehrere {CMK}-Agentenpakete zur Auswahl:
 * Ein `rpm`-Paket für Red Hat Enterprise Linux (RHEL), dessen binärkompatible Distributionen und SUSE Linux Enterprise Server (SLES)
 * Ein Paket für Windows
 
-// ES: Ich wollte die Aufzählung übersichtlicher machen, bin aber noch nicht mit der von mir hier vorgeschlagenen Präsentation zufrieden. Kannst du gerne noch ändern.
-
 Für das Herunterladen müssen Sie sich authentisieren, standardmäßig mit Benutzername und Passwort.
 Eine Abkürzung und mehr Sicherheit bietet hier das Slideout an, welches die Authentisierung für diese Aktion mit einem _Einmal-Token_ durchführt, das für eine erfolgreiche Ausführung innerhalb eines begrenzten Zeitraums gültig ist.
 
@@ -494,7 +492,7 @@ Im Slideout können Sie mit [.guihint]#Next step# den dritten und letzten Schrit
 image::intro_setup_first_host_saas.png[alt="Der Ordner 'preconfigured_agent' mit dem automatisch erstellten Host."]
 
 Zur Erfolgskontrolle wechseln Sie abschließend einmal in die xref:glossar#monitoring_environment[Monitoring-Umgebung], zum Beispiel indem Sie in der Navigationsleiste den Eintrag [.guihint]#Monitor > Overview > Main dashboard# auswählen.
-Im Artikel über die xref:wato.html#activate_changes[Konfiguration von {CMK}] erfahren Sie übrigens mehr über den Unterschied zwischen Konfigurations- und Monitoring-Umgebung.
+Im Artikel über die xref:wato#activate_changes[Konfiguration von {CMK}] erfahren Sie übrigens mehr über den Unterschied zwischen Konfigurations- und Monitoring-Umgebung.
 
 .Das [.guihint]#Main dashboard# zeigt den ersten Host im Monitoring
 image::intro_dashboard_saas.png[alt="Das 'Main dashboard'.",fullscreen=1]
@@ -566,7 +564,7 @@ Dazu sind zwei weitere Schritte nötig, die Sie ohne Unterstützung eines Assist
 . Service-Erkennung durchführen +
 Nachdem Sie das Slideout beendet haben, kehren Sie zur Seite mit den Eigenschaften des Hosts zurück.
 Hier starten Sie per Knopf [.guihint]#Save & run service discovery# die xref:glossar#service_discovery[Service-Erkennung], das heißt die Festlegung der Services, die auf dem Host überwacht werden.
-Der Artikel zu den xref:wato_services.html#discovery[Services] beschreibt, welche Möglichkeiten Sie dabei haben.
+Der Artikel zu den xref:wato_services#discovery[Services] beschreibt, welche Möglichkeiten Sie dabei haben.
 
 . Änderungen aktivieren +
 {CMK} speichert alle Änderungen, die Sie vornehmen, zunächst nur in einer vorläufigen xref:glossar#configuration_environment[Konfigurationsumgebung], die das aktuell laufende Monitoring noch nicht beeinflusst.

src/common/en/intro_setup_monitor.asciidoc

@@ -460,7 +460,21 @@ After clicking on [.guihint]#Server (Linux, Windows, Solaris, ...)#, the [.guihi
 .The first step in the slideout for creating an on-premises host
 image::intro_host_install_agent_slideout_1_saas.png[alt="The slideout for creating an on-premises host."]
 
+// This block is outdated
+// delete from here
 You can choose to install the {CMK} agent package for Debian and Ubuntu (`DEB`), for Red Hat Enterprise Linux (RHEL), its binary-compatible distributions, and SUSE Linux Enterprise Server (SLES) (`RPM`), as well as for Windows.
+// delete to here
+// This block is new
+// start translation
+////
+Dabei stehen mehrere {CMK}-Agentenpakete zur Auswahl:
+
+* Ein `deb`-Paket für Debian und Ubuntu
+* Ein `rpm`-Paket für Red Hat Enterprise Linux (RHEL), dessen binärkompatible Distributionen und SUSE Linux Enterprise Server (SLES)
+* Ein Paket für Windows
+
+////
+// end translation
 
 To download the package, you must authenticate yourself, typically using a username and password.
 The slideout offers a shortcut and enhanced security by performing authentication for this action using a _one-time token (OTT)_, which is valid for a successful execution within a limited period of time.
@@ -487,17 +501,19 @@ In the slideout, you can select the third and final step using [.guihint]#Next s
 image::intro_setup_first_host_saas.png[alt="The 'preconfigured_agent' folder containing the automatically-created host."]
 
 To verify that everything is working properly, switch to the xref:glossar#monitoring_environment[monitoring environment], for example by selecting [.guihint]#Monitor > Overview > Main dashboard# from the navigation bar.
+In the article on xref:wato#activate_changes[configuring {CMK}], you can learn more about the difference between the configuration and monitoring environments.
 
 .The [.guihint]#Main dashboard# displays the first host in the monitoring
 image::intro_dashboard_saas.png[alt="The 'Main dashboard'.",fullscreen=1]
 
-In the article on xref:wato#activate_changes[configuring {CMK}], you can learn more about the difference between the configuration and monitoring environments.
-
 You have now successfully added the first host and its services to the monitoring -- Congratulations!
 
-The reason why it all works so easily is that the packages with the {CMK} agent are preconfigured in {CE} for all supported operating systems -- for the automatic registration of the agent, the creation of the host, and activation of the resulting changes.
+The reason why it all works so easily is that the packages with the {CMK} agent are preconfigured in {CE} for all supported operating systems
+-- for the xref:hosts_autoregister#[auto-registration of a host], i.e., for agent registration, host creation, service discovery, and the activation of the resulting changes.
 You can find these packages in the {CMK} interface in [.guihint]#Setup > Agents > Windows, Linux, Solaris, AIX# in the line [.guihint]#Agent controller auto-registration#.
 
+// This block is outdated
+// delete from here
 The packages are configured in such a way that the host is always stored in your site's prepared `preconfigured_agent` folder in {CE}.
 If you would instead prefer to store your hosts in your own folder structure, you have several options:
 You can move already created hosts to other folders, create your own packages for the xref:hosts_autoregister#[auto-registration of hosts] using the xref:glossar#agent_bakery[Agent Bakery], or perform each of the individual steps manually.
@@ -546,6 +562,94 @@ If the last executed auto-registration failed, you will find initial troubleshoo
 
 If, on the other hand, everything went well, you can add further Linux and Windows hosts in the same way.
 If the downloaded file with the installation package is not located on the target host for the installation of the agent, you must first copy the file to the target host, for example using the command line tool `scp`.
+// delete to here
+
+// This block is new
+// start translation
+////
+Die Pakete sind dabei so konfiguriert, dass der Host stets im vorbereiteten Ordner `preconfigured_agent` Ihrer Instanz in {CE} abgelegt wird.
+Wenn Sie stattdessen Ihre Hosts in Ihrer eigenen Ordnerstruktur ablegen wollen, haben Sie mehrere Möglichkeiten.
+Die einfachste ist, jeden der einzelnen Schritte manuell durchzuführen, einschließlich derer, die von der Autoregistrierung automatisch erledigt wurden.
+Aber keine Sorge, auch bei der manuellen Methode, die im nächsten Abschnitt beschrieben ist, unterstützt Sie {CMK}.
+
+Falls bei der Aufnahme des ersten Hosts etwas schiefgegangen ist, geht es jetzt an die Fehlersuche.
+Diese starten Sie am besten in umgekehrter Reihenfolge der Ausführung.
+Falls also die zuletzt ausgeführte Autoregistrierung fehlgeschlagen ist, finden Sie im Artikel zur xref:hosts_autoregister#test[Autoregistrierung] erste Hinweise zur Fehlersuche. 
+
+
+[#first]
+== Den ersten Host manuell aufnehmen
+
+Zusätzlich zum Assistenten für die automatische Aufnahme des ersten Hosts, der im vorherigen Abschnitt vorgestellt wurde, liefert {CMK} einen weiteren Assistenten, der Sie durch die einzelnen Schritte zur Erstellung eines Hosts in der Konfigurationsumgebung führt.
+Das ist komfortabel, da Ihnen dieser Assistent die notwendigen Befehle zeigt und die Authentisierung per Einmal-Token ermöglicht.
+Dabei müssen Sie zwar jeden Schritt einzeln ausführen, dafür bietet Ihnen dieser Assistent mehr Flexibilität.
+
+Wählen Sie [.guihint]#Setup > Hosts > Hosts#, um den Ordner [.guihint]#Main# zu öffnen.
+Wechseln Sie in einen zuvor xref:create_folders[erstellten Ordner] und klicken Sie [.guihint]#Add host#.
+Auf der Seite [.guihint]#Add host# geben Sie den Host-Namen ein.
+Im Kasten [.guihint]#Monitoring agents# finden Sie anschließend bei der Option [.guihint]#Checkmk agent connection mode# den aktiven Knopf [.guihint]#Install & register agent#:
+
+.In den Eigenschaften des Hosts finden Sie den Knopf zum Öffnen des Assistenten
+image::intro_add_host_saas.png[alt="Die Eigenschaften des Hosts mit dem Knopf 'Install & register agent'."]
+
+Klicken Sie auf diesen Knopf und das Slideout [.guihint]#Install Checkmk agent (Push Mode)# wird geöffnet:
+
+.Der erste Schritt im Slideout zur Installation und Registrierung des {CMK}-Agenten
+image::intro_host_install_push_agent_slideout_saas.png[alt="Das Slideout zur Installation und Registrierung des {CMK}-Agenten."]
+
+Das prinzipielle Vorgehen ist für einen Linux- und für einen Windows-Host identisch und wird im Folgenden nur skizziert:
+
+. Host erstellen (und sichern) +
+Die Registrierung (in Schritt 3) setzt einen existierenden Host in {CMK} voraus.
+
+. Agent herunterladen und installieren +
+Hier wählen Sie das Betriebssystem des Hosts aus und bei Linux zusätzlich die Distribution.
+Nach der Generierung des Einmal-Tokens werden Ihnen die Befehle zum Download und zur Installation angezeigt, die Sie in die Zwischenablage kopieren können, um sie dann auf dem Host auszuführen.
+Falls sich die heruntergeladene Datei mit dem Installationspaket nicht auf dem Ziel-Host für die Installation des Agenten befinden sollte, müssen Sie die Datei zuerst auf den Ziel-Host kopieren, zum Beispiel mit dem Befehlszeilentool `scp`.
+Alle Details zur Installation können Sie in den Artikeln zu xref:agent_linux#install[Linux] und xref:agent_windows#install[Windows] nachlesen.
+
+. Host registrieren +
+Mit der Registrierung des Hosts beim {CMK}-Server wird das Vertrauensverhältnis zwischen beiden eingerichtet.
+Die Kommunikation zwischen Host und Server erfolgt dann nur noch verschlüsselt mit Transport Layer Security (TLS).
+Die Registrierung erfolgt manuell per Befehlszeile, wie es wieder in den Artikeln zu xref:agent_linux#registration[Linux] und xref:agent_windows#registration[Windows] beschrieben ist.
+
+. Test und Fehlerdiagnose +
+Zum Abschluss zeigt Ihnen das Slideout noch einen Befehl, mit dem Sie den Erfolg der Registrierung überprüfen können. +
+Bei vielen einzelnen Schritten kann es vorkommen, dass etwas nicht erfolgreich durchläuft.
+Murphys Gesetz („Alles, was schiefgehen kann, wird auch schiefgehen.“) kann leider auch von {CMK} nicht außer Kraft gesetzt werden.
+Schiefgehen kann vor allem dann etwas, wenn man es zum ersten Mal probiert.
+Daher sind gute Möglichkeiten zur Fehlerdiagnose wichtig. +
+Die Artikel zu xref:agent_linux#test[Linux] und xref:agent_windows#test[Windows] widmen dem Thema Test und Diagnose ein eigenes, ausführliches Kapitel. +
++
+Mit diesem Schritt endet das Slideout.
+Der Host ist nun fertig konfiguriert, muss aber noch ins Monitoring aufgenommen werden.
+Dazu sind zwei weitere Schritte nötig, die Sie ohne Unterstützung eines Assistenten erledigen müssen.
+
+. Service-Erkennung durchführen +
+Nachdem Sie das Slideout beendet haben, kehren Sie zur Seite mit den Eigenschaften des Hosts zurück.
+Hier starten Sie per Knopf [.guihint]#Save & run service discovery# die xref:glossar#service_discovery[Service-Erkennung], das heißt die Festlegung der Services, die auf dem Host überwacht werden.
+Der Artikel zu den xref:wato_services#discovery[Services] beschreibt, welche Möglichkeiten Sie dabei haben.
+
+. Änderungen aktivieren +
+{CMK} speichert alle Änderungen, die Sie vornehmen, zunächst nur in einer vorläufigen xref:glossar#configuration_environment[Konfigurationsumgebung], die das aktuell laufende Monitoring noch nicht beeinflusst.
+Erst durch das „Aktivieren der ausstehenden Änderungen“ werden diese in die xref:glossar#monitoring_environment[Monitoring-Umgebung] übernommen.
+Mehr über die Hintergründe dazu erfahren Sie im xref:wato#activate_changes[Artikel über die Konfiguration von {CMK}]. +
+Die Zahl der Änderungen, die noch nicht aktiviert sind, sehen Sie in der Navigationsleiste, im Menü [.guihint]#Changes#, und dort an der Nummer im gelben Kreis.
+Wenn Sie das Symbol anklicken, sehen Sie die Details dieser Änderungen. +
+Die aufgelisteten Änderungen können nur zusammen aktiviert werden.
+Klicken Sie auf den Knopf [.guihint]#Activate pending changes#, um die Änderungen anzuwenden.
+Nach kurzer Wartezeit erhalten Sie die Rückmeldung, dass die Änderungen erfolgreich aktiviert wurden und alles auf dem neuesten Stand ist.
+Die Nummer im Menü [.guihint]#Changes# ist verschwunden und bleibt es auch solange, bis die nächste Änderung ansteht.
+
+Die Erfolgskontrolle ist genau so, wie im xref:first[vorherigen Abschnitt] beschrieben.
+Wechseln Sie in die xref:glossar#monitoring_environment[Monitoring-Umgebung], zum Beispiel mit [.guihint]#Monitor > Overview > Main dashboard#, und überprüfen Sie, ob der neu erstellte Host angezeigt wird.
+
+Wenn alles geklappt hat, können Sie nach dem gleichen Muster weitere Linux- und Windows-Hosts aufnehmen.
+
+////
+// end translation
+
+
 endif::[]