wiki:Configuration

Configuration

After you have installed all needed software and configured the webserver and database you will have to do some configuration of the web scripts to get it working.

Creating the database

Before you can configure the web interface you will have to create a new database. At the same time you can set up a new database user with limited access, by using the following commands:

echo "create database <databasename>;" | mysql
echo "grant all on <databasename>.* to <dbuser>@localhost identified by '<dbuserpass>'" | mysql <databasename>

config.php

The config.php(.dist) is located in trunk/sites/<project>/ , depending on which part of the web interface you want to use. You will need to copy the config.php.dist to config.php which will contain your local settings.

Shared configuration settings

  • openlabs_dir, should point to the top source directory. E.g. /usr/local/www/openlabsweb/trunk
  • site_db_hostname, site_db_user, site_db_db is database access parameters. This must match the configuration of your database.
  • site_admin, should be a email address of your site admin.
  • site_root, should be the path on the web server where the scripts are located. On a dedicated system this is empty.
  • smarty_compile_dir, this is where smarty outputs its compiled templates and must be read/writable by the user running the webserver.
  • wiki_upload_dir, this is where uploaded wiki files are stored, this must be read/writeable by the user running the webserver. Special care SHOULD be taken to avoid file upload attacks, such as disabling script execution in the webserver. Basic protection exist, but you can never be to sure.

Electronic specific configuration

  • g_immediate_experiment_time, this indicates how many seconds a immediate experiment session lasts.

Creating databases

After you have created the database and set it up correctly in the config.php file you will have to create the initial database structure. This is done by running the script create_database.php in the dbscripts folder.

cd dbscripts
php create_database.php

This will create the database structure in the database chosen in the config.php file.

Adding the first administrator account

To begin administrating the web site you will have to add an admin account. This can be done by running the create_admin.php script in the dbscripts folder.

cd dbscripts
php create_admin.php <user@domain> <password>

Adding additional administrators can be done by first adding the user, then change the users role through the admin user interface.

Setting path permissions

Don't forget to set the access permissions of the directories that you entered into config.php so that the webserver user can access them.

Basic page information

If the previous steps have been completed you should now see a page with the message "Page data is missing, maybe the page doesn't exist or it hasn't been translated yet. ". This is because no wiki pages exist yet. Also notice that no sidebar menu is visible, as this is also a wiki page.

Wiki markup

We use the Text_Wiki markup engine and documentation and markup can be found there.

Creating new wiki pages

The usual way to create new wiki pages is to first link to a new page, and by following that link you can create that page. If you have no link, you can still create new pages by entering the name of the page you want to create into the url field. Go to the url http://<your site>/index.php?page=SomePage

Special wiki pages

  • StartPage, this is the welcoming page.
  • PageMenu, describes what you see in the public sidebar. Format described below.

An example:

+ [StartPage Main Menu]
++ [StartPage Start]
++ [AboutPage About]
++ [DemoPage Demo]
++ [FaqPage FAQ]
Last modified 8 years ago Last modified on Nov 3, 2009, 5:56:47 PM