How can we help you today?

Go ahead and ask us anything.

See the KanBo newest version.

Creating and updating the Elastic Cloud deployment

Last modified:


1. Go to portal.azure.com

2. In the search bar on the top, search for “Elastic” and click on “Elasticsearch (Elastic Cloud)” Image 13050

3. Click on “Create”

Image 13051

4. Choose Your Resource group, Resource name and region (pick the one closest to You). Image 13052

Important thing to note is that the price here will be cut down by 80%. This topic will be explained further into the article.

5. After that, press “Review + create” and then “Create”

Image 13053

6. After that, Your Elasticsearch will begin installing. It will take around 20 to 30 minutes.

7. After the installation is done, You will see a message that the deployment is complete

Image 13054

Click on “Go to resource”

8. You should see this

Image 13055

Click on “Manage changes in Elastic Cloud”

9. If You are prompted about permissions, tick off the box to consent on behalf of the organization and press “Accept”

10. Now we have access to Elastic Cloud Administration Panel

Image 13056

We should update Elastic Cloud deployment to the newest version first. Click on “upgrade” (as shown in screenshot).

Image 13057

Select the newest Generally available version and click on “upgrade”.

Image 13058

And Confirm Upgrade

11. Now Your Elastic Cloud deployment is updating all of its components. This may also take somewhere between 20 to 30 minutes.

After the update is done, the window will look like this

Image 13059

Click on the Elastic logo in the top left corner. We will now start with creating a user that will act as a connector between KanBo and Elastic Search.

Creating a user for KanBo

1. Now we will create a user that will be used as a connector between KanBo and Elastic Search.

Image 13077

Click on the name that You gave to the Elastic deployment (in our case, KanBoElasticSearch).

2. Now You have accessed Kibana. In the search bar at the top of the site, search for “Roles” and select it by “Go to”

Image 13078

After that, click on “Create role”

Image 13079

3. 

Image 13064

Image 13065

Then configure these options the same way they are configured in the screenshot.

  • Role name: admin-KanBoSearch

  • Cluster privileges: manage, manage_security

  • Run As privileges: *

  • Indices: kanbosearch.*

  • Privileges: all

4. After creating a role, search for “Users” in the top bar and select “Go to

Image 13066

And create a user in this fashion:

Image 13067

It is good practice to have the same username as the role name. The password is not generated and is set by You. For the “roles” section, select the role created in the step before: “admin-KanBoSearch”

From here, save the username and password somewhere for later.

Scaling down the Elastic Cloud deployment

The default sizing of Elastic search is a lot more than what is generally needed for searching through KanBo, which is why the deployment should be downscaled to avoid any unnecessary costs.

1. Go back to Your Elastic Cloud instance inside of Azure and go to “Configuration”

Image 13068

2. Click on “resize deployment”

Image 13069

3. Here we only need to modify the Elastic Search sizing, as other components do not impact the hourly costs.

Choose “1 zone” and change the sizing. The minimum required sizing of Elastic Search for KanBo is “60GB storage | 2 GB RAM | Up to 2.1 vCPU”, but, in case search is underperforming inside of KanBo, You should change the size to a higher one

Image 13071

After You select Your size, scroll all the way down and press “Save”

Image 13072

Your Elastic Search will now begin downscaling. This will take around 10 minutes.

Image 13073

After it is done, click on “Cloud” below the Elastic logo, as we will now begin KanBo with our Elastic Search.

Connecting KanBo with Elastic Search

1. Make sure You have this line in Your KanBo web.config: <elastic key=”55a42c0f7fc8e9444ba6e22370d8339c”/>, the key here is the encryption key and is a random String of min. 30 characters. This key will not be used anywhere in the configuration and is used to encrypt the communication between KanBo and elastic as additional layer of security.

2. Copy the cloud id (as shown below)

Image 13074

And save it somewhere

3. Go to KanBo Setup (https://yourkanbo.com/setup), show advanced setup and click on Elastic.

If the ”Elastic” option does not appear, restart the KanBo App and try again.

4. Click on “Cloud” and input these values into the boxes in the “Connection” section:

  • Cloud ID: The Cloud ID of Your Elastic Deployment
  • User: The username from “Creating a user for KanBo”, step 4.
  • Password: The password from “Creating a user for KanBo”, step 4.

  • Tenant name: kanbosearch

Image 13075

After that, click on register, and Your KanBo will be connected to the Elastic Search service

5. Index all Your data by choosing “All”, in the “Data import” section, ticking the “clean” box and clicking on “Execute”

Image 13076

Wait until Elastic indexed everything.

6. Restart Your KanBo application

7. Your KanBo now uses Elastic Search!

Troubleshooting

Failed registering elastic connection: Elastic ping failed

If that happened, then one of the inputs inside the boxes in the “Connection section” must have been wrong. Please make sure that:

1. You copied the whole Elastic Cloud ID

2. The Username and Password are correct

3. The tenant name doesn’t include the “.*” part that was present inside the Indices of a role we have created in Kibana


Is this article helpful for you?