COBISOFT Documentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.

====== COBI.time Installation ======

===== Anforderungen =====

  * Node.js Version 16
  * Microsoft IIS (WebServer)
  * [[https://www.iis.net/downloads/microsoft/url-rewrite|Modul für Microsoft IIS (URL Umschreiben)]]
  * SAP Business One ServiceLayer
  * SAP Business One 10 Patchlevel 2
===== Installation =====

==== NODE.js Installation ====

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.

----
==== 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.

Stellen Sie sicher, dass Microsoft IIS nicht installiert ist:

{{:1.png?800|}}

Wenn nicht, installieren Sie Microsoft IIS:

{{:2.png?300 |}}

\\\

Fügen Sie Rollen und Features hinzu

\\

Klicken Sie auf Weiter:

{{:5n.png?500|}}

\\\

Klicken Sie auf Weiter:

{{:6n.png?500|}}

\\\

Klicken Sie auf Weiter:

{{:7n.png?500|}}

\\\

Installieren Sie Webserver IIS mit Standardfunktionen (klicken Sie einfach auf Webserver), fügen Sie aber auch unter Leistung: Dynamische Komprimierung hinzu.

{{:3.png?500 |}}

\\\

Klicken Sie auf „Weiter“, bis Sie zur Installation gelangen. Dann installieren Sie die Funktionen.
Normalerweise ist kein Neustart des Computers erforderlich.

----

==== IIS Modul URL Installation neu schreiben ====

Installieren Sie die URL Umschreibung gemäß den Anforderungen, nachdem Sie IIS erfolgreich installiert haben:

https://www.iis.net/downloads/microsoft/url-rewrite

----

==== COBI.time Installation ====

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“).:

\\\

{{:4n.png?650 |}}

\\\

<code>
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)
</code>

Ändern Sie keine anderen Felder!

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 ====

Ö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.):

<code>
npm i -g qckwinsvc2
</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:

<code>
qckwinsvc2 Installationsname="COBI-time" Beschreibung="COBI.time Backend Server" path="C:\Program Files (x86)\COBI.time\server\server.js" args="-a -c" jetzt
</code>

Wenn Sie COBI.time in einem anderen Ordner installieren, ändern Sie den Befehl entsprechend.

Wenn Sie einen Powershell-Ausführungsrichtlinienfehler erhalten, führen Sie diesen Befehl vorher aus:

<code>
Set-ExecutionPolicy RemoteSigned
</code>

----

==== IIS Konfiguration ====

Öffnen Sie den IIS-Manager:

{{:8.png?550|}}

\\\

Ändern Sie die Standardwebsite in den COBI.time-Ordner: 

\\

{{:9.png?550|}}

\\

Ändern Sie die den Pfad in:
''C:\Program Files (x86)\COBI.time\dist''

\\\

{{:10.png?700|}}

\\

Öffnen Sie die Serverzertifikate und fügen Sie COBI.time Servercertificate hinzu:

{{:11.png?700|}}

\\

Rechtsklick -> Importieren

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 =====

Navigieren Sie zu: ''C:\Program Files (x86)\COBI.time\dist\cfg'' und bearbeiten Sie die ''settings.js'' Datei:

{{:14.png?350|}}

\\\

Ändern Sie die URL in die Backend-IP-Adresse + Port, die Sie in der Datei „.env“ angegeben haben.

----

===== COBI.time Datenbank einrichten =====

Warnung: COBI.time verändert die SAP-Datenbank.
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:

{{:15.png?600|}}

\\\

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.

Nachdem Sie den Service Layer neu gestartet haben, klicken Sie auf OK:

{{:16.png?400|}}

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

Sie haben COBI.time erfolgreich installiert. Sie können sich jetzt als Administrator anmelden:

Benutzername: admin

Passwort: admin

Stellen Sie sicher, dass Sie dieses Passwort ändern. Weitere Fragen zur COBI.time-Nutzung finden Sie im COBI.time-Handbuch.

----

==== 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: <file env .env>
PinLoginPassword=test
</file>

----
====== Deinstallation ======

===== Entfernen Sie den COBI.time-Dienst =====

Verwenden Sie den folgenden Befehl, um den COBI.time-Dienst zu deinstallieren:

<code>
qckwinsvc --uninstall --name "COBI-time"
</code>

Danach können Sie die COBI.time-Installation einfach von Ihrem Computer entfernen.

====== COBI.time Installation ======

===== Requirements =====

  * Node.js Version 22
  * Microsoft IIS (WebServer)
  * [[https://www.iis.net/downloads/microsoft/url-rewrite|Module for Microsoft IIS (URL Rewrite)]]
  * SAP Business One ServiceLayer
  * SAP Business One 10 Patchlevel 2

===== Installation =====

==== NODE.js Installation ====

Download the NODE.js LTS Version (See link in Requirements) and install it. Do not alter any values in the installation process. Just install it in the default way.

----
==== IIS Installation ====

If Microsoft IIS is already installed you this Installation Guide may not be applicable for you. Just make sure the dynamic compression is installed for Microsoft IIS.

Make sure Microsoft IIS is not installed:

{{:1.png?800|}}

If not, install Microsoft IIS:

{{:2.png?300 |}}

\\\

Picture 1: Add Roles or Features

\\

Press Next:

{{:5.png?500|}}

\\\

Press Next:

{{:6.png?500|}}

\\\

Press Next:

{{:7.png?500|}}

\\\

Install Webserver IIS with standard Features (just click on Webserver) but also add under Performance: Dynamic Compression:

{{:3.png?500 |}}

\\\

Press next untill you get install. Then Install the Features. You normally don’t need to restart the computer.

\\\

==== IIS Module URL Rewrite Installation ====

Install the URL Rewrite from the requirements after you have installed IIS successfully:

https://www.iis.net/downloads/microsoft/url-rewrite

\\\

==== COBI.time Installation ====

Install COBI.time via the Installation File which you get from us. COBI.time then gets installed to the standard folder: ''C:\Program Files (x86)\COBI.time\''

Navigate to that folder and then edit the ''.env'' file with Notepad. (Make sure you have administrator rights. Otherwise start notepad as admin and then open the ''.env'' from Open File context):

\\\

{{:4.png?450 |}}

\\\

<code>
MODE=production (production or development – put it in production to minimize logs)
PORT=62000 (specify any port here for COBI.time Backend)
SAP_URL=https://localhost:50000/b1s/v1 (ServiceLayer URL – Replace Localhost with ServiceLayerIP)
SAP_USER=manager (SAP User with indirect Access License or higher)
SAP_PASSWORD=**** (SAP User Password)
SAP_DB=SBODemoDE93 (SAP Database Name)
SSLPass=1234 (Password for custom SSL Certificate. Leave 1234 if you don’t provide with an extra SSL Certificate)
SECRET=iosncaonmwdo1! (Change to any random string for authorization token encryption)
</code>

Don’t change any other fields!

You have the possibility to change the SSL Certificate if you want to host COBI.time outside of your internal network and specify a domain. In ''C:\Program Files (x86)\COBI.time\server\certs'' replace the ''cert.pem'' with the certificate and the ''key.pem'' with the private password protected key.  Change the SSLPass accordingly.

\\\

==== COBI.time Service Installation ====

Open Powershell as Administrator and navigate to: ''C:\Program Files (x86)\COBI.time\server''

Install a global NPM Package for Microsoft service creation with the command (Make sure NODE.JS LTS Version is installed. After new NODE.JS Installation restart powershell):

<code>
npm i -g qckwinsvc2
</code>

After that use that new package to install a COBI.time Microsoft Service.  Make sure all values in the command are correct:

<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>

If you install COBI.time to a different folder change the command accordingly.

If you get an Powershell Execution Policy Error execute this Command beforehand:

<code>
Set-ExecutionPolicy RemoteSigned
</code>

\\\

==== IIS Configuration ====

Open IIS-Manager:

{{:8.png?550|}}

\\\

Change the default Website to COBI.time Folder: 

\\

{{:9.png?550|}}

\\

Change the Physical Path Property to: ''C:\Program Files (x86)\COBI.time\dist''

\\\

{{:10.png?700|}}

\\

Open Server Certificates and add COBI.time Servercertificate to it:

{{:11.png?700|}}

\\

Right Click -> Import

Select the .pfx from ''C:\Program Files (x86)\COBI.time\server\certs\cobitime.pfx'' (Or use your own Certificate).  The default Password is 1234.

\\\

Edit the Default Web Site Binding Settings:

{{:12.png?300|}}

\\\

Remove http from the list and add only https to it. Select the SSL Certificate which you just imported:

{{:13.png?700|}}

\\\

Important: SNI (Server Name Indication) must be ticked!

After this Step the COBI.time Website should be up and running under: ''https://serverNameHere'' or ''https://localIpAddressHere''.

\\\

===== COBI.time Setup Website Backend Connection =====

Navigate to: ''C:\Program Files (x86)\COBI.time\dist\cfg'' and edit the ''settings.js'' file:

{{:14.png?350|}}

\\\

Change the URL to the Backend IP Address + Port which you specified in the ''.env'' File.

\\\

===== COBI.time Database Setup =====

Warning: COBI.time will alter the SAP Database. Make sure every User is logged out from SAP before doing this Step
Make sure the previously installed service is running. Navigate to COBI.time Website: https://localhost/Setup

This site should display a changelog and every table COBI.time wants to create:

{{:15.png?600|}}

\\\

Click on execute and wait until all tables have been created. COBI.time then asks you to restart the Service Layer.

After you have restarted the Service Layer click ok:

{{:16.png?400|}}

The Website will reload and you can now create the fields for the tables. After that it asks you to restart the service layer one more time. After restarting press on OK. The Website again should reload. After it has reloaded press execute one more time for the COBI.time initial data. Once it is done you can just press ok and the website will reload and you should be taken to the login page. If the automatic transfer to the login page does not work, just navigate to it manually: https://localhost/Login

You have successfully installed COBI.time. You can now login as Administrator with:

Username: admin

Password: admin

Make sure to change that password. If you have further questions regarding COBI.time usage is answered in the COBI.time manual. 

----

==== PIN Activation (optional) ====

To enable PIN entry in COBI.time, an activation password is required.

Prerequisite (Server):  
On the server, a password must be defined in the .env file (activation password). \\  
This password is not stored in COBI.time itself but is only used once to activate the PIN function on the device. \\  

Content example:  
<file env .env>
PinLoginPassword=test
</file>

====== Uninstallation ======

===== Remove COBI.time Service =====

Use the following command to uninstall the COBI.time Service:

<code>
qckwinsvc --uninstall --name "COBI-time"
</code>

After that you can just remove the COBI.time installation from your computer.