Cluster Management Console

The CMC is a web UI application developed by Incorta to help administrators:

  • Create/Manage a cluster using the CMC.
  • Add/Federate a node. Each node can be attached to one cluster only. To attach a node to a different cluster, it must be deleted from the current cluster.
  • Create/Add/Start/Stop a service in a cluster using the CMC.
  • Create/Import/Export a tenant using the CMC easily manage clusters, nodes (i.e. machines) within clusters, and the services (i.e. analytics/loader) within each node. The CMC can also be used to create/import/export tenants. In brief, the CMC is the control unit for all the infrastructure within a cluster.

Log in to the CMC

After you Install the CMC and Install an Incorta HA node, navigate to the CMC at the following URL to complete the cluster setup: <IP_ADDRESS>:<HTTP_CONNECTOR_PORT>/CMC. For example, localhost:6060/cmc.

Create/Manage a cluster using the CMC

If you have a fresh Incorta installation, you must create a cluster and register the node using the CMC. You can also use the CMC to manage clusters, using the following steps:

  1. Select Clusters.
  2. Select +New.
  3. Provide a unique name to the cluster, then select Next.
  4. Provide the parameters for an empty SQL/Oracle database for Incorta’s metadata, then select Next.

  5. Create the admin UI login credentials, then select Next. The admin UI is a web application for admins to manage system and tenant configurations. It can be accessed at: <IP_ADDRESS>:<PORT_NO>/incorta/admin. For example: localhost:8080/incorta/admin
  6. Provide an address for Zookeeper, then select Next. If you plan to use the Zookeeper bundled with the installation, remember the default port is 2181.
  7. Provide the Spark configuration parameters, then select Next or skip to configure later.
  8. Review the cluster configuration summary, then select Create.
  9. Select Finish, or select Create another cluster to repeat the steps.

Now that you have created a cluster, you can Add/Federate a node, then Create/Add/Start/Stop a service in a cluster using the CMC and attach them to the cluster you created.

Add/Federate a Node

To add a node:

  1. Select Nodes in the panel on the left-hand side.
  2. Select +New.
  3. Provide the node connection string and ports number, then select Next.
  4. Create a unique name for the node, then select Federate.
  5. Select Finish, or select Add another node another cluster to repeat the steps.

Now that you have added a node, you can Create/Add/Start/Stop a service in a cluster using the CMC, then Create/Import/Export a tenant using the CMC.

Create/Add/Start/Stop a Service in a Cluster using the CMC

To create a service:

  1. Select Nodes in the panel on the left-hand side.
  2. Select a node to open the node details page.
  3. Select +New to create a service.
  4. Select the service type (loader or analytics) and provide the configuration parameters, then select Next.
  5. Configure the service ports, then select Create.
  6. Select Finish, or select Add another service to create another service.

You must have one analytics service and one loader service at minimum in any cluster setup.

Add a Service to a Cluster

To add a service to a cluster:

  1. Select Clusters in the panel on the left-hand side.
  2. Select a cluster to open the cluster details page.
  3. Select the Services tab.
  4. Select +New corresponding to “join services”, to add a service.
  5. Select the Node drop-down menu, to select the node hosting the service you want to add to the cluster.
  6. Select the “Service” drop-down menu, and select a node.
  7. Select Add.
  8. (Optional) Create additional services.

Start the Analytics and Loader Services

To start or stop the analytics or loader services:

  1. Select Clusters in the panel on the left-hand side.
  2. Select the cluster where the services are located.
  3. Select the Services tab.
  4. Select a service to start it.
  5. Select Start on the bottom right-hand corner. Select the sync/refresh icon in the upper right-hand corner periodically, to reflect the latest service status (e.g. stopped/processing/started).
  6. Wait until the Status field indicates started.
  7. (Optional) Start other services.
  8. Select Clusters in the panel on the left-hand side.
  9. Select localCluster. Both the Analytics and Loader services should indicate Started.

  10. Select Restart to restart the service or or Stop to stop the services.

After you create and add the services to the cluster, you can create, import, or export a tenant using the CMC to create a user with credentials in Incorta Analytics that can log in.

Create, Import, or Export a tenant using the CMC

You can create, import, or export a tenant at any time after installing Incorta Analytics. It is usually the step following Create/Add/Start/Stop a service in a cluster using the CMC for a fresh installation.

To createor import a tenant using the CMC:

  1. Select Clusters in the panel on the left-hand side.
  2. Select the cluster where you want to create a tenant.
  3. Select the Tenants tab.
  4. Select +New.
  5. Select Create Tenant, to create a new tenant, or select Import Tenant to import a tenant that you can have exported from another environment or received as a separate file.
  6. Create a unique name and credentials for the new tenant, ensuring the Path field contains a directory that is accessible by all the nodes withing a cluster.
  7. Enable the Include Sample Data option to include sample schemas and dashboards with the installation, then select Next. This is recommended to verify that everything is working properly post installation, and before uploading your data.
  8. Provide an email address and password to use as the sender’s email when sending dashboards then select Create.
  9. Select Login, to log in to Incorta’s web application in a browser with the tenant just created.
  10. Select Configure, to log in to the Admin UI console to configure the tenant just created (Admin Privileges Required). The admin UI is a web application for admins to manage system and tenant configurations. It can be accessed at: <IP_ADDRESS>:<PORT_NO>/incorta/admin.

Add Nodes to the CMC

  1. Go to the Nodes tab.
  2. Select +New to add a new node.
  3. Enter the IP of the loader node in the Host field (for example, 172.17.0.3)
  4. Select Next.
  5. Change the Name to a unique name.
  6. Select Federate.
  7. Select Finish.
  8. Select Add another node.
  9. Enter the Host IP of the analytics node (e.g. 172.17.0.4)
  10. Change the Name to a unique name.
  11. Select Federate.
  12. Select Finish.
  13. Verify that the nodes are visible by the CMC.

© Incorta, Inc. All Rights Reserved.