How can we help you today?

Go ahead and ask us anything.

See the KanBo newest version.

Updating KanBo (Azure backend part)

Last modified:

update

Prepare web.config

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


1. Put this part in <plugins> section before <load-packages /> Fill parts of {SPAddress}, {CLIENTID}, {CLIENTSECRET} and {LICENSEKEY} accordingly with values from “old” web.config's section of authentication. Compare other parts of both web.configs.


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


2. Compare following KanBo settings

  <appsettings>
    <add key="IsOffice365" value="true" />
    <add key="KanBoAllowOpenbook" value="false">
    <add key="KanBoAllowPublicBoards" value="true">
    <add key="KanBoLicenseKey" value="Your-License-Key-Goes-Here">
    <!-- 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>
<!-- <o365> -->    
<add key="IsOffice365" value="true" />
<!-- </o365> -->

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

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.

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

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

4. 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-messages.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 />

5. To avoid issues please remove entire section for on-premises configuration.

<!-- <on premise> -->      
<provider id="sp" type="Sharepoint" clientId="{CLIENTID}" issuerId="{ISSUERID}">
<!-- signer is described below, this one must contain a private key -->
<signer type="X509SignerFromStore" storeName="My" storeLocation="LocalMachine" key="Thumbprint" value="{Thumbprint}" />
</provider>
<!-- </on premise> -->


6. 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. In case of Azure installation scenario, it can be like: D:\home\site\{yourfoldername} if you create an appropiate folder in this location.

<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>

IMPORTANT: Make sure that yoour Azure Web App is running on .NET Framework 4.8: https://blogs.msdn.microsoft.com/waws/2016/11/02/how-to-determine-the-installed-net-version-in-azure-app-services/

8. ZIP all files to have those files visible at first glance without any root folder.


9. Navigate to your Azure website folder via FTP or KUDU service (add .scm just before azurewebsites.net e.g https://kanbo-online-kanbo.scm.azurewebsites.net, then select Debug console -> PowerShell).


10. Delete everything under Sites -> wwwroot (ensure you have backup of those files).


12. Now drag and drop you .zip archive into left upper part of KUDU service.

Updating KanBo (Azure backend part) KanBo Update


Once upload is finished, please start your Web App on Azure and continue with upgrade KanBo databases.



This article was helpful for 1 person. Is this article helpful for you?