Skip to content

[Linux] Install Requirements and Instructions

Shad86 edited this page Feb 21, 2021 · 3 revisions

These are the requirements:


Webspace:

For the statistics page and to be able to run the Bot in a PHP process, we need a webspace (webserver).

PHP 5.5.0 or higher PHP with privileges for the command "exec" PHP with unlimited script execution time; especially you should check this on a webhosting required PHP extensions:

  • PHP PDO extension
  • PHP PDO MySQL driver
  • PHP cURL extension
  • PHP Zip extension
  • PHP OpenSSL extension
  • PHP SSH2 extension
  • PHP mbstring extension

network connection to the TS3 ServerQuery of your TS3 server on TCP; default port 10011 network connection to ts-ranksystem.com (IP: 193.70.102.252) on TCP port 443 optional: job scheduler (for automatically restart the Bot) like a cronjob

Database:

The database will storage all information. This is necessary to get a real time statistic page.

MySQL (or derivative like MariaDB) requires its own database required privileges:

  • Data: SELECT, INSERT, UPDATE, DELETE
  • Structure: CREATE, ALTER, INDEX, DROP

Teamspeak:

To connect with the TeamSpeak 3 server, we need access to the TS3 ServerQuery interface.

Network connection between the webspace and the TS3 ServerQuery TS3 ServerQuery User with following permissions:

  • b_virtualserver_info_view
  • b_virtualserver_client_list
  • b_virtualserver_client_dblist
  • b_virtualserver_client_dbsearch
  • b_virtualserver_client_dbinfo
  • b_virtualserver_notify_register
  • b_virtualserver_servergroup_list
  • b_virtualserver_servergroup_client_list
  • i_group_member_add_power
  • i_group_member_remove_power
  • b_icon_manage
  • b_client_remoteaddress_view
  • i_client_private_textmessage_power
  • i_ft_file_browse_power
  • i_ft_file_download_power

With these installed packages it should run smoothly on a Debian9(Stretch) system:


apt-get install mariadb-server mariadb-client

apt-get install php-zip libapache2-mod-php php-curl php-xml php-mysql php-common php-ssh2 php-mbstring

apt-get install apache2

apt-get install phpmyadmin (if needed / if you want it / Personally, I think it's a very useful tool for beginners.)


Downloading the file and using the standart webuser from debian9:


download the latest release.

the best way to do this:

Go to your webspace folder via ssh console

Webspace folder is mostly:

/var/www/html or /var/www

then download it with wget http/link.de .

then you're untar or unzip the whole thing.

Now, a new folder should be available with tsn-ranksystem, you can check it with

Is

if found:

chown www-data:www-data tsn-ranksystem/* -Rf <- on lamp / "apache" and may also "nginx" server's most time this is the standart webuser and should be set, if not the cronjob later may not work correctly.

Now the following folders and files in the tsn-ranksystem folder need the following chmod' s

change to the folder once and then (assuming it is the stable release)

chmod 740 tsicons/ avatars/ logs/ update/ other/dbconfig.php -Rf

Now you have to create a database user in your Mariadb and of course a database that the user can access.

Once you've done that, you can go to your homepage

YourHp.de/tsn-ranksystem/install.php

Here you will be guided through, should something else be wrong or missing, know that the ranksystem will point to it, if everything runs correctly you are finished after that and you can use the ranksystem.


Hints:


A cronjob is good for keep the bot alive:

*/10 * * * * sudo -u www-data php /path/to/your/ranksystem/worker.php check >/dev/null 2>&1