Updating KanBo (IIS backend part)

Prepare web.config

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


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


<provider id="sp" type="Sharepoint" clientId="{CLIENTID}" issuerId="{ISSUERID}">
<signer type="X509SignerFromStore" storeName="My" storeLocation="LocalMachine" key="Thumbprint" value="{Thumbprint}" />


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="X509SignerFromFile" file="{C:\certs\yourcertname.pfx}" key="{CertificatePassword}"></signer>


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

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


4. Compare following KanBo settings

   <add key="KanBoAllowOpenbook" value="false"></add>
    <add key="KanBoInstancePath" value="intranet"></add>
    <add key="KanBoLicenseKey" value="YOUR LICENSE KEY"></add>
    <!-- Determines whether myboards are disabled or enabled -->
    <add key="KanBoMyBoard" value="true"></add>
    <!-- override server's timezone if necessary 
<add key="Timezone" value="US Mountain Standard Time" >
    </add> -->
    <!-- Determines whether License warnings are shown -->
    <add key="KanBoLicenseWarnings" value="true"></add>
    <add key="KanBoEmailNotifications" value="true"></add>
    <add key="KanBoUserCanSyncProfile" value="false"></add>
    <add key="KanBoUserCanEditAvatar" value="true"></add>
    <add key="KanBoUserCanLinkProfile" value="false"></add>
    <add key="KanBoUserCanEditProfile" value="true"></add>
    <add key="KanBoDebuggingTokenIssuerPassword" value=""></add>
    <!-- Set this to limit amount of instances that can be created in this instances database -->
    <add key="KanBoMaxInstances" value="0"></add>
    <add key="KanBoIncomingMail" value="false"></add>
    <add key="KanBoIncomingMailDomain" value=""></add>
    <add key="ErrorReportingUrl" value="http://KanBoErrorReportingURL"></add>


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 Managers, but also regular users can create their own Public and Private Boards. If it’s not enabled (set as false in web.config), only Managers can create these two types of Boards.


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



5. Copy database connection strings into MAIN_CS and PROFILES_CS.

<connectionStrings>    
<add name="KanBoSqlConnectionString" connectionString="MAIN_CS" providerName="System.Data.SqlClient" />
<add name="KanBoProfilesConnectionString" connectionString="PROFILE_CS" providerName="System.Data.SqlClient" />
</connectionStrings>


6. Change IsOffice365 value to "false".

<!-- <o365> -->    
<add key="IsOffice365" value="false" />
<!-- </o365> -->


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

<plugin alias="search-cards.database.by-name"></plugin>
<plugin alias="search-docs.database.by-name"></plugin>
<plugin alias="search-boards.database.by-name"></plugin>


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.

<plugin alias="plugin-config-executor.multiplex-config" user="{USERNAME}" pass="{PASSWORD}" solrUrl="{SOLRURL}">
<plugin alias="search-docs.solr"></plugin>
<plugin alias="search-cards.solr"></plugin>
<plugin alias="search-boards.solr"></plugin>
 </plugin>


8. To avoid potential issues please remove entire o365 sections

<!-- <o365> -->      
<provider id="sp" type="Sharepoint" clientId="{CLIENTID}" clientSecret="{CLIENTSECRET}" />
<!-- </o365> -->
Please make sure that you have .NET Framework 4.7 installed on virtual machine which serves as an Application Server for KanBo

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
KanBo Update IIS update

Is this article helpful for you?