Update guide

This guide describes how to update an existing installation of KissLog on-premises.

Artifacts

  • KissLog.Backend.AspNetCore.zip

  • KissLog.Frontend.AspNetCore.zip

Artifacts can be downloaded from here.

Update steps

  1. Stop both IIS applications:

    • KissLog.Backend

    • KissLog.Frontend

Create backup

  1. Create a backup of the existing IIS application folders.

    /Backups
    ├── KissLog.Frontend\
    └── KissLog.Backend\
    

Copy new files

  1. Delete from the KissLog.Backend folder everything but:

    /KissLog.Backend
    ├── Configuration\
    ├── appsettings.json
    └── web.config
    
  2. Delete from the KissLog.Frontend folder everything but:

    /KissLog.Frontend
    ├── _kisslogMedia\
    ├── Configuration\
    ├── appsettings.json
    └── web.config
    
  3. Extract the contents of KissLog.Backend.AspNetCore.zip to KissLog.Backend folder.

    Choose not to override the existing files (keep the local files).

  4. Extract the contents of KissLog.Frontend.AspNetCore.zip to KissLog.Frontend folder.

    Choose not to override the existing files (keep the local files).

Update KissLog.Backend configuration

  1. Apply the configuration changes (if any) by updating KissLog.json file.

Update KissLog.Frontend configuration

  1. Apply the configuration changes (if any) by updating KissLog.json file.

  2. Change/increment the value of "AppVersion" property from KissLog.json file.

    This will refresh the browser cache for static resources.

    C:\inetpub\wwwroot\KissLog.Frontend\Configuration\KissLog.json
    {
        "ApplicationName": "KissLog",
        "AppVersion": "any-new-value",
    
        "InternalLogs.DirectoryPath": "Logs",
        "InternalLogs.MinimumStatusCode": "400"
    }
    

Start the applications

  1. Restart the IIS applications:

    • KissLog.Backend

    • KissLog.Frontend

  2. Make a single request to KissLog.Backend root URL (“http://kisslog-backend.myapp.com”)

    If the startup process went successful, a 200 OK "Running" response will be returned.

    KissLog.Backend Startup
  3. Make a single request to the KissLog.Frontend root URL (“http://kisslog.myapp.com”).

    If the startup process went successful, you will see the home page.

    KissLog.Frontend Startup

Troubleshooting

Please follow the troubleshooting steps from the installation guide.

Need help?

Open a GitHub issue or send an email to catalingavan@gmail.com.