Difference between revisions of "TeamSpeak"

From ArchWiki
Jump to: navigation, search
m (First startup: updating to reflect package changes)
(The entire "Configuration and startup" section is about the server therefore name it accordignly)
 
(14 intermediate revisions by 10 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:TeamSpeak}}
+
[[Category:Telephony and voice]]
[[Category:Sound]]
+
[[ja:TeamSpeak]]
{{Article summary start}}
+
[[de:TeamSpeak]]
{{Article summary text|An introduction to [http://teamspeak.com/ TeamSpeak], covering installation and basic configuration of the client and server.}}
+
From [[Wikipedia:TeamSpeak]]:
{{Article summary end}}
+
  
From [http://en.wikipedia.org/wiki/Teamspeak Wikipedia, the free encyclopedia]:
+
:TeamSpeak is proprietary Voice over IP software that allows computer users to speak on a chat channel with fellow computer users, much like a telephone conference call.
 
+
:''TeamSpeak is a proprietary Voice over IP software that allows computer users to speak on a chat channel with fellow computer users, much like a telephone conference call.''
+
  
 
== Installation ==
 
== Installation ==
  
===Install client===
 
Install {{AUR|teamspeak3}}, available in the [[Arch User Repository]].
 
 
===Install server===
 
Install {{AUR|teamspeak3-server}}, available in the [[Arch User Repository]].
 
 
== Configuration/Startup ==
 
 
=== Client ===
 
=== Client ===
I do not use the Linux client, please feel free to expand this article at this point.
+
 
 +
[[Install]] the {{Pkg|teamspeak3}} package.
  
 
=== Server ===
 
=== Server ===
==== Configuration ====
+
 
* You can configure the TeamSpeak server via {{ic|/etc/conf.d/teamspeak3-server}} if you are using [[Initscripts]]. You can find all necessary explanations inside this file. If you are using [[Systemd]] please check {{ic|/usr/share/doc/teamspeak3-server/server_quickstart.txt}} for all available command line parameters.
+
Install the {{AUR|teamspeak3-server}} package.
 +
 
 +
== Server configuration and startup ==
 +
 
 +
=== Configuration ===
 +
 
 +
* You can configure the TeamSpeak server. If you are using [[systemd]] please check {{ic|/usr/share/doc/teamspeak3-server/server_quickstart.txt}} for all available command line parameters.
  
 
* If you possess a license file please copy it to {{ic|/var/lib/teamspeak3-server/licensekey.dat}}.
 
* If you possess a license file please copy it to {{ic|/var/lib/teamspeak3-server/licensekey.dat}}.
  
==== First startup ====
+
=== First startup ===
At the first startup TeamSpeak creates the SQLite database at {{ic|/var/lib/teamspeak3-server/ts3server.sqlitedb}} and the first logfiles. At the same moment TeamSpeak creates the ServerQuery administration account (the superuser of all servers) and the first virtual server including a privilege key for the server administrator of this virtual server. The ServerQuery account is displayed only once on standard output. If you have already started your server and missed it you have to delete {{ic|/var/lib/teamspeak3-server/ts3server.sqlitedb}} and clear {{ic|/var/log/teamspeak3-server/}} of all logfiles as described below.
+
  
{{Warning|These steps delete your current configured TeamSpeak servers, your users, permissions and all settings.}}
+
With the first startup TeamSpeak creates the SQLite database at {{ic|/var/lib/teamspeak3-server/ts3server.sqlitedb}} and starts logging its standard output in files in: {{ic|/var/log/teamspeak3-server/}}. Teamspeak also creates the first ServerQuery administration account (the superuser) and the first virtual server including a privilege key for the server administrator of this virtual server. The privilege key is only displayed once on standard output.
  
* Stop teamspeak3-server (see [[Daemon]]).
+
* [[Start]] the {{ic|teamspeak3-server}} service.
  
* Remove {{ic|/var/lib/teamspeak3-server/ts3server.sqlitedb}}:
+
* To find the privilege key:
{{bc|
+
$ systemctl status teamspeak3-server
rm /var/lib/teamspeak3-server/ts3server.sqlitedb}}
+
  
* Clear {{ic|/var/log/teamspeak3-server/}}:
+
* Scan the output for the privilege key:
{{bc|
+
{{hc|Example output:|<nowiki>
rm /var/log/teamspeak3-server/*.log}}
+
● teamspeak3-server.service - TeamSpeak3 Server
 +
  Loaded: loaded (/usr/lib/systemd/system/teamspeak3-server.service; enabled; vendor preset: disabled)
 +
  Active: active (running) since Sat 2015-09-05 23:34:42 BST; 49min ago
 +
Main PID: 20126 (teamspeak3-serv)
 +
  CGroup: /system.slice/teamspeak3-server.service
 +
          └─20126 /usr/bin/teamspeak3-server logpath=/var/log/teamspeak3-server/ dbsqlpath=/usr/share/teamspeak3-server/sql/
  
* Now you can run the server (as root):
+
Sep 05 23:34:45 Your-Hostname teamspeak3-server[20126]: serveradmin rights for your virtualserver. please
{{bc|
+
Sep 05 23:34:45 Your-Hostname teamspeak3-server[20126]: also check the doc/privilegekey_guide.txt for details.
<nowiki>su -s /bin/bash -l -c "/usr/bin/teamspeak3-server logpath=/var/log/teamspeak3-server/ dbsqlpath=/usr/share/teamspeak3-server/sql/" teamspeak</nowiki>}}
+
Sep 05 23:34:45 Your-Hostname teamspeak3-server[20126]: token=lcUEBG5YVxnhzPcS5hAmOkW1Zb6KbTZbkntbPFca                                                   
 +
Sep 05 23:34:45 Your-Hostname teamspeak3-server[20126]: ------------------------------------------------------------------
 +
Sep 05 23:34:45 Your-Hostname teamspeak3-server[20126]: 2015-09-05 22:34:45.322567|INFO    |CIDRManager  |  | updated query_ip_whitelist ips: 127.0.0.1,
 +
Sep 05 23:34:45 Your-Hostname teamspeak3-server[20126]: 2015-09-05 22:34:45.323806|INFO    |Query        |  | listening on 0.0.0.0:10011
 +
Sep 05 23:34:53 Your-Hostname systemd[1]: Started TeamSpeak3 Server.
 +
</nowiki>}}
  
* You should see an output similar to this:
+
* The privilege key is what token is equal to.
{{hc|Example output|
+
<nowiki>------------------------------------------------------------------
+
                        I M P O R T A N T                         
+
------------------------------------------------------------------
+
              Server Query Admin Acccount created               
+
          loginname= "serveradmin", password= "password"
+
------------------------------------------------------------------</nowiki>}}
+
  
{{Note|Write down the password for the ServerQuery administrator!}}
+
* Alternatively, you can navigate to the logs directory for teamspeak3-server and read the output log directly. (This is a persistent file and will still have the first startup output here even if you have restarted the server):
 +
{{Note| You have to be have either be logged in as root or as the teamspeak user to access this directory!}}
 +
$ cd /var/log/teamspeak3-server
 +
$ cat ts3server_*.log
  
* You will also find the privilege key of the first virtual server in this output which can be used to gain administrative rights on this virtual server. But the key is also written to the logfile at {{ic|/var/log/teamspeak3-server/}} and you can see it in {{ic|<nowiki> journalctl -f --lines=50 </nowiki>}}
+
Open up a Teamspeak 3 client, connect to the server and copy and paste the privilege key into the client popup.
 +
 
 +
=== Regular startup ===
 +
 
 +
Simply [[enable]] the {{ic|teamspeak3-server}} service.
 +
 
 +
=== Re-Initialising Teamspeak ===
 +
 
 +
If you have used the initial privilege key and have lost server permissions (e.g. your teamspeak 3 client with superadmin rights was uninstalled) you will have to start from scratch.
 +
 
 +
{{Warning|These steps delete your current configured TeamSpeak servers, your users, permissions and all settings.}}
 +
 
 +
* [[Stop]] the {{ic|teamspeak3-server}} service.
 +
 
 +
* Remove {{ic|/var/lib/teamspeak3-server/ts3server.sqlitedb}}:
 +
 
 +
$ rm /var/lib/teamspeak3-server/ts3server.sqlitedb
 +
 
 +
* Clear {{ic|/var/log/teamspeak3-server/}}:
 +
$ rm /var/log/teamspeak3-server/*.log
  
* You can stop the server with this:
+
* Now follow the same instructions for a first time setup.
{{bc|
+
kill `pidof -o %PPID /usr/bin/teamspeak3-server`}}
+
  
==== Regular startup ====
+
== See also ==
Simply start teamspeak3-server (see [[Daemon]]).
+
  
== External links ==
 
 
* [http://www.teamspeak.com/?page=literature Official documentation]
 
* [http://www.teamspeak.com/?page=literature Official documentation]

Latest revision as of 12:33, 13 May 2016

From Wikipedia:TeamSpeak:

TeamSpeak is proprietary Voice over IP software that allows computer users to speak on a chat channel with fellow computer users, much like a telephone conference call.

Installation

Client

Install the teamspeak3 package.

Server

Install the teamspeak3-serverAUR package.

Server configuration and startup

Configuration

  • You can configure the TeamSpeak server. If you are using systemd please check /usr/share/doc/teamspeak3-server/server_quickstart.txt for all available command line parameters.
  • If you possess a license file please copy it to /var/lib/teamspeak3-server/licensekey.dat.

First startup

With the first startup TeamSpeak creates the SQLite database at /var/lib/teamspeak3-server/ts3server.sqlitedb and starts logging its standard output in files in: /var/log/teamspeak3-server/. Teamspeak also creates the first ServerQuery administration account (the superuser) and the first virtual server including a privilege key for the server administrator of this virtual server. The privilege key is only displayed once on standard output.

  • Start the teamspeak3-server service.
  • To find the privilege key:
$ systemctl status teamspeak3-server
  • Scan the output for the privilege key:
Example output:
● teamspeak3-server.service - TeamSpeak3 Server
   Loaded: loaded (/usr/lib/systemd/system/teamspeak3-server.service; enabled; vendor preset: disabled)
   Active: active (running) since Sat 2015-09-05 23:34:42 BST; 49min ago
 Main PID: 20126 (teamspeak3-serv)
   CGroup: /system.slice/teamspeak3-server.service
           └─20126 /usr/bin/teamspeak3-server logpath=/var/log/teamspeak3-server/ dbsqlpath=/usr/share/teamspeak3-server/sql/

Sep 05 23:34:45 Your-Hostname teamspeak3-server[20126]: serveradmin rights for your virtualserver. please
Sep 05 23:34:45 Your-Hostname teamspeak3-server[20126]: also check the doc/privilegekey_guide.txt for details.
Sep 05 23:34:45 Your-Hostname teamspeak3-server[20126]: token=lcUEBG5YVxnhzPcS5hAmOkW1Zb6KbTZbkntbPFca                                                     
Sep 05 23:34:45 Your-Hostname teamspeak3-server[20126]: ------------------------------------------------------------------
Sep 05 23:34:45 Your-Hostname teamspeak3-server[20126]: 2015-09-05 22:34:45.322567|INFO    |CIDRManager   |   | updated query_ip_whitelist ips: 127.0.0.1,
Sep 05 23:34:45 Your-Hostname teamspeak3-server[20126]: 2015-09-05 22:34:45.323806|INFO    |Query         |   | listening on 0.0.0.0:10011
Sep 05 23:34:53 Your-Hostname systemd[1]: Started TeamSpeak3 Server.
  • The privilege key is what token is equal to.
  • Alternatively, you can navigate to the logs directory for teamspeak3-server and read the output log directly. (This is a persistent file and will still have the first startup output here even if you have restarted the server):
Note: You have to be have either be logged in as root or as the teamspeak user to access this directory!
$ cd /var/log/teamspeak3-server
$ cat ts3server_*.log

Open up a Teamspeak 3 client, connect to the server and copy and paste the privilege key into the client popup.

Regular startup

Simply enable the teamspeak3-server service.

Re-Initialising Teamspeak

If you have used the initial privilege key and have lost server permissions (e.g. your teamspeak 3 client with superadmin rights was uninstalled) you will have to start from scratch.

Warning: These steps delete your current configured TeamSpeak servers, your users, permissions and all settings.
  • Stop the teamspeak3-server service.
  • Remove /var/lib/teamspeak3-server/ts3server.sqlitedb:
$ rm /var/lib/teamspeak3-server/ts3server.sqlitedb
  • Clear /var/log/teamspeak3-server/:
$ rm /var/log/teamspeak3-server/*.log
  • Now follow the same instructions for a first time setup.

See also