** INSTALLATION INSTRUCTIONS FOR TOES ONLINE **

This is a short explanation on how to install the .NET application
"Toes Online". See http://toesonline.sourceforge.net/ for updates and
latest news.

This is version 2007-03-22 of this document.

** REQUIREMENTS **
To install Toes Online on your webserver you need the following:
1) A .NET 2.0 webserver, like Apache with Mono or the Microsoft .NET
   server. It has been tested using Apache (with mod-mono) and the xsp2
   server running on Linux and using Microsoft .NET webserver on Windows.
2) You will need MySQL as database server. Microsoft SQL server is not yet
   supported but will require only minimal changes.
3) The Toes Online-binaries, which you can get from a precompiled binary
   package from our website or you can compile them yourself from the sources.

** INSTALLATION **
This describes the installation for Toes Online. If you get any unexpected
errors, whether you solve them or not, please let me know!
1)  Extract the Toes Online binaries to a directory where you like it.
    (In later versions: If you want to upload picture of e.g. your members,
    you'll have to make the upload directory writable for your webserver).
2)  If you do not have a database already in which toesonline can store its
    data, you have to create a database yourself. In some situations, you'll
    want to use an existing database that is also used for other services. In
    that case you should set a table prefix in the configuration file and use
    the host/username/password/database properties associated with that
    database.
    
    Below is an example how to create a database named 'toesonline' with a
    user 'anoko' with password 'aumijnteen'.
    - Login on the database with administrative privileges (e.g. root):
        $ mysql -u <adminusername> -p
        Enter password: *****
    - On the mysql prompt, create a database:
        mysql> CREATE DATABASE toesonline;
        Query OK, 1 row affected (0.12 sec)
    - Create an account for this database:
        mysql> CREATE USER anoko IDENTIFIED BY 'aumijnteen';
        Query OK, 0 rows affected (0.08 sec)
      (mysql version >= 5 is required for this statement. If you do not have
      mysql 5, please refer to the manual how to create a user).
    - Specify the account privileges for the new database:
        mysql> GRANT ALL ON toesonline.* TO anoko;
        Query OK, 0 rows affected (0.11 sec)
        mysql> quit;
        Bye
    
3)  Copy the file config/siteconfig_example.xml to config/siteconfig.xml and
    alter the database settings and other settings you wish to change. If
    you now go to the path of Toes Online in your browser, you should now be able
    to see a valid 'not yet set up' message (you won't be able to login yet).
4)  Browse to http://path-to-your-installation/default.aspx?page=Upgrade and
    click on 'Upgrade'. This might take some moment, as the database will now
    get initialized.
    Once finished, you will see all statements performed on the database;
    check whether there are errors on the bottom of the page (if so, please
    let me know). You will also automatically get logged in as admin. The
    admin password will be set to 'aumijnteen' initially.
5)  The upgrade script will tell you that you need to update your config
    file, so do this now.
6)  Your system is up and running now. Change your admin password immediately!
7)  Change the system configuration under the 'admin' tab accordingly to your
    demands.
8)  You'll have to change the default mails, e.g. for sending birthday mail, so
    change the default mails (under the 'mail' tab).
9)  Set up rights and accounts for the board of the organisation and other
    users.
10) Your system is now up, running and completely configured. You might want to
    import data with the import function. Please tell me your experiences of
    this installation! You can find us at http://toesonline.sourceforge.net/ .

** LICENSE **
This file is part of Toes Online.

Toes Online is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

Toes Online is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with Toes Online; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 
Copyrights 2006 by Andre Offringa
Email: offringa@gmail.com