/
Managing Services Mapping

Managing Services Mapping

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 2024.3 onwards, you can only configure one service either BI Server or Query Engine on a node. No other service can be configured on a BI Server or Query Engine node. Ensure that this applies to all Cloud Deployments.

  • 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.

  1. On the navigation pane, click Kyvos and Ecosystem > Node and Services. 

  2. On the Node and Services page, you will see a list of all the nodes configured in the cluster.

  3. On the right, you will see the number of instances configured in the system for each service and the number allowed in your license. 

  4. 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.

  1. Once done, click the Save button.

    Add_nodes_12.png

     

  2. 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 Kyvos Core Service 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 https://kyvosdocumentation.atlassian.net/wiki/spaces/KD202410/pages/238866623 for more details.

To add a Kyvos Core Service Node to your Kyvos cluster, perform the following steps.

  1. On the title bar, click the Menu button (hamburger icon).
    The Kyvos Manager menu appears. 

  2. 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.

  3. On the Node and Services page, select the Add >Kyvos Core Service Node option from the three-dots menu.

    Add_nodes_1.png

  4. On the Add Nodes to Cluster dialog, enter space-separated hostnames or IP addresses for the nodes that you want to add.

    Add-1.png

  5. Click the Fetch Details button.

  6. 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.

  7. At the time of adding nodes, you can also configure high availability for the Kyvos Web Portal and Postgres Server nodes.

  8. Select the Web Portal option from the Services list, and then click Next.
    The Web Portal HA Configuration dialog is displayed.  

  9. To configure high availability for the Web portal, select the Enable Web Portal High Availability option and provide details as:

Parameter

Description

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.
NOTE: If protocol and port are not specified, those will be picked from the Web Portal URL. 

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.
NOTE : This option is recommended for On-Premise clusters (e.g., node-1 or http://node-1:80).

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

Copyright Kyvos, Inc. 2025. All rights reserved.