Adding a new tenant (core) to KanBo Search

You can add many KanBo tenants to your KanBo SOLR-based Search. Please perform the following procedure.


Contact us at support@kanbozone.com to receive the most recent Search core package.

Before adding a new tenant to the KanBo Search, please make sure that you have the most recent version of KanBo deployed (in any installation model). Contact us to get the newest KanBo version package and if you don't have the most recent version, please perform the whole update procedure.


1. Enter your Virtual Machine where SOLR is deployed.
Find the places where the cores are stored. In our case C:\Solr\solr ( you can also search for core.properties file, it is in every core).



2. Create a folder for a new tenant files. We recommend naming it after your tenant's name and adding a name of it's content database next to it.

For example: MyKanBo-KanBo 8537889f832a4a70ac852aa81b69f332


3. Open the freshly created folder.

Prepare the Core Template. Please copy it and paste it into the opened folder.



4. Now extract it's files in the same location. When it's extracted, please delete the .zip file.



5. Open core.properties file in the text editor. Change "testcore" to name of Content database. Save these changes.


6. Prepare a connection string to your Content database.

Go to the "conf" directory of your core and edit the db-data-config.xml.

  • Change the URL to a connection string your database f.ex. url="jdbc:sqlserver://SERVERNAME:1433;databaseName=KanBoContentNAME;user=USER;password=PASSWORD"
  • Add values to the user and passowrd.

user="USERNAME"

password="YOURPASSWORD"

Save these values.




7. Go to C:\SOLR\Management or any other location where your SOLR is installed and search for Management folder.


Note that if you don't have a Management folder, please enter SolrInstaller.zip, search for the empty Management folder and copy it into location where your Search is installed.


Search for "SolrManagement.exe.config" and add your core to the "Cores" after comma ex. https://127.0.0.1:20112/solr/<YOURCORENAME>.



8. Restart SOLR (Services->KanBoSearchService->Restart)


9. Enter your Internet browser. Paste there a following URL, adding a solrPort number you already entered.

https://localhost:solrPortNumber/solr

example: https://localhost:12345/solr/


10. Select your freshly added core in the Core Selector and enter it. Then, click on Data import.

Select "Auto-refresh status" and click on Execute button.



Step 11. You will see your Indexing being completed in a couple of seconds.



Also please go to Logging section to see if any errors appear.


Adding Search plugin to Web.config

Follow the final steps responding to your installation scenario: Office 365+ Azure or SharePoint/On Premises.


Office 365 + Azure installation scenario

1. Enter Kudu Services. If your URL is f.ex. https://kanbo.azurewebsites.net, please type https://kanbo.scm.azurewebsites.net into your browser and enter it.

Go to Site -> wwwroot -> and start editing the Web config.


2. Delete the following section.

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


3. Copy the SOLR part and apply there your port address (SOLR URL), administrator name and password.

Save these changes.


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



4. Save these changes. Go to Kanbo.log to see if SOLR plugin is working properly.

2017-05-02 05:27:55,543 Plugins         DEBUG | plugin 20000000-0000-0000-0000-000000000001(Solr Cards Search): Running...
2017-05-02 05:27:55,668 Plugins         DEBUG | plugin 20000000-0000-0000-0000-000000000001(Solr Cards Search): Adding factory of type search.cards named SolrSearch
2017-05-02 05:27:55,683 Plugins         DEBUG | plugin 20000000-0000-0000-0000-000000000001(Solr Cards Search): Finished successfully
2017-05-02 05:27:55,683 Plugins         DEBUG | plugin 20000000-0000-0000-0000-000000000001(Solr Cards Search): Trying to hit cores info...
2017-05-02 05:27:55,715 Plugins         DEBUG | plugin 3cb5fbfd-78cb-41ad-b533-a00f9a0d6e80(Config multiplexer): Finished successfully


On Premises Installation Scenario


1. Enter the Machine where KanBo is installed. Move to folder where KanBo files are located.

Go to wwwroot -> and start editing the Web config in any text editor.



2. In web config, please delete the following section.

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


3. Copy there the SOLR part and apply there your port address (SOLR URL), administrator name and password.

Save these changes.

<plugin alias="plugin-config-executor.multiplex-config" user="USERNAME" pass="PASSWORD" allow-all-certificates="true" solrUrl="SOLRURL">
 <plugin alias="search-docs.solr" />
 <plugin alias="search-cards.solr" />
 </plugin>



4. Save these changes. Go to Kanbo.log (located in the wwwroot folder)to see if SOLR plugin is working properly.

2017-05-09 08:35:34,052 Plugins DEBUG | plugin 20000000-0000-0000-0000-000000000002(Solr Documents Search): Running...
2017-05-09 08:35:34,059 Plugins DEBUG | plugin 20000000-0000-0000-0000-000000000002(Solr Documents Search): Adding factory of type search.documents named SolrSearch
2017-05-09 08:35:34,060 Plugins DEBUG | plugin 20000000-0000-0000-0000-000000000002(Solr Documents Search): Finished successfully
2017-05-09 08:35:34,060 Plugins DEBUG | plugin 20000000-0000-0000-0000-000000000001(Solr Cards Search): Running...
2017-05-09 08:35:34,061 Plugins DEBUG | plugin 20000000-0000-0000-0000-000000000002(Solr Documents Search): Trying to hit cores info...
2017-05-09 08:35:34,061 Plugins DEBUG | plugin 20000000-0000-0000-0000-000000000001(Solr Cards Search): Adding factory of type search.cards named SolrSearch
2017-05-09 08:35:34,061 Plugins DEBUG | plugin 20000000-0000-0000-0000-000000000001(Solr Cards Search): Finished successfully

Read also about:

Installing and configuring KanBo Search

Updating a tenant (core) in KanBo Search


Is this article helpful for you?