Configure ThoughtSpot Nodes on the SMC Appliance

Configure your nodes before you can install your cluster(s).


ThoughtSpot Training

  • For best results when configuring ThoughtSpot on a SMC appliance, we recommend that you take the following ThoughtSpot U course: Network Configuration.

  • See other training resources at ThoughtSpot U.


After you connect the appliance, configure the nodes in your Mac or Windows terminal emulator.

Follow the steps in this checklist.

Step 1: SSH into your cluster

Step 2: Change to the install directory

Step 3: Get a template for node configuration

Step 4: Prepare node configuration

Step 5: Configure the nodes

Step 6: Confirm node configuration

If you completed ThoughtSpot’s site survey form and returned it to ThoughtSpot Support before ThoughtSpot shipped the appliance, the appliance may be pre-configured for your network environment and ready to install and connect to your network.

If the network configuration was not pre-set, then this step must be done as part of the installation process.

Follow these steps to determine the configuration status of your appliance.

  1. SSH into your cluster. Run ssh admin@<nodeIP>.

    Replace nodeIP with your specific network information.

     $ ssh admin@<nodeIP>
  2. Run tscli cluster status.

     $ tscli cluster status
  3. If the output shows READY, and looks like the cluster status output in the next article, your appliance is configured.

  4. Skip to Finalize installation.

If your status is not READY, continue with the installation process outlined below.

Step 1: SSH into your cluster

SSH into your cluster with admin credentials.

  1. Run the command ssh admin@<cluster-IP> or ssh admin@<hostname> on the command line.

    Replace clusterIP or hostname with your specific network information.

     $ ssh admin@<nodeIP>
  2. Enter your admin password when prompted.

    Ask your network administrator if you don’t know the password.

Step 2: Change to the install directory

In your terminal, change directory to /home/admin/install by running the command cd /home/admin/install. If your /install subdirectory does not exist, you may have to use the /home/admin directory.

$ cd /home/admin/install

Step 3: Get a template for network configuration

Run the tscli cluster get-config command to get a template for network configuration. Redirect it to the file nodes.config. You can find more information on this process in the nodes.config file reference.

$ tscli cluster get-config |& tee nodes.config

Step 4: Prepare node configuration

  1. Add your specific network information for the nodes in the nodes.config file, as demonstrated in the autodiscovery of one node example. Run vim nodes.config to edit the file.

     $ vim nodes.config
    Some of the information in the nodes.config file may be pre-populated from earlier steps. For example, if you specified an IP address while creating VMs, that IP address might already be present in your nodes.config file.
  2. Fill in the areas specified in Parameters of the nodes.config file with your specific network information.

    If you have additional nodes, complete each node within the nodes.config file in the same way.

    Edit only the parts of the nodes.config file that are explicitly discussed in Parameters of nodes.config. If you delete quotation marks, commas, or other parts of the code, it may cause setup to fail.

  3. Update the file /etc/hosts with all the node IP addresses and hostnames for the other VMs that will be part of the ThoughtSpot cluster.

Step 5: Configure the nodes

Configure the nodes in the nodes.config file using the set-config command.

Run $ cat nodes.config | tscli cluster set-config in your terminal.

If the command returns an error, refer to set-config error recovery.

$ cat nodes.config | tscli cluster set-config

Connecting to local node-scout
Setting up hostnames for all nodes
Setting up networking interfaces on all nodes
Setting up hosts file on all nodes
Setting up IPMI configuration
Setting up NTP Servers
Setting up Timezone
Done setting up ThoughtSpot

Step 6: Confirm node configuration

Use the get-config command to confirm node configuration. Your output may look similar to the following:

$ tscli cluster get-config

{
  "ClusterId": "",
  "ClusterName": "",
  "DataNetmask": "255.255.252.0",
  "DataGateway": "192.168.4.1",
  "IPMINetmask": "255.255.252.0",
  "IPMIGateway": "192.168.4.1",
  "Timezone": "America/Los_Angeles",
  "NTPServers": "0.centos.pool.ntp.org,1.centos.pool.ntp.org,2.centos.pool.ntp.org,3.centos.pool.ntp.org",
  "DNS": "192.168.2.200,8.8.8.8",
  "SearchDomains": "example.company.com",
  "Nodes": {
	"ac:1f:6b:8a:77:f6": {
  	"NodeId": "ac:1f:6b:8a:77:f6",
  	"Hostname": "Thoughtspot-server1",
  	"DataIface": {
    	"Name": "eth2",
    	"IPv4": "192.168.7.70"
  	},
  	"IPMI": {
    	"IPv4": "192.168.5.70"
  	}
	}
  }
}

Install the cluster