How can we help you today?

Go ahead and ask us anything.

See the KanBo newest version.

Updating KanBo (IIS backend part)

Last modified:

KanBo Update IIS update

Prepare web.config

Always use web.config included in recent update package. Open web.config from KanBo update package in notepad.


1. Fill {SharePoint Address}, {CLIENTID}, {ISSUERID} and {Thumbpring} parts accordingly with values from "old" web.config. Compare other parts of both web.configs.


<auth-by-login issuer="sp">
        <identity-source />
      <auth.sharepoint sp-host-url="{SPAddress}" client-id="{ClientId}" issuer-id="{IssuerId}">
        <signer type="x509-store" key="thumbprint" value="{Thumbprint}" store-name="my" store-location="localmachine" valid-only="false" />
       
   </auth.sharepoint>
      <setup-permissions.sharepoint />
      <sp-app url="sharepoint-appfile" />

2. In case your organization is using a local certificate which is configured in the appSettings
instead of using the signer-attribute in the authentication-section, please perform the following change in the web.config file - add the file path in {C:\certs\yourcertname.pfx} and key in {CertificatePassword}.

 <signer type="x509-file" file="{PathToPFXCert}" key="{PassForCert}" />

3. Copy your license key into {LICENSEKEY} part.

<add key="KanBoLicenseKey" value="{LICENSEKEY}" />

4. Compare following KanBo settings

   <appsettings>
    <add key="IsOffice365" value="false" />
    <add key="KanBoAllowOpenbook" value="false" />
    <add key="KanBoAllowPublicBoards" value="true" />
    <add key="KanBoLicenseKey" value="" />
    <!-- Determines whether myboards are disabled or enabled -->
    <add key="KanBoMyBoard" value="true" />
    <!-- override server's timezone if necessary
      <add key="Timezone" value="US Mountain Standard Time" />
    -->
    <!-- Determines whether License warnings are shown -->
    <add key="KanBoLicenseWarnings" value="true" />
    <add key="KanBoEmailNotifications" value="true" />
    <add key="KanBoUserCanSyncProfile" value="false" />
    <add key="KanBoUserCanEditAvatar" value="true" />
    <add key="KanBoUserCanLinkProfile" value="false" />
    <add key="KanBoUserCanEditProfile" value="true" />
    <add key="KanBoDebuggingTokenIssuerPassword" value="" />
    <add key="KanBoIncomingMail" value="false" />
    <add key="KanBoIncomingMailDomain" value="" />
    <add key="ErrorReportingUrl" value="https://sendto.kanbobugs.net/kanbo_error_reporting" />
    <add key="HelpUrl" value="https://community.kanboapp.com" />
      </appSettings>

Openbook functionality will allow you to decide whether all KanBo users are able to create new Boards or not.

When Openbook availability is set as enabled (set as true in web.config), not only users with Board adding role but also regular users can create their own Public and Private Boards. If it’s not enabled (set as false in web.config), only users with appropriate role can create these two types of Boards.

KanBo Error Reporting functionality is explained here - KanBo Error Reporting.

5. Copy database connection strings and place them into Main_CS and PROFILE_CS values.

 <connectionstrings>
    <add name="KanBoContentConnectionString" connectionstring="" providername="System.Data.SqlClient" />
  </connectionstrings />

6. If you have KanBo Search installed and configured in your web.config, you must delete the following section (which works for default search):

  <package name="search-db" />

and paste the KanBo Search configuration lines which are copied from the old web.config.

They must be equipped with your SOLR admin name, password and SOLR URL.

 <package name="search-db" />
      
    
      <solr user="" pass="" url="" allow-all-certificates="true" />
          <search-docs.solr />
              <search-cards.solr />
              <search-boards.solr />
              <search-users.solr />
              <search-desks.solr />
              <permission-update.solr />
              <board-update.solr />
              <homelayout-update.solr />
              <card-update.solr />
              <user-update.solr />
          <solr.detect-downstate />


7. Add these entries in <plugins>

<website-search.sharepoint />
<require-user-account />  
<heartbeats>
<sql sync-interval="100" />
<messaging track="single-node" queue-interval="1000" send-interval="1000" inactive-detect-interval="1000" />
 <user-location / >
</heartbeats>

Add this entry if you would like to use Board Templates functionality. Make sure to replace {Path to the folder} with a valid path to a folder on a server where KanBo is installed

<template-files path="Path to the folder" />

7. Make sure to replace this entry

<system.web>
    <compilation targetframework="4.7" />
    <httpruntime targetframework="4.7" maxrequestlength="25165824" />
    <customerrors mode="Off" />
    <identity impersonate="false" />
 </system.web>

with this entry

<system.web>
    <compilation targetframework="4.8" />
    <httpruntime targetframework="4.8" maxrequestlength="25165824" />
    <customerrors mode="Off" />
    <identity impersonate="false" />
</system.web>

Please make sure that you have .NET Framework 4.8 installed on a virtual machine which serves as an Application Server for KanBo. You can download it from here: https://dotnet.microsoft.com/download/dotnet-framework/net48

8. To avoid potential issues please remove entire o365 sections

            <auth-by-login issuer="sp"/>
      <auth.sharepoint-online sp-host-url="{SPAddress}" client-id="{ClientId}" client-secret="{ClientSecret}" />
      <setup-permissions.sharepoint />

Update KanBo IIS website files

Go back to your Explorer window with IIS site.


DELETE everything from IIS site directory and upload all files from KanBo update package.

Updating KanBo (IIS backend part)

Once you finish START your Kanbo IIS Website

Now you need to upgrade KanBo databases

Possible issues:

  1. overrideMode
  2. viewstate MAC failed issue

Is this article helpful for you?