diff options
author | Stefan Joosten <stefan@sjoosten.nl> | 2016-08-25 16:19:31 +0200 |
---|---|---|
committer | Stefan Joosten <stefan@sjoosten.nl> | 2016-08-25 16:19:31 +0200 |
commit | 819bb41873e49c520fc4506dfc00d46b6e849f44 (patch) | |
tree | 6827ae34388494858b09feb6342039f029d8eeb6 | |
parent | 330f3cbc19168b4f98745fcfa4154b16a21283ca (diff) | |
download | ansible-teamspeak-819bb41873e49c520fc4506dfc00d46b6e849f44.tar.gz ansible-teamspeak-819bb41873e49c520fc4506dfc00d46b6e849f44.tar.xz ansible-teamspeak-819bb41873e49c520fc4506dfc00d46b6e849f44.zip |
Updated README with license functionality
-rw-r--r-- | README.md | 11 |
1 files changed, 9 insertions, 2 deletions
@@ -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,16 @@ 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_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: |