Differences

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

--- cobi.time:installation_guide [2021/09/29 10:45] – created tkammer
+++ cobi.time:installation_guide [2024/05/02 10:56] (current) – [NODE.js Installation] thuth
@@ Line 1: / Line 1: @@
-======COBI.time Installation ======
+====== COBI.time Installation ======
 ===== Requirements =====
-  * 	NODE.js LTS
+  * Node.js Version 16
-  * 	Microsoft IIS (WebServer)
+  * Microsoft IIS (WebServer)
-  * 	Module for Microsoft IIS (URL Rewrite)
+  * [[https://www.iis.net/downloads/microsoft/url-rewrite|Module for Microsoft IIS (URL Rewrite)]]
-  * 	SAP Business One ServiceLayer
+  * SAP Business One ServiceLayer
-  * 	SAP Business One 10 Patchlevel 2
+  * SAP Business One 10 Patchlevel 2
-==== Installation ====
+===== Installation =====
-=== IIS 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.
@@ Line 57: / Line 62: @@
 \\\
-=== IIS Module URL Rewrite Installation ===
+==== IIS Module URL Rewrite Installation ====
-Install the URL Rewrite from the requirements after you have installed IIS successfully.
+Install the URL Rewrite from the requirements after you have installed IIS successfully:
+https://www.iis.net/downloads/microsoft/url-rewrite
 \\\
-=== IIS Module URL Rewrite Installation ===
+==== 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\
+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):
+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):
 \\\
@@ Line 88: / Line 95: @@
 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.
+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 ===
+==== COBI.time Service Installation ====
-Open Powershell as Administrator and navigate to: C:\Program Files (x86)\COBI.time\server
+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:
+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):
-npm i -g qckwinsvc
-After that use that new package to install a COBI.time Microsoft Service. Make sure all values in the command are correct:
+<code>
-qckwinsvc --name "COBI-time" --description "COBI.time Backend Server" --script "C:\Program Files (x86)\COBI.time\server\server.js" –startImmediately
+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 ===
+==== IIS Configuration ====
 Open IIS-Manager:
@@ Line 122: / Line 141: @@
 \\
-Change the Physical Path Property to: C:\Program Files (x86)\COBI.time\dist
+Change the Physical Path Property to: ''C:\Program Files (x86)\COBI.time\dist''
 \\\
@@ Line 137: / Line 156: @@
 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
+Select the .pfx from ''C:\Program Files (x86)\COBI.time\server\certs\cobitime.pfx'' (Or use your own Certificate).  The default Password is 1234.
 \\\
@@ Line 154: / Line 173: @@
 \\\
-After this Step the COBI.time Website should be up and running under: https://serverNameHere or https://localIpAddressHere
+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 ====
+===== COBI.time Setup Website Backend Connection =====
-Navigate to: C:\Program Files (x86)\COBI.time\dist\cfg and edit the settings.js file:
+Navigate to: ''C:\Program Files (x86)\COBI.time\dist\cfg'' and edit the ''settings.js'' file:
 {{:14.png?350|}}
@@ Line 166: / Line 187: @@
 \\\
-Change the URL to the Backend IP Address + Port which you specified in the .env File.
+Change the URL to the Backend IP Address + Port which you specified in the ''.env'' File.
 \\\
-==== COBI.time Database Setup ====
+===== 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
@@ Line 195: / Line 216: @@
 Password: admin
-Make sure to change that password. If you have further questions regarding COBI.time usage is  answered in the COBI.time manual.
+Make sure to change that password. If you have further questions regarding COBI.time usage is answered in the COBI.time manual.
 \\
-===== Uninstallation =====
+====== Uninstallation ======
-==== Remove COBI.time Service ====
+===== 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.