Bereiten Sie eine Umgebung mit Docker vor. Weitere Informationen finden Sie im Docker-Einrichtungs- und Orientierungsleitfaden.

 In geschweiften Klammern { } stehender Inhalt kennzeichnet einen Platzhalter. Sowohl die geschweiften Klammern als auch der darin enthaltene Inhalt müssen ersetzt werden, damit die Anfrage funktioniert.

Ausführungssyntax

Datei-Mount für server-config.json

docker container run -d \
    --name {container-name} \
    -p {port-on-host}:{value-of-port-in-server-config.json}|{default-is-8080} \
    -v /mount/path/for/server-config.json:/usr/local/nxdb/server-config.json \
    -v NX-DATA:value-of-data-in-server-config.json-or-default-is-/var/nxdb ninoxdatabase/ninox-on-premise

Verzeichnis-Mount für den Konfigurationsordner mit server-config.json

docker container run -d \
    --name {container-name} \
    -p {port-on-host}:{value-of-port-in-server-config.json}|{default-is-8080} \
    -v /mount/path/for/config/:/usr/local/nxdb/config \
    -v NX-DATA:value-of-data-in-server-config.json-or-default-is-/var/nxdb ninoxdatabase/ninox-on-premise

Beispielhafte Befehle

Ohne Proxy zwischen Client und Server und ohne spezifische Server-Konfiguration

docker container run -d \
    --name nxdb \
    -v NX-DATA:/var/nxdb \
    -p 80:8080 ninoxdatabase/ninox-on-premise

Änderungen an der Server-Konfiguration über die UMS-Schnittstelle sind nicht persistent. Zugriff auf Ninox über http://localhost.

Mit einem Proxy zwischen Client und Server

docker container run -d \
    --name nxdb \
    -p 6999:8080 ninoxdatabase/ninox-on-premise \
    -v NX-DATA:/var/nxdb \
    -v /mount/path/for/server-config.json:/usr/local/nxdb/server-config.json ninoxdatabase/ninox-on-premise

Geben Sie das Server-Konfigurations-Mount an, da es die Standardkonfiguration überschreibt. Zugriff auf Ninox über http://{host-specified-in-server-config-json}.

 Stellen Sie sicher, dass die folgenden Kriterien erfüllt sind:

• host

  • Hauptparameter, der überschrieben werden soll

  • Hat einen Wert, mit dem der Proxy konfiguriert ist

• HostPort in der -p -Direktive des Containers

• run -Befehl gibt den Port an, über den der Proxy eingehende Anfragen weiterleitet

SSL-Konfiguration

Ohne Proxy zwischen Client und Server

Es wird empfohlen, SSL auf dem Ninox-Server zu konfigurieren. Siehe die ssl-Eigenschaft in der server-config.json-Referenz und tragen Sie die entsprechenden Werte ein. Sie können zusätzlich ein Verzeichnis innerhalb des Containerpfads mounten, z. B. /usr/local/nxdb/certificates, und dieses zur Konfiguration des ssl-Feldes in server-config.json nutzen.

 Stellen Sie sicher, dass die folgenden Kriterien erfüllt sind:

• redirectPort -Eigenschaft auf 80 gesetzt, um alle HTTP-Anfragen auf einen SSL-aktivierten Port weiterzuleiten

• port -Eigenschaft hat den Wert 443

• bindPort -Eigenschaft hat einen Wert, z. B. 8443, falls verfügbar

Mit einem Proxy zwischen Client und Server

SSL sollte direkt auf dem Proxy konfiguriert werden.

Konfigurationsdatei

server-config.json definiert die umgebungsspezifischen Einstellungen, die der Ninox-Server beim Start verwendet. Die Konfigurationsdatei wird aus /usr/local/nxdb/server-config.json geladen, wenn der Container startet.

 Es ist nicht zwingend erforderlich, server-config.json zur Laufzeit des Containers bereitzustellen, da ein Standard-server-config.json mit dem Image geliefert wird. Falls jedoch eine eigene server-config.json verwendet werden soll, muss eine Datei über den Befehl -v /mount/path/for/server-config.json:/usr/local/nxdb/server-config.json eingebunden werden.

Weitere Informationen zur server-config.json finden Sie im Abschnitt Beispieldatei für die Konfiguration.