Installation guide¶
Prerequisites¶
Artifacts
KissLog.Backend.AspNetCore.zip
KissLog.Frontend.AspNetCore.zip
Artifacts can be downloaded from here.
Services
IIS Web server with NET Core 3.1 Runtime installed
MongoDB Community Server (version 4.2.x)
Installation¶
MongoDB
For instructions installing MongoDB server, please check the official tutorial.
MS-SQL / MySql
We will not cover the installation guide for these services. There is a high possibility that the existing server will already have a running instance of MySQL or MS-SQL server.
IIS web applications
On the machine hosting the IIS server, install .NET Core 3.1 Runtime
Create two IIS applications, one
KissLog.Backend
and the secondKissLog.Frontend
Update the Application Pool settings for both of the applications to the following:
.NET CLR version: No Managed Code
Managed pipeline mode: Integrated


Copy into each Site folder the corresponding deploy package


Initial startup¶
KissLog.Backend¶
Update KissLog.Backend configuration file located under
Configuration\KissLog.json
:
KissLogBackendUrl |
---|
Example: |
Root url pointing to the KissLog.Backend site |
KissLogFrontendrl |
---|
Example: |
Root url pointing to the KissLog.Frontend site |
Database.MongoDb.ConnectionString |
---|
Example: |
Connection string used to connect to the MongoDB server |

Make a single request to the KissLog.Backend root URL (“/”).
If the startup process went successful, a 200 OK "Running"
response will be returned.
This will bootstrap all the necessary components, including configuration validation and MongoDB database generation.

KissLog.Frontend¶
Update KissLog.Frontend configuration file located under
Configuration\KissLog.json
:
KissLogBackendUrl |
---|
Example: |
Root url pointing to the KissLog.Backend site |
KissLogFrontendrl |
---|
Example: |
Root url pointing to the KissLog.Frontend site |
Database.KissLogDbContext |
---|
Example: |
Database connection string |
Authorization.HS256Secret |
---|
Example: |
Represents the authentication JWT signature key. In order to authenticate to this KissLog application, the user must provide a JWT token which has been signed with the same key (HS256Secret) that has been specified here. The authentication JWT can be created programmatically, or online using https://jwt.io/. |

Make a single request to the KissLog.Frontend root URL (“/”).
If the startup process went successful, you will see the home page.
