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

# 2) Create a backup of the existing IIS application folders.

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

Copy new files

# 3) Delete from the KissLog.Backend folder everything but:

/KissLog.Backend
├── Configuration\
├── appsettings.json
└── web.config

# 4) Delete from the KissLog.Frontend folder everything but:

/KissLog.Frontend
├── _kisslogMedia\
├── Configuration\
├── appsettings.json
└── web.config

# 5) Extract the contents of KissLog.Backend.AspNetCore.zip to KissLog.Backend folder.

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

# 6) Extract the contents of KissLog.Frontend.AspNetCore.zip to KissLog.Frontend folder.

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

Update configuration

# 6) Update KissLog.Backend\Configuration\KissLog.json file.

Apply the configuration schema changes (if any).

# 7) Update KissLog.Frontend\Configuration\KissLog.json file.

Apply the configuration schema changes (if any).

# 8) Update KissLog.Frontend\appsettings.json file.

Change/increment the values for "AppVersion" and "HtmlMetaImagesVersion" settings.

This will refresh the browser cache for static resources.

C:\inetpub\wwwroot\KissLog.Frontend\appsettings.json
{
    "Logging": {},
    "ApplicationType": "OnPremises",
    "ConfigurationFilePath": "Configuration\\KissLog.json",
    "KissLog.License": "",
    "AppVersion": "any-new-value",
    "HtmlMetaImagesVersion": "any-new-value"
}

Start the applications

# 9) 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

# 10) 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.