Skip to content

Commit 8ad6969

Browse files
nwang92alishamayor
andauthored
Adding docs on remote license master (#389)
Co-authored-by: Alisha Mayor <[email protected]>
1 parent 6819930 commit 8ad6969

File tree

1 file changed

+32
-0
lines changed

1 file changed

+32
-0
lines changed

docs/advanced/LICENSE_INSTALL.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@ There are primarily two different ways to apply a license when starting your con
1010
* [Download via URL](#download-via-url)
1111
* [Free license](#splunk-free-license)
1212
* [Using a license master](#using-a-license-master)
13+
* [Using a remote instance](#using-a-remote-instance)
1314

1415
## Path to file
1516
We recommend using [Docker Secrets](https://docs.docker.com/engine/swarm/secrets) to manage your license. However, in a development environment, you can also specify a volume-mounted path to a file.
@@ -156,3 +157,34 @@ services:
156157
</p></details>
157158

158159
Note that in the above, only the license master container `lm1` needs to download and apply the license. When the standalone `so1` container comes up, it will detect (based off the environment variable `SPLUNK_LICENSE_MASTER_URL`) that there is a central license master, and consequently add itself as a license slave to that host.
160+
161+
## Using a remote instance
162+
Alternatively, you may elect to create your Splunk environment all within containers but host the license master externally such that it can be used by multiple teams or organizations. These images support this type of configuration, through the following example:
163+
```yaml
164+
version: "3.6"
165+
166+
networks:
167+
splunknet:
168+
driver: bridge
169+
attachable: true
170+
171+
services:
172+
so1:
173+
networks:
174+
splunknet:
175+
aliases:
176+
- so1
177+
image: ${SPLUNK_IMAGE:-splunk/splunk:latest}
178+
hostname: so1
179+
container_name: so1
180+
environment:
181+
- SPLUNK_START_ARGS=--accept-license
182+
- SPLUNK_STANDALONE_URL=so1
183+
- SPLUNK_LICENSE_MASTER_URL=http://central-license-master.internal.com:8088
184+
- SPLUNK_ROLE=splunk_standalone
185+
- SPLUNK_PASSWORD
186+
ports:
187+
- 8000
188+
```
189+
190+
Note that it's possible to use a different protocol and port when supplying the license master URL. If scheme and port are not provided, the playbooks fall back to using `https` and the `8089` Splunk Enterprise management port.

0 commit comments

Comments
 (0)