default.yml.spec 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337
  1. ansible_post_tasks: <str>
  2. * Comma-separated list of paths or URLs to custom Ansible playbooks to run AFTER Splunk has been setup using the provided site.yml
  3. * Default: null
  4. ansible_pre_tasks: <str>
  5. * Comma-separated list of paths or URLs to custom Ansible playbooks to run BEFORE Splunk sets up using the provided site.yml
  6. * Default: null
  7. hide_password: <bool>
  8. * Boolean that determines whether or not to output Splunk admin passwords through Ansible
  9. * Default: false
  10. retry_num: <int>
  11. * Number of retries to make for potentially flakey/error-prone tasks
  12. * Default: 50
  13. shc_bootstrap_delay: <int>
  14. * Number of seconds of delay when verifying SHC success on the deployer
  15. * Default: 30
  16. splunk_home_ownership_enforcement: true
  17. * Boolean that to control and enable UAC on $SPLUNK_HOME (recommended to be enabled)
  18. * Default: true
  19. config:
  20. baked: <str>
  21. * Configuration filename
  22. * Default: default.yml
  23. defaults_dir: <str - filepath>
  24. * Location on filesystem where the default.yml can be found
  25. * Default: /tmp/defaults
  26. env:
  27. headers: <str>
  28. * Define header information (in necessary) when pulling default.yml from a URL
  29. * Default: null
  30. var: <str>
  31. * Control environment variable name that determines location of default.yml
  32. * Default: SPLUNK_DEFAULTS_URL
  33. verify: <bool>
  34. * Enable/disable SSL validation
  35. * Default: true
  36. host:
  37. headers: <str>
  38. * Define header information (in necessary) when pulling default.yml from a URL
  39. * Default: null
  40. url: <str>
  41. * Define URL to pull default.yml from
  42. * Default: null
  43. verify: <bool>
  44. * Enable/disable SSL validation
  45. * Default: true
  46. max_delay: <int>
  47. * Maximum duration (in seconds) between attempts to pull the default.yml from a remote source
  48. * Default: 60
  49. max_retries: <int>
  50. * Maximum attempts to pull the default.yml from a remote source
  51. * Default: 3
  52. max_timeout: <int>
  53. * Maximum timeout for attempts to pull the default.yml from a remote source
  54. * Default: 1200
  55. splunkbase_username: <str>
  56. * Used for authentication when downloading apps from https://splunkbase.splunk.com/ (this is NOT required to even be specified, unless you have SplunkBase apps defined in your splunk.apps_location)
  57. * NOTE: Use this in combination with splunkbase_password. You will also need to run Ansible using the dynamic inventory script (environ.py) for this to register and work properly.
  58. * Default: null
  59. splunkbase_password: <str>
  60. * Used for authentication when downloading apps from https://splunkbase.splunk.com/ (this is NOT required to even be specified, unless you have SplunkBase apps defined in your splunk.apps_location)
  61. * NOTE: Use this in combination with splunkbase_username. You will also need to run Ansible using the dynamic inventory script (environ.py) for this to register and work properly.
  62. * Default: null
  63. splunk:
  64. role: <str>
  65. * Role to assume when setting up Splunk
  66. * Default: splunk_standalone
  67. upgrade: <bool>
  68. * Determines whether or not to perform an upgrade (to the splunk.build_location)
  69. * Default: false
  70. build_location: <str>
  71. * Splunk build location, either on the filesystem or a remote URL
  72. * Default: /tmp/splunk.tgz
  73. build_remote_src: <bool>
  74. * Boolean to determine whether the installer is local (false) or remote (true)
  75. * Default: true
  76. license_master_included: <bool>
  77. * Boolean to determine whether there exists a separate license master
  78. * Default: false
  79. preferred_captaincy: <bool>
  80. * Boolean to determine whether splunk should set a preferred captain. This can have an effect on day 2 operations if the search heads need to be restarted
  81. * Default: true
  82. apps_location: <list>
  83. * List of apps to install - elements can be in the form of a URL or a location in the filessytem
  84. * Default: null
  85. license_uri: <str>
  86. * Path or remote URL to a valid Splunk license
  87. * Default: null
  88. ignore_license: <bool>
  89. * Allow proceeding with a bad/invalid Splunk license
  90. * Default: false
  91. license_download_dest: <str - filepath>
  92. * Path in filesystem where licenses will be downloaded as
  93. * Default: /tmp/splunk.lic
  94. nfr_license: <str - filepath>
  95. * Path in filesystem where of special NFR licenses
  96. * Default: /tmp/nfr_enterprise.lic
  97. wildcard_license: <bool>
  98. * Enable licenses to be interpreted as fileglobs, to support provisioning with multiple Splunk licenses
  99. * Default: false
  100. admin_user: <str>
  101. * Default admin-level user to run provisioning commands under
  102. * Default: admin
  103. password: <str>
  104. * Default Splunk admin user password. This is REQUIRED when starting Splunk
  105. * Default: null
  106. user: <str>
  107. * Host user under which Splunk will run
  108. * Default: splunk
  109. group: <str>
  110. * Host group under which Splunk will run
  111. * Default: splunk
  112. enable_service: <bool>
  113. * Determine whether or not to enable Splunk for boot-start (start via sysinitv or systemd, etc.)
  114. * Default: false
  115. opt: <str - filepath>
  116. * Path in filesystem where Splunk will be installed
  117. * Default: /opt
  118. home: <str - filepath>
  119. * Path in filesystem where SPLUNK_HOME is located
  120. * Default: /opt/splunk
  121. exec: <str - filepath>
  122. * Path in filesystem where splunk binary exists (this will depend on splunk.home)
  123. * Default: /opt/splunk/bin/splunk
  124. pid: <str - filepath>
  125. * Path in filesystem of splunk PID file (this will depend on splunk.home)
  126. * Default: /opt/splunk/var/run/splunk/splunkd.pid
  127. app_paths:
  128. default: <str - filepath>
  129. * Path in filesystem of default apps (this will depend on splunk.home)
  130. * Default: /opt/splunk/etc/apps
  131. deployment: <str - filepath>
  132. * Path in filesystem of deployment apps (this will depend on splunk.home)
  133. * Default: /opt/splunk/etc/deployment-apps
  134. httpinput: <str - filepath>
  135. * Path in filesystem of the HTTP input apps (this will depend on splunk.home)
  136. * Default: /opt/splunk/etc/apps/splunk_httpinput
  137. idxc: <str - filepath>
  138. * Path in filesystem of indexer cluster master apps (this will depend on splunk.home)
  139. * Default: /opt/splunk/etc/master-apps
  140. shc: <str - filepath>
  141. * Path in filesystem of search head cluster apps (this will depend on splunk.home)
  142. * Default: /opt/splunk/etc/shcluster/apps
  143. hec_disabled: <int|bool>
  144. * Determine whether or not to disable setting up the HTTP event collector (HEC)
  145. * Default: 0
  146. hec_enableSSL: <int|bool>
  147. * Determine whether or not to enable SSL on the HTTP event collector (HEC) endpoint
  148. * Default: 1
  149. hec_port: <int>
  150. * Determine the port used for the HTTP event collector (HEC) endpoint
  151. * Default: 8088
  152. hec_token: <str>
  153. * Determine a token to use for the HTTP event collector (HEC) endpoint
  154. * Default: null
  155. http_enableSSL: <int|bool>
  156. * Determine whether or not to enable SSL on SplunkWeb
  157. * Default: 0
  158. http_enableSSL_cert: <str>
  159. * Path in filesystem to SplunkWeb SSL certificate
  160. * Default: null
  161. http_enableSSL_privKey: <str>
  162. * Path in filesystem to SplunkWeb SSL private key
  163. * Default: null
  164. http_enableSSL_privKey_password: <str>
  165. * Password used to setup SplunkWeb SSL private key
  166. * Default: null
  167. http_port: <int>
  168. * Determine the port used for SplunkWeb
  169. * Default: 8000
  170. s2s_enable: <int|bool>
  171. * Determine whether or not to enable Splunk-to-Splunk communication. This is REQUIRED for any distributed topologies.
  172. * Default: true
  173. s2s_port: <int>
  174. * Determine the port used for Splunk-to-Splunk communication
  175. * Default: 9997
  176. svc_port: <int>
  177. * Determine the port used for Splunk management/remote API calls
  178. * Default: 8089
  179. search_head_cluster_url: null
  180. * URL of the Splunk search head cluster
  181. * Default: null
  182. secret: null
  183. * Secret passcode used to encrypt all of Splunk's sensitive information on disk. When not set, Splunk will autogenerate a unique secret local to each installation. This is NOT required for any standalone or distributed Splunk topology
  184. * NOTE: This may be set once at the start of provisioning any deployment. Any changes made to this splunk.secret after the deployment has been created must be resolved manually, otherwise there is a severe risk of bricking the capabilities of your Splunk environment.
  185. * Default: null
  186. idxc:
  187. enable: <bool>
  188. * Enable indexer clustering
  189. * Default: false
  190. label: <str>
  191. * Provide a label for indexer clustering configuration
  192. * Default: idxc_label
  193. replication_factor: <int>
  194. * Determine knowledge object replication factor
  195. * Default: 3
  196. replication_port: <int>
  197. * Determine the port used for replication of artifacts
  198. * Default: 9887
  199. search_factor: <int>
  200. * Determine the search factor used by indexer clustering
  201. * Default: 3
  202. secret: <str>
  203. * Determine the secret used to configure indexer clustering. This is REQUIRED when setting up indexer clustering
  204. * Default: null
  205. shc:
  206. enable: <bool>
  207. * Enable search head clustering
  208. * Default: false
  209. label: <str>
  210. * Provide a label for search head clustering configuration
  211. * Default: shc_label
  212. replication_factor: <int>
  213. * Determine knowledge object replication factor
  214. * Default: 3
  215. replication_port: <int>
  216. * Determine the port used for replication of artifacts
  217. * Default: 9887
  218. secret: <str>
  219. * Determine the secret used to configure search head clustering. This is REQUIRED when setting up search head clustering
  220. * Default: null
  221. dfs:
  222. enable: <bool>
  223. * Enable Data Fabric Search (DFS)
  224. * Default: false
  225. port: <int>
  226. * Identifies the port on which the DFSMaster Java process runs.
  227. * Default: 9000
  228. dfc_num_slots: <int>
  229. * Maximum number of concurrent DFS searches that run on each search head
  230. * Default: 4
  231. dfw_num_slots: <int>
  232. * Maximum number of concurrent DFS searches that run on a search head cluster
  233. * Default: 10
  234. dfw_num_slots_enabled: <bool>
  235. * Enables you to set the value of the field dfw_num_slots.
  236. * Default: false
  237. spark_master_host: <str>
  238. * This setting identifies the Spark master.
  239. * Default: 127.0.0.1
  240. spark_master_webui_port: <int>
  241. * Identifies the port for the Spark master web UI.
  242. * Default: 8080
  243. smartstore: <dict>
  244. * Nested dict obj to enable automatic SmartStore provisioning
  245. * Default: null
  246. tar_dir: <str>
  247. * Name of directory for the Splunk tar
  248. * Default: splunk
  249. conf: <dict>
  250. (filename):
  251. directory: <str - filepath>
  252. * Path in filesystem to create `.conf` file
  253. * Default: /opt/splunk/etc/system/local
  254. content: <dict>
  255. (section name): <dict>
  256. (name) : (value)
  257. * Key-value pairs in configuration file