On this page you will learn
The DataTank requires a server with
- Apache2 or Nginx
- mod rewrite enabled
- PHP 5.4 or higher
- Any database supported by Laravel 4
If you're using a Unix system, the easiest way to meet these requirements is to perform the following commands:
$ apt-get install apache2 php5 mysql-server php5-dev php5-memcache memcached php5-curl $ a2enmod rewrite
If you're using a Windows system, you'll have to download a web stack that holds the necessary requirements.
Set the rewrite rules in
<Directory /> Options FollowSymLinks AllowOverride All </Directory> <Directory /var/www/> Options Indexes FollowSymLinks MultiViews AllowOverride All Order allow,deny allow from all </Directory>
An installation through the command line requires the installation of composer. Make sure you have it downloaded properly and ready to use. Next to that you'll need to prepare a database with a user that has read & write permissions for The DataTank to use.
Install the application
To install, open up a terminal and clone our repository
git clone https://github.com/tdt/core.git
Configure the database
Provide your database credentials in the
app/config/database.php file, according to the Laravel database configuration.
After that you're ready to make composer work his magic! Run the following command from the root of the folder where you cloned the repository:
Add permissions to the log directory
To store logs and other files, the right permissions need to be set:
$ chmod -R 777 /var/www/tdt/app/storage/
Get started with our demo data
In order to get you started, we've provided a seeder that publishes a set of data files. This can be done with the following command:
php artisan db:seed --class=DemoDataSeeder
This will publish some data sets to some self-explanatory uri's. For example CSV files will be published under the collection uri 'csv', JSON files under 'json', and so on and so forth.
Get started with our user interface
We've created a user interface to manage datasets and users on the uri api/admin, relative to the root uri. The default credentials are:
user: admin password: admin
Best practice is to change the admin password immediatly by editing it using the user interface. Click the question mark in the user interface to start the help guide.