Updating KanBo (Azure backend part)

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 {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="{SHAREPOINTURL}" 
client-secret="{CLIENTSECRET}" />
      <setup-permissions.sharepoint />

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

2. 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>
<!-- <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.

    <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="SOLRLOGIN" pass="SOLRPASS" url="https://SOLRURL:PORT/SOLR/CORENAME" />
<search-docs.solr />
<search-cards.solr />
<search-boards.solr />
<search-users.solr />
<search-desks.solr />
<user-update.solr />
<permission-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}" />
<!-- </on premise> -->

6. Add these entries in <plugins>

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

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

8. 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).

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

10. 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?