User Tools

Site Tools


cobi.time:installation_guide

COBI.time Installation

Requirements

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:

If not, install Microsoft IIS:

Picture 1: Add Roles or Features


Press Next:

Press Next:

Press Next:

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

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

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)

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

npm i -g qckwinsvc2

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

qckwinsvc2 install name="COBI-time" description="COBI.time Backend Server" path="C:\Program Files (x86)\COBI.time\server\server.js" args="-a -c" now

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:

Set-ExecutionPolicy RemoteSigned

IIS Configuration

Open IIS-Manager:

Change the default Website to COBI.time Folder:



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


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


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:

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

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:

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:

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:

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:

qckwinsvc --uninstall --name "COBI-time"

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

cobi.time/installation_guide.txt · Last modified: 2024/03/08 14:30 by wpertsch

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki