--- title: "DNS-REST-Nominum-ANS Installations-Guide (Linux)" url: "https://help.internetx.com/de/domains/dns-rest-nominum-ans-installations-guide-linux/" lang: "de" section: "Domains" --- # DNS-REST-Nominum-ANS Installations-Guide (Linux) DNS-REST-Nominum-ANS wurde für die Verwendung mit RPM-basierten Systemen entwickelt und ist als RPM-Paket erhältlich. Sobald unsere Repositorys verfügbar sind, kann DNS-REST-Nominum-ANS einfach mit folgendem Befehl installiert werden: `yum install dns-rest-nominum-ans` Der Paketmanager löst die Anforderungen und ermöglicht die Installation fehlender Programme. Die Anwendung DNS-REST-NOMINUM-ANS bildet eine Brücke zwischen AutoDNS und einem NOMINUM-ANS Nameserver, wodurch die Zonen in AutoDNS verwaltet werden können. Die dazu in AutoDNS erforderlichen Aktionen werden mit Hilfe von DNSREST-NOMINUM-ANS an den NOMINUM-ANS Server übergeben. Dazu wird das auf HTTP basierende REST Protokoll verwendet. Um eine sichere Verbindung zu gewährleisten, empfehlen wir, den Server im SSL-Modus zu starten. Es können entweder eigene Zertifikate integriert werden oder das bereits in der Anwendung vorhandene Zertifikat verwendet werden. ## Systemanforderungen Die Anwendung erfordert eine Java Virtual Machine (JDK). Sie ist außerdem abhängig vom mitgelieferten Javad-Util-Paket. Obwohl es keine besonderen Hardware-Anforderungen gibt, empfehlen wir dennoch ein x86-System mit mindestens 256 MB RAM. ## Empfehlung Wir verwenden das OpenJDK Amazon Corretto-8 zur Entwicklung unserer Software, daher empfehlen wir die Verwendung von Amazon Corretto-8. Amazon Corretto ist eine freie, plattformübergreifende und produktionsbereite Distribution des Open Java Development Kit (OpenJDK). Corretto bietet langfristigen Support, der Leistungsverbesserungen und Sicherheitskorrekturen umfasst. Es kann mit dem folgenden Befehl einfach installiert werden: - Das Repository importieren `rpm --import yum.corretto.aws/corretto.key curl -L -o /etc/yum.repos.d/corretto.repo yum.corretto.aws/corretto.repo` - Das JDK installieren `yum install java-1.8.0-amazon-corretto-devel` Wenn eine Firewall aktiv ist, muss sichergestellt werden, dass Port 9090 aktiviert ist. ## Erste Installation ### Installation mit Package Manager yum DNS-REST-Nominum-ANS wurde für die Verwendung mit RPM basierten Systemen entwickelt und ist als RPM Paket erhältlich. Sobald die InterNetX Repositories verfügbar sind, kann DNS-REST-Nominum-ANS einfach mit folgendem Befehl installiert werden: `yum install dns-rest-nominum-ans` Der Paketmanager löst die Anforderungen und ermöglicht die Installation fehlender Programme. ## Konfiguration ### Vordefinierte Variablen | Variable | Beschreibung | Vorgabe-Pfad | | --- | --- | --- | | `CONFIGDIR` | Pfad für die Konfigurations-Dateien. | `/etc/javad/dns-rest-nominum-ans` | | `HOME` | Pfad für das Home-Verzeichnis (Daten und Arbeitsverzeichnis). | `/var/lib/javad/dns-rest-nominum-ans` | | `APPDIR` | Pfad für die Programm-Dateien (Binaries/JARs). | `/usr/share/java/dns-rest-nominum-ans` | ### Password-Konfiguration Der Server verwendet HTTP-BASIC-Auth zur Autorisierung des Benutzers. Die Benutzer und die entsprechenden Kennwörter können in der Datei `passwd` im Konfigurations-Index definiert werden. Die Datei hat folgendes Format: `User: Password,rest-user` `Beispiel: user.one: pwsecret,rest-user` `Rest-user` kann nicht geändert werden und muss dem Passwort folgen. Es definiert die Benutzergruppe (im Server angegeben). ### Protokoll-Konfiguration Die Datei log4j.xml wird bei der Installation im Konfigurationsindex gespeichert. Die Datei definiert das Protokollverhalten. Dieses basiert auf "Log4j-Logger". Er schreibt die Protokolldaten in die Datei /`var/log/javad/dns-rest-nominum-ans.info.log`. Die Protokollierung ist so eingestellt, dass maximal 1 GB Festplattenspeicher verwendet werden kann, d. h. 10 Dateien von je 100 MB. Wenn die Protokollierung z. B. über `syslog` erfolgen soll, ist die "Log4j"-Konfiguration. ### Konfiguration der NOMINUM-ANS Verbindung Die folgenden Parameter sind in dem Konfigurations-Ordner unter NOMINUM-ANS.properties definiert: | Name | Format | Beschreibung | Vorgabewert | | --- | --- | --- | --- | | `ans.host` | FQDN | Der Hostname des Nameservers, zu dem die Verbindung aufgebaut werden soll. | localhost | | `ans.port` | Integer | Der Port des Nameservers, zu dem die Verbindung aufgebaut werden soll. | 8080 | | `ans.secret` | String | Das Passwort für die Verbindung. | | | `ans.message.directory` | Path | Der lokale Pfad zum Verzeichnis für Benachrichtigungen (Spool/Logs). | `/var/lib/javad/dns-rest-nominum-ans` | | `ans.message.enabled` | Boolean | Aktiviert oder deaktiviert das [Ereignis-Protokoll](/de/domains/event-log-ereignis-protokoll/) | false | | `ans.axfrTimeout` | Integer | Die Zeitüberschreitung (Timeout) für Zonentransfers (AXFR) in Sekunden. | 60 | | `ans.axfrPort` | Integer | Der Port, der für lokale AXFR-Anfragen (Zonentransfers) verwendet wird. | 53 | | `ans.localAxfr` | IP | Die lokale IP-Adresse, die für die Kommunikation mit NOMINUM-ANS gebunden wird. | 0.0.0.0 | ### Server-Start-Parameter Die Server-Startparameter sind in den Tabellen definiert. Diese können unter /`etc/sysconfig/javad/dns-rest-nominum-ans` unter dem Punkt PARAM geändert werden. ### Server-Parameter (Nominum ANS) | Name | Erforderlich | Typ | Beschreibung | Vorgabewert | | --- | --- | --- | --- | --- | | `Port, -p` | Ja | Integer | Der Server-Port, über den auf eingehende Aufträge gewartet wird. | 9090 | | `ssl` | Nein | Boolean | Legt fest, ob HTTPS anstelle von HTTP verwendet wird. Falls aktiviert, sind zusätzliche SSL-Parameter erforderlich. | true | | `keystore` | Nein | Path | Der Dateipfad zum SSL-Keystore. | | | `keystore-password` | Nein | String | Das Kennwort für den SSL-Keystore (wird AES-verschlüsselt gespeichert). | | | `cert-password` | Nein | String | Das Passwort für das Zertifikat (wird AES-verschlüsselt gespeichert). | | | `passwd` | Ja | String | Der Pfad zur Benutzerdatei für die Authentifizierung. | `/etc/javad/dns-rest-nominum-ans/passwd` | | `hostname` | Nein | IP | Die IP-Adresse, an die der Server gebunden werden soll (Listen Address). | 0.0.0.0 | ### Allgemeine Parameter ### Start-Konfiguration (JVM & Prozess) | Name | Erforderlich | Typ | Beschreibung | Vorgabewert | | --- | --- | --- | --- | --- | | `USER` | Ja | String | Der Benutzer, unter dessen Identität der Server-Prozess gestartet wird. | `autodns` | | `VMOPTS` | Ja | String | Definiert JDK-spezifische Parameter, wie zum Beispiel die Speichernutzung (Heap Size) oder System-Properties. | `-Dconf-dir=file:$CONFIGDIR` | | `PARAMS` | Ja | String | Spezifische Startparameter für die Anwendung (siehe Abschnitt „Konfiguration der Startparameter des Servers“). | | | `JMX` | Nein | Boolean | Legt fest, ob die Java Virtual Machine (VM) mit JMX (Java Management Extensions) für Monitoring-Zwecke gestartet wird. | `false` | | `JMXPORT` | Nein | Integer | Der Port, über den JMX-Verbindungen (z. B. via JConsole oder VisualVM) entgegengenommen werden. | `10120` | | `DEBUG` | Nein | Boolean | Startet die VM im Remote-Debug-Modus. | `false` | | `DEBUGPORT` | Nein | Integer | Der Port, an dem der Java-Debugger (JDWP) auf Verbindungen wartet. | `10220` |