Differences

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

--- cobi.time:installation_guide [2021/09/29 11:44] – [COBI.time Service Installation] tkammer
+++ cobi.time:installation_guide [2024/05/02 10:56] (current) – [NODE.js Installation] thuth
@@ Line 3: / Line 3: @@
 ===== 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 =====
+==== 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 ====
@@ Line 67: / Line 72: @@
 ==== 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 90: / 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.
 \\\
@@ Line 96: / Line 101: @@
 ==== 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>
+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>
-qckwinsvc --name "COBI-time" --description "COBI.time Backend Server" --script "C:\Program Files (x86)\COBI.time\server\server.js" -–startImmediately
+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>
 \\\
@@ Line 127: / 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 142: / 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 159: / 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''.
 \\\
@@ Line 165: / Line 181: @@
 ===== 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 171: / 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.
 \\\
@@ Line 200: / 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.
 \\
@@ Line 209: / Line 225: @@
 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.