Applies to: 
Kyvos Enterprise Kyvos Cloud (SaaS on AWS) Kyvos AWS Marketplace
Kyvos Azure Marketplace Kyvos GCP Marketplace Kyvos Single Node Installation (Kyvos SNI)
Services Mapping
Kyvos Manager lets you configure services for the BI Server, Web Portal, Postgres Server, and Standby Postgres Server on the cluster nodes.
You can configure services for nodes at the time of adding new nodes or migrate roles later at any time.
Note
From Kyvos 2023.3 onwards, you can see the last performed node and service mapping operation details, including progress status and start time, by clicking the i icon located next to the Revert button. To view more comprehensive details, simply click the View Details link, which will take you to the Operations page, where you can view the operation information in detail.
On Azure Marketplace, the license information for the Query Engine and BI Server will not be available for Kyvos Managed Application and Kyvos Single Node Standard installation.
Migrate Services
To migrate services from one node to another, perform the following steps.
On the navigation pane, click Kyvos and Ecosystem > Node and Services.
On the Node and Services page, you will see a list of all the nodes configured in the cluster.
On the right, you will see the number of instances configured in the system for each service and the number allowed in your license.
Use the Services drop-down lists to select the role that you want to assign to the node.
Note
The service assignment must comply with the number of instances allowed by your licenses. For example, if your license allows two BI Servers, you cannot assign the BI Server service to more than two nodes. Ensure that this is not applicable to Kyvos Marketplace.
When enabling Kyvos Manager HA, if the node being removed has a Kyvos Manager instance, it must be removed before removing the Kyvos Web Portal node.
Once done, click the Save button.
Enter your Kyvos Manager Password to continue and then click Save.
NOTE: From Kyvos 2023.3 onwards, if you want to start Kyvos services, select the Start Kyvos Services checkbox.
The Operations page displays the details of role migration. Once the operation completes, you will see the new services on the Dashboard and Node and Service Mapping page.
Managing Nodes
Kyvos allows you to add as many nodes to your cluster as you want. However, the roles that you can assign to the nodes are governed by your Kyvos License.
In this section, you will learn the following:
Adding a new node
Note
Applicable in all environments except Kyvos Single Node Standard (SNS), Kyvos Single Node Installation (SNI), and environments that do not support node scaling.
The options for displaying, adding, or deleting a node may vary depending on the type of environment you are using. For example, the Launch Node and Terminate Node options will be displayed in all Marketplace environments. See the Scaling nodes and services for more details.
To add a node to your Kyvos cluster, perform the following steps.
On the title bar, click the Menu button (hamburger icon).
The Kyvos Manager menu appears.On the navigation pane, click Kyvos and Ecosystem > Node and Services.
The Node and Service Mapping page shows the current instances configuration and the configuration allowed in your Kyvos license.On the Node and Services page, select the Add Nodes option from the three-dots menu.
On the Add Nodes to Cluster dialog, enter space-separated hostnames or IP addresses for the nodes that you want to add.
Click the Fetch Details button.
Once the node list is retrieved, you will see a tabular view of nodes along with options to configure the Services and the number of Instances for the service on the node.
You will also see the status in the corresponding column.
The Node Details and Prerequisite Checks on the right show detailed information for the node, as shown in the following figure.
At the time of adding nodes, you can also configure high availability for the Kyvos Web Portal and Postgres Server nodes.
Tip
You can later configure high availability from the Node and Service Mapping page in the Properties section.
Select the Web Portal option from the Services list, and then click Next.
The Web Portal HA Configuration dialog is displayed.
To configure high availability for the Web portal, select the Enable Web Portal High Availability option and provide details as:
Parameter | Description |
|---|---|
Virtual IP/Hostname | Enter the virtual IP/Hostname in the protocol://host:port format to access the Kyvos Web Portal when the Web Portal is configured with high availability mode. It is the single IP/Hostname that will be used to access the Kyvos Web Portal, regardless of the IP/Hostname on which the Web Portal is actually running. |
Enable Session Management | Select to enable Tomcat-based session management. Do not select this for cloud clusters with a load balancer configured for Web Portal HA. |
Multicast Address | Specify the multicast IP address that will be used for multi-casting messages to all web portal IP/Hostname. It is a logical identifier for a group of hosts in a computer network that is available for processing. Read more |
Multicast Port | Enter the multicast port to be used for sending multicast messages. |
Receiver Port | Enter the port that will be used as the receiver port |
Once done, click the Next button. The system validates the node information and shows the Validation Logs.
You can Filter the logs to view Info, Warnings, or Error.
In case of any errors or warnings, click the Back button and make the requisite changes. Click the Revalidate button to recheck the configuration.Provide your Kyvos Manager Password at the bottom left of the page.
Click the Add button. You will be redirected to the Add node Operation page.
Once the operation completes, you can refresh the Node and Service Mapping page to view the new node added to the list. It will also show up on the Dashboard.
Deleting a node
Note
Nodes once deleted, cannot be retrieved.
Applicable in all environments except Kyvos Single Node Standard (SNS) and Kyvos Single Node Installation (SNI).
To delete a node from your Kyvos cluster, perform the following steps.
On the navigation pane, click the click Kyvos and Ecosystem > Node and Services option.
On the Node and Services page, select the Delete Nodes option from the three-dots menu.
On the Delete Nodes dialog box, select the nodes that you want to delete.
Enter your credentials in the Password box, and click the Delete button.
Note
When you delete a BI Server node from a multiple BI Server nodes cluster, and that has Zookeeper configured on it, in this case, you need to remove Zookeeper and redeploy it using the Zookeeper configuration page.
You cannot delete a node if it is the ONLY BI Server node in the cluster.
You cannot delete the Postgres Server node from the cluster.
You cannot delete Web Portal node till the Kyvos Manager Service is configured on it.
Adding Kyvos Manager Service
Important
Before adding a Kyvos Manager Service, you must complete the Prerequisites mentioned in the Kyvos Manager High Availability section.
To manually add Kyvos Manager services if UI is unavailable, download a script file named kyvosmanager-instance-setup-script from the DFS at path <engine_work>/setup/scripts/ and execute that script. This will set up the Kyvos Manager service on the current node.
To add a Kyvos Manager Service, perform the following steps.
On the title bar, click the Menu button (hamburger icon).
The Kyvos Manager menu appears.On the navigation pane, click Kyvos and Ecosystem > Node and Services.
The Node and Service Mapping page shows the current instances configuration and the configuration allowed in your Kyvos license.On the Node and Services page, select the Add Kyvos Manager Service option from the three-dots menu.
On the Add Kyvos Manager to Cluster dialog, select hostnames or IP addresses for the nodes that you want to add.
Note
The drop-down list for selecting hostnames or IP addresses includes only:
The nodes that have the Web Portal configured on them.
The nodes that do not have the Kyvos Manager services on them.
Click the Fetch Details button.
Once the node list is retrieved, you will see a tabular view of nodes along with options to configure the Services and the number of Instances for the service on the node.
You will also see the status in the corresponding column.
Click the Add button. The Kyvos Manager Service is added and displayed on the Kyvos Manager Dashboard and Node and Service Mapping page in the Kyvos Manager Nodes section.
Important
For cloud environments where Load Balancer is used, after adding Kyvos Manager Service, you need to perform manual steps to add newly added entry of Kyvos Manager nodes in the target group of Load Balancer. See the Kyvos Manager High Availability Manual Steps section.
Removing Kyvos Manager Service
Note
Kyvos Manager Service cannot be removed from the Active Kyvos Manager instance.
To remove a Kyvos Manager Service, perform the following steps.
On the title bar, click the Menu button (hamburger icon).
The Kyvos Manager menu appears.On the navigation pane, click Kyvos and Ecosystem > Node and Services.
The Node and Service Mapping page shows the current instances configuration and the configuration allowed in your Kyvos license.
On the Node and Services page, select the Remove Kyvos Manager Service option from the three-dots menu. The Remove Kyvos Manager Service dialog is displayed.
Select the checkbox to remove the required node, and then click Remove.
Important
For cloud environments where Load Balancer is used, after removing Kyvos Manager Service, you need to perform manual steps for removing entry of Kyvos Manager nodes in the target group of Load Balancer. See the Kyvos Manager High Availability Manual Steps section.