TUTOS Homepage / Easy Installation how to install TUTOS / the easy way

  1. If you are updating from an older relase. Make a copy of your [tutosdir]/php/config.pinc and [tutosdir]/apache.conf !
  2. get the latest tarball from TUTOS Project. Go to the directory where you like to install the software.
  3. Unpack
  4. Change to the newly created tutos directory
    Note: That directory should be accessible by your webserver (on unix run "chmod 711 tutos").
  5. look for patches that might be neccessary for your release
    You will find patches at http://sourceforge.net/patch/?group_id=8047
  6. 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.

  7. 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 !
  8. 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).
  9. 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.
  10. run http://[yourserver]/tutos/php/scheme.php
  11. test everything
  12. remove [tutosdir]/php/scheme.php and [tutosdir]/php/update.php from your php subdir or at least disable it for public use!!!
  13. 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