TikiWiki installation v1.7.2
-----------------------------
$Header: /cvsroot/tikiwiki/tiki/INSTALL,v 1.1.2.5 2003/10/01 13:16:32 mose Exp $


Where to find help for installation ?
-------------------------------------
It is highly recommended you refer to the online documentation :

* Setup Guide
  http://tikiwiki.org/InstallTikiDoc

* What to do in case of problems ?
  http://tikiwiki.org/InstallTikiHelp

* Troubleshooting and workarounds
  http://tikiwiki.org/InstallTikiTroubleShootingDoc

* Wiki pages about install on tikiwiki.org
  http://tikiwiki.org/cat57

* Official manual for 1.6 version (350 pages)
  http://tikiwiki.org/tiki.pdf

* Read the Tiki Install FAQ
  http://tikiwiki.org/tiki-view_faq.php?faqId=5

* Tikiwiki is also a community
  irc.freenode.net channel #tikiwiki



INSTALL TIKI
-----------------------------
Before you get start it's a good idea to know:
- your database user name and password
  If you can setup a new user for tiki db it's even better
- your apache user and group
  you can find it in httpd.conf file or read it in your phpinfo

( note about rpm install :
  If you're using the rpm that is available
  you can skip down to browser based install. )

Unpack the archive to the directory where you want tiki
installed (we use in our examples a subdir of /var/www)
  mv tikiwiki-1.7.2.tar.bz2 /var/www/tiki
  cd /var/www/tiki

to uncompress bz2 file use
  tar xvjf tikiwiki-1.7.2.tar.bz2

If not done already make setup.sh executable
  chmod 755 setup.sh

Then, follow the next steps one after one :


1/ Rights fixing (shell/ftp-based)
-----------------------------------

This script assigns necessary permissions for the directories that the
webserver writes files to. It also creates the (initially empty) cache
directories.

Usage ./setup.sh user [group] [rights] [list of virtual host domains]

For example, if apache is running as user 'webuser' and group 'webgroup', type:

  su -c "./setup.sh webuser"

Alternatively, you may wish to set both the user and group (using
your login that we call here 'mylogin')

  su -c "./setup.sh mylogin webgroup"

This will allow you to delete certain files and directories without becoming root.

Or, if you can't become root, but are a member of the group apache runs under
(for example: 'webgroup'), you can type:

  ./setup.sh mylogin webgroup

If you can't become root, and are not a member of the apache group, then type:
(according your default group is 'mygroup')

   ./setup.sh mylogin mygroup 02777

NOTE: If you do execute this last command, you will not be able to delete
certain files created by apache, and will need to ask your system
administrator to delete them for you if needed.

To use Tiki's multi-site capability (virtual hosts from a single DocumentRoot)
add a list of domains to the command to create all the needed directories.
For example:

  su -c "./setup.sh mylogin webgroup 02775 domain1 domain2 domain3"

If you only have a ftp access and can change rights, here is the list of directories
that need to be created and setup with proper rights :

backups
db
dump
dump/html
img/wiki
img/wiki_up
modules/cache
temp
templates_c
templates
styles
lib/Galaxia/processes


2/ DB setup (web-based)
---------------------------

* Create a tiki empty database (using phpmyadmin or 'myqsladmin create' command)

* Point your browser to the web address that corresponds to the file tiki-install.php
  (e.g. http://localhost/tiki/tiki-install.php)

* Follow the instructions there
  you'll need the password and user name for your database

* For the first time to log into Tiki is
  - user: admin
  - password: admin


3/ Local configuration (tiki-bsed)
-------------------------------------

Next you can configure Tiki to your needs :

* Choose which features you want switched on
  - click on http://localhost/tiki/tiki-admin.php on the left side of your screen

* (Optionally) create groups of users that share permissions

* Assign appropriate permissions


4/ Now enjoy your fresh tiki !
-------------------------------

You can find useful to write down your installation history on a wiki page
on http://tikiwiki.org and if you work on it, contribute your code back ! :)


the tikiwiki community

