====== COBI.time Installation ====== ===== Anforderungen ===== * Node.js Version 22.14.0 LTS * Microsoft IIS (Webserver) * [[https://www.iis.net/downloads/microsoft/url-rewrite|URL Rewrite Modul für Microsoft IIS]] * PostgreSQL Datenbank * SAP Business One Service Layer * SAP Business One 10 (Patchlevel 2 oder höher) ===== Vorbereitung & Prerequisites ===== ==== 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 ==== Sollte Microsoft IIS bereits installiert sein, stellen Sie sicher, dass die **Dynamische Komprimierung** aktiviert ist. \\ Stellen Sie sicher, dass IIS bisher nicht installiert ist: \\\ {{:1.png?800|}} \\\ Falls nicht, installieren Sie Microsoft IIS: \\\ {{:2.png?300 |}} \\\ Rollen und Features hinzufügen: \\ Klicken Sie im Assistenten jeweils auf **Weiter**: \\\ {{:5n.png?500|}} \\\ {{:6n.png?500|}} \\\ {{:7n.png?500|}} \\\ Wählen Sie die Rolle **Webserver (IIS)** aus. \\ Navigieren Sie unter **Leistung** und aktivieren Sie zwingend die Option **Dynamische Komprimierung**. \\\ {{:3.png?500 |}} \\\ Klicken Sie auf **Weiter** und schließen Sie die Installation ab. Ein Neustart des Servers ist in der Regel nicht erforderlich. ---- ==== IIS URL Rewrite Modul Installation ==== 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]] ---- ===== 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|}} ---- ==== 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|}} ---- ==== 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|}} ---- ==== 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: MODE=production (Produktion oder Entwicklung – stellen Sie es auf Produktion, um Protokolle zu minimieren) PORT=62000 (Geben Sie hier einen beliebigen Port für COBI.time Backend an) SAP_URL=https://localhost:50000/b1s/v1 (ServiceLayer URL – Ersetzen Sie Localhost durch die ServiceLayerIP) SAP_USER=manager (SAP-Benutzer mit indirekter Zugriffslizenz oder höher) SAP_PASSWORD=**** (SAP Benutzername Passwort) SAP_DB=SBODemoDE93 (SAP Datenbank Name) SSLPass=1234 (Passwort für benutzerdefiniertes SSL-Zertifikat. Belassen Sie 1234, wenn Sie kein zusätzliches SSL-Zertifikat bereitstellen) SECRET=iosncaonmwdo1! (Wechseln Sie zu einer beliebigen Zufallszeichenfolge für die Autorisierungstoken-Verschlüsselung) > **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. ---- ==== COBI.time Service per PowerShell installieren ==== Öffnen Sie die Windows PowerShell als Administrator und führen Sie folgende Befehle aus: (1) In den Server-Ordner wechseln: cd "C:\Program Files (x86)\COBI.time\server" (2) Das Hilfspaket für Windows-Dienste global installieren: npm i -g qckwinsvc2 (3) Den COBI.time-Dienst registrieren und starten: \\ Wenn Sie COBI.time in einem anderen Ordner installieren, ändern Sie den Befehl entsprechend. qckwinsvc2 install name="COBI-time" description="COBI.time Backend Server" path="C:\Program Files (x86)\COBI.time\server\server.js" args="-a -c" now \\ {{: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: Set-ExecutionPolicy RemoteSigned ---- ==== Ü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. \\\ {{:de:playground:11_setup_dienst.png?800|}} \\\ ---- ===== IIS Webserver Konfiguration ===== 1. Öffnen Sie den **Internetinformationsdienste-Manager (IIS)**. \\ {{:8.png?550|}} 2. Wählen Sie die **Default Web Site** aus und ändern Sie den physischen Pfad zu: \\ C:\Program Files (x86)\COBI.time\dist {{:9.png?550|}} {{:10.png?700|}} 3. **Serverzertifikat importieren**: * Öffnen Sie den Punkt Serverzertifikate. * 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|}} 4. **Site-Bindungen anpassen:** * Entfernen Sie den HTTP-Eintrag. * Fügen Sie eine HTTPS-Bindung hinzu und wählen Sie das importierte SSL-Zertifikat aus. * Wichtig: Aktivieren Sie die Option Servernamensanzeige erforderlich (SNI). {{:12.png?300|}} {{:13n.png?700|}} ---- ===== Backend-Verbindung im Frontend einrichten ===== 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). ---- ===== Ersteinrichtung der COBI.time Datenstrukturen (Web-Setup) ===== > **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. 1. Stellen Sie sicher, dass der Dienst **COBI-time** läuft. \\ 2. Öffnen Sie Ihren Browser und rufen Sie die Setup-Seite auf: \\ https://localhost/Setup (bzw. Ihre Server-Adresse). {{:15.png?600|}} 3. 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**. {{:16.png?400|}} 4. Nach Abschluss werden Sie automatisch zur Anmeldeseite weitergeleitet (https://localhost/Login). Sie können sich nun mit den Standard-Administrator-Anmeldedaten einloggen: * **Benutzername:** admin * **Passwort:** admin > **Sicherheitshinweis:** Ändern Sie das Administrator-Passwort direkt nach dem ersten Login! ---- ==== PIN-Freischaltung (optional) ==== Um die Eingabe einer PIN in COBI.time zu aktivieren, wird ein Freischalt-Passwort benötigt. Voraussetzung (Server): Auf dem Server wird in der .env-Datei ein Passwort hinterlegt (Freischalt-Passwort). \\ Dieses Passwort wird nicht in COBI.time gespeichert, sondern dient nur zur einmaligen Aktivierung der PIN-Funktion auf dem Gerät. \\ Inhalt: PinLoginPassword=test ---- ====== Deinstallation ====== ===== Entfernen Sie den COBI.time-Dienst ===== Verwenden Sie den folgenden Befehl, um den COBI.time-Dienst zu deinstallieren: qckwinsvc --uninstall --name "COBI-time" Danach können Sie die COBI.time-Installation einfach von Ihrem Computer entfernen.