LETS Trading Portal (tportal)
=============================

Copyright (c) 2004 Fundamentech GbR, Hallbergmoos, Germany

This software is provided by Fundamentech "as is", with no warranty.
The user must not held Fundamentech liable for any damage
that occurs through its usage.

Redistribution of this software is not permitted.

This directory contains all necessary files for 
installing tportal on a SuSE Linux system.


System Requirements:
--------------------
SuSE Linux 9.3 for i386
MySQL 4.1
Apache 2.0		All modules compiled as dynamically
			loadable, prefork-version.


How to Install the Tportal Software:
-----------------------------------
Make sure this directory is located or soft-linked at root level,
i.e. its path should be "/tportal".

Run /tportal/tportal_install. This will copy a number of files from
the /tportal/conf directory to the appropriate places.
The original versions of the system configuration files will be 
backed up to *.orig


How to Start and Stop the Apache2 HTTP Server:
---------------------------------------------
Type "apache2ctl" to see the available command line options.


How to Install, Start and Stop the MySQL Database Server:
---------------------------------------------------------
Make sure you have installed the Obelio software first (see above).
Then to initialize the grand tables of MySQL enter the shell command:
	mysql_install_db
You can manually start the mysqld server by entering:
	mysqld_safe &
You can manually shut down the mysqld server via:
	mysqladmin shutdown
Please note that the mysqld server starts automatically after reboot,
when the tportal software has been installed as described above (test it!).


How to build the Database and Administer the Portal:
----------------------------------------------------
Once you have installed the tportal software you should test the 
connection between the Web browser client and the server by 
entering http://www.tportal.de or whatever is the configured domain 
of the tportal software. Make sure the DNS name resolution works or a 
loop-back interface is configured in case your browser runs in the 
server.

At the home page you select your language and click on "My Account". 
At the Login window you should enter user name "superadmin" and 
password "donnerkeil".

After you have logged in you see the commands of the portal 
administrator. You can build the database by clicking
"Create Database" and "Import from Dump File". The dump file contains
human-readable sql statements. It is located at /tportal/db_dump/db_dump.sql.

Via the commands "Insert Members", "Insert Profiles", 
"Insert Roles and Members", "Insert Communities", and "Insert Accounts" 
you need to provide the information that registers yourself as a member, 
gives you an account, and a login.

At the end you close your browser window. You then reopen the browser 
and login with the user credentials that you provided. If you gave 
yourself the three roles "Member", "Community Administrator", and 
"Portal Administrator" you will be able to see and execute all possible 
commands of the tportal software.

Have fun, but don't complain!