Installation und Update von Dr.DOC Web

1. Glossar
2. Installationsanleitung
3. Gemachte Änderungen an Ihrem System, durch das Update
4. Option A: Installation/Update via Befehlszeile / CLI (CMD) - Neues Setup ab V165
   4.1. Parameter
   4.2. Beispiele
5. Option A: Installation/Update via Befehlszeile / CLI (CMD) - Altes Setup bis V165
6. Option B: Installation/Update via GUI

---

Der Dr.DOC Web Server kann über die Datei "SetupWeb.exe" installiert und aktualisiert werden. Dabei kann die Installation/Update über die Befehlszeile/CMD (Option A) oder die GUI (Option B) gesteuert werden.

1. Glossar

Basisverzeichnis = Basisverzeichnis der Installation, welches als erstes abgefragt wird.

2. Installationsanleitung

1. Vor der (Neu-)Installation:
   1. Aktion: Prüfen, ob bereits eine Installation vorhanden ist. Falls ja, nehmen Sie später ein "Update" vor (siehe unten).
      Wir empfehlen Backups zu machen, z.B. vom Web Basisverzeichnis (z.B. "C:\DRDOC\web") sowie der Dr.DOC Benutzerverwaltung/Archive/Container.
   2. Aktion: wir empfehlen, den Dr.DOC Netzwerk Server Dienst (DocService.exe) bzw. Server App (DocServ.exe) zu beenden.
   3. Aktion (nur bei Neuinstallation): Geben Sie dem Benutzer SERVER Rechte zum Zugriff auf die Benutzerverwaltung sowie allen erforderlichen Archiven (z.B. für E-Mail-Archivierung):
      
      1. Öffnen Sie Ihre Dr.DOC Benutzerverwaltung Ihres Datenarchivs (im Dr.DOC Netzwerk Client/Admin -> Menü -> Organisation -> Benutzer-Manager)
      2. Wählen Sie den Benutzer SERVER, bzw. erstellen Sie diesen, falls noch nicht vorhanden
      3. Geben sie dem Benutzer SERVER alle nötigen Rechte
      4. Im Benutzer, Tab "Beschreibung", setzen Sie die Checkbox "Zugangsberechtigung für Benutzer-Manager"
      5. Button "Speichern" klicken
2. Nach der Installation

   1. Aktion: SSL/TLS Zertifikat installieren oder ggf. IP und Hostnamen festlegen in \configs\server.ini, z.B. C:\DrDOC\WEB\configs\server.ini

       [SERVER]
       AUTO_IP=true
       IP=<Server IP>
       HOSTNAME=<Ihr Hostname>
       PORT=443
       SSL_ACTIVE=true
      

   2. Aktion: Bitte den Dienst Dr.DOC Web Server (bzw. wie Sie den Dienst genannt haben) starten.
      Dr.DOC Web migriert nun automatisch das Konfigurationsarchiv. Das kann etwa eine Minute dauern. Sollte der Dienst nicht starten (z.B. weil die angegebene IP nicht gebunden werden kann), können Sie die Fehlerursache in der Logdatei logs\log.txt nachvollziehen

   3. Aktion: Web-Browser starten und http://<ip>:<port> aufrufen.

   4. Aktion: Erstanmeldung als Benutzer PUBLIC vornehmen.
      Hintergrund: Es wird automatisch der Benutzer SERVER erstellt (bis Version 1.0.0.72 Benutzer DrDocSync) sowie Benutzer anon und alle Benutzer automatisch von der Benutzerverwaltung des Datenarchivs, ins Konfigurationsarchiv synchronisiert.
      Unter Dr.DOC Web -> Menü (oben link) -> Benutzer Einstellungen: prüfen, ob das Upgrade erfolgreich war.
      

   5. Aktion: Dr.DOC Netzwer Server Dienst wieder starten

3. Gemachte Änderungen an Ihrem System, durch das Update

Beim Update werden folgende Dateien und Verzeichnisse vollständig überschrieben:

• /bin
• /htdocs/system
• /WebNodes/system

Im Verzeichnis "/configs" werden Lizenz und weitere Einstellungen gesetzt.
Der Dienst "Dr.DOC Web Server" wird installiert (auto).
Alle WebNodes im Node-Konfigruationsarchiv, die mit dem Namen "system/" beginnen, werden ebenfalls vollständig überschrieben.
Nach dem Update wir der Dienst automatisch neu gestartet.

Bei der (Neu-)Installation werden alle Dateien im Basisverzeichnis komplett überschrieben, u.a. das Node Konfigurationsarchiv, welches z.B. die Einstellungen zur E-Mail-Archivierung enthält.
Nach der Neuinstallation wird der Dienst NICHT automatisch gestartet, da davon ausgegangen wird, dass

4. Option A: Installation/Update via Befehlszeile / CLI (CMD) - Neues Setup ab V165

Als CLI-Argument zur SetupWeb.exe können Parameter übergeben werden:

• Parameter direkt (als CLI-Argument) übergeben.
• Konfigurationsdatei übergeben (CLI-Argument /M).
• CLI-Argument /SILENT für den Silent-Mode (keine Rückfragen, mit GUI).
• CLI-Argument /VERYSILENT für den Silent-Mode (keine Rückfragen, keine GUI).

SetupWeb.exe /SILENT /M="<Pfad-Setup-Konfigurationsdatei>.ini" /<Parameter1>="<Wert1>"

Die Setup-Konfigurationsdatei gibt Schlüssel-Wert-Paare im INI Format an, zeilenweise "Schlüssel=Wert", innerhalb der Section WEB.

4.1. Parameter

Folgende Schlüssel können angegeben werden:

Schlüssel	Wert Beschreibung
ACTION	install, update
MAINDIR	Das Basisverzeichnis der Dr.DOC Web Server Installation.
API_KEY	Optional Dr.DOC Web Lizenzschlüssel. Der alte Key LICENSE_DEFAULT_API_KEY bleibt lesbar und wird nachrangig gelesen. Wenn leer, wird der derzeit verwendete Key verwendet aus configs\license.ini.
USERMANAGER	Optional Pfad zur Dr.DOC Benutzerverwaltung (*.BVD) Ihres Datenarchivs. Der alte Key SERVER_USER_DEFAULT_USERMANAGER bleibt lesbar und wird nachrangig gelesen. Wenn leer, wird der derzeit verwendete Usermanager verwendet aus configs\server.ini.
SERVICE_NAME	Optional (bei Nicht-Änderung) Name des Dienstes. Default: Dr.DOC Web Server Wenn Sie den Namen des Dienstes vom Default-Wert ändern, MUSS der Dienst-Name Parameter in der Konfigurationsdatei oder als CLI-Argument IMMER angegeben werden.
SERVICE_INSTALL	Optional Dienst installieren. Default: 1, mögliche Werte: 1, 0 Bei 1 wird der Dienst nach dem Setup automatisch gestartet.

4.2. Beispiele

Silent-Mode mit Parametern:

SetupWeb.exe /SILENT /ACTION="update" /MAINDIR="C:\DrDOC\web" /API_KEY="012345asdfg"

Beispiel 1 (Silent-Mode mit Konfigurationsdatei):

SetupWeb.exe /SILENT /M="Setup.ini"

Beispiel 3 (GUI-Mode mit Konfigurationsdatei):

SetupWeb.exe /M="Setup.ini"

Beispiel Installations-Konfigurationsdatei Setup.ini für ein Update:

[WEB]
MAINDIR=D:\Dr.DOC\WEB
API_KEY=asdfghjklqwertzuiop
API_FEATURE=UNLIMITED_WEB
USERMANAGER=D:\Dr.DOC\DATA\USER\user.BVD
ACTION=update
SERVICE_NAME=Dr.DOC Web Server
SERVICE_INSTALL=1

5. Option A: Installation/Update via Befehlszeile / CLI (CMD) - Altes Setup bis V165

Als Argument zur "SetupWeb.exe" wird (optional) eine Konfigurationsdatei übergeben.

SetupWeb.exe /S /M="<Pfad-Setup-Konfigurationsdatei>.ini"

Die Setup-Konfigurationsdatei gibt Schlüssel-Wert-Paare zeilenweise an: "Schlüssel=Wert".
Der Silent-Mode (keine Rückfragen) könnte den Computer ohne Rückfrage neu starten.
Folgende Schlüssel können angegeben werden:

Schlüssel	Wert Beschreibung
ACTION	install, update oder uninstall
MAINDIR	Das Basisverzeichnis der Dr.DOC Web Server Installation.
LICENSE_DEFAULT_API_KEY	Lizenzschlüssel
SERVER_USER_DEFAULT_USERMANAGER	Pfad zur Benutzerverwaltung (*.BVD)

Beispiel 1 (Silent-Mode):

SetupWeb.exe /S /M="Setup.ini"

Beispiel 2 (GUI-Mode):

SetupWeb.exe /M="Setup.ini"

Beispiel Installations-Konfigurationsdatei Setup.ini für ein Update:

[WEB]
MAINDIR=D:\Dr.DOC\WEB
LICENSE_DEFAULT_API_KEY=asdfghjklqwertzuiop
LICENSE_DEFAULT_API_FEATURE=UNLIMITED_WEB
SERVER_USER_DEFAULT_USERMANAGER=D:\Dr.DOC\DATA\USER\user.BVD
ACTION=update

6. Option B: Installation/Update via GUI

Folgen Sie den Anweisungen der Benutzeroberfläche.
Folgende Informationen werden abgefragt:

1. Basisverzeichnis der Web-Server Installation
2. Aktion: Update / (Neu-)Installation
3. Lizenzschlüssel
4. Pfad zur Benutzerverwaltung (*.BVD)