TUTOS Homepage / Easy Installation
how to install TUTOS / the easy way
- If you are updating from an older relase. Make a copy of your [tutosdir]/php/config.pinc and [tutosdir]/apache.conf !
- get the latest tarball from TUTOS
Project. Go to the directory where you like to install the software.
- Unpack
- if you got the bzip version
tar xvjf tutos.....bz2
or
cat tutos.....bz2 | bunzip | tar xvf -
- if you got the gzip version
tar xvzf tutos.....gz
or
cat tutos.....gz | gunzip | tar xvf -
- if you got the zip version
unzip tutos.....zip
- Change to the newly created tutos directory
Note: That directory should be accessible by your webserver (on unix run "chmod 711 tutos").
- look for patches that might be neccessary for your release
You will find patches at http://sourceforge.net/patch/?group_id=8047
- edit [tutosdir]/php/config.pinc according to your Database settings.
If you are not updating you have to start a new config.pinc
This "per installation" config file can have all the configuration directives you can see in config_default.pinc.
You should read the file config_default.pinc complete (!) and make all your
changes s in your personal config.pinc.
A minimal config.pinc looks like this
<?php
# see config_default for more info
$tutos[dbname][0] = "tutos";
$tutos[dbhost][0] = "localhost";
$tutos[dbport][0] = 5432;
$tutos[dbuser][0] = "wwwrun";
$tutos[dbpasswd][0] = "";
# see config_default or other Types
$tutos[dbtype][0] = 2;
$tutos[dbalias][0] = "My first TUTOS";
# Encrypt passwords
$tutos[cryptpw][0] = 1;
$tutos[repository][0] = "repository";
# No prefix for tablenames
$tutos[dbprefix][0] = "";
?>
On runtime TUTOS will first read config_default.pinc and then config.pinc which can overwrite the previous default values. If you are happy with the defaults you don't have to copy such an entry to config.pinc.
- if you are updating: Read the [tutosdir]/ChangeLog file in your base directory and
call the http://[yourserver]/tutos/php/update.php?id=XX page where XX is
our database index from config.pinc
Updaters should stop here !
- You will need a database and a DB User.
Functions to create your empty database and setting up a user are not part of TUTOS
(but here's a hint).
- edit [tutosdir]/apache.conf and include it into your apache httpd.conf
a line like "Include /home/gero/src/tutos/apache.conf" will do it.
Restart apache !.
This step could be optional if you can already reach your TUTOS install dir using your apache.
Nevertheless have a look at this file (apache.conf) in order to see what we do there.
- run http://[yourserver]/tutos/php/scheme.php
- depending on the number of steps you perform you will have a runable tutos installation afterwards
- with a superuser account (User: superuser Password: tutos CHANGE THIS !!)
- with some example users and data
- test everything
- Login at http://[yourserver]/tutos/php/mytutos.php with the above username and password
- remove [tutosdir]/php/scheme.php and [tutosdir]/php/update.php from your php subdir or at least disable it for public use!!!
- CHECK that http://[yourserver]/tutos/php/config.pinc is not readable. This should be the case if you leave [tutosdir]/php/.htaccess intact and/or use the provided [tutosdir]/apache.conf, otherwise you should provide some own protection.
If you still have problems you can look here on the SourceForge Help discussion forum.
Back to install page