Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Area

Parameter/Field

Remarks/Description

Cluster Name

Provide a unique cluster name

License

Upload your Kyvos license file, and click UPLOAD

Installation Path

Provide the installation path for Kyvos

Authentication

User Name

Enter your username for authentication.

Authentication Type

  • Private Key: Choose and Upload the Private Key file.

  • Password: Provide your credentials.
    NOTE: To use password authentication for instances while deployment, ensure that the instances have been configured for using Password-based authentication.

Configure Kyvos Services on Cloud

Select Instance by

  • IP Address: Select this option for IP Address-based deployment.

  • Hostname:  Select this option for hostname-based deployment. In this case, you can deploy the cluster using custom hostnames for nodes to be used for Kyvos services. 

    • Click the Use custom hostname for selected nodes link to specify or map a custom hostname for the selected BI Server, Query Engine, and Kyvos Manager/repository node.
      NOTE: Ensure that the instances have been configured for using Custom hostnames.

Deployment

Select None (node mapping manually) option. 

Fetch Resources

Click the link to get a list of externally created resources.

Deploy BI Server, Query Engine, and Web Portal Kyvos Services on <IP address> instance

This checkbox is displayed only when you select the None (node mapping Manually) option from the Deployment list. 

NOTE: By default, this checkbox is disabled. 

Virtual machines for BI Server

Select the VMs to be used for Kyvos BI Server from the drop-down list.

Query Engine Scale Set

Select the scale set to be used for the Kyvos Query Engine scale set from the drop-down list.

Virtual Machines for Query Engine

Select the VMs to be used for the Kyvos Query Engine from the drop-down list.

Virtual machines for Web Portal

Provide a comma-separated list of IP Addresses/Hostnames for the VMs to be used as Web portal instances.

Repository

Shows the IP Address/Hostname of the Kyvos Manager node that will be used as the Repository. 

Repository Password

Provide the Postgres repository password.

Storage

ABFS Account Name

Provide the ABFS Account Name to be used for storage.

Container name

Provide the Container Name to be used for storage.

Databricks

Databricks Cluster Id

Enter the ID of the cluster you created. To obtain this ID, click the Cluster Name on the Clusters page in Databricks.
The page URL shows <https://<databricks-instance>/#/settings/clusters/<cluster-id>>

File System Type

Select the type of file system to be used in Databricks.

Organization Id

Provide the Organization ID for the Azure environment. It is the number after o= in the workspace URL.

Databricks URL

Provide the URL in <https://<account>.cloud.databricks.com> format.
Example: https://centralus.azuredatabricks.net/

Vault URL

Enter your existing Azure Key Vault URL.
Optionally, you can create your own Key Vault for use with Kyvos. 

Databricks Authentication 

 Select the authentication type for the Databricks cluster from:

  • AAD Token Using Managed Identity: This option is supported only with premium workspace.

  • Personal Access Token

NOTE: Post deployment of the cluster, you can change the Databricks Authentication type from the Databricks page on Kyvos Manager.

  • When switching from AAD to PAT, you need to provide personal access token, which is saved as a secret in your Azure Key Vault and is read from there for authentication purposes. For this:

    • Go to Key Vault Secret.

    • Add KYVOS-DATABRICKS-SERVICE-TOKEN-DefaultHadoopCluster01 and provide the DB token value and click Save.

  • When switching from AAD to PAT, you need to Configure Managed Identity in Azure Databricks

    Compute Cluster

    Compute Cluster Type

    Select the Kubernetes or Shared Query Engines option.

    NOTE: When you select Kubernetes from the Compute Cluster list, the Kubernetes Details section is displayed.

    Kubernetes Details

    Enter the following Kubernetes details:

    • Kubernetes Cluster Name: Select the Kubernetes cluster name from the list. Click Fetch Details. The Kubernetes cluster details will be fetched.

    • System Node Pool Name: Select the system Node Pool name from the list.

    • User Node Pool Name: Select the User Node Pool name from the list.

    • Validate Kubernetes Cluster Details: Click this link to validate Kubernetes cluster details.

    Enable Compute Server Scaling

    Select this checkbox to enable maximum or minimum compute server for scaling. When you select this checkbox, the following options will be displayed.

    • Minimum Compute Server Count: Select the minimum compute Server count that will be started initially.

    • Maximum Compute Server Count: Select the maximum compute Server count up to which you want to scale.

    NOTE: If you do not select this checkbox, the Compute Server Count field is displayed. Compute server scaling will be disabled if this checkbox is not selected.

    Fetch Parameters

    • Clicking this will open a new dialog box where you need to provide the following details:

      • fs.azure.account.auth.type: The OAuth input is displayed by default.

      • fs.azure.account.oauth.provider.type: The input for this field is displayed by default.

      • fs.azure.account.oauth2clientID: Enter the managed identity client ID.

      • fs.azure.account.oauth2clientID: Enter the tenant ID.

    Function

    Function Deployment

    Optionally, provide the name of the deployment where your Azure Functions are deployed.

    ...