History: Linux

            !Tiki Installation on Linux

!!Initial Steps: Download, Unpack, Create Directories
These initial steps presume you're installing Tiki on a Linux machine running the Apache Webserver. Read this once top to bottom before getting started. If you're using a Windows box you can ignore the portion about setting permissions, but you'll have to set up some of Tiki's directories manually.

-=Before you get started it's a good idea to know=-
* your database user name and password
* your apache user and group ID
----
If you're using the rpm that is available you can skip down to browser based install.

These are notes on how to setup and configure Tiki.

-=Step one:=-
Download the appropriate version [http://info.tiki.org/download|download page]
Unpack and set the necessary permissions
unpack to the document root of where you want tiki installed, e.g. /var/www/tiki/ 

{CODE(caption="bz2 file Use" colors=bash)}tar -xvjf tikiwikiv.xxx{CODE}
{CODE(caption="(g)zip file Use" colors=bash)}tar -xvzf tikiwikiv.xxx{CODE}

-=Step two:=-
CHMOD the file setup.sh to 755. 
{CODE(colors=bash)}chmod 755 setup.sh{CODE}

The script __setup.sh__ in this directory 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 $AUSER and group $AGROUP, type:
You can find your group using the command 'id'.
{CODE(colors=bash)} su -c './setup.sh $AUSER'{CODE}

Alternatively, you may wish to set both the user and group:
If not root then
{CODE(colors=bash)} su -c './setup.sh $USER $AGROUP'{CODE}

This will allow you to delete certain files/directories without becoming root. Or, if you can't become
root, but are a member of the group apache runs under (for example: $AGROUP), you can type:
{CODE(colors=bash)} ./setup.sh $USER $AGROUP{CODE}

If root then, and are not a member of the apache group, then type:
{CODE(colors=bash)} ./setup.sh $USER yourgroup 02777{CODE}

Replace yourgroup with your default group.

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

If Root then
{CODE(colors=bash)}root@localhost tiki]# sh ./setup.sh youruser nobody 02775 test1 test2 test3{CODE}

If not Root then
{CODE(colors=bash)} ./setup.sh $USER $AGROUP 02777 domain1 domain2 domain3{CODE}

This will get you to the next screen go to step three below.

-=Step three: browser based setup=-
* create a tiki database
** using PhpMyAdmin (cache) and MySQL
** or on the command line mysqladmin create dbname the database name is usually called "tiki" 
* Point your browser to the web address that corresponds to the file __tiki-install.php?lang=~~red:XX~~__ (http://your_host/tiki/tiki-install.php?lang=~~red:XX~~); being ~~red:XX~~ the two letter language code of your choice (e.g. em for English, available from Tiki version 1.9.7).
* Follow the instructions there: you will need the password and user name for your database 
* For the first time to log into Tiki is 
** user: admin
** password: admin

-=Step four: Custom configuration=-
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 


-=More information=-
{toc}