Skip to main content
Versa Networks

Configure Analytics Cluster Nodes from the Director UI

  1. Last updated
  2. Save as PDF

For supported software information, click here.​

You can perform initial software installation for an Analytics cluster from the Director UI. To do this, you do the following:

  • Run a series of pre-installation commands from the shell on each Analytics node in the cluster
  • Install the cluster using a workflow in the Director UI
  • Select the post-installation option in the Director UI

Pre-Installation Procedure

You must perform the pre-installation procedure before configuring a new Analytics cluster.

To perform the pre-installation procedure for an Analytics cluster:

  1. Bring up all the Analytics instances running on virtual machines (VM) and/or bare metal that are required for the deployment with the 23.1.1 Analytics image.
  2. Ensure that you have expanded disk storage as described in Expand Disk Storage for Analytics Nodes.
  3. Configure the northbound (eth0) and southbound (eth1) interfaces on each Analytics node and ensure their reachability from the Director node.
  4. On each analytics-type and search-type node of the Analytics cluster, edit the /etc/hosts file to add entries for the hostnames of the Analytics cluster's analytics-type, search-type, and log-forwarder type nodes. The hostnames must map to the eth1 interfaces on the nodes. 

    The following example shows the contents of the /etc/hosts file on node Analytics01 in a four-node Analytics cluster. The file has entries for each of the four nodes (Analytics01, Analytics02, Analytics03, and Analytics04), and the corresponding IP address for the eth1 network interfaces (192.168.1.101, 192.168.1.102, 192.168.1.103, and 192.168.1.104, respectively).
      
    admin@Analytics01$ cat /etc/hosts
127.0.0.1 localhost

# The following lines are desirable for IPv6 capable hosts
::1     localhost ip6-localhost ip6-loopback
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters

192.168.1.101    Analytics01
192.168.1.102    Analytics02
192.168.1.103    Analytics03
192.168.1.104    Analytics04
  5. On any node in the Analytics cluster, login to the shell and enter CLI mode to setup the cluster installer. This node acts as the coordinator for Director in order to connect and perform various operations on all the nodes in the Analytics cluster.  
    admin@Analytics$ cli
admin@Analytics>
  1. Issue the following commands: 
    admin@Analytics> request system cluster-installer agent ?
Description: Setup cluster installer agent service
Possible completions:
  setup  - Setup cluster installer agent
  start  - Start cluster installer agent service
  status - Cluster installer agent service status
  stop   - Stop cluster installer agent service
admin@Analytics> request system cluster-installer agent setup
Value for 'agent-password' (<string>): <Password>
status success
  2. By default, Versa Director nodes use REST API port 5040 to communicate with the Analytics node for cluster installation operations. See the Analytics Firewall Requirements section in Firewall Requirements.

    You can verify that port 5040 is enabled or else ​​​​choose and enable a different REST API port and then change the values for the port by editing the application.properties file on the Analytics node. 
    • admin@Analytics> exit
admin@Analytics$ sudo cat /opt/versa/var/van-app/properties/application.properties | grep clusterinstall
auth.clusterinstaller.sslCertificate=/opt/versa/var/van-app/certificates/versa_cluster_installer.crt
auth.clusterinstaller.sslPrivateKey=/opt/versa/var/van-app/certificates/versa_cluster_installer.key
auth.clusterinstaller.username=admin
auth.clusterinstaller.password=<Password>
conf.clusterinstaller.ip=0.0.0.0
conf.clusterinstaller.port=5040

Install the Analytics Cluster

To install an Analytics cluster from the Director UI:

  1. In Director view, select Workflows > Infrastructure > Analytics Clusters.

    Workflow_menu.png
     
  2. Click +Add. The following workflow displays.

    Install_Analytics_workflow_main_screen.png
     
  3. Go to workflow step 1, Cluster Details, and enter information for the following fields.
     
    Field Description
    Name Enter a name for the Analytics cluster.
    Type

    Select Standard.
    NTP Servers Enter a comma-separated list of network time protocol (NTP) servers. 

     
  4. Go to workflow step 2, Director Nodes, the following screen displays.

    Step_2_Director_nodes.png
     
  5. Click +Add. The Add Versa Director Node popup window displays. Enter information for the following fields.

    Director_nodes_screen.png
     
    Field  Description
    Northbound IP Address Northbound IP address of the Director node.
    Southbound IP Address Southbound IP address of the Director node.
    Username Shell user name for the Director node. This information is required to make a connection to the Director node from the Analytics cluster.
    Password Shell password for the Director node.
  6. Go to workflow step 3, Versa Analytics Nodes. 

    Step_3_Versa_analytics_nodes.png
     
  7. Click +Add. The the Add Versa Analytics Node popup window displays. You can configure a search-type or analytics-type node from this screen.

    Add_analytics_node_analytics_personality.png
     
  8. Enter information for the following fields.
     
    Field Description
    Hostname Enter a host name for the analytics-type or search-type Analytics node.
    Username Enter the shell account name for the node. Please consult Versa technical support for default credentials. 
    Password Enter the password for the shell account.
    Northbound IP Address Enter the IP address for the northbound interface on the node.
    Southbound IP Address Enter the IP address for the southbound interface on the node.
    Collector IP Address

    Enter an IP address for the local collector on the analytics-type or search-type node. This is typically the IP address of the southbound interface.

     

    The collector IP and port is used to initialize the local collector server for receiving logs from devices. For more information about local collectors, see Log Collector Exporter in Versa Analytics Configuration Concepts.
    Collector Port Enter a port number for the local collector. This is typically port number 1234.
    Zookeeper

    Search-type and analytics-type nodes within an Analytics cluster run the Apache Zookeeper service to coordinate applications. Set this value to Yes to configure the node as a zookeeper.

     

    The following table describes how to configure the Zookeeper parameter for Analytics clusters with varying numbers of analytics-type and search-type nodes.

    Number of Nodes Description Zookeeper Settings
    1  1 standalone node Set to Yes on the node.
    2 1 search-type and 1 analytics-type node Set to Yes on both nodes.
    4  2 search-type and 2 analytics-type nodes Set to Yes on 2 analytics-type nodes and 1 search-type node. Set to No on the remaining node.
    6 or more 2 search-type nodes with the remaining nodes configured as analytics-type nodes Set to Yes on 3 or 5 of the nodes. For typical deployments, 3 zookeepers are sufficient. Set this value to No on the remaining nodes.
    Mode Select Cluster.
    Personality

    Select the node type:

    • Analytics
    • Search
  9. Click OK to add the node.
  10. Repeat procedure Steps 6 through 8 for each analytics-type and search-type node in the cluster.
  11. Go to workflow step 4, Forwarder Nodes.

    Step_4_forwarder_nodes.png
  12. Click +Add. The Add Forwarder Node popup window displays. Enter information for the following fields.

    Forwarder_popup.png
     
    Field Description
    Hostname Enter a hostname for the forwarder node.
    Username Enter the shell account name for the Analytics node. Please consult Versa technical support for default credentials.
    Password Enter the password for the shell account.
    Northbound IP Address Enter the IP address for the northbound interface on the forwarder node.
    Southbound IP Address Enter the IP address for the southbound interface on the forwarder node.
    Collector IP Address

    Enter an IP address for the local collector on the node. This is typically the IP address of the southbound interface.

     

     
    Collector Port Enter a port number for the local collector. This is typically port number 1234.
    Mode Select Cluster.
    Personality Select Forwarder.
  13. Repeat procedure Step 11 for each log-forwarder type node in the cluster.
  14. Click workflow step 5, Review.

    Step_5_Review.png
     
  15. Review the configuration. If required, you can modify the configuration by doing the following:
    • Click the workflow step corresponding to the information to be changed
    • Make your changes
    • Return to workflow step 6, Review
       
  16. Click Continue to install the configuration. When the installation is complete, the following screen displays.

    Screen_post_install.png
     

  17. (Optional) To abort the installation process or reinstall the Analytics cluster:

    1. Click the drop-down list in the upper-right portion of the Analytics Cluster table.

      Expanded_menu_highlight_reinstall_and_abort.png

    2. To abort the installation process, select Abort Process.

    3. To reinstall the Analytics cluster, select Reinstall.

  18. After the Analytics cluster has successfully installed, select the Post-Setup Procedures option from the drop-down list. The following tasks are performed for the Analytics cluster and Director node:
     
    • Configure log collector exporter instances on Analytics nodes. 
    • Install self-signed certificates on Analytics nodes. 
    • Install self-signed certificates on the Director node.
    • Register Director instances in Analytics.

      Cluster_options_menu.png
       
  19. Wait while the post-setup procedure completes.

Supported Software Information

Releases 23.1.1 and later support all content described in this article. 

  1. Back to top
  • Was this article helpful?

Recommended articles

  1. Page type
    Topic
  2. Tags
    This page has no tags.