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

===== Requirements =====

  * Node.js Version 16
  * 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. 

\\

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