====== Installing TeamSpeak on Gandi AI ======

[[http://www.goteamspeak.com/|TeamSpeak]] is free software which allows you to communicate vocally with your friends. This tool is just as simple to use as it is to install.

Here is how to install the software server:

===== Step 1: Creating a user and fetching the package =====

Let's start by creating a user (you can, of course, choose a user you had already created if you wish). Thanks to Gandi AI, we can use a web interface to create a new Unix user.

In your Gandi AI interface, click on the server you want to create a user for. Then, in the **System Administration** section, click **manage** next to the "Services installed" line. 

Then, in **Configuration**, click **Configure my server**.

In the "**Operating system (unix)**" section, click **Create** in the **Users: choose_or_create** sub-section.

In our example, we've called the user **tss**. Define a password for this user and make sure the little box next to the user name is ticked (or else it wil not be created):

{{ en:hosting:using-linux:tutorials:gandiai:teamspeak-user.png }}

Submit the new Gandi AI configuration and wait a couple minutes for it to be effective (you can return to the Gandi AI main hosting interface and reload it every 2 minutes to check).

Once the configuration has been modified, you connect to your server in SSH with this new user. Therefore, log in with this user name (**tss** in our example**) and its password.

Once you have logged in in SSH, fetch the TeamSpeak archive containing the compressed files (the URL given here was working at time time of writing, but we're relying on the Gandi Iwi community for updating it if someone finds it has become out of date):
  wget ftp://ftp.freenet.de/pub/4players/teamspeak.org/releases/ts2_server_rc2_202319.tar.bz2  

Now let's decompress the archive:

  tar -xjf ts2_server_rc2_202319.tar.bz2

The server is ready to start working!


===== Step 2: Starting the server =====

Open the following folder in the server's directory
  cd tss2_rc2

You should see something looking like this (with the ls -la command)

{{ fr:hosting:using-linux:tutorials:ubuntu:fr:tss_phase2.gif }}

However, a key file is missing: server.log\\
It will be generated during the server's first launch, and will be essential from that point onwards.

Let's launch the server:
  ./teamspeak2-server_startscript start
  
Which will display this message:

{{ fr:hosting:using-linux:tutorials:ubuntu:fr:tss_phase3.gif }}

If we list the folder again, we'll find 6 new files including the infamous server.log

Let's take a look at this one:
  cat server.log

The file's essential information resides in the two lines shown below:  

{{ fr:hosting:using-linux:tutorials:ubuntu:fr:tss_phase4.gif }}

Those are the passwords for the server's admin AND the superadmin. Of course, each TeamSpeak setup generates a different password during the first launch.
That's why server.log didn't exist before we had launched it. 


You can also type this command to display the passwords:
  ./teamspeak2-server_startscript passwords
  
  
===== Step 3: Configuring the server =====

With these informations, we're going to connect to the TeamSpeak web interface.

No need for Apache, MySQL, PHP or anything of the sort, TeamSpeak is a real stand alone :)  

Using your favorite web browser, open the URL which corresponds to the server's IP (or the domain name if you'd configured a DNS), adding the specific port corresponding to TeamSpeak's administration, this being 14534. For example:
  http://217.70.190.13:14534

You'll reach the following interface:

{{ fr:hosting:using-linux:tutorials:ubuntu:fr:tss_phase5.gif }}

You should use the superadmin interface, which will allow you to transfer to the admin one later (working your way down, as it were):

{{ fr:hosting:using-linux:tutorials:ubuntu:fr:tss_phase6.gif }}

From this interface, you'll be able to edit your server, add users, creating other servers etc... But that would be another tutorial altogether :)

===== See also =====
  * [[:en:hosting:gandi-ai:configure-teamspeak]]