Deployment Architecture

Why does running btool on my Deployer not output authentication config files for a search head cluster?

Thuan
Explorer

I was in the process of identifying all the authentication config files on my Deployer in a search head cluster environment. The intent is find out all the files that are listed under $SPLUNK_HOME/etc/shcluster/apps/ as they relate to authentication settings on the remote systems.

I did:

$SPLUNK_HOME//bin/splunk btool authentication list --debug

The output listing did NOT show anything about $SPLUNK_HOME/etc/shcluster/apps/
This subdirectory does exist however and shows up using a regular "ls".
Have I missed anything about btool?

0 Karma

somesoni2
Revered Legend

The btool utility will provide the effective Splunk configuration (taking into account configuration file layering and user/app context) for the Splunk instance where the utility was run. The files that are effective in a Splunk instance are located in etc/system (default and local) and etc/apps/AppName (default and local). The configuration in etc/shcluster/apps (and etc/deployment-apps) are just app repository and they are applied on the system(s) receiving it, which will be Search Heads. So, if you want to inquire what authentication applied on your SH Cluster, then run the btool from one of the SH Cluster member.

lguinn2
Legend

btool consolidates the on-disk configuration settings for a Splunk instance and then displays them. You are running btool on the deployer, but the configuration files of interest are not the settings for the deployer - etc/shcluster does not apply to the deployer. So btool does not consider those settings.

etc/shcluster is just a repository for configurations. The same is true for etc/deployment-apps on a deployment server and etc/master-apps on a cluster master. None of these directories will be examined by btool.

To see the authentication settings, you need to go to a Splunk instance where those settings are active - in other words, on one of the clustered search heads.

Thuan
Explorer

This helps me to understand why /etc/shcluster is not included in btool.
Thank you for the clarification.

0 Karma
Get Updates on the Splunk Community!

Adoption of RUM and APM at Splunk

    Unleash the power of Splunk Observability   Watch Now In this can't miss Tech Talk! The Splunk Growth ...

Routing logs with Splunk OTel Collector for Kubernetes

The Splunk Distribution of the OpenTelemetry (OTel) Collector is a product that provides a way to ingest ...

Welcome to the Splunk Community!

(view in My Videos) We're so glad you're here! The Splunk Community is place to connect, learn, give back, and ...