Creating and updating the Elastic Cloud deployment
Last modified:
2. In the search bar on the top, search for “Elastic” and click on
“Elasticsearch (Elastic Cloud)”
3. Click on “Create”
4. Choose Your Resource group, Resource name and region (pick the one
closest to You).
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”
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
Click on “Go to resource”
8. You should see this
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
We should update Elastic Cloud deployment to the newest version first. Click on “upgrade” (as shown in screenshot).
Select the newest Generally available version and click on “upgrade”.
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
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.
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”
After that, click on “Create role”
3.
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
And create a user in this fashion:
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”
2. Click on “resize deployment”
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
After You select Your size, scroll all the way down and press “Save”
Your Elastic Search will now begin downscaling. This will take around 10 minutes.
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 these lines in Your KanBo appsettings.json:
{
"type": "elastic",
"key": "FILL-ME"
},
The "key" variable 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 an additional layer of security.
2. Copy the cloud id (as shown below)
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
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”
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