Installation of KanBo without Tenant administrator rights

It is also possible to install KanBo without KanBo.app added to SharePoint App Catalog. You can complete this installation while you are a SharePoint Site Collection administrator in SharePoint. In this article, we have described how you can add KanBo and KanBo trial to the SiteCollection without tenant administrator rights.

If you have any questions or problems, please contact us at support@kanbozone.com

Prererequisites:

User which will perform the procedure needs to have:

In a scenario when KanBo is added on a Private Site Collection

User should have Administrator rights on a Site Collection. He should be also added to owners of a Site Collection.

Learn more about adding Administrators to a Site Collection here: https://support.office.com/en-us/article/Manage-administrators-for-a-site-collection-9a7e46f9-3fc4-4297-955a-82cb292a5be0 .

In a scenario when KanBo is added on a Group Site Collection

User should be added as an Owner to the Group. 

Learn more about adding Owners to the Office 365 groups here: https://support.office.com/en-us/article/add-or-remove-members-from-office-365-groups-using-the-office-365-admin-center-e186d224-a324-4afa-8300-0e4fc0c3000a .

You can also add user as a Member to a group and then go to the group interface to change the permissions.

Go to the Outlook Online : https://outlook.office.com/owa/ . Enter a Group by clicking on it's name on the left pane:

Click on members button on the right side of the Group page.

Now click on  button next to user's name and select Make Owner.

Installing KanBo

Log into your Office 365 Account.

Go to https://yourSharePointurl.sharepoint.com/_layouts/15/appregnew.aspx

Please keep in mind that Group site's URLi is : https://yourSharePointurl.sharepoint.com/sites/YourGroupName/ so the address will be https://yourSharePointurl.sharepoint.com/sites/YourGroupName/_layouts/15/appregnew.aspx 

KanBo Installation of KanBo on Office 365 without Tenant administrator rights


Enter the registration data with URL pointing to your KanBo website


App domain should be the domain of the site you we have created on Azure – in this example it is: installingkanbo-kanbo.azurewebsites.net . The Redirect Url should be the site address with the HTTPS prefix + /pages/default.aspx. In our case it will be https://installingkanbo-kanbo.azurewebsite.com/pages/default.aspx.


KanBo Installation of KanBo on Office 365 without Tenant administrator rights


After clicking "Create", you will be presented with the following page:


KanBo Installation of KanBo on Office 365 without Tenant administrator rights



 Go to https://yourSharePointurl.sharepoint.com/_layouts/15/appinv.aspx.

In case of a Group site the address will be https://yourSharePointurl.sharepoint.com/sites/YourGroupName/_layouts/15/appinv.aspx.

Enter your App ID and click on "Lookup" button. All data about your app will be found and added to the form fields.


Provide the permissions in App's Permission Request XML field in following format:

<AppPermissionRequests AllowAppOnlyPolicy="true">
<AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web" Right="FullControl" />
<AppPermissionRequest Scope="http://sharepoint/content/sitecollection" Right="FullControl" />
</AppPermissionRequests>



TRUST KanBo in your Site Collection.

KanBo Installation of KanBo on Office 365 without Tenant administrator rights



Configuring the web.config file

Providing the ClientId and ClientSecret

Download the most recent KanBo installation package (contact us at support@kanbozone.com to receive it).

Extract the KanBo.Web package and open the web.config file provided in it.

After opening it, insert values of Client Id in {CLIENTID} and Client Secret in {CLIENTSECRET}. Also add a SharePoint URL in {SPHOSTURL} location.

  <!-- <o365> -->
      <provider id="sp" type="Sharepoint" spHostUrl="{SPHOSTURL}" clientId="{CLIENTID}" clientSecret="{CLIENTSECRET}" /> 
      <!-- </o365> -->

Moreover, remove entire section dedicated on premise installation

<!-- <on premise> -->
      <provider id="sp" type="Sharepoint" sphosturl="{SPHOSTURL}" 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}"></signer>
      </provider>
<!-- </on premise> --> 

Save your changes.

Creating an SQL database

Enter link https://portal.azure.com/#create/Microsoft.SQLDatabase to create an SQL Database.

The new database is only temporary as it is needed only to configure DB connectivity in the further steps of the installation. In the last step of the installation procedure we will ask you to delete it - it will not be used.
You can name it "kanboinstallation_db" or use any other name. Please set the pricing tier to "Basic: 5 DTU, 2 GB", collation to SQL_Latin1_General_CP1_CI_AS and leave all other parameters as they are.

Click on Create to save your database.

Configuring the DB connectivity

Use the Azure portal to obtain the connection string necessary for your Web App to connect with Azure SQL Database:

Click on SQL Databases icon and then, search for your temporary database.

Click on your database, then click Show database connection strings.

If you are going to use ADO.NET connection library, copy the string of ADO.NET.

Go to the web.config file where we have previously entered the ClientId and ClientSecret. Search for <connectionstrings> section.

Paste the connection string there in the place of an old string. Please modify added connection string - add your user ID and password (use server admin's credentials).

Save the changes.

There are two important things:


a) Put "MultipleActiveResultSets=True" at the end of each connection string.

b) Find out a new Database name (ex. KanBoContent_db) so it is unique for the chosen database. (the name can't be the same as the name of the database we've created for the Azure site). Delete a previous name and replace it with new one.

Now you can delete the previously created temporary database (in our scenario it will be "kanboinstallation_db").

Uploading the KanBo installation package

You can do it in two different ways.

Option 1 - Use FTP

After all changes to the web.config have been made, save the file and upload the whole content of the .rar to the {yourAzureFTPRootFolder}/site/wwwroot/. ATTENTION: DO NOT DELETE EXISTING SITE STRUCTURE!

Full KanBo installation on Office 365 SharePoint Azure Microsoft

Option 2 - Use KUDU service

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

Then enter site folder -> wwwroot.

Pack all your files into a .zip file (but please don't add the folder!)

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




Adjust the following link:  https://Your KanBo Address/setup (example https://installingkanbo-kanbo.azurewebsites.net/setup) and enter it in your browser.


After clicking a link, you will be redirected to KanBo Setup page.

Select Automatic setup and wait a few minutes as the installation proceeds.

KanBo Installation of KanBo on Office 365 without Tenant administrator rights

You will see the following communication with your license ID. Please send this License Id (numeric) to support@kanbozone.com and we will generate a new license key for you. Once we send you the key, you will have to paste it into KanBo configuration. 

Once the license has been added, hit Reauthenticate in Setup. Then, click on the Automatic setup button.

 You will get a communicate 'KanBo is now usable". Click on it to enter KanBo.


10) Your KanBo is ready now!


If you have any questions or problems, please contact us at support@kanbozone.com

installation SharePoint

Is this article helpful for you?