====== Installation von untermStrich ======
Für die Installation benötigen Sie eine geeignete Serverumgebung. Beachten Sie
dazu die [[de:installation:requirements#server|Systemanforderungen]] und die
[[de:installation:installation_os|Installationsbeispiele]].
===== Vor der Installation =====
Stellen Sie sicher, dass:
* eine geeignete Serverumgebung vorhanden ist,
* die erforderlichen Zugriffsrechte eingerichtet sind,
* eine aktuelle Datensicherung vorhanden ist,
* die aktuelle untermStrich-Version heruntergeladen wurde.
Falls noch nicht erfolgt, laden Sie die aktuelle Version unter
[[https://webservices.untermstrich.com/update/]] herunter und entpacken Sie sie
in das Webserver-Verzeichnis.
----
===== Neuinstallation oder Update? =====
Wählen Sie zunächst aus, welche Situation auf Sie zutrifft.
==== Neuinstallation ====
Sie installieren untermStrich zum ersten Mal.
* Es gibt noch keine bestehende untermStrich-Installation.
* Sie legen ein neues Datenverzeichnis an.
* Sie benötigen einen Lizenzschlüssel und die Zugangsdaten zur Datenbank.
* Nach der Installation melden Sie sich mit dem Benutzer
''Administrator'' und dem Kennwort ''admin'' an.
* Das Kennwort muss anschließend sofort geändert werden.
==== Updateinstallation ====
Sie aktualisieren eine bereits vorhandene untermStrich-Installation.
* Verwenden Sie das bereits bestehende Datenverzeichnis.
* Legen Sie kein neues Datenverzeichnis an.
* Das Datenverzeichnis enthält die Datei ''usystem.ini''.
* Die vorhandenen Datenbankinformationen werden angezeigt und müssen geprüft
werden.
* Melden Sie sich nach der Installation mit Ihren bestehenden Zugangsdaten an.
Bei einer Updateinstallation muss immer das bestehende Datenverzeichnis
verwendet werden. Wird stattdessen ein neues Verzeichnis ausgewählt, kann
untermStrich die bestehende Datenbank beziehungsweise Installation nicht
korrekt zuordnen.
----
===== Installation starten =====
Öffnen Sie untermStrich im Browser:
[[http://localhost/ustrich/]]
Wenn Sie bei der Installation einen anderen Port verwendet haben, ergänzen Sie
diesen in der Adresse. Für Port ''81'' lautet die Adresse beispielsweise:
[[http://localhost:81/ustrich/]]
Während einer Installation wird die Lizenz überprüft. Stellen Sie daher sicher,
dass der Server ohne Proxy mit dem Internet verbunden ist.
Brechen Sie die Installation nicht ab, solange im Browser ein Fortschritt
angezeigt wird. Wenn ein Update tatsächlich abgebrochen wurde oder über einen
ungewöhnlich langen Zeitraum keinerlei Fortschritt erkennbar ist, starten Sie
den Vorgang erneut.
----
===== Datenverzeichnis auswählen =====
In diesem Schritt legen Sie fest, wo untermStrich die Daten gespeichert werden.
^ Installationsart ^ Auswahl des Datenverzeichnisses ^
| **Neuinstallation** | Legen Sie ein neues Verzeichnis an. Das Verzeichnis muss für den Webserver beschreibbar sein. |
| **Updateinstallation** | Wählen Sie das bereits vorhandene untermStrich-Datenverzeichnis aus. Es enthält die Datei ''usystem.ini''. |
{{:de:installation:inst1.png?nolink&450|Auswahl des Datenverzeichnisses}}
Wenn Sie ein Netzwerkverzeichnis beziehungsweise einen UNC-Pfad verwenden,
muss der Apache-Dienst über die erforderlichen Zugriffsrechte verfügen.
Weitere Informationen finden Sie unter:
[[de:installation:windows_server_network|(Apache) HTTP Server, PHP, ionCube Bundle für Netzwerkzugriff konfigurieren]]
Überprüfen Sie anschließend die angezeigten Voreinstellungen.
----
===== Datenbankdaten eingeben oder prüfen =====
==== Bei einer Neuinstallation ====
Geben Sie den erhaltenen Lizenzschlüssel und die Zugangsdaten zur Datenbank ein.
* Kopieren Sie den Lizenzschlüssel in das dafür vorgesehene Feld.
* Geben Sie den Datenbankserver und die Zugangsdaten ein.
* Wenn ''localhost'' nicht funktioniert, verwenden Sie als Datenbankserver
''127.0.0.1''.
* Der **untermStrich-Datenbank-Benutzername** wird automatisch vorausgefüllt
und muss nicht geändert werden.
{{:de:installation:inst2.png?nolink&400|Datenbankdaten bei einer Neuinstallation}}
==== Bei einer Updateinstallation ====
Bei einem Update werden die bestehenden Datenbankinformationen zur Kontrolle
angezeigt.
* Prüfen Sie die angezeigten Datenbankinformationen.
* Wurde die IP-Adresse oder der Servername des Datenbankservers geändert,
passen Sie den Wert in der Datei ''usystem.ini'' im Datenverzeichnis an.
* Der **untermStrich-Datenbank-Benutzername** wird automatisch vorausgefüllt
und muss nicht geändert werden.
{{:de:installation:up6.png?nolink&400|Datenbankdaten bei einer Updateinstallation}}
----
===== Besonderheit beim Wechsel der PHP-Version =====
Ein Wechsel von **PHP 7.x auf PHP 8.1** ist mehr als ein gewöhnliches
untermStrich-Update. In diesem Fall müssen Sie zusätzlich eine Migration
durchführen.
Beachten Sie dabei folgende Reihenfolge:
- Aktualisieren Sie zunächst das [[apache_update|HTTP-Server-, PHP- und ionCube-Bundle]].
- Verwenden Sie bei der Installation den bisherigen Port.
- Führen Sie anschließend das Migrationsskript aus.
- Installieren Sie danach das aktuelle untermStrich-Update nochmals über die
Weboberfläche.
Unter Windows befindet sich das Migrationsskript im untermStrich-Verzeichnis:
''C:\Apache24\htdocs\ustrich\migrate.bat''
Wenn beim Ausführen des Skripts eine Fehlermeldung auftritt:
- Beenden Sie den Apache-Dienst.
- Führen Sie ''migrate.bat'' erneut aus.
- Starten Sie den Apache-Dienst anschließend wieder.
- Melden Sie sich bei untermStrich an und installieren Sie das aktuelle
Update nochmals über die Weboberfläche.
Weitere Informationen zum Bundle-Update finden Sie unter:
[[de:installation:apache_update|(Apache) HTTP Server, PHP, ionCube Bundle Update für Windows]]
Auch bei einem Wechsel von PHP 7.x auf PHP 8.1 muss das bestehende
untermStrich-Datenverzeichnis verwendet werden. Legen Sie kein neues
Datenverzeichnis an.
----
===== Installation abschließen =====
Die Installation kann einige Zeit dauern. Achten Sie auf die Statusanzeige des
Browsers und brechen Sie den Vorgang nicht ab.
{{:de:installation:inst2_1.png?nolink&300|Installation läuft}}
Nach erfolgreichem Abschluss wird eine entsprechende Meldung angezeigt.
{{:de:installation:inst3.png?nolink&400|Installation erfolgreich abgeschlossen}}
----
===== Zugriff im Netzwerk =====
Um von einem anderen Arbeitsplatz im Intranet auf untermStrich zuzugreifen,
ersetzen Sie ''localhost'' durch den Servernamen oder die IP-Adresse des
Servers.
Beispiel bei einem Server mit dem Namen ''example'':
[[http://example/ustrich/]]
Wenn Sie eine Meldung erhalten, dass keine Verbindung hergestellt werden kann,
muss möglicherweise der Port ''80'' in der Firewall des Servers freigegeben
werden.
{{:de:installation:no_conn.png?direct&200|Keine Verbindung}}
----
===== Anmeldung nach der Installation =====
==== Nach einer Neuinstallation ====
Melden Sie sich mit folgenden Zugangsdaten an:
^ Benutzer ^ Kennwort ^
| ''Administrator'' | ''admin'' |
{{:de:installation:inst4.png?nolink&250|Anmeldung}}
Ändern Sie das Kennwort des Benutzers ''Administrator'' sofort nach der ersten
Anmeldung. Die Änderung können Sie im Modul
[[de:user:start|Benutzer]] vornehmen.
==== Nach einer Updateinstallation ====
Melden Sie sich mit Ihren bestehenden Zugangsdaten an.
----
===== Optionale Zusatzkomponenten =====
Je nach Systemumgebung und gewünschtem Funktionsumfang können zusätzliche
Komponenten erforderlich sein. Installieren Sie nur die Komponenten, die Sie
tatsächlich benötigen.
==== e-Connector ====
Der untermStrich e-Connector ist eine Zusatzkomponente für bestimmte Funktionen
der untermStrich-Software.
Einige Funktionen im Bereich **Dokumente** benötigen den e-Connector.
Der e-Connector unterstützt:
* Windows ab Version 8
* macOS ab Version 10.12 Sierra
* Linux mit [[https://appimage.org/|AppImage-Unterstützung]]
Installieren Sie den e-Connector auf den Arbeitsplätzen, auf denen die
entsprechenden Funktionen benötigt werden.
=== Installation ===
[[de:econnector:setup|e-Connector installieren]]
==== Connector 4VX ====
🦕 Alte Nutzungsvariante
{{page>de:need4vx}}
Installieren Sie den Connector 4VX auf den Arbeitsplätzen, auf denen die
entsprechenden Funktionen benötigt werden.
=== Installation ===
[[de:connector:start|Connector 4VX installieren]]
Um Probleme mit Virenscannern zu vermeiden, empfehlen wir, das untermStrich-
Connector-Verzeichnis vom Virenscan auszunehmen.
----
===== Microsoft-365-Integration =====
Dokumente können auch direkt mit Microsoft 365 verwaltet werden. In diesem Fall
benötigen Sie weder eine Windows-/SMB-Freigabe noch einen Connector.
Weitere Informationen:
[[de:o365:start|Microsoft-365-Integration]]
----
===== TAPI-Server =====
Wenn Sie den TAPI-Server auf einem zentralen Server nutzen möchten, finden Sie
den Download und die Beschreibung unter:
[[http://kunden.untermstrich.com/version-12.html|TAPI-Server]]