From e1cee982b0c9de78ef500e46350780b7707cf7b1 Mon Sep 17 00:00:00 2001 From: wainstead Date: Sun, 8 Oct 2000 19:08:06 +0000 Subject: [PATCH] Reread and updated. git-svn-id: svn://svn.code.sf.net/p/phpwiki/code/trunk@253 96ab9672-09ca-45d6-a79d-3d69d39ca109 --- INSTALL | 47 ++++++++++++++++++++++++++++------------------- 1 file changed, 28 insertions(+), 19 deletions(-) diff --git a/INSTALL b/INSTALL index cebd28715..ef427c151 100644 --- a/INSTALL +++ b/INSTALL @@ -8,24 +8,24 @@ That's it. To improve efficiency, edit lib/config.php and set the $ServerAddress by hand; this will save a regexp call on every invocation. bash$ gzip -d phpwiki-X.XX.tar.gz -bash$ tar xvf phpwiki-X.XX.tar +bash$ tar -xvf phpwiki-X.XX.tar Let's say you own the web server http://www.foo.com/. You untar in the server's root directory; then you should be able to just go to your new Wiki: -http://www.foo.com/wiki/index.php +http://www.foo.com/phpwiki/index.php If you configure your server to recognize index.php as the index of a directory, you can just do: -http://www.foo.com/wiki/ +http://www.foo.com/phpwiki/ 1. CONFIGURATION The first time you run this Wiki it will load a set of basic pages from -the pgsrc/ directory. These should be enough to get your Wiki started! +the pgsrc/ directory. These should be enough to get your Wiki started. PhpWiki will create some DBM files in /tmp. They contain the pages of the live site, archived pages, and some additional information. @@ -39,23 +39,25 @@ directory made when you untarred PhpWiki. Move the DBM files there. The files are called: wikipagesdb, wikiarchivedb, wikilinksdb, wikihottopicsdb, and wikihitcountdb. The files should already have proper rights and owners, as they were created by the web server. Otherwise -change them accordingly so your web server can read/write the DBM files. +change them accordingly so your web server can read/write the DBM +files. (Note you must be root to move files created by the web server). Then you must ensure that the web server can access the "pages" directory and can create new files in it. These can be achieved e.g. by doing +bash$ chown nobody:youraccount pages +bash$ chmod 755 pages + +if your web server runs as user 'nobody'. This is necessary so that +the server can also create/set the lock file (PHP has a built in +locking mechanism for DBM file access). Or if you're really lazy and +don't worry much about security: + bash$ chmod 777 pages Note: this is insecure. The proper way is to let the directory be owned -by the web servers GUID and give it read and write access. For example, -if your web server runs as 'nobody' you would issue these commands -(you may need to do this as 'root'): - -bash$ chown nobody:nogroup pages -bash$ chmod 755 pages +by the web servers GUID and give it read and write access. -This is necessary so that the server can also create/set the lock file -(PHP has a built in locking mechanism for DBM file access). 2. ALLOWING EMBEDDED HTML @@ -63,7 +65,7 @@ This is necessary so that the server can also create/set the lock file PhpWiki ships with this featured disabled by default. According to CERT (http://www.cert.org/advisories/CA-2000-02.html) malicious users can embed HTML in your pages that allow pure evil to happen. You can uncomment the -"elseif" in lib/transform.php to allow embedded HTML; but you should never +"elseif" in lib/transform.php to allow embedded HTML; but you should NEVER do this if your Wiki is publically accessible. @@ -71,13 +73,20 @@ do this if your Wiki is publically accessible. Installing PHP is beyond the scope of this document :-) You should visit http://www.php.net/ if you don't have PHP. -Note that I have the web server configured to allow index.php +Note that you should have the web server configured to allow index.php as the root document of a directory. -This web application was written under PHP version 3.0.12. I used -a very generic installation, so hopefully you will have no problems. -The development platform is a Redhat Linux 4.2 box. +This web application was written under PHP version 3.0.12 and +the latest build of PHP4. It's tested under the following systems: + +MySQL + Debian +mSQL + Red Hat 4.1 +DBM or Postgresql on Red Hat 6.2 + +It reportedly works on Windows with Apache+PHP, which amazes me. + +That should be all. Send patches, bugs etc. to: -That should be all. Send patches, bugs etc. to swain@wcsb.org. +phpwiki-talk@lists.sourceforge.net FIN -- 2.45.0