aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorStefan Joosten <stefan@sjoosten.nl>2016-08-26 00:31:49 +0200
committerStefan Joosten <stefan@sjoosten.nl>2016-08-26 00:31:49 +0200
commit9f7b61ea916c73b556d19b5c1d982ea9e5fb007f (patch)
tree84c0ad246251245224e63de848742625d878f481 /README.md
parentbe6b41e5c246d4c249c3d068b543a0f97326f3ac (diff)
parent7ef374edd6f40c1d8a754fdd58dba22efb707932 (diff)
downloadansible-teamspeak-9f7b61ea916c73b556d19b5c1d982ea9e5fb007f.tar.gz
ansible-teamspeak-9f7b61ea916c73b556d19b5c1d982ea9e5fb007f.tar.xz
ansible-teamspeak-9f7b61ea916c73b556d19b5c1d982ea9e5fb007f.zip
Merge branch 'issue3'
Add the functionality to include a TeamSpeak 3 Server license file. Close issue #3
Diffstat (limited to 'README.md')
-rw-r--r--README.md12
1 files changed, 10 insertions, 2 deletions
diff --git a/README.md b/README.md
index 3135fd7..cfbf8c6 100644
--- a/README.md
+++ b/README.md
@@ -33,7 +33,7 @@ These variables define properties for the user thats going to run the TeamSpeak
* `teamspeak.symlink`: Name of symlink to point to current TeamSpeak 3 server directory. Defaults to "current".
* `teamspeak.version`: Version of Teamspeak 3 Server to install. Defaults to "3.0.12.4".
* `teamspeak.checksum`: SHA256 checksum of archive of TeamSpeak 3 server version for verification purposes. Example: "sha256:6bb0e8c8974fa5739b90e1806687128342b3ab36510944f576942e67df7a1bd9"
-* `teamspeak.keep`: Amount of TeamSpeak 3 server versions to keep installed, includes the currently installed version. A setting of "3" keeps the current and two previous version installed, which is the default. In case an upgrade goes wrong, you simply rewind the `teamspeak.version` and `teamspeak.checksum` to the older version and run the role again to downgrade back to a known good.
+* `teamspeak.keep`: Amount of TeamSpeak 3 server versions to keep installed, includes the currently installed version. A setting of "2" keeps the current and two previous version installed, which is the default. In case an upgrade goes wrong, you simply rewind the `teamspeak.version` and `teamspeak.checksum` to the older version and run the role again to downgrade back to a known good.
### Further configuraton
To configure TeamSpeak 3 Server a INI-style configuration file is used. If you require detailed configuration, enable creation of such a file by setting the `teamspeak_ini_enabled` to `yes`. For example by defining it that way in host or group vars in your playbook. A INI file containing your configuration will be created.
@@ -41,9 +41,17 @@ To configure TeamSpeak 3 Server a INI-style configuration file is used. If you r
* `teamspeak_ini_enabled`: Set to `yes` if you want use the configuration options listed below. It will create INI-style configuration file for the TeamSpeak 3 Server to use. Defaults to `no`.
* `teamspeak_ini_filename`: Name of the INI-style configuration file. Defaults to `ts3server.ini`.
+#### License file
+
+If you have a TeamSpeak 3 Server license, you can have this role install it for you. Place your license file called `licensekey.dat` in the `files/` directory of this role. Tip: if you use Git, add that path to your `.gitignore` to make sure you do not push it somewhere by accident.
+
+* `teamspeak_use_license`: Set to `yes` to have your license set up. Default is `no`.
+* `teamspeak_license_srcfile`: TeamSpeak 3 Server license file on Ansible host to copy to target. Default searches for the license file at `files/licensekey.dat`
+* `teamspeak_licensepath`: Used to specify a directory where your license should be located on the target host. If a non-existent directory is specified it will be created for you. Make sure you enable the use of a INI configuration file, otherwise this option will be ineffective. The default is to leave this variable empty, which will place the license file in the same directory as the TeamSpeak 3 Server is installed in.
+
#### Network configuration
-The following configuration blocks can be used to configure the TeamSpeak 3 Server as you please. Make sure to define the configuration blocks in full as they contain nested properties. Most reliable way would be to copy a block from the `defaults/main.yml` into your own definitions file and edit accordingly.
+The network configuration block can be used to configure the TeamSpeak 3 Server as you please. Make sure to define the configuration block in full as it contains nested properties. Most reliable way would be to copy a block from the `defaults/main.yml` into your own definitions file and edit accordingly.
Description of the `teamspeak_network` configuration block and it's options: