6 easy steps for a successful installation
Read the Installation Requirements and make sure everything is installed. Is PHP's include path set correctly? Does your web host allow the use of .htaccess files?
The installation of AWF into a subdirectory of your web root is not supported, though it may work with some template modifications.
- Untar the archive (should be awf-2.XX.tar.gz) in the directory of your choice. The http server (normally Apache) needs to have read AND write access (if you don't know how to do this, try "man chmod", "man chgrp" and "man chown" on UNIX systems). The files should belong to your Web server (httpd) and/or PHP safe_mode should be disabled.
- PHP 5.0.3 (or better), Apache mod_rewrite, PEAR::DB, PEAR::Text_Wiki and an installed MySQL server (other servers are experimental) are required. You can enable register_globals (warning: this is insecure!), but should set magic_quotes_gpc = Off in your php.ini (default location is /usr/local/lib/php.ini or /etc/php/php.ini). If unsure, ask your hosting service provider or have a look at http://php.net/docs.php.
- If not yet done, create a database user with read/write permissions and a database (CREATE DATABASE [name]) in MySQL. If you need help, have a look at http://www.mysql.com/ or ask your hosting service provider.
- If not yet done, start your Web server and verify, that you can connect. On Linux, this can be normally done with "/etc/init.d/httpd start", "/etc/init.d/apache start" or "apachectrl start" (do this as root)
- If you want to use the Spaw WYSIWYG editor, adapt spaw/config/spaw_control.config.php to your needs.
- Finally, you can continue using the installation script admin/install.php.
AWF should then be available at http://www.domain.com/index.html. The initial default user is "admin" with the password "admin". Changes can and should be made using the User Management script (admin/user_management.php).
Please don't forget to protect the directories templates, templates_c, cache, inc, private and maybe spaw with .htaccess files or (even better) directly in httpd.conf. You can remove the spaw directory, if you don't want to use the Spaw editor.
Created: 07.01.2006 22:43 CET, Last Change: 02.04.2006 18:29 CEST by allnew
