Differences

This shows you the differences between two versions of the page.

--- de:cobi.time:cobi.time_installation [2024/05/03 10:41] – thuth
+++ de:cobi.time:cobi.time_installation [2026/08/04 09:09] (current) – thuth
@@ Line 3: / Line 3: @@
 ===== Anforderungen =====
-  * Node.js Version 16
+  * Node.js Version 22.14.0 LTS
-  * Microsoft IIS (WebServer)
+  * Microsoft IIS (Webserver)
-  * [[https://www.iis.net/downloads/microsoft/url-rewrite|Modul für Microsoft IIS (URL Umschreiben)]]
+  * [[https://www.iis.net/downloads/microsoft/url-rewrite|URL Rewrite Modul für Microsoft IIS]]
-  * SAP Business One ServiceLayer
+  * PostgreSQL Datenbank
-  * SAP Business One 10 Patchlevel 2
+  * SAP Business One Service Layer
-===== Installation =====
+  * SAP Business One 10 (Patchlevel 2 oder höher)
-==== NODE.js Installation ====
+===== Vorbereitung & Prerequisites =====
-Laden Sie die LTS-Version von NODE.js herunter (siehe Link in den Anforderungen) und installieren Sie sie. Ändern Sie während des Installationsprozesses keine Werte.
+==== Node.js Installation ====
+Laden Sie die LTS-Version von Node.js herunter: \\
+[[https://nodejs.org/dist/v22.14.0/node-v22.14.0-x64.msi|nodejs.org/dist/v22.14.0/node-v22.14.0-x64.msi]] und führen Sie die Installation aus. \\
+Belassen Sie während des Installationsprozesses alle Standardeinstellungen.
 ----
 ==== IIS Installation ====
-Wenn Microsoft IIS bereits installiert ist, ist dieses Installationshandbuch möglicherweise nicht für Sie zugeschnitten. Stellen Sie einfach sicher, dass die dynamische Komprimierung für Microsoft IIS installiert ist.
+Sollte Microsoft IIS bereits installiert sein, stellen Sie sicher, dass die **Dynamische Komprimierung** aktiviert ist. \\
+Stellen Sie sicher, dass IIS bisher nicht installiert ist:
-Stellen Sie sicher, dass Microsoft IIS nicht installiert ist:
+\\\
 {{:1.png?800|}}
-Wenn nicht, installieren Sie Microsoft IIS:
+\\\
+Falls nicht, installieren Sie Microsoft IIS:
+\\\
 {{:2.png?300 |}}
@@ Line 29: / Line 39: @@
 \\\
-Fügen Sie Rollen und Features hinzu
+Rollen und Features hinzufügen: \\
-\\
+Klicken Sie im Assistenten jeweils auf **Weiter**:
-Klicken Sie auf Weiter:
+\\\
 {{:5n.png?500|}}
 \\\
-Klicken Sie auf Weiter:
 {{:6n.png?500|}}
 \\\
-Klicken Sie auf Weiter:
 {{:7n.png?500|}}
@@ Line 51: / Line 57: @@
 \\\
-Installieren Sie Webserver IIS mit Standardfunktionen (klicken Sie einfach auf Webserver), fügen Sie aber auch unter Leistung: Dynamische Komprimierung hinzu.
+Wählen Sie die Rolle **Webserver (IIS)** aus. \\
+Navigieren Sie unter **Leistung** und aktivieren Sie zwingend die Option **Dynamische Komprimierung**.
+\\\
 {{:3.png?500 |}}
@@ Line 57: / Line 66: @@
 \\\
-Klicken Sie auf „Weiter“, bis Sie zur Installation gelangen. Dann installieren Sie die Funktionen.
+Klicken Sie auf **Weiter** und schließen Sie die Installation ab. Ein Neustart des Servers ist in der Regel nicht erforderlich.
-Normalerweise ist kein Neustart des Computers erforderlich.
 ----
-==== IIS Modul URL Installation neu schreiben ====
+==== IIS URL Rewrite Modul Installation ====
-Installieren Sie die URL Umschreibung gemäß den Anforderungen, nachdem Sie IIS erfolgreich installiert haben:
+Installieren Sie nach erfolgreicher IIS-Installation das Microsoft URL Rewrite Modul: \\
+[[https://www.iis.net/downloads/microsoft/url-rewrite|https://www.iis.net/downloads/microsoft/url-rewrite]]
-https://www.iis.net/downloads/microsoft/url-rewrite
+----
+===== COBI.time Setup-Assistent =====
+Führen Sie die Setup-Executable vX.X.X.X.exe als Administrator aus, um den Installations-Assistenten zu starten.
+==== Schritt 1: Setup starten ====
+Starten Sie die Installation über die bereitgestellte Installer-Datei. \\
+{{:de:playground:1_setup_symbol.png?100|}}
 ----
-==== COBI.time Installation ====
+==== Schritt 2: Setup-Sprache wählen ====
+(1) Wählen Sie Ihre bevorzugte Sprache (z. B. Deutsch oder English) aus der Liste aus. \\
+(2) Bestätigen Sie mit OK. \\
+{{:de:playground:2_setup_sprache.png?600|}}
-Installieren Sie COBI.time über die Installationsdatei, die Sie von uns erhalten haben. COBI.time wird dann im Standardordner installiert: ''C:\Program Files (x86)\COBI.time\''
+----
-Navigieren Sie zu diesem Ordner und bearbeiten Sie dann die Datei „.env“ mit Notepad. (Stellen Sie sicher, dass Sie über Administratorrechte verfügen. Andernfalls starten Sie Notepad als Administrator und öffnen Sie dann die Datei „.env“ über den Kontext „Datei öffnen“).:
+==== Schritt 3: PostgreSQL Konfiguration ====
+Geben Sie die Verbindungsdaten für Ihre PostgreSQL-Datenbank ein (Host, Port, Benutzername, Passwort und Datenbankname). \\
+Klicken Sie anschließend auf Weiter. \\
+{{:de:playground:3_setup_postgresql.png?600|}}
-\\\
+----
-{{:4n.png?450 |}}
+==== Schritt 4: SAP Service Layer Konfiguration ====
+(1) Geben Sie die URL zum SAP Service Layer ein (z. B. http://10.200.17.93:50001/b1s/v1). \\
+(2) Tragen Sie den SAP-Benutzernamen ein (z. B. manager). \\
+(3) Geben Sie das zugehörige Passwort ein. \\
+(4) Tragen Sie den exakten Namen der SAP-Firmendatenbank ein (z. B. SBODemoDE). \\
+(5) Klicken Sie auf Test Connection und stellen Sie sicher, dass die Meldung Login successful erscheint. \\
+(6) Klicken Sie auf Weiter. \\
+{{:de:playground:4_setup_servicelayer.png?750|}}
-\\\
+----
+==== Schritt 5: Ziel-Ordner wählen ====
+Wählen Sie den Installationspfad aus. Standardmäßig installiert sich COBI.time unter C:\Program Files (x86)\COBI.time. \\
+Klicken Sie auf Weiter. \\
+{{:de:playground:5_setup_auswaehlen.png?600|}}
+----
+==== Schritt 6: Bereits zur Installation ====
+Überprüfen Sie Ihre Angaben und klicken Sie unten rechts auf Installieren. \\
+{{:de:playground:6_setup_installation.png?600|}}
+----
+==== Schritt 7: Installation & Datenbank-Initialisierung ====
+Der Installationsprozess dauert ca. 5 bis 15 Minuten. \\
+Bestätigen Sie das Informationsfenster PostgreSQL installed and connection successful! mit OK. \\
+{{:de:playground:7_setup_installation_.png?600|}}
+----
+==== Schritt 8: Setup beenden ====
+Klicken Sie auf Fertigstellen, um den Assistenten zu schließen. \\
+{{:de:playground:8_setup_finish.png?600|}}
+----
+===== Nachkonfiguration & Dienst-Einrichtung =====
+==== Konfiguration der .env-Datei ====
+Navigieren Sie zum Ordner C:\Program Files (x86)\COBI.time\server und öffnen Sie die Datei .env mit einem Texteditor (als Administrator): \\
+{{:de:playground:9_setup_env.png?1000|}}
+Überprüfen Sie die Werte. Für den Produktivbetrieb passen Sie die folgenden Parameter an:
 <code>
 MODE=production (Produktion oder Entwicklung – stellen Sie es auf Produktion, um Protokolle zu minimieren)
@@ Line 94: / Line 157: @@
 </code>
-Ändern Sie keine anderen Felder!
+> **Hinweis zum SSL-Zertifikat:** Wenn Sie ein eigenes Zertifikat nutzen möchten, ersetzen Sie im Ordner C:\Program Files (x86)\COBI.time\server\certs die Datei cert.pem und key.pem und passen Sie den Wert SSLPass in der .env an.
-Sie haben die Möglichkeit, das SSL-Zertifikat zu ändern, wenn Sie COBI.time außerhalb Ihres internen Netzwerks hosten und eine Domain angeben möchten. In ''C:\Program Files (x86)\COBI.time\server\certs'' ersetzen Sie die ''cert.pem''
-mit dem Zertifikat und „key.pem“ mit dem privaten, passwortgeschützten Schlüssel. Ändern Sie den SSLPass entsprechend.
 ----
-==== COBI.time Service Installation ====
+==== COBI.time Service per PowerShell installieren ====
+Öffnen Sie die Windows PowerShell als Administrator und führen Sie folgende Befehle aus:
-Öffnen Sie die Powershell als Administrator und navigieren Sie zu:''C:\Program Files (x86)\COBI.time\server''
-Installieren Sie ein globales NPM-Paket für die Erstellung von Microsoft-Diensten mit dem Befehl (Stellen Sie sicher, dass die NODE.JS LTS-Version installiert ist. Starten Sie Powershell nach der neuen NODE.JS-Installation neu.):
+(1) In den Server-Ordner wechseln:
 <code>
-npm i -g qckwinsvc2
+cd "C:\Program Files (x86)\COBI.time\server"
 </code>
-Verwenden Sie anschließend dieses neue Paket, um einen COBI.time-Microsoft-Dienst zu installieren. Stellen Sie sicher, dass alle Werte im Befehl korrekt sind:
+(2) Das Hilfspaket für Windows-Dienste global installieren:
 <code>
-qckwinsvc2 Installationsname="COBI-time" Beschreibung="COBI.time Backend Server" path="C:\Program Files (x86)\COBI.time\server\server.js" args="-a -c" jetzt
+npm i -g qckwinsvc2
 </code>
+(3) Den COBI.time-Dienst registrieren und starten: \\
 Wenn Sie COBI.time in einem anderen Ordner installieren, ändern Sie den Befehl entsprechend.
+<code>
+qckwinsvc2 install name="COBI-time" description="COBI.time Backend Server" path="C:\Program Files (x86)\COBI.time\server\server.js" args="-a -c" now
+</code> \\
+{{:de:playground:10_setup_powershell.png?600|}}
+Stellen Sie sicher, dass am Ende die Bestätigung [INFO] Service COBI-time started. erscheint. \\
 Wenn Sie einen Powershell-Ausführungsrichtlinienfehler erhalten, führen Sie diesen Befehl vorher aus:
@@ Line 127: / Line 190: @@
 ----
-==== IIS Konfiguration ====
+==== Überprüfung in den Windows-Diensten ====
+Öffnen Sie die Windows-Diensteverwaltung (services.msc). \\ Suchen Sie nach dem Dienst **COBI-time** und stellen Sie sicher, dass der Status auf **Laufend** und der Starttyp auf **Automatisch** steht.
-Öffnen Sie den IIS-Manager:
+\\\
-{{:8.png?550|}}
+{{:de:playground:11_setup_dienst.png?800|}}
 \\\
-Ändern Sie die Standardwebsite in den COBI.time-Ordner:
+----
-\\
+===== IIS Webserver Konfiguration =====
-{{:9.png?550|}}
+. Öffnen Sie den **Internetinformationsdienste-Manager (IIS)**. \\
-\\
+{{:8.png?550|}}
-Ändern Sie die den Pfad in:
+. Wählen Sie die **Default Web Site** aus und ändern Sie den physischen Pfad zu: \\
-''C:\Program Files (x86)\COBI.time\dist''
+   C:\Program Files (x86)\COBI.time\dist
-\\\
+{{:9.png?550|}}
 {{:10.png?700|}}
-\\
+. **Serverzertifikat importieren**:
+   * Öffnen Sie den Punkt Serverzertifikate.
-Öffnen Sie die Serverzertifikate und fügen Sie COBI.time Servercertificate hinzu:
+   * Rechtsklick -> Importieren...
+   * Wählen Sie die Zertifikatsdatei C:\Program Files (x86)\COBI.time\server\certs\cobitime.pfx aus (Standardpasswort: 1234) oder nutzen Sie Ihr eigenes SSL-Zertifikat.
 {{:11.png?700|}}
-\\
+. **Site-Bindungen anpassen:**
+   * Entfernen Sie den HTTP-Eintrag.
-Rechtsklick -> Importieren
+   * Fügen Sie eine HTTPS-Bindung hinzu und wählen Sie das importierte SSL-Zertifikat aus.
+   * Wichtig: Aktivieren Sie die Option Servernamensanzeige erforderlich (SNI).
-Wähle Sie die .pfx Datei aus ''C:\Program Files (x86)\COBI.time\server\certs\cobitime.pfx'' (Oder verwenden Sie Ihr eigenes Zertifikat). Das Standardpasswort lautet 1234.
-\\\
-Bearbeiten Sie die Standardeinstellungen für die Webseitenanbindung:
 {{:12.png?300|}}
-\\\
-Entfernen Sie http aus der Liste und fügen Sie nur https hinzu. Wählen Sie das SSL-Zertifikat aus, das Sie gerade importiert haben:
 {{:13n.png?700|}}
-\\\
-Wichtig: SNI (Server Name Indication) muss angekreuzt sein!
-Nach diesem Schritt sollte die COBI.time-Website erreichbar sein: ''https://serverNameHere'' oder ''https://localIpAddressHere''.
 ----
-===== COBI.time Einrichten der Website Backend Verbindung =====
+===== Backend-Verbindung im Frontend einrichten =====
-Navigieren Sie zu: ''C:\Program Files (x86)\COBI.time\dist\cfg'' und bearbeiten Sie die ''settings.js'' Datei:
+Navigieren Sie zum Ordner C:\Program Files (x86)\COBI.time\dist\cfg und öffnen Sie die Datei settings.js.
 {{:14.png?350|}}
-\\\
+Tragen Sie unter der Backend-URL die Server-IP bzw. den Hostnamen inklusive des in der .env definierten Ports ein (z. B. https://10.200.17.93:62000).
-Ändern Sie die URL in die Backend-IP-Adresse + Port, die Sie in der Datei „.env“ angegeben haben.
 ----
-===== COBI.time Datenbank einrichten =====
+===== Ersteinrichtung der COBI.time Datenstrukturen (Web-Setup) =====
-Warnung: COBI.time verändert die SAP-Datenbank.
+> **Wichtig:** Da COBI.time benutzerdefinierte Tabellen und Felder in SAP Business One anlegt, stellen Sie sicher, dass während der Ersteinrichtung **alle Benutzer aus SAP Business One abgemeldet** sind.
-Stellen Sie sicher, dass jeder Benutzer von SAP abgemeldet ist, bevor Sie diesen Schritt ausführen
-Stellen Sie sicher, dass der zuvor installierte Dienst ausgeführt wird. Navigieren Sie zur COBI.time Webseite: https://localhost/Setup
-Diese Seite sollte ein Änderungsprotokoll anzeigen und jede Tabelle, die COBI.time erstellen möchte:
+. Stellen Sie sicher, dass der Dienst **COBI-time** läuft. \\
+. Öffnen Sie Ihren Browser und rufen Sie die Setup-Seite auf: \\
+   https://localhost/Setup (bzw. Ihre Server-Adresse).
 {{:15.png?600|}}
-\\\
+. Das Web-Setup führt Sie automatisch durch das Anlegen der erforderlichen SAP-Tabellen, Felder und Initialdaten:
+   * **Tabellen erstellen:** Klicken Sie auf **Ausführen**. Starten Sie nach Fertigstellung den **SAP Service Layer neu** und bestätigen Sie mit **OK**.
+   * **Felder erstellen:** Klicken Sie erneut auf **Ausführen**. Starten Sie den **SAP Service Layer ein zweites Mal neu** und bestätigen Sie mit **OK**.
+   * **Initialdaten einspielen:** Klicken Sie ein letztes Mal auf **Ausführen**.
-Klicken Sie auf Ausführen und warten Sie, bis alle Tabellen erstellt wurden. COBI.time fordert Sie dann auf, den Service Layer neu zu starten.
+{{:16.png?400|}}
-Nachdem Sie den Service Layer neu gestartet haben, klicken Sie auf OK:
+. Nach Abschluss werden Sie automatisch zur Anmeldeseite weitergeleitet (https://localhost/Login).
-{{:16.png?400|}}
+Sie können sich nun mit den Standard-Administrator-Anmeldedaten einloggen:
+  * **Benutzername:** admin
+  * **Passwort:** admin
-Die Website wird neu geladen und Sie können nun die Felder für die Tabellen erstellen. Danach werden Sie aufgefordert, den Servicelayer noch einmal neu zu starten. Drücken Sie nach dem Neustart auf OK. Die Website sollte erneut neu geladen werden. Nachdem diese neu geladen wurde, drücken Sie noch einmal „Ausführen“, um die COBI.time-Anfangsdaten anzuzeigen. Sobald dies erledigt ist, können Sie einfach auf „OK“ drücken. Die Website wird neu geladen und Sie sollten zur Anmeldeseite weitergeleitet werden. Sollte die automatische Weiterleitung zur Anmeldeseite nicht funktionieren, navigieren Sie einfach manuell dorthin: https://localhost/Login
+> **Sicherheitshinweis:** Ändern Sie das Administrator-Passwort direkt nach dem ersten Login!
-Sie haben COBI.time erfolgreich installiert. Sie können sich jetzt als Administrator anmelden:
+----
-Benutzername: admin
+==== PIN-Freischaltung (optional) ====
+Um die Eingabe einer PIN in COBI.time zu aktivieren, wird ein Freischalt-Passwort benötigt.
-Passwort: admin
+Voraussetzung (Server):
+Auf dem Server wird in der .env-Datei ein Passwort hinterlegt (Freischalt-Passwort). \\
-Stellen Sie sicher, dass Sie dieses Passwort ändern. Weitere Fragen zur COBI.time-Nutzung finden Sie im COBI.time-Handbuch.
+Dieses Passwort wird nicht in COBI.time gespeichert, sondern dient nur zur einmaligen Aktivierung der PIN-Funktion auf dem Gerät. \\
+Inhalt: <file env .env>
+PinLoginPassword=test
+</file>
 ----
 ====== Deinstallation ======